Personnaliser une fonctionnalité SharePoint

  • Article

Vous pouvez créer et personnaliser des fonctionnalités SharePoint à l’aide du Concepteur de fonctionnalités dans Visual Studio. Par exemple, vous pouvez définir l’étendue de la fonctionnalité et ajouter d’autres fonctionnalités en tant que dépendances. Par défaut, le Concepteur de fonctionnalités est ouvert lorsque vous ajoutez une nouvelle fonctionnalité dans l’Explorateur de solutions ou l’Explorateur de packages SharePoint.

Ouverture du concepteur de fonctionnalités

Vous pouvez ajouter ou supprimer des éléments de projet SharePoint à une fonctionnalité à l’aide du Concepteur de fonctionnalités.

Pour ouvrir le Concepteur de fonctionnalités

  1. Dans l’Explorateur de solutions, développez Fonctionnalités.

  2. Double-cliquez sur l’élément Feature1 ou ouvrez le menu contextuel de l’élément Feature1, puis choisissez Concepteur de vues.

Afficher le fichier manifeste empaqueté

Vous pouvez utiliser le Concepteur de fonctionnalités pour modifier et générer le fichier manifeste empaqueté pour la fonctionnalité (feature.xml). Ensuite, vous pouvez afficher le code XML de ce fichier dans Visual Studio.

Pour afficher le fichier manifeste empaqueté

  1. Dans le Concepteur de fonctionnalités, choisissez l’onglet Manifeste.

Pour afficher le fichier manifeste empaqueté à l’aide de l’Explorateur de solutions

  1. Dans l’Explorateur de solutions, choisissez l’icône Afficher tous les fichiers.

  2. Développez Features, FeatureName, FeatureName.feature, puis ouvrez le fichier <FeatureName>.Template.xml.

    Notes

    Lorsque vous ouvrez le fichier XML du manifeste du modèle de fonctionnalité, les fichiers sont automatiquement validés et les avertissements qui s’affichent dans la fenêtre Liste d’erreurs peuvent être ignorés.

Modifier le modèle de manifeste

Vous pouvez modifier le code XML du fichier manifeste de fonctionnalité dans l’Éditeur XML Visual Studio ou le volet Modèle de manifeste. Toutes les modifications apportées au code XML sont fusionnées dans le fichier manifeste empaqueté pour la fonctionnalité. Par exemple, vous pouvez modifier le modèle de manifeste pour personnaliser une propriété de fonctionnalité.

Pour modifier le modèle de manifeste à l’aide de l’éditeur XML

  1. Dans le Concepteur de fonctionnalités, choisissez l’onglet Manifeste, développez le nœud Modifier les options, puis choisissez le lien Ouvrir dans l’éditeur XML.

    Les modifications apportées au code XML sont fusionnées dans le fichier manifeste empaqueté.

Pour modifier le modèle de manifeste à l’aide du volet Modèle de manifeste

  1. Dans le Concepteur de fonctionnalités, choisissez l’onglet Manifeste, développez le nœud Modifier les options, puis modifiez le code XML qui apparaît dans le volet Modèle de manifeste.

    Les modifications apportées au code XML s’affichent dans le volet Aperçu du manifeste empaqueté.

Remplacer le fichier manifeste empaqueté

Vous pouvez désactiver le Concepteur de fonctionnalités et créer manuellement le fichier feature.xml. La première fois que vous effectuez cette procédure, les paramètres actuels dans le Concepteur de fonctionnalités sont enregistrés dans le fichier XML du modèle de fonctionnalité. Vous pouvez ensuite modifier ou remplacer le code XML.

Notes

Si vous ajoutez ou supprimez des éléments de projet SharePoint dans le fichier XML alors que le Concepteur de fonctionnalités est désactivé, ces éléments de projet ne sont pas empaquetés.

Pour remplacer le fichier manifeste empaqueté en désactivant le concepteur

  1. Dans le Concepteur de fonctionnalités, choisissez l’onglet Manifeste.

  2. Développez le nœud Modifier les options, choisissez le lien Remplacer le XML généré et le manifeste de modification générés dans l’éditeur XML, puis choisissez le bouton Oui.

    Le modèle est mis à jour avec le fichier manifeste empaqueté actuel.

Activer le Concepteur de fonctionnalités

Vous pouvez réactiver le Concepteur de fonctionnalités pour personnaliser le fichier feature.xml.

Pour réactiver le concepteur

  1. Dans le Concepteur de fonctionnalités, choisissez le lien Ignorer les modifications du manifeste et réactiver le concepteur, puis choisissez le bouton Oui.

  2. Le modèle est actualisé avec le texte d’origine, et toutes les modifications apportées au code XML sont perdues.

Contenu connexe