Partager via

Colonnes de site et types de contenu dans le modèle de complément SharePoint

  • Article

L’approche que vous utilisez pour créer des colonnes de site et des types de contenu dans des sites SharePoint est différente dans le nouveau modèle de complément SharePoint qu’avec le code de confiance totale. Dans un scénario standard de code de confiance totale (FTC) /solution de batterie de serveurs, vous utilisez du code déclaratif pour créer des colonnes de site et des types de contenu. Dans l’approche du code déclaratif, vous définissez les colonnes de site et les types de contenu en XML, puis vous utilisez les éléments de l’infrastructure de fonctionnalités de SharePoint pour les empaqueter et les déployer.

Dans un scénario de modèle de complément SharePoint, vous utilisez le modèle objet côté client SharePoint (CSOM) ou les API REST SharePoint pour créer des colonnes de site et des types de contenu.

Conseils généraux

En règle générale, nous vous recommandons les instructions générales suivantes pour la création de colonnes de site et de types de contenu.

  • Vous devez utiliser les API CSOM ou REST SharePoint pour créer des colonnes de site et des types de contenu.
  • Vous ne devez pas utiliser d’éléments d’infrastructure de fonctionnalité pour créer des colonnes de site et des types de contenu.
    • La seule exception à cette directive est lorsque vous utilisez l’approvisionnement xml déclaratif pour un site web de complément SharePoint dans un complément SharePoint hébergé par SharePoint. Cela est dû au fait que le modèle CSOM n’est pas disponible dans un complément SharePoint hébergé par SharePoint.
  • Vous pouvez automatiser la création de colonnes de site et de types de contenu dans le cadre du processus d’approvisionnement de site. Pour plus d’informations, consultez la recette d’approvisionnement de site.

Difficultés à créer des colonnes de site et des types de contenu dans des sites SharePoint

Création d’un navigateur et création avec code

Il est important de comprendre que la création de colonnes de site et de types de contenu via le navigateur web ou via le code est différente. Cette liste décrit les différentes options.

  • Création via un navigateur web
    • Dans cette option, les utilisateurs accèdent à un site SharePoint via un navigateur web et utilisent les pages d’administration pour créer des colonnes de site et des types de contenu.
    • En règle générale, la seule fois où vous utiliserez le navigateur web pour créer manuellement des colonnes de site et des types de contenu, c’est lorsque vous prototypez ou modifiez un seul site SharePoint qui n’est pas prévu pour inclure d’autres collections de sites ou sous-sites.
  • Création de code
    • Dans cette option, vous exécutez du code CSOM/REST SharePoint pour créer des colonnes de site et des types de contenu.
    • Plus loin dans cet article, vous découvrirez quelques options que vous pouvez utiliser pour exécuter le code CSOM/REST SharePoint.

Lors de la création via un navigateur web, tenez compte des points suivants.

  • La création de colonnes de site et de types de contenu via le navigateur web est généralement un processus complexe et fastidieux.
    • Ces facteurs le rendent sujet aux erreurs.
  • Vous ne contrôlez pas les GUID pour les colonnes de site ou les types de contenu que vous créez via un navigateur web.
    • Il est donc difficile de déployer les colonnes de site et les types de contenu dans différents environnements et de les référencer de manière cohérente dans des applications métier.

Lors de la création avec du code , tenez compte des points suivants.

  • La création de colonnes de site et de types de contenu avec du code implique généralement l’utilisation de bibliothèques utilitaires personnalisées pour exécuter du code CSOM/REST SharePoint.
    • Vous trouverez ces bibliothèques disponibles dans de nombreux projets dans le référentiel GitHub Plug and Play OfficeDev. Ils sont référencés dans l’ensemble de l’article ainsi qu’à la fin.
    • Ces facteurs rendent la création de colonnes de site et de types de contenu avec du code susceptible de réussir.
  • Vous pouvez contrôler les GUID des colonnes de site ou des types de contenu créés via le CSOM/REST SharePoint.
    • Cela facilite le déploiement des colonnes de site et des types de contenu dans différents environnements et leur référence dans des applications métier de manière cohérente.

Doit se produire rapidement !

