Définir les actions personnalisées pour modifier le ruban

  • Article

 

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Par défaut, une barre de commandes d’application ou le ruban est défini par les métadonnées Microsoft Dynamics 365. Ces données par défaut ne peuvent pas être modifiées, mais vous pouvez inclure des définitions d’actions spécifiques qui remplaceront le ruban par défaut.

Types d’actions personnalisées

Il existe deux types d’actions personnalisées pour les rubans :

Personnaliser les actions

Une action personnalisée est une instruction sur la manière dont vous souhaitez modifier la définition du ruban par défaut. Elle est évaluée et appliquée au ruban au moment de l’exécution. Pour définir le contexte pour une action personnalisée, vous devez inclure les informations à propos de l’emplacement des éléments que vous souhaitez modifier. Utilisez l’attribut Location pour spécifier où votre modification s’applique.

Lorsque vous souhaitez ajouter un nouveau élément de ruban, vous faites référence à l’élément conteneur, par exemple un onglet ou un groupe existant. Vous ajoutez ensuite le suffixe ._children pour indiquer que cette action personnalisée ajoutera une modification à un élément existant.

Lorsque vous modifiez la définition d’un élément existant, la valeur Location correspondra à l’ID de cet élément.

Vous devez également spécifier un identificateur unique pour l’action personnalisée. Utilisez l’attribut Id pour définir cette valeur. Nous vous recommandons vivement d’utiliser une convention d’affectation de noms qui garantira une valeur unique. Pour la cohérence et la lisibilité, nous recommandons d’utiliser un point pour séparer les composants cohérents. Le premier élément de votre convention d’affectation de noms doit être un élément lié à votre éditeur de solutions ou solution, par exemple, Contoso.contact.form.CustomButton.CustomAction.

Conseil

Le fait d’appliquer de manière cohérente vos conventions d’affectation de noms Id permet d’accroître considérablement votre productivité tout en modifiant RibbonDiffXml.

En fonction des informations d’emplacement que vous offrez, la valeur d’attribut Sequence détermine l’ordre dans lequel afficher les éléments. Si vous souhaitez qu’un contrôle personnalisé apparaisse entre deux contrôles existants, vous devez sélectionner une valeur de séquence qui se situe entre les valeurs de séquence des éléments existants.

Masquer les actions personnalisées

Une <HideCustomAction> (RibbonDiffXml) est une instruction que vous utilisez lorsque vous souhaitez supprimer un élément de ruban existant, de sorte qu’il ne soit pas affiché. Cela ne masque pas l’élément de ruban, mais supprime en fait l’élément de ruban au moment de l’exécution, afin qu’il disparaisse du ruban.

Notes

Parce que l’élément HideCustomAction supprime un nœud spécifié du ruban, la suppression des éléments de ruban de cette manière peut ne pas être la meilleure option pour chaque situation.

  • Si vous souhaitez supprimer un bouton associé à un privilège spécifique, vous devez ajuster les privilèges pour l’entité dans les rôles de sécurité de votre implémentation. Cela permettra au ruban par défaut de s’afficher et activera les règles pour masquer ou désactiver les éléments du ruban à partir des utilisateurs qui n’ont pas les privilèges nécessaires pour exécuter ces actions.

  • Si vous souhaitez remplacer un élément de ruban existant par un élément de ruban personnalisé, vous pouvez remplacer cet élément en spécifiant une valeur CustomAction.Location identique à l’élément existant.

L’élément HideActionId fournit un ID unique pour l’action. Pour la cohérence et la lisibilité, vous devez suivre la même convention d’affectation de noms décrite pour les éléments <CustomAction>. L’attribut Location doit correspondre à l’Id de l’élément de ruban à supprimer.

Voir aussi

Personnaliser les commandes et le ruban
Transmettre des données Microsoft Dynamics 365 à partir d’une page en tant que paramètre des actions du ruban
Définir la mise à l’échelle pour les éléments de ruban

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright