Élément Configuration (Site)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013

Spécifie les listes et modules utilisés pour créer 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 les 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 cette 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 page .master de remplacement 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 ont besoin d’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 frontux.

Pour plus d’informations sur la façon dont la valeur de CustomMasterUrl est utilisée, voir 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 de portail ou de gestion de contenu améliorées, telles que SharePoint Foundation, telles que Microsoft SharePoint Server, à utiliser comme moyen de catégoriser les configurations de site d’une manière qui ne s’adonnent pas précisément aux catégorisations qui apparaissent dans l’interface utilisateur. (Voir aussi 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 qui est 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 fichier et par un fichier correspondant WebTemp*.xml pour la Onet.xml définition. Voir les éléments parents et les 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.
Nom
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 d’approvisionnement, s’il en existe une. (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 une fonctionnalité d’approvisionnement qui s’exécute lorsque l’exécution termine la création d’un site à partir de la configuration. Il n’est pas nécessaire qu’une telle classe existe, 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 la classe ProvisionClass (voir ci-dessus). Il peut s’agit 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é.
Title
Texte facultatif. Contient le titre de la configuration de définition de site affichée 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 fichier pour masquer la configuration de définition de site en fonction de l’état WebTemp*.xml 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 les fichiers (voirWebTemp.xml) pour identifier une configuration de définition de site disponible dans une définition de WebTemp*.xml site.

Il est utilisé dans Onet.xml 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 fichier, cet élément est contenu dans un élément Template qui WebTemp*.xml spécifie la définition de site. Dans , cet élément est contenu dans un élément Configurations qui spécifie les configurations dont les Onet.xml listes sont définies dans le Onet.xml .

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

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

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

Exemple

L’exemple 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>

Voir aussi