Définir les actions du ruban

 

Date de publication : janvier 2017

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

Définissez les actions à effectuer par une barre de commandes ou une commande de ruban dans un élément <CommandDefinition> (RibbonDiffXml) ainsi que les règles qui contrôlent si le contrôle est activé ou visible dans le ruban.

Une commande de ruban peut effectuer deux actions de types et peut inclure plusieurs actions :

• Fonctionnalités JavaScript : un élément <JavaScriptFunction> (RibbonDiffXml) référence une fonction définie dans une ressource Web de script.

• Ouvrir une URL : le ruban ouvre une URL avec la valeur issue d’un attribut Address dans l’élément <Url> (RibbonDiffXml). Des paramètres supplémentaires peuvent transmettre des informations sur la manière dont certains paramètres querystring sont transmis et le mode dans laquelle la fenêtre s’ouvre.

  Vous disposez de plusieurs options pour transmettre des paramètres à une URL avec le ruban.Pour plus d'informations :Transmettre les paramètres vers une URL à l’aide du ruban

Transmission de paramètres aux actions de ruban

Utilisez les éléments suivants pour définir les données à passer à l’action personnalisée :

• <BoolParameter> (RibbonDiffXml)
  Spécifie une valeur avec un type de données booléen pouvant être transmise sous la forme d'un paramètre.

• <CrmParameter> (RibbonDiffXml)
  Représente les données récupérées auprès de l'application Microsoft Dynamics 365 pouvant être transmises en tant que paramètre.Pour plus d'informations :Transmettre des données Microsoft Dynamics 365 à partir d’une page en tant que paramètre des actions du ruban

• <DecimalParameter> (RibbonDiffXml)
  Spécifie une valeur avec un type de données décimal pouvant être transmis sous la forme d'un paramètre.

• <IntParameter> (RibbonDiffXml)
  Spécifie une valeur avec un type de données entier pouvant être transmise sous la forme d'un paramètre.

• <StringParameter> (RibbonDiffXml)
  Spécifie une valeur avec un type de données de chaîne pouvant être transmise sous la forme d'un paramètre.

Lorsque les paramètres sont transmis à un élément <Url> (RibbonDiffXml), ils le sont sous la forme d’une chaîne de requête. Par conséquent, ils doivent inclure une valeur de nom pour représenter la clé dans la paire clé/valeur de la chaîne de requête.

Les paramètres transmis à un élément <JavaScriptFunction> (RibbonDiffXml) ne nécessitent pas de nom mais ils doivent être inclus dans l’ordre attendu par la fonction et avoir le type de données approprié.

Voir aussi

Personnaliser les commandes et le ruban
Définir les règles d’affichage du ruban
Transmettre des données Microsoft Dynamics 365 à partir d’une page en tant que paramètre des actions du ruban

Microsoft Dynamics 365

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