Partager via

Contrôles utilisateur et contrôles web dans le modèle de complément SharePoint

  • Article

L’approche que vous appliquez pour implémenter des contrôles personnalisés dans votre code est différente dans le nouveau modèle de complément SharePoint et dans le code de confiance totale. Dans un scénario standard de code de confiance totale (FTC) /solution de batterie de serveurs, les contrôles personnalisés ont été générés en tant que contrôles utilisateur ou contrôles web et déployés via des solutions SharePoint.

Dans un scénario de modèle de complément SharePoint, le code JavaScript est incorporé dans les pages SharePoint pour implémenter des contrôles personnalisés.

Conseils généraux

En règle générale, nous aimerions fournir les instructions générales suivantes pour la création de contrôles personnalisés dans le nouveau modèle de complément SharePoint.

  • Utilisez javascript incorporé pour créer des contrôles personnalisés.
  • Utilisez le modèle objet côté client (CSOM) SharePoint ECMA et/ou les API REST SharePoint/Office 365 pour interagir avec les données et les services SharePoint.

Options d’incorporation de JavaScript dans les pages SharePoint

Vous avez quelques options pour incorporer JavaScript dans les pages SharePoint.

  • Utiliser des actions utilisateur personnalisées
  • Incorporer JavaScript directement dans des mises en page
  • Incorporer JavaScript directement dans des pages master personnalisées (non recommandé)

Utiliser des actions utilisateur personnalisées

Dans ce modèle, des actions utilisateur personnalisées sont utilisées pour incorporer JavaScript dans une page au moment de l’exécution.

  • Cette approche est absolument prise en charge et est une approche valide.

Quand est-elle adaptée ?

Lorsque vous devez incorporer JavaScript dans toutes vos pages SharePoint, cette option est adaptée.

Prise en main

L’article suivant et la vidéo qui l’accompagne montrent comment utiliser des actions utilisateur personnalisées pour incorporer JavaScript dans des pages SharePoint.

Incorporer JavaScript directement dans des mises en page

Dans ce modèle, JavaScript est incorporé directement dans les mises en page des sites de publication.

  • Cette approche est absolument prise en charge et est une approche valide.
  • Cette approche fonctionne avec les sites de publication.

Quand est-elle adaptée ?

Lorsque vous devez incorporer JavaScript dans des mises en page SharePoint spécifiques dans des sites de publication dans un scénario WCM, cette option est adaptée.

Incorporer JavaScript directement dans des pages de master personnalisées

Dans ce modèle, JavaScript est incorporé directement dans des pages master personnalisées.

  • Cette approche n’est pas recommandée.
  • Cette approche est valide.
  • Vous pouvez incorporer JavaScript directement dans des pages de master personnalisées, mais gardez à l’esprit que cela vous entraînera des coûts à long terme supplémentaires et des défis à long terme avec les futures mises à jour.
    • Si vous avez choisi d'utiliser des pages de base personnalisées, soyez prêt à appliquer des changements aux pages de base personnalisées lorsque des mises à jour fonctionnelles majeures sont appliquées à Office 365.

Quand est-elle adaptée ?

Lorsque vous devez incorporer JavaScript sur une base par master page, il s’agit d’une bonne option, car elle vous permet de contrôler les master pages dans lesquelles JavaScript est incorporé.

Exemples PnP

S’applique à

  • Office 365 multi-locataire (MT).
  • Office 365 dédiés (D)
  • SharePoint 2013 en local