Procedimiento para agregar elementos a una característica existente
Última modificación: martes, 21 de septiembre de 2010
Hace referencia a: SharePoint Foundation 2010
Es muy probable que un escenario de actualización de características básico incluya los pasos enumerados en el siguiente procedimiento, en el que se agregan nuevos elementos a una característica existente.
Adición de nuevos elementos a una característica existente
Agregue un atributo Version a Feature.xml, si es que aún no tiene uno, y establézcalo en un valor posible (por ejemplo, Version="2.0.0.0", si la versión existente es 1.0.0.0). Si no aumenta el número de versión, no se llamará al código de actualización de característica.
Agregue una sección <UpgradeActions> al archivo Feature.xml.
Cree un nuevo archivo Elements.xml que contenga todos los elementos nuevos que va a agregar a la característica y asígnele un nombre único, por ejemplo, Elements2.xml.
Haga referencia el archivo Elements2.xml en la sección principal <ElementManifests> y en la sección <ApplyElementManifests> dentro de la sección <UpgradeActions>, como se muestra en el ejemplo siguiente.
<Feature Id="712224F9-6708-4965-A18C-B73CA86AEFCA" Title="MyCoolFeature" Description="My cool feature." Version="2.0.0.0" Scope="Site" Hidden="FALSE" DefaultResourceFile="core" xmlns="https://schemas.microsoft.com/sharepoint/"> <ElementManifests> <ElementManifest Location="Elements.xml" /> <ElementManifest Location="Elements2.xml" /> </ElementManifests> <UpgradeActions <VersionRange EndVersion="2.0.0.0"> <ApplyElementManifests> <ElementManifest Location="Elements2.xml" /> </ApplyElementManifests> </VersionRange> </UpgradeActions> </Feature>
Cuando activa la característica de versión "2", se aprovisionan todos los elementos de los archivos Elements.xml y Elements2.xml. Cuando ejecuta una actualización en el conjunto o granja de servidores, la infraestructura de actualización de característica realiza una consulta sobre todas las instancias de la característica que tienen un número de versión inferior a 2.0.0.0; además, todos los elementos del archivo Elements2.xml se aprovisionarán de manera incremental para las instancias existentes de la característica de versión "1". Si no se producen errores, se actualiza el número de versión de la característica en la base de datos. Si se produce un error al actualizar una instancia determinada de la característica de versión "1", dicha característica se omite y el número de versión no se actualiza en la base de datos. Las siguientes actualizaciones de la granja de servidores detectarán que la instancia de característica no se ha actualizado e intentarán actualizarla de nuevo.