Elemento Configuration (Sitio)

Artículo
09/24/2014

Última modificación: jueves, 11 de febrero de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

Especifica las listas y módulos usados al crear un sitio web de SharePoint Foundation basado en la configuración de definición de sitio representada por el elemento Configuration. Estos elementos también representan las configuraciones de las plantillas web. Para simplificar, en todo este tema se usa la frase "configuración de definición de sitio", aunque el tema también se aplica a las configuraciones de plantilla web. Excepto cuando se especifique lo contrario, las siguientes descripciones de atributos se aplican a los elementos Configuration tanto en definiciones de sitio como en 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>

Atributos

Atributo	Descripción
AllowGlobalFeatureAssociations	Boolean opcional. Especifica si se permiten asociaciones de características globales en 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 puede usarse en páginas de sitios web creados mediante la configuración de definición de sitio, sin tener que personalizar dichas páginas. Nota Al cambiar simplemente el valor del atributo MasterPageFile en las páginas que necesitan una página maestra alternativa, se personalizarán dichas páginas y, como consecuencia, se almacenarán en la base de datos de contenido, en lugar de hacerlo en el sistema de archivos de los servidores front-end web. Para obtener más información acerca de cómo se usa el valor de CustomMasterUrl, vea Páginas maestras en páginas de aplicación.
Description	Text opcional. Contiene la descripción específica de configuración regional de la configuración de definición de sitio que aparece en la interfaz de usuario de SharePoint Foundation.
DisplayCategory	Text opcional. Especifica la categoría en la que la configuración de definición de sitio aparecerá en la interfaz de usuario de SharePoint Foundation, por ejemplo, Collaboration, Meetings o algún nombre personalizado.
FilterCategories	Text opcional. SharePoint Foundation no usa este atributo. Está disponible para soluciones de administración de contenido y de portal mejoradas basadas en SharePoint Foundation, como Microsoft SharePoint Server, para usarlo como un medio para categorizar las configuraciones de sitio de ciertas maneras que no se asignen precisamente 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	Integer obligatorio. Especifica un identificador para la configuración de definición de sitio que es único en la definición de sitio. Una definición, como STS o MPS, se define mediante un elemento Template de un archivo WebTemp.xml y mediante un archivo Onet.xml correspondiente para la definición. Vea Elementos primarios* y Comentarios más adelante.
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 va a usar para los sitios web creados mediante la configuración de definición de sitio.
Name	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 provisión, si existe. (Vea ProvisionClass más adelante). 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 la funcionalidad de aprovisionamiento que se ejecutará cuando el tiempo de ejecución finalice la creación de un sitio a partir de la configuración. No es obligatoria la existencia de una clase de este tipo, pero si necesita una para una configuración personalizada, debe derivar de SPWebProvisioningProvider. Por ejemplo: ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"
ProvisionData	Text opcional. Especifica los datos que usará el método Provision(SPWebProvisioningProperties) de ProvisionClass (vea el apartado anterior). Puede ser una ruta de acceso al archivo que contiene los datos estructurados. Por ejemplo: ProvisionData="SiteTemplates\\MySiteManifest.xml"
RootWebOnly	Boolean opcional. TRUE para especificar que el sitio creado a partir de la configuración existe sólo como el sitio web raíz de una colección de sitios. Este atributo no se exige en las plantillas web almacenadas en la solución (archivos .wsp).
SubWebOnly	Boolean opcional. TRUE para especificar que el sitio creado a partir de la configuración existe sólo como un subsitio dentro de una colección de sitios. Este atributo no se exige en las plantillas web almacenadas en la solución (archivos .wsp).
SupportsMultilingualUI	Boolean opcional. TRUE (valor predeterminado) para especificar que los administradores pueden habilitar los 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.
Type	Text opcional. Identifica la definición de sitio, como STS o MPS.
VisibilityFeatureDependency	Text opcional. Se usa en un archivo WebTemp*.xml para ocultar la configuración de definición de sitio según el estado de activación de la característica especificada. Cuando una configuración contiene características que dependen de otra característica, al establecer este atributo se 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

ExecuteUrl, Lists, Modules, SiteFeatures, WebFeatures

Elementos primarios

Configurations, Template

Repeticiones

Mínimo: 0

Máximo: sin límite

Comentarios

Un elemento Configuration se usa en los archivos WebTemp*.xml (vea WebTemp.xml) para identificar una configuración de definición de sitio disponible dentro de una definición de sitio. Se usa en los archivos Onet.xml para definir una configuración de listas, módulos y características usados para crear un sitio a partir de la configuración de definición de sitio. En un archivo WebTemp*.xml, este elemento se incluye en un elemento Template que especifica la definición de sitio. En Onet.xml, este elemento se incluye en un elemento Configurations que especifica las configuraciones cuyas listas se definen en Onet.xml.

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

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

Una plantilla web, a diferencia de una configuración de definición de sitio, se define con un elemento WebTemplate en un archivo elements.xml dentro de un archivo .wsp almacenado en la base de datos de SharePoint. Además, en el archivo .wsp hay un archivo Onet.xml con un solo elemento Configuration que especifica los detalles de la plantilla web

Ejemplo

El siguiente ejemplo de WebTemp.xml especifica las tres configuraciones de la definición de sitio web de 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>

Vea también

Conceptos

Plantillas web

Configuraciones y definiciones de sitios

Compartir a través de