Desarrollo de nuevas definiciones del sitio personalizadas y creación de archivos de definición de actualización (Office SharePoint Server)

En este artículo:

• Antes de desarrollar nuevas definiciones de sitio personalizadas

• Desarrollo de nuevas definiciones de sitio personalizadas

• Acerca de los archivos de definición de actualización

• Creación de archivos de definición de actualización

• Registro de información del archivo de definición de actualización en una hoja de trabajo

Antes de desarrollar nuevas definiciones de sitio personalizadas

Antes de actualizar los sitios basados en definiciones de sitio personalizadas, debe realizar los pasos siguientes para garantizar que todas las listas y páginas que se derivan de las definiciones de sitio personalizadas continúen funcionando después de la actualización.

1. **Obtención o desarrollo de nuevas definiciones de sitio personalizadas y elementos personalizados   **Si desea mantener la funcionalidad de los sitios basados en una definición de sitio personalizada, necesita una nueva definición de sitio que incluya toda la funcionalidad que necesita, además de cualquier nueva capacidad que desee usar. Si obtuvo una definición de sitio personalizada o elementos personalizados de un proveedor de soluciones, compruebe si el proveedor tiene una nueva versión. Si no la tiene, es posible que tenga que desarrollar la suya propia.

2. Creación de un archivo de definición de actualización del sitio   También debe crear un archivo que asigne los elementos personalizados de la definición de sitio personalizada anterior a la nueva definición de sitio personalizada, de modo que cada elemento del sitio (por ejemplo, una página personalizada) pueda actualizarse al elemento nuevo que corresponda.

3. **Creación de archivos de definición de actualización de la plantilla de página   **En Microsoft Office SharePoint Portal Server 2003, también debe crear archivos de definición de actualización para traducir las plantillas de página, como la página principal, a los nuevos diseños de página. Los diseños de página de Microsoft Office SharePoint Server 2007 reemplazan las plantillas de página de SharePoint Portal Server 2003 y necesita especificar qué diseño de página se va a usar para cada tipo de página. Para obtener más información acerca de los diseños de página, vea Planeación de páginas web.

Durante el proceso previo a la actualización, debe copiar la nueva definición de sitio personalizada y los archivos de definición de actualización en el directorio de instalación para que estén disponibles al actualizar las colecciones de sitios.

Desarrollo de nuevas definiciones de sitio personalizadas

Use el proceso siguiente para crear definiciones de sitio personalizadas en un entorno de desarrollo. Para obtener más información, vea el Kit de desarrollo de software (SDK) de Windows SharePoint Services en MSDN.

1. Cree definiciones de sitio personalizadas empezando con una definición de sitio incluida en el nuevo entorno.

   • Las definiciones del sitio se almacenan en la carpeta siguiente:

     %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\SiteTemplates\NOMBRE

     Donde NOMBRE coincide con el nombre de la definición de sitio (por ejemplo, "ACCIÓN"). Cree una carpeta para la nueva definición de sitio y dé un nombre en mayúsculas a la nueva carpeta.

   • Los archivos XML que se usan para registrar las plantillas de sitio se almacenan en la siguiente ubicación:

     %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\TEMPLATE\LCID\XML\webtempnombre.xml

     Donde nombre coincide con el nombre de la definición de sitio, a diferencia de que está en minúsculas (por ejemplo, "acción"), y donde LCID es el identificador de configuración regional del idioma de la plantilla (por ejemplo, 1033 para inglés de EE.UU.).

2. Cree una nueva versión del archivo webtempnombre.xml para cada definición de sitio personalizada que tenga en SharePoint Portal Server 2003, donde nombre es el nombre de la definición de sitio. Puede crear archivos webtempnombre.xml a partir de los archivos de las definiciones de sitio estándar proporcionadas con el nuevo producto (entorno).

3. Una vez terminado correctamente el proceso de actualización, copie las plantillas de página usadas para SharePoint Portal Server 2003 en la carpeta de la galería de páginas maestras, en la raíz de una colección de sitios actualizada. Para obtener más información, vea Planeación de páginas web.

   Asimismo, cree diseños de página mediante las páginas de destino personalizadas correspondientes de SharePoint Portal Server 2003. Antes de actualizar, guarde una copia de las páginas de destino personalizadas. Una vez terminado correctamente el proceso de actualización, cargue estas páginas de destino en la carpeta de la galería de páginas maestras, en la raíz de una colección de sitios.

4. Pruebe las definiciones de sitio en el entorno de desarrollo; para ello, cree un nuevo sitio basado en la definición de sitio.

Cuando haya creado y probado sus nuevas definiciones de sitio, podrá crear los archivos de definición actualizados que asignan las definiciones de sitio anteriores a las definiciones de sitio nuevas.

Acerca de los archivos de definición de actualización

Los archivos de definición de actualización de un sitio describen cómo asignar una definición de sitio personalizada anterior a una definición de sitio nueva. El objetivo de un archivo de definición de actualización de un sitio es dar a los programadores una herramienta para transformar las versiones anteriores de sus sitios en unas nuevas versiones equivalentes que aprovechen todas las mejoras que el nuevo entorno puede ofrecer.

En Microsoft Office SharePoint Server 2007, hay archivos de definición de actualización para plantillas de página específicas (también conocidas como diseños de página). Una plantilla de página es un archivo ASPX (Active Server Page Extension) que define la estructura de una página. La ventaja de las plantillas de página es que puede crear nuevas páginas basadas en la plantilla de página, en lugar de crear las páginas en un editor de páginas web que sea compatible con Office SharePoint Server 2007. Las plantillas de página se almacenan en la raíz de la colección de sitios y se comparten en toda la colección de sitios.

En Office SharePoint Server 2007, las plantillas de página se usan para la mayoría de las páginas de los sitios de portal. Dicho de otro modo, todas las definiciones de sitio nuevas de Office SharePoint Server 2007 incluyen plantillas de página y muchas páginas de portal que se basaban en la definición de sitio de portal estándar del producto (entorno) anterior se basan en diseños de página diferentes en el nuevo producto. El proceso de actualización mueve las páginas de portal del producto anterior a páginas que usan diseños de página del nuevo producto. Las plantillas de página del producto anterior se mueven al conjunto predeterminado de diseños de página que se incluye con el nuevo producto. Si el conjunto predeterminado de diseños de página no se adapta a sus necesidades, puede crear un conjunto personalizado y proporcionar un archivo de definición de actualización para asignar las páginas de portal anteriores a los nuevos diseños de página.

Un archivo de definición de actualización de una definición del sitio tiene las siguientes secciones:

• **WebTemplate   **Especifica la información de actualización para la plantilla web en su totalidad. En esta sección, necesita una etiqueta WebTemplate para cada archivo de definición de actualización.

• **Lists   **Especifica la información de actualización para cada lista o biblioteca de la plantilla. En la sección Lists, necesita una etiqueta List para cada lista o biblioteca.

• **Files   **Especifica la información de actualización para las páginas individuales de la plantilla. En la sección Files, necesita una etiqueta File para cada página fantasma (no personalizada) de la plantilla.

• AppliedSiteFeature. Especifica información de actualización para todas las características de nivel de colección de sitios o subsitio incluidas en la plantilla. En las secciones AppliedSiteFeature y AppliedWebFeature, necesita una etiqueta Feature para cada característica del nivel en la plantilla.

• **Applied WebFeature   **Especifica la información de actualización para cualquier característica de nivel de subsitio o de nivel de colección de sitios incluida en la plantilla. En la sección Applied WebFeature, necesita una etiqueta Feature para cada característica en ese nivel de la plantilla.

El ejemplo siguiente, tomado de uno de los archivos instalados en Office SharePoint Server 2007, describe el formato de un archivo de definición de actualización de plantilla de página.

<SPSSiteUpgraderConfig>
    <PublishingPageLayoutMappings>
        <PublishingPageLayoutMapping WebTemplateId="20" PublishingPageLayout="/_catalogs/masterpage/defaultlayout.aspx"/>
        <PublishingPageLayoutMapping WebTemplateId="22" PublishingPageLayout="/_catalogs/masterpage/welcomelayout2.aspx"/>
    </PublishingPageLayoutMappings>
</SPSSiteUpgraderConfig>

En este ejemplo puede ver que se asigna una plantilla de sitio web a una plantilla de página; dicho de otro modo, la plantilla de sitio web con el identificador 20 se asigna al diseño de página defaultlayout.aspx. Esto significa que cada sitio que use el identificador de plantilla 20 tendrá una página principal (normalmente default.aspx) que usará un diseño de página definido por defaultlayout.aspx.

Asegúrese de incluir en el archivo de definición de actualización de la plantilla de página las entradas de las páginas de destino personalizadas de SharePoint Portal Server 2003 que se usarán para los diseños de página de Office SharePoint Server 2007. Estas entradas establecen un identificador de plantilla de sitio web como el nombre de la página de destino de SharePoint Portal Server 2003 que usará como diseño de página.

Creación de archivos de definición de actualización

Dé un nombre único al archivo de definición de actualización que empiece con el nombre de la definición del sitio. Por ejemplo, para una definición del sitio llamada "STS1", asigne el nombre "STS1_upgrade.xml" al archivo de definición de actualización.

Los archivos de definición de actualización deben instalarse en la carpeta siguiente:

%COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\Config\Upgrade

Para obtener información acerca de la creación de archivos de definición de actualización, incluido un archivo de definición de actualización de ejemplo, vea los temas Upgrade Definition Files (https://go.microsoft.com/fwlink/?linkid=109945&clcid=0xC0A) y Upgrade Definition Schema (https://go.microsoft.com/fwlink/?linkid=109946&clcid=0xC0A) en el SDK de Windows SharePoint Services 3.0 de MSDN.

Para obtener más información acerca de cómo implementar archivos de definición de actualización y las nuevas definiciones de sitio, vea Implementación de archivos de definición de actualización y definiciones de sitio nuevas (Office SharePoint Server). Para obtener más información acerca de la creación de archivos de definición de actualización, por ejemplo, qué incluir en los archivos y en el esquema, vea Actualización de personalizaciones de SharePoint Portal Server 2003 a SharePoint Server 2007 (https://go.microsoft.com/fwlink/?linkid=105294&clcid=0xC0A) en la biblioteca de MSDN.

Registro de información del archivo de definición de actualización en una hoja de trabajo

Registre los nombres de archivo y las rutas de acceso de cada archivo de definición de actualización que necesita crear en la hoja de trabajo de plantillas personalizadas y archivos de asignación (en inglés) (https://go.microsoft.com/fwlink/?linkid=73751&clcid=0xC0A) (en inglés).

Descarga de este libro

En este tema se incluye el siguiente libro descargable para facilitar la lectura y la impresión:

• Actualización a Office SharePoint Server 2007 (en inglés)

Vea la lista completa de libros disponibles en la página que muestra el contenido descargable para Office SharePoint Server 2007.