Elemento Configuration (Site)

Artículo
04/08/2023

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Especifica las listas y módulos usados para crear un sitio web de SharePoint Foundation que se basa en la configuración de definición de sitio representada por el elemento Configuration . Estos elementos también representan configuraciones en plantillas web.

Por motivos de simplicidad, la frase "configuración de definición de sitio" se usa a lo largo de este tema, aunque el tema también se aplica a las configuraciones de plantillas web. Salvo que se especifique lo contrario, las descripciones de atributo siguientes se aplican a los elementos Configuration tanto en las definiciones de sitio como en las plantillas 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>

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
AllowGlobalFeatureAssociations	Boolean opcional. Especifica si se permiten asociaciones de características globales para los sitios creados con la configuración de definición de sitio.
CustomMasterUrl	Text opcional. Especifica la dirección URL de una página .master alternativa que se puede usar en páginas de sitios web que se crean a través de la configuración de definición de sitio sin personalizar esas páginas. NOTA: Simplemente cambiar el valor del atributo MasterPageFile en páginas que necesitan una página maestra alternativa personalizaría esas páginas y haría que se almacenaran en la base de datos de contenido en lugar del sistema de archivos de los servidores front-end web. Para obtener más información sobre cómo se usa el valor de CustomMasterUrl , vea Páginas maestras en páginas de aplicación.
Descripción	Text opcional. Contiene la descripción específica de la configuración regional de la definición de sitio que aparece en la interfaz de usuario de SharePoint Foundation.
DisplayCategory	Text opcional. Especifica la categoría en la que aparecerá la configuración de definición de sitio en la interfaz de usuario de SharePoint Foundation, por ejemplo, colaboración, reuniones o algún nombre personalizado.
FilterCategories	Text opcional. SharePoint Foundation no usa este atributo. Está disponible para que las soluciones mejoradas de administración de contenido o portal basadas en SharePoint Foundation, como Microsoft SharePoint Server, se usen como medio para clasificar las configuraciones de sitio de maneras que no se asignen con precisión a las categorizaciones que aparecen en la interfaz de usuario. (Vea también el atributo DisplayCategory ).
Hidden	Boolean opcional. Especifica si la configuración de definición de sitio aparece como una opción en la interfaz de usuario de SharePoint Foundation.
ID	Required Integer. Especifica un identificador para la configuración de definición de sitio que es única dentro de la definición de sitio. Una definición, como STS o MPS, se define mediante un elemento Template en un `WebTemp.xml` archivo y por un archivo correspondiente `Onet.xml` para la definición. Vea elementos primarios* y comentarios a continuación.
Imageurl	Text obligatorio. Contiene la dirección URL de la imagen de vista previa que se muestra en la interfaz de usuario de SharePoint Foundation.
MasterUrl	Text opcional. Especifica la página maestra predeterminada que se usará para los sitios web creados a través de la configuración de definición de sitio.
Nombre	Text opcional. Contiene el nombre de la configuración de definición de sitio.
ProvisionAssembly	Text opcional. Especifica el nombre del ensamblado que contiene la clase de aprovisionamiento, si hay uno. (Vea ProvisionClass a continuación). Por ejemplo: `ProvisionAssembly="MyCompany.SharePoint.ProvisionHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=82f0cdf222f0530d"`
ProvisionClass	Text opcional. Especifica el nombre completo de una clase que proporciona funcionalidad de aprovisionamiento que se ejecutará cuando el tiempo de ejecución termine de crear un sitio a partir de la configuración. No es necesario que haya una clase de este tipo, pero si necesita una para una configuración personalizada, debe derivarse de SPWebProvisioningProvider . Por ejemplo: `ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"`
ProvisionData	Text opcional. Especifica los datos que usará el método Provision(SPWebProvisioningProperties) de ProvisionClass (consulte anteriormente). Puede ser una ruta de acceso al archivo que contiene datos estructurados. Por ejemplo: `ProvisionData="SiteTemplates\\MySiteManifest.xml"`
RootWebOnly	Boolean opcional. TRUE para especificar que el sitio creado a partir de la configuración solo existe como sitio web raíz en una colección de sitios. Este atributo no se aplica en las plantillas web, que se almacenan en la solución (`.wsp` archivos).
SubWebOnly	Boolean opcional. TRUE para especificar que el sitio creado a partir de la configuración solo existe como subsitio dentro de una colección de sitios. Este atributo no se aplica en las plantillas web, que se almacenan en la solución (`.wsp` archivos).
SupportsMultilingualUI	Boolean opcional. TRUE (valor predeterminado) para especificar que los administradores pueden habilitar idiomas alternativos para los sitios creados a partir de la configuración. FALSE impide que los administradores habiliten esta funcionalidad.
Title	Text opcional. Contiene el título de la configuración de definición de sitio que se muestra en la interfaz de usuario de SharePoint Foundation.
Tipo	Text opcional. Identifica la definición de sitio, como STS o MPS.
VisibilityFeatureDependency	Text opcional. Se usa en un `WebTemp*.xml` archivo para ocultar la configuración de definición de sitio en función del estado de activación de la característica especificada. Cuando una configuración contiene características que dependen de otra característica, establecer este atributo impide que la configuración aparezca como una opción en la interfaz de usuario de SharePoint Foundation si la característica especificada no está instalada o activada. Este atributo no es compatible con las características en el ámbito de la aplicación web.

Elementos secundarios

Elementos principales

Repeticiones

Mínimo: 0
Máximo: sin límite

Comentarios

Un elemento Configuration se usa en WebTemp*.xml archivos (vea WebTemp.xml) para identificar una configuración de definición de sitio disponible dentro de una definición de sitio.

Se usa en Onet.xml archivos para definir una configuración de listas, módulos y características que se usan para crear un sitio a partir de la configuración de definición de sitio.

En un WebTemp*.xml archivo, este elemento se encuentra dentro de un elemento Template que especifica la definición del sitio. En Onet.xml, este elemento se encuentra dentro de un elemento Configurations que especifica las configuraciones cuyas listas se definen dentro de Onet.xml.

Hay un elemento Template en un WebTemp*.xml archivo y un Onet.xml archivo para cada definición de sitio.

El atributo ID asocia el elemento Configuration para una definición de sitio determinada en un WebTemp*.xml archivo con el elemento Configuration correspondiente para esa misma definición de Onet.xmlsitio en .

Una plantilla web, como distinta de una configuración de definición de sitio, se define con un elemento WebTemplate en un elements.xml archivo dentro de un archivo .wsp que se almacena en la base de datos de SharePoint. También en el archivo .wsp hay un Onet.xml archivo con un único elemento Configuration que especifica los detalles de la plantilla web.

Ejemplo

En el ejemplo siguiente de WebTemp.xml se especifican las tres configuraciones para la definición del sitio 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>

Compartir a través de