Configuration, élément (Site)

Article
09/24/2014

Dernière modification : jeudi 11 février 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences

Spécifie les listes et les modules utilisés lors de 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 les configurations dans les modèles Web. Pour des raisons de simplicité, l’expression « configuration de définition de site » est utilisée tout au long de cette rubrique bien que celle-ci concerne également les configurations de modèle Web. Sauf indication contraire, les descriptions d’attribut ci-après 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>

Attributs

Attribut	Description
AllowGlobalFeatureAssociations	Boolean facultatif. Spécifie si les associations de Composants fonctionnels globales sont autorisées pour les sites créés avec la configuration de définition de site.
CustomMasterUrl	Text facultatif. Spécifie l’URL d’une page .master de substitution pouvant être utilisée dans les pages des sites Web créés par le biais de la configuration de définition de site, sans personnalisation de ces pages. Remarque Le simple fait de modifier la valeur de l’attribut MasterPageFile sur les pages qui ont besoin d’une page maître de substitution personnalise ces pages et entraîne leur stockage 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 l’utilisation de la valeur de CustomMasterUrl, voir Pages maîtres des pages d’application.
Description	Text 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	Text facultatif. Spécifie la catégorie dans laquelle la configuration de définition de site apparaît dans l’interface utilisateur de SharePoint Foundation, par exemple, Collaboration, Meetings ou un nom personnalisé.
FilterCategories	Text facultatif. Cet attribut n’est pas utilisé par SharePoint Foundation. Disponible pour les solutions de gestion de portail ou de contenu améliorées basées sur SharePoint Foundation, telles que Microsoft SharePoint Server, il permet de classer les configurations de site sans suivre précisément les classements qui apparaissent dans l’interface utilisateur. (Voir également l’attribut DisplayCategory.)
Hidden	Boolean facultatif. Spécifie si la configuration de définition de site apparaît en tant qu’option dans l’interface utilisateur de SharePoint Foundation.
ID	Integer obligatoire. Spécifie pour la configuration de définition de site un ID 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 WebTemp.xml et par un fichier Onet.xml correspondant pour la définition. Voir Éléments parents* et Remarques ci-après.
ImageUrl	Text obligatoire. Contient l’URL de l’image d’aperçu affichée dans l’interface utilisateur de SharePoint Foundation.
MasterUrl	Text facultatif. Spécifie la page maître par défaut à utiliser pour les sites Web créés par le biais de la configuration de définition de site.
Name	Text facultatif. Contient le nom de la configuration de définition de site.
ProvisionAssembly	Text facultatif. Spécifie le nom de l’assembly qui contient la classe de mise en service éventuellement existante. (Voir ProvisionClass ci-après.) Par exemple : ProvisionAssembly="MyCompany.SharePoint.ProvisionHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=82f0cdf222f0530d"
ProvisionClass	Text facultatif. Spécifie le nom complet d’une classe qui fournit les fonctionnalités de mise en service à exécuter lorsque le runtime termine la création d’un site à partir de la configuration. La présence d’une classe de ce type n’est pas obligatoire, mais si vous en avez besoin d’une pour une configuration personnalisée, elle doit dériver de SPWebProvisioningProvider. Par exemple : ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"
ProvisionData	Text facultatif. Spécifie les données que doit utiliser la méthode Provision(SPWebProvisioningProperties) de l’attribut 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	Boolean facultatif. TRUE pour spécifier que le site créé à partir de la configuration existe uniquement en tant que site Web racine d’une collection de sites. Cet attribut n’est pas appliqué dans les modèles Web, qui sont stockés dans la solution (fichiers .wsp).
SubWebOnly	Boolean facultatif. TRUE pour spécifier que le site créé à partir de la configuration existe uniquement en tant que sous-site d’une collection de sites. Cet attribut n’est pas appliqué dans les modèles Web, qui sont stockés dans la solution (fichiers .wsp).
SupportsMultilingualUI	Boolean facultatif. TRUE (valeur par défaut) pour spécifier que les administrateurs peuvent activer des langues de substitution pour les sites créés à partir de la configuration. FALSE empêche les administrateurs d’activer cette fonctionnalité.
Title	Text facultatif. Contient le titre de la configuration de définition de site qui apparaît dans l’interface utilisateur de SharePoint Foundation.
Type	Text facultatif. Identifie la définition de site, telle que STS ou MPS.
VisibilityFeatureDependency	Text facultatif. Utilisé dans un fichier WebTemp*.xml pour masquer la configuration de définition de site basée sur l’état d’activation du Composant fonctionnel spécifié. Lorsqu’une configuration contient des Composants fonctionnels liés à un autre Composant fonctionnel, la définition de cet attribut empêche la configuration d’apparaître en tant qu’option dans l’interface utilisateur de SharePoint Foundation, dans le cas où le Composant fonctionnel spécifié n’est pas installé ou activé. Cet attribut n’est pas pris en charge pour les Composants fonctionnels ayant une étendue d’application Web.

Éléments enfants

ExecuteUrl,Listes, Modules, SiteFeatures, WebFeatures

Éléments parents

Configurations, Template

Occurrences

Minimum : 0

Maximum : Unbounded

Remarques

Un élément Configuration est utilisé dans les fichiers WebTemp*.xml (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 pour définir une configuration de listes, de modules et de fonctionnalités qui permettent de créer un site à partir de la configuration de définition de site. Dans un fichier WebTemp*.xml, 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 fichier WebTemp*.xml et un élément Onet.xml, pour chaque définition de site.

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

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

Exemple

Le code exemple suivant extrait 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

Concepts

Modèles Web

Définitions et configurations de sites