Vous créez généralement des colonnes de site et des types de contenu lorsque vous approvisionnez un site SharePoint. Les utilisateurs finaux n’accepteront pas d’avoir à attendre plusieurs heures avant que vous ayez mis en service leurs nouveaux sites SharePoint.

Doivent convenir de manière cohérente!

Les colonnes de site et les types de contenu sont la base qui définit votre architecture d’informations au niveau le plus bas, ils doivent être parfaits!

L’approvisionnement incorrect d’une colonne de site et d’un type de contenu peut affecter l’ensemble d’une application métier dans le site SharePoint où ils sont provisionnés, ainsi que d’autres parties de SharePoint et d’autres applications métier qui accèdent aux services SharePoint.

Par exemple : si votre entreprise utilise des sites SharePoint pour gérer des projets, vous allez probablement créer un schéma de liste commun pour tous ces derniers. Pour cela, vous devez créer des colonnes de site et des types de contenu. Lorsque vous recherchez des informations sur ces sites via la page de recherche SharePoint, vous filtrez les résultats par type de contenu ou la balise (colonne de site). Si les colonnes de site et les types de contenu ne sont pas parfaitement cohérents dans tous les sites de projet, vous ne recevrez pas les résultats de recherche précis.

Vous pouvez appliquer cet exemple aux composants WebPart Contenu par recherche, aux compléments SharePoint, aux compléments SharePoint mobiles et à tout autre système qui accède aux informations dans les sites SharePoint.

Options permettant de créer des colonnes de site et des types de contenu dans des sites SharePoint

Il existe plusieurs façons d’appeler le code CSOM/REST pour créer des colonnes de site et des types de contenu. Ces modèles s’inscrivent tous dans l’approche Création avec code décrite ci-dessus. Vous verrez chacun de ces modèles décrits en détail dans la recette d’approvisionnement de site.

  • Remplacer le lien créer un site
  • Remplacer le lien créer un sous-site
  • Utilisez un complément SharePoint hébergé par un fournisseur
  • Utiliser des applications Windows/Java/iOS ou des scripts PowerShell

Quelle que soit l’option que vous choisissez d’implémenter, vous allez finalement utiliser CSOM/REST pour créer des colonnes de site et des types de contenu.

Il existe de nombreux articles et exemples différents que vous pouvez utiliser pour apprendre à créer des colonnes de site et des types de contenu avec le modèle CSOM. Vous trouverez ici ces exemples (classés par le modèle utilisé pour appeler le code CSOM) pour créer des colonnes de site et des types de contenu.

Utilisez un complément SharePoint hébergé par un fournisseur

Cette option fonctionne également lorsque vous avez besoin de fournir à vos utilisateurs finaux une capacité en libre service pour créer des collections de sites et sous-sites basées sur des modèles personnalisés.

  • Core.ContentTypesAndFields (Exemple PnP O365)
    • Montre comment créer un type de contenu dans le site web hôte, créer un champ de taxonomie dans le site web hôte et le relier à la taxonomie, créer une liste et l’associer à un type de contenu, et créer des types de contenu et des champs dans des langues particulières.

Utiliser des applications Windows/Java/iOS ou des scripts PowerShell

Cette option fonctionne bien dans les scénarios opérations et développement. Elle permet de créer des applications personnalisées ou des scripts spécifiquement conçus pour fonctionner avec vos processus d’opérations et de développement. Cette option offre le niveau d’automatisation ultime, car vous pouvez générer les compléments et les scripts SharePoint à exécuter sans aucune interaction de l’utilisateur.

  • Core.CreateContentTypes (exemple PnP O365)
    • Cet exemple montre comment créer des colonnes de site, des types de contenu et ajouter, puis ajouter les colonnes de site au type de contenu. Il explique également les nouvelles fonctionnalités de localisation qui ont été introduites pour Office 365 API CSOM.
  • Core.CreateDocumentContentType (exemple PnP O365)
    • Cet exemple montre comment créer des types de contenu de document et ajouter, puis associer un modèle de document au type de contenu.

Exemples PnP

S’applique à

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

Les modèles pour les versions dédiées et en local sont identiques au complément SharePoint technique du modèle, mais il existe des différences sur les technologies qui peuvent être utilisées.