Procedimiento para usar configuraciones de definición de sitios

Artículo
02/01/2010

Si va a crear una definición de sitio, las configuraciones de las definiciones de sitios le permiten especificar las listas que deben incluirse en la creación de un sitio. Mediante las configuraciones de definición de sitios, puede volver a usar definiciones de lista existentes en el archivo Onet.xml para una definición sitio determinada, lo que le ahorrará tener que copiar o volver a codificar las definiciones de lista. Puede crear varias configuraciones en un archivo Onet.xml; cada configuración puede habilitar la creación de un sitio con un conjunto de listas diferente.

Para establecer la configuración de definición de un sitio dentro de una definición de sitio, use elementos Configuration de un archivo WebTemp.xml personalizado y de uno o varios archivos Onet.xml a los que se haga referencia en el archivo WebTemp. Para obtener información sobre cómo crear un archivo WebTemp*.xml personalizado, consulte Procedimiento para crear una definición y una configuración personalizadas de un sitio.

Ejemplo

El siguiente archivo WebTemp.xml usa dos elementos Configuration para definir configuraciones de definición de sitios diferentes y crear instancias de un sitio, uno para un sitio de colaboración de investigación y el otro para un sitio de área de documentos de investigación. En este ejemplo, se usan sólo dos configuraciones dentro de una sola definición de sitio; sin embargo, puede incluir varias definiciones de sitio, cada una de ellas con varias configuraciones, en un solo archivo WebTemp.xml. Cada definición del sitio hace referencia a una carpeta de definición de sitio diferente y a su archivo Onet.xml.

<?xml version="1.0" encoding="utf-8" ?>
<Templates xmlns:ows="Microsoft SharePoint">
  <Template Name="RESEARCH" ID="10001">
    <Configuration ID="0" Title="Research Collaboration site" 
      Hidden="FALSE" ImageUrl="_layouts/images/stsprev.jpg" 
      Description="This definition creates a site for the Research 
      team to create, organize, and share general information." 
      DisplayCategory="Collaboration">
    </Configuration>
    <Configuration ID="1" Title="Research Workspace" Hidden="FALSE" 
      ImageUrl="_layouts/images/dwsprev.jpg" Description="This 
      definition creates a site for Research team colleagues to 
      work together on specific documents." 
      DisplayCategory="Collaboration">
    </Configuration>
  </Template>
</Templates>

Como se ha indicado mediante el valor del atributo Name en el elemento Template, en este ejemplo se supone que existe un directorio de definición de sitio denominado "RESEARCH". Si un archivo WebTemp*.xml especifica más de una definición de sitio, las definiciones se distinguirán por sus valores ID únicos. (Para evitar que entren en conflicto con las definiciones de sitio proporcionadas por Microsoft actuales o futuras, use valores de ID superiores a 10000 para todas las definiciones de sitio personalizadas.)

Cada elemento Configuration también contiene un atributo ID. La combinación de este ID y el valor del atributo Name en el elemento Template proporciona una referencia al contenido de un elemento Configuration determinado en un archivo Onet.xml específico. En el ejemplo, el atributo Name contiene RESEARCH y los atributos ID contienen 0 y 1, que hacen referencia a la definición de sitio RESEARCH y a las configuraciones con identificadores 0 o 1 en Onet.xml.

Nota

En el modelo de objetos de Windows SharePoint Services 3.0, la configuración de definición de sitio y su definición de sitio primario se representan mediante un objeto Microsoft.SharePoint.SPWebTemplate. La propiedad Name de dicho objeto concatena el nombre de la definición y el identificador de configuración con un símbolo "#" entre ellos. Por lo tanto, las dos configuraciones de definición de sitio del ejemplo anterior se denominarían "RESEARCH#0" y "RESEARCH#1".

En el archivo Onet.xml, cada configuración de definición de sitio define un tipo específico de sitio que se puede crear a partir de la definición de sitio. Todas las configuraciones dentro de este archivo comparten un conjunto de definiciones de lista, plantillas de documento, áreas de exploración, tipos de lista base y módulos disponibles que se definen dentro del archivo. Puede agregar una referencia a una lista que esté definida en Onet.xml agregando un elemento List a la colección de listas especificada en un elemento Configuration. Por ejemplo, si define un tipo de lista denominada "My_Custom_List" en Onet.xml con un atributo Type de 10001, podrá agregar <List Title="My_Custom_List" Type="10001" Url="Lists/My_Custom_List" /> para realizar la parte de lista de la configuración. En el ejemplo siguiente, se muestra la disposición de las configuraciones en un archivo Onet.xml.

