Élément Configuration (Site)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Spécifie les listes et modules utilisés dans la création d’un site web SharePoint Foundation basé sur la configuration de définition de site représentée par l’élément Configuration . Ces éléments représentent également des configurations dans les modèles web.

Par souci de simplicité, l’expression « configuration de définition de site » est utilisée tout au long de cette rubrique, bien que la rubrique s’applique également aux configurations de modèles web. Sauf indication contraire, les descriptions d’attribut suivantes s’appliquent aux éléments Configuration dans les définitions de site et les modèles Web.

<Configuration
    AllowGlobalFeatureAssociations = "TRUE" | "FALSE"
    CustomMasterUrl = "Text"
    Description = "Text"
    DisplayCategory = "Text"
    FilterCategories = "Text"
    Hidden = "TRUE" | "FALSE"
    ID = "Integer"
    ImageUrl = "Text"
    MasterUrl = "Text"
    Name = "Text"
    ProvisionAssembly = "Text"
    ProvisionClass = "Text"
    ProvisionData = "Text"
    RootWebOnly = "TRUE" | "FALSE"
    SubWebOnly = "TRUE" | "FALSE"
    SupportsMultilingualUI = "TRUE" | "FALSE"
    Title = "Text"
    Type = "Text"
    VisibilityFeatureDependency = "Text">
</Configuration>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
AllowGlobalFeatureAssociations	Facultatif Boolean. Spécifie si les associations de fonctionnalités globales sont autorisées pour les sites créés avec la configuration de définition de site.
CustomMasterUrl	Texte facultatif. Spécifie l’URL d’une autre page .master qui peut être utilisée sur les pages des sites web créés via la configuration de définition de site sans personnaliser ces pages. REMARQUE : Le simple fait de modifier la valeur de l’attribut MasterPageFile sur les pages qui nécessitent une autre page maître permet de personnaliser ces pages et de les stocker dans la base de données de contenu plutôt que dans le système de fichiers des serveurs Web frontaux. Pour plus d’informations sur la façon dont la valeur de CustomMasterUrl est utilisée, consultez Pages maîtres sur les pages d’application.
Description	Texte facultatif. Contient la description propre aux paramètres régionaux de la configuration de définition de site qui apparaît dans l’interface utilisateur de SharePoint Foundation.
DisplayCategory	Texte facultatif. Spécifie la catégorie dans laquelle la configuration de définition de site apparaîtra dans l’interface utilisateur de SharePoint Foundation, par exemple Collaboration, Réunions ou un nom personnalisé.
FilterCategories	Texte facultatif. Cet attribut n’est pas utilisé par SharePoint Foundation. Il est disponible pour les solutions améliorées de portail ou de gestion de contenu basées sur SharePoint Foundation, telles que Microsoft SharePoint Server, à utiliser comme un moyen de catégoriser les configurations de site d’une manière qui ne correspond pas précisément aux catégorisations qui apparaissent dans l’interface utilisateur. (Voir également l’attribut DisplayCategory .)
Hidden	Facultatif Boolean. Spécifie si la configuration de définition de site apparaît en tant qu’option dans l’interface utilisateur de SharePoint Foundation.
ID	Argument de type Integer obligatoire. Spécifie un ID pour la configuration de définition de site unique dans la définition de site. Une définition, telle que STS ou MPS, est définie par un élément Template dans un `WebTemp.xml` fichier et par un fichier correspondant `Onet.xml` pour la définition. Consultez Éléments parents* et remarques ci-dessous.
Imageurl	Texte obligatoire. Contient l’URL de l’image d’aperçu affichée dans l’interface utilisateur de SharePoint Foundation.
MasterUrl	Texte facultatif. Spécifie la page maître par défaut à utiliser pour les sites web créés via la configuration de définition de site.
Name	Texte facultatif. Contient le nom de la configuration de définition de site.
ProvisionAssembly	Texte facultatif. Spécifie le nom de l’assembly qui contient la classe de provisionnement, le cas échéant. (Voir ProvisionClass ci-dessous.) Par exemple : `ProvisionAssembly="MyCompany.SharePoint.ProvisionHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=82f0cdf222f0530d"`
ProvisionClass	Texte facultatif. Spécifie le nom complet d’une classe qui fournit des fonctionnalités d’approvisionnement qui s’exécutent lorsque le runtime termine la création d’un site à partir de la configuration. Il n’est pas obligatoire qu’il existe une telle classe, mais si vous en avez besoin pour une configuration personnalisée, elle doit dériver de SPWebProvisioningProvider . Par exemple : `ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"`
ProvisionData	Texte facultatif. Spécifie les données qui seront utilisées par la méthode Provision(SPWebProvisioningProperties) de provisionClass (voir ci-dessus). Il peut s’agir d’un chemin d’accès au fichier qui contient des données structurées. Par exemple : `ProvisionData="SiteTemplates\\MySiteManifest.xml"`
RootWebOnly	Facultatif Boolean. TRUE pour spécifier que le site créé à partir de la configuration existe uniquement en tant que site web racine dans une collection de sites. Cet attribut n’est pas appliqué dans les modèles Web, qui sont stockés dans solution (`.wsp` fichiers).
SubWebOnly	Facultatif Boolean. TRUE pour spécifier que le site créé à partir de la configuration existe uniquement en tant que sous-site dans une collection de sites. Cet attribut n’est pas appliqué dans les modèles Web, qui sont stockés dans solution (`.wsp` fichiers).
SupportsMultilingualUI	Facultatif Boolean. TRUE (valeur par défaut) pour spécifier que les administrateurs peuvent activer d’autres langues pour les sites créés à partir de la configuration. FALSE empêche les administrateurs d’activer cette fonctionnalité.
Titre	Texte facultatif. Contient le titre de la configuration de définition de site qui s’affiche dans l’interface utilisateur de SharePoint Foundation.
Type	Texte facultatif. Identifie la définition de site, telle que STS ou MPS.
VisibilityFeatureDependency	Texte facultatif. Utilisé dans un `WebTemp*.xml` fichier pour masquer la configuration de la définition de site en fonction de l’état d’activation de la fonctionnalité spécifiée. Lorsqu’une configuration contient des fonctionnalités qui dépendent d’une autre fonctionnalité, la définition de cet attribut empêche la configuration d’apparaître en tant qu’option dans l’interface utilisateur de SharePoint Foundation si la fonctionnalité spécifiée n’est pas installée ou activée. Cet attribut n'est pas pris en charge pour les fonctionnalités ayant une étendue d'application Web.

