Partager via

Procédure : ajouter des éléments à un Composant fonctionnel existant

  • Article

Dernière modification : mardi 21 septembre 2010

S’applique à : SharePoint Foundation 2010

Un scénario de mise à niveau de Composant fonctionnel de base est susceptible de comprendre les étapes indiquées dans la procédure suivante, qui consiste à ajouter de nouveaux éléments à un Composant fonctionnel existant.

Ajout de nouveaux éléments à un Composant fonctionnel existant

  1. Ajoutez un attribut Version à Feature.xml, s’il n’en possède pas déjà un, et définissez-le sur une valeur réaliste, par exemple, Version="2.0.0.0" si la version existante est 1.0.0.0. Si vous n’augmentez pas le numéro de version, le code de mise à niveau du Composant fonctionnel ne sera pas appelé.

  2. Ajoutez une section <UpgradeActions> au fichier Feature.xml.

  3. Créez un nouveau fichier Elements.xml qui contient tous les nouveaux éléments que vous ajoutez au Composant fonctionnel, et attribuez-lui un nom unique, par exemple, Éléments2.xml.

  4. Référencez le fichier Elements2.xml dans la section <ElementManifests> principale et dans la section <ApplyElementManifests> au sein de la section <UpgradeActions>, comme le montre l’exemple suivant.

    <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>

Lorsque vous activez le Composant fonctionnel version « 2 », tous les éléments dans les deux fichiers Elements.xml et Elements2.xml sont mis en service. Lorsque vous exécutez une mise à niveau sur la batterie de serveurs, l’infrastructure de mise à niveau de Composant fonctionnel recherche toutes les instances de votre Composant fonctionnel qui possèdent un numéro de version inférieur à 2.0.0.0, et tous les éléments du fichier Elements2.xml sont mis en service de façon incrémentielle pour les instances de Composant fonctionnel version « 1 » existantes. Si aucune erreur ne se produit, le numéro de version du Composant fonctionnel est mis à jour dans la base de données. Si une erreur se produit pendant la mise à niveau d’une instance particulière du Composant fonctionnel version « 1 », cette instance de Composant fonctionnel est ignorée et le numéro de version n’est pas mis à jour dans la base de données. Les mises à niveau de batterie de serveurs ultérieures détecteront que l’instance de Composant fonctionnel n’a pas été mise à niveau et essaieront de nouveau de la mettre à niveau.