<Configurations>
  <Configuration ID="0" Name="RC">
    <Lists>
      <List FeatureId="00BFEA71-E717-4E80-AA17-D0C71B360101" 
        Type="101" Title="$Resources:core,shareddocuments_Title;" 
        Url="$Resources:core,shareddocuments_Folder;" 
        QuickLaunchUrl="$Resources:core,shareddocuments_Folder;/Forms/AllItems.aspx" /> 
      <List FeatureId="00BFEA71-6A49-43FA-B535-D15C05500108" 
        Type="108" Title="$Resources:core,discussions_Title;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,discussions_Folder;" 
        QuickLaunchUrl="$Resources:core,lists_Folder;/$Resources:core,discussions_Folder;/AllItems.aspx" 
        EmailAlias="$Resources:core,discussions_EmailAlias;" /> 
      <List FeatureId="00BFEA71-D1CE-42de-9C63-A44004CE0104" 
        Type="104" Title="$Resources:core,announceList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,announce_Folder;">
        <Data>
          <Rows>
            <Row>
              <Field Name="Title">$Resources:onetid11;</Field> 
              <Field Name="Body">$Resources:onetid12;</Field> 
              <Field Name="Expires"><ows:TodayISO/></Field> 
            </Row>
          </Rows>
        </Data>
      </List>
      <List FeatureId="00BFEA71-2062-426C-90BF-714C59600103" 
        Type="103" Title="$Resources:core,linksList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,links_Folder;" /> 
      <List FeatureId="00BFEA71-EC85-4903-972D-EBE475780106" 
        Type="106" Title="$Resources:core,calendarList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,calendar_Folder;" 
        QuickLaunchUrl="$Resources:core,lists_Folder;/$Resources:core,calendar_Folder;/Calendar.aspx" 
        EmailAlias="$Resources:core,calendar_EmailAlias;" /> 
      <List FeatureId="00BFEA71-A83E-497E-9BA0-7A5C597D0107" 
        Type="107" Title="$Resources:core,taskList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,tasks_Folder;" 
        QuickLaunchUrl="$Resources:core,lists_Folder;/$Resources:core,tasks_Folder;/AllItems.aspx" /> 
    </Lists>
    <Modules>
      <Module Name="Default" /> 
    </Modules>
    <SiteFeatures>
      <Feature ID="00BFEA71-1C5E-4A24-B310-BA51C3EB7A57" /> 
    </SiteFeatures>
    <WebFeatures>
      <Feature ID="00BFEA71-4EA5-48D4-A4AD-7EA5C011ABE5" /> 
    </WebFeatures>
  </Configuration>
  <Configuration ID="1" Name="RDW">
    <Lists>
      <List FeatureId="00BFEA71-E717-4E80-AA17-D0C71B360101" 
        Type="101" Title="$Resources:core,shareddocuments_Title;" 
        Url="$Resources:core,shareddocuments_Folder;" /> 
      <List FeatureId="00BFEA71-6A49-43FA-B535-D15C05500108" 
        Type="108" Title="$Resources:core,discussions_Title;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,discussions_Folder;" 
        QuickLaunchUrl="$Resources:core,lists_Folder;/$Resources:core,discussions_Folder;" /> 
      <List FeatureId="00BFEA71-D1CE-42de-9C63-A44004CE0104" 
        Type="104" Title="$Resources:core,announceList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,announce_Folder;">
        <Data>
          <Rows>
            <Row>
              <Field Name="Title">$Resources:onetid11;</Field> 
              <Field Name="Body">$Resources:onetid12;</Field> 
              <Field Name="Expires"><ows:TodayISO/></Field> 
            </Row>
          </Rows>
        </Data>
      </List>
      <List FeatureId="00BFEA71-2062-426C-90BF-714C59600103" 
        Type="103" Title="$Resources:core,linksList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,links_Folder;" /> 
      <List FeatureId="00BFEA71-EC85-4903-972D-EBE475780106" 
        Type="106" Title="$Resources:core,calendarList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,calendar_Folder;" 
        QuickLaunchUrl="$Resources:core,lists_Folder;/$Resources:core,calendar_Folder;/Calendar.aspx" /> 
      <List FeatureId="00BFEA71-A83E-497E-9BA0-7A5C597D0107" 
        Type="107" Title="$Resources:core,taskList;" 
        Url="$Resources:core,lists_Folder;/$Resources:core,tasks_Folder;" /> 
    </Lists>
    <Modules>
      <Module Name="DWS" /> 
    </Modules>
    <SiteFeatures>
      <Feature ID="00BFEA71-1C5E-4A24-B310-BA51C3EB7A57" /> 
    </SiteFeatures>
    <WebFeatures>
      <Feature ID="00BFEA71-4EA5-48D4-A4AD-7EA5C011ABE5" /> 
    </WebFeatures>
  </Configuration>
</Configurations>

El valor del atributo ID para cada elemento Configuration corresponde a los identificadores especificados en el archivo WebTemp.xml para las configuraciones. En este ejemplo, el sitio predeterminado es un sitio de "colaboración para investigación" (0) y no un sitio "área de documentos de investigación" (1). El atributo Type de cada elemento List hace referencia a un tipo de lista definido en Onet.xml. El atributo Url contiene la dirección URL de la carpeta donde se guarda la definición de lista para cada lista, que incluye los archivos ASPX, Schema.xml y los archivos relacionados. Cuando se especifica, el atributo QuickLaunchUrl contiene la ruta de acceso completa al archivo AllItems.aspx de una lista, que muestra la lista en el área Inicio rápido.

Advertencia

Debe crear una definición de sitio personalizada copiando una definición de sitio existente, en lugar de modificar los archivos originales que se instalan con Windows SharePoint Services. Al instalar las actualizaciones o Service Pack para Windows SharePoint Services, o cuando se actualice una instalación a la siguiente versión del producto, es posible que se sobrescriban los cambios realizados a los archivos instalados originalmente. Para obtener información acerca de cómo crear una definición de sitio personalizada, consulte Procedimiento para crear una definición y una configuración personalizadas de un sitio.

Compartir a través de

Procedimiento para usar configuraciones de definición de sitios

Ejemplo

Recursos adicionales