Éléments enfants

Éléments parents

Occurrences

Minimum : 0
Maximum : pas de limite

Remarques

Un élément Configuration est utilisé dans WebTemp*.xml les fichiers (voir WebTemp.xml) pour identifier une configuration de définition de site disponible dans une définition de site.

Il est utilisé dans Onet.xml fichiers pour définir une configuration de listes, de modules et de fonctionnalités qui sont utilisés pour créer un site à partir de la configuration de définition de site.

Dans un WebTemp*.xml fichier, cet élément est contenu dans un élément Template qui spécifie la définition de site. Dans Onet.xml, cet élément est contenu dans un élément Configurations qui spécifie les configurations dont les listes sont définies dans .Onet.xml

Il existe un élément Template dans un WebTemp*.xml fichier, et un Onet.xml fichier, pour chaque définition de site.

L’attribut ID associe l’élément Configuration pour une définition de site donnée dans un WebTemp*.xml fichier à l’élément Configuration correspondant pour cette même définition de site dans le Onet.xml.

Un modèle Web, par rapport à une configuration de définition de site, est défini avec un élément WebTemplate dans un fichier à l’intérieur d’un elements.xml fichier .wsp stocké dans la base de données SharePoint. Le fichier .wsp contient également un Onet.xml fichier avec un seul élément Configuration qui spécifie les détails du modèle Web.

Exemple

L’exemple suivant de WebTemp.xml spécifie les trois configurations pour la définition de site web STS .

<Template Name="STS" ID="1">
    <Configuration ID="0" Title="Team Site" Hidden="FALSE" ImageUrl="/_layouts/images/stts.png" Description="A site for teams to quickly organize, author, and share information. It provides a document library, and lists for managing announcements, calendar items, tasks, and discussions." DisplayCategory="Collaboration" >    </Configuration>
    <Configuration ID="1" Title="Blank Site" Hidden="FALSE" ImageUrl="/_layouts/images/stbs.png" Description="A blank site for you to customize based on your requirements." DisplayCategory="Collaboration" AllowGlobalFeatureAssociations="False" >    </Configuration>
    <Configuration ID="2" Title="Document Workspace" Hidden="FALSE" ImageUrl="/_layouts/images/stdw.png" Description="A site for colleagues to work together on a document. It provides a document library for storing the primary document and supporting files, a tasks list for assigning to-do items, and a links list for resources related to the document." DisplayCategory="Collaboration" >    </Configuration>
 </Template>