Archivos de definición de actualización

Última modificación: martes, 06 de abril de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Proceso de elección de definiciones de actualización de SharePoint Foundation
Aplicación de la actualización de definición de sitio
Referencias de ensamblado
Paquetes de idioma y actualización de definición de sitio

Una definición de actualización de sitio permite transformar sitios que se personalizaron en una versión anterior del producto SharePoint para que aprovechen las nuevas características disponibles en la versión más reciente. Un archivo de definición de actualización asigna (o "relaciona") los archivos y datos de lista de una compilación o versión a una compilación o versión posterior, además de especificar los elementos adicionales que deberían incluirse en sitios web actualizados.

Para registrar una definición de actualización para una definición de sitio, se le debe asignar un nombre de archivo único, que normalmente comienza con el nombre de la definición de sitio, y debe colocarse en la carpeta %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config\Upgrade del directorio de instalación. Las definiciones de actualización de sitio se registran por definición de sitio, pero pueden existir varias definiciones de actualización para la misma definición de sitio. Una definición de actualización de sitio también incluye plantillas de actualización de lista, que describen cómo se asignan columnas específicas de una lista a los tipos de contenido de la nueva versión de SharePoint Foundation 2010.

Una buena forma de entender las definiciones de actualización es mediante el estudio de los archivos de definición de actualización que se incluyen en una instalación de SharePoint Foundation y que se pueden encontrar en el directorio %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config\Upgrade. Este directorio incluye dos plantillas de actualización: una plantilla de actualización que actualiza de la versión anterior a la versión actual y una plantilla de actualización que actualiza entre compilaciones de SharePoint Foundation hasta su última versión de lanzamiento.

Proceso de elección de definiciones de actualización de SharePoint Foundation

Cuando se determina si se puede actualizar un sitio, SharePoint Foundation usa el siguiente algoritmo para seleccionar la definición de actualización que se usa cuando se encuentran disponibles varias definiciones:

  1. Si el sitio web no es de la versión actual del producto, SharePoint Foundation elige una definición de actualización que actualice todas las versiones del producto y que actualice el sitio a la última versión de la plantilla. Las definiciones de actualización ejecutan acciones de actualización entre versiones, o entre plantillas, pero no ambas, lo que significa que una definición no puede tener el conjunto de atributos de FromProductVersion y de BeginFromSchemaVersion/EndFromSchemaVersion. Si un sitio web no se encuentra en la versión actual del producto y ninguna definición de actualización puede actualizar el sitio web entre versiones, el sitio web no se puede actualizar.

  2. Si el primer caso no es aplicable, SharePoint Foundation selecciona una definición de actualización en la que el valor del atributo ToSchemaVersion se adapte mejor a la versión de la plantilla actual de la definición de sitio (sin superarlo), y en la cual la versión de la plantilla de la instancia del sitio existente se encuentre en el intervalo entre BeginFromSchemaVersion y EndFromSchemaVersion.

  3. Si más de una definición de actualización de sitio supera los criterios del segundo caso, SharePoint Foundation selecciona la definición de actualización con el valor BeginFromSchemaVersion más alto.

  4. Si existe un idioma genérico y una plantilla de configuración regional específica para una determinada definición de sitio, SharePoint Foundation selecciona la plantilla de configuración regional específica.

Aplicación de la actualización de definición de sitio

SharePoint Foundation usa una definición de actualización para aprovisionar sitios convertidos. El proceso de aplicar una actualización de definición de sitio debe realizar sustituciones de los elementos predeterminados, de la siguiente manera:

  • Si los nodos de navegación de una definición de sitio no se han modificado, se quitan los nodos de navegación existentes de una versión anterior y se reemplazan con nodos de exploración de la definición de sitio de la versión actual.

  • La sección <ListTemplates> de un archivo Onet.xml o Feature.xml determina las plantillas de lista que se pueden seleccionar en la página Crear. Cuando se aplica una definición de actualización de sitio, SharePoint Foundation usa el conjunto de plantillas de lista del archivo Onet.xml o Feature.xml de la versión actual, no los archivos de la versión anterior, para determinar el conjunto de plantillas de lista.

  • Asimismo, después de la actualización, SharePoint Foundation usa la sección <DocumentTemplates> del nuevo archivo Onet.xml para determinar el conjunto de plantillas de documento que se encuentran disponibles, en lugar del conjunto de archivos <DocumentTemplate> de la versión anterior.

    Nota

    Se recomienda que la mayoría de las plantillas de documento estén asociadas con los tipos de contenido y que no sean independientes.

De manera predeterminada, cuando se actualiza un sitio web existente, la actualización de definición de sitio no aprovisiona módulos ni instancias de lista desde la nueva definición de sitio. SharePoint Foundation depende de un conjunto de elementos <File> para especificar el modo en que los archivos de una versión anterior se asignan a la versión actual, y de un conjunto de etiquetas de instancia de módulo y lista en la definición de actualización que especifican archivos y datos de lista diferenciales de la versión anterior a la versión actual.

El uso de una definición de actualización permite que un sitio web se actualice de forma coherente para usar los tipos de contenido, formularios, listas y páginas de reemplazo. Si una definición de actualización no se encuentra disponible, SharePoint Foundation actualiza los sitios web sobre la base de la versión del producto anterior, dando la máxima prioridad posible a la migración de datos y a la interoperabilidad, a costa de exponer potencialmente las características de la versión actual a los usuarios (como los tipos de contenido). Este es el estado predeterminado para todos los sitios web después de que se hayan aprovisionado las tareas principales de actualización de versión a versión (por ejemplo, las transformaciones de bases de datos).

Referencias de ensamblado

El archivo web.config contiene redirecciones de directivas que asignan versiones anteriores de ensamblados del producto (tales como ensamblados Microsoft.SharePoint.dll de Windows SharePoint Services 3.0) a sus equivalentes de la versión actual del producto.

Paquetes de idioma y actualización de definición de sitio

En la actualización de versión a versión, si se instala un paquete de idioma determinado de una versión anterior pero no se instala el paquete de idioma correspondiente de la versión actual antes de la actualización, el registro de actualización informará de errores. A pesar de ello, se completa la operación de actualización.

Vea también

Conceptos

Métodos de arquitectura para actualizar una definición de sitio

Actualización de una definición de sitio personalizada

Otros recursos

Actualización de SharePoint Foundation