Colonnes de site et types de contenu dans le modèle de complément SharePoint
L’approche que vous proposez pour créer des colonnes de site et des types de contenu dans les sites SharePoint est différente dans le nouveau modèle de SharePoint par rapport au code de confiance totale. Dans un scénario classique de code de confiance totale /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 d’infrastructure de fonctionnalités de SharePoint pour les packager et les déployer.
Dans un SharePoint de modèle de SharePoint, vous utilisez le modèle objet côté client (CSOM) SharePoint 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 SharePoint CSOM ou REST 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 recommandation concerne l’utilisation d’une mise en service XML déclarative sur un site web de SharePoint dans un SharePoint hébergé par SharePoint. Cela est dû au fait que le CSOM n’est pas disponible dans un SharePoint de SharePoint hébergé.
- Vous pouvez automatiser la création de colonnes de site et de types de contenu dans le cadre du processus de mise en service du site. Pour plus d’informations, voir la recette de mise en service du site.
Défis liés à la création de colonnes de site et de types de contenu SharePoint sites
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 du 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 que 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 site SharePoint unique qui n’est pas prévu pour s’agrandir pour inclure d’autres collections de sites ou sous-sites.
- Création de code
- Dans cette option, vous exécutez SharePoint code CSOM/REST 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 SharePoint CSOM/REST.
Lorsque vous créez via un navigateur web, prenez en compte les 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 chronophage.
- Ces facteurs la rendent sujette à des 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.
- Ainsi, il est 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 les applications métier.
Lorsque vous créez avec du code, prenez en compte les 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 d’utilitaires personnalisées pour exécuter SharePoint code CSOM/REST.
- 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 qui sont créés via SharePoint CSOM/REST.
- Cela facilite le déploiement des colonnes de site et des types de contenu dans différents environnements et les référence dans les applications métier de manière cohérente.
Doit se produire rapidement !
En règle générale, vous créez des colonnes de site et des types de contenu lorsque vous SharePoint site. Les utilisateurs finaux n’accepteront pas d’avoir à attendre plusieurs heures avant que vous n’approvisionnement leurs nouveaux sites SharePoint sites.
Doivent convenir de manière cohérente!
Les colonnes de site et les types de contenu sont les bases qui définissent votre architecture des informations au niveau le plus bas, ils doivent être parfaits!
Une mise en service incorrecte de la colonne de site et du type de contenu peut affecter l’ensemble d’une application métier dans le site SharePoint où elle est mise en service, ainsi que d’autres parties de SharePoint et d’autres applications métier qui accèdent aux services SharePoint.
Par exemple : si votre société utilise des sites SharePoint pour gérer des projets, vous créerez probablement un schéma de liste commun pour tous. Pour ce faire, 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 Web Parts de recherche de contenu, aux SharePoint, aux SharePoint mobiles et aux autres systèmes qui accèdent aux informations dans les sites SharePoint.
Options de création de colonnes de site et de types de contenu SharePoint sites
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 relèvent tous de l’approche Création avec code décrite ci-dessus. Vous verrez chacun de ces modèles décrit en détail dans la recette de mise en service du 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 Windows/Java/iOS ou des scripts PowerShell
Quelle que soit l’option que vous choisissez d’implémenter, vous utiliserez finalement 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 à faire 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 l’associer à 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 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 créer les SharePoint et les scripts à 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, 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, puis comment ajouter un modèle de document au type de contenu.
Liens connexes
- Mise en service de site dans SharePoint modèle de add-in (recette PnP O365)
- Articles de référence sur la page https://aka.ms/OfficeDevPnPGuidance
- Références dans MSDN sur la page https://aka.ms/OfficeDevPnPMSDN
- Vidéos sur la page https://aka.ms/OfficeDevPnPVideos
Exemples PnP
- Core.CreateContentTypes (exemple PnP O365)
- Core.ContentTypesAndFields (exemple PnP O365)
- Core.CreateDocumentContentType (exemple PnP O365)
- Branding.DisplayTemplates (exemple PnP O365)
- Core.DataStorageModels (exemple PnP O365)
- Exemples de code et contenu dans https://github.com/SharePoint/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.