Rubans disponibles

Notes

Cette rubrique concerne les commandes classiques.

Il existe une nouvelle façon de définir les commandes. Voir Vue d’ensemble du commandement moderne (Version préliminaire)

Cet article décrit où les rubans sont définis et modifiés dans les applications basées sur un modèle.

Définitions du ruban

Les applications basées sur un modèle <RibbonDiffXml> contiennent des définitions par défaut pour l’ensemble des rubans de l’application. Vous pouvez exporter et afficher le XML définissant le ruban de votre entreprise, mais vous ne pouvez pas mettre à jour le XML directement. Vous personnalisez le ruban en définissant comment vous souhaitez qu’il soit modifié. Les définitions de modifications que vous spécifiez sont appliquées au moment de l’exécution lorsque le ruban est affiché dans l’application. Toutes vos modifications seront dans les éléments <CustomAction> ou <HideCustomAction>. Ces éléments sont appliqués sur les définitions par défaut du ruban fournies par les applications pilotées par modèle.

Lorsque vous écrivez vos définitions de modification, vous devrez régulièrement faire référence aux définitions des rubans par défaut. Par exemple, si vous souhaitez masquer un élément spécifique de ruban, vous devrez connaître l’ID unique de cet élément. Si vous souhaitez placer un nouvel élément du ruban dans ou en regard d’un élément de ruban existant, vous devrez connaître les valeurs d’ID de ces éléments, ainsi que l’ordre de séquence qui contrôlera la position relative des éléments.

Du fait de ce besoin de référencer les définitions des éléments existants du ruban, il est très important de comprendre les définitions du ruban actives dans votre organisation. Il existe deux messages que vous pouvez utiliser pour exporter des fichiers XML représentant l’état actuel de vos rubans. Ces définitions contiennent toutes les personnalisations qui ont déjà été appliquées à votre système afin que vous puissiez personnaliser tous les rubans personnalisés précédemment appliqués. Pour plus d’informations, voir Exporter les définitions du ruban.

Pour vous aider à démarrer, vous pouvez télécharger les définitions de ruban par défaut pour les applications pilotées par modèle à partir de Exemple d’exportation de définitions de ruban. Le fichier The ExportedRibbonXml inclut les fichiers de sortie que vous auriez pour une organisation.

Dans les fichiers XML de ruban exportés, le fichier applicationRibbon.xml comprend tous les rubans qui ne sont pas définis pour une table spécifique. Ils correspondent au composant de solution Rubans de l’application. Pour chaque table, vous trouverez un fichier nom de table ribbon.xml. Cela correspond au RibbonDiffXml inclus dans chaque table. Pour modifier le ruban pour une table spécifique, vous devez localiser le fichier XML du ruban pour cette table.

Rubans de table

Toutes les tables utilisent une définition de ruban commune appelée Modèle de ruban de table. La définition du modèle de ruban de table se trouve dans le fichier applicationribbon.xml. Lorsque vous créez une table personnalisée, le ruban qui s’affiche est le ruban par défaut défini par le modèle de ruban de table. Chaque table système possède une définition <RibbonDiffXml> distincte qui repose sur la définition du modèle de ruban de table.

Dans le fichier applicationribbon.xml, vous pouvez voir les onglets suivants qui s’appliquent à toutes les tables :

• Mscrm.Form.{!EntityLogicalName}.MainTab

  L’onglet affiche le nom complet de la table dans l’étiquette.

• Mscrm.Form.{!EntityLogicalName}.Related

  L’onglet contient l’étiquette Ajouter.

• Mscrm.Form.{!EntityLogicalName}.Developer

  L’onglet contient l’étiquette Personnaliser.

• Mscrm.HomepageGrid.{!EntityLogicalName}.MainTab

  L’onglet affiche le nom complet de la table au pluriel dans l’étiquette.

• Mscrm.HomepageGrid.{!EntityLogicalName}.View

  L’onglet contient l’étiquette Afficher.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Related

  L’onglet contient l’étiquette Ajouter.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Developer

  L’onglet contient l’étiquette Personnaliser.

• Mscrm.SubGrid.{!EntityLogicalName}.ContextualTabs

  Lorsqu’une sous-grille sous dans un formulaire ou un graphique a le focus, l’onglet contextuel apparaît avec l’étiquette Outils de liste.

  • Mscrm.SubGrid.{!EntityLogicalName}.MainTab

    L’onglet affiche le nom complet de la table au pluriel.

  Lorsque vous affichez les définitions de ruban d’une table spécifique, vous voyez que le nom de la table remplace généralement le jeton {!EntityLogicalName}. Lorsque vous consultez le jeton {!EntityLogicalName} dans la définition du ruban pour une table spécifique, cela signifie qu’il n’existe aucune définition spécifique pour cette table et qu’elle utilise simplement la définition du modèle de ruban de table. Lorsque vous définissez les rubans pour une table spécifique, utilisez toujours le nom de table réel. Les modifications de ruban pour une table spécifique doivent être définies dans le nœud //ImportExportXml/Entities/Entity/RibbonDiffXml.

  Vous pouvez apporter des modifications qui s’appliquent à toutes les tables en définissant les modifications des rubans de l’application substituant le jeton {!EntityLogicalName} à la place du nom logique de la table de votre nœud RibbonDiffXml. Les modifications apportées aux rubans de l’application qui sont définies pour toutes les tables doivent être définies dans le nœud ImportExportXml/RibbonDiffXml. Elles ne peuvent pas être définies dans le nœud RibbonDiffXml d’une table spécifique.

Rubans de grille

Le ruban de grille de table est un ensemble d’onglets avec une valeur d’ID commençant par Mscrm.HomepageGrid.<entity logical name>. Par exemple, l’onglet avec le texte « Comptes » sur une grille de table de compte est Mscrm.HomepageGrid.account.MainTab. Tous les onglets affichés sur la grille de table de compte ont une valeur d’ID qui commence par Mscrm.HomepageGrid.account.

Rubans de sous-grille

Le ruban de sous-grille de table est un groupe contextuel avec une collection d’onglets ayant une valeur d’ID commençant par Mscrm.SubGrid.<entity logical name>. Par exemple, l’onglet avec le texte « Comptes » sur une sous-grille de table de compte est Mscrm.SubGrid.account.MainTab.

Lorsqu’une liste d’enregistrements pour une table est affichée dans une sous-grille sur le formulaire d’une autre table ou dans un graphique, il existe uniquement trois contrôles disponibles directement au-dessus ou dans la sous-grille. Les comportements pour ces contrôles peuvent être modifiés en modifiant les commandes auxquelles ils sont associés.

• Ajouter : le comportement par défaut de la commande avec l’icône varie selon que les enregistrements de la sous-grille sont liés ou non à l’enregistrement actuel.

  Si les enregistrements sont liés à l’enregistrement actif, le comportement par défaut consiste rechercher les enregistrements existants. Si un enregistrement existant est introuvable ou si l’utilisateur souhaite simplement créer un enregistrement, il peut cliquer sur Ajouter un nouveau.

  Si les enregistrements ne sont pas liés à l’enregistrement actif, le comportement par défaut consiste à ajouter un nouvel enregistrement. Si la table a un formulaire Création rapide, il sera affiché, sinon un nouveau formulaire complet apparaîtra.

  Les activités constituent l’exception de ce modèle. La commande Ajouter invite toujours à entrer le type d’activité en premier.

  Notes

  Le mode hors connexion dans Dynamics 365 ne prend pas en charge la relation plusieurs-à-plusieurs sur les tables personnalisées. Pour cette raison, le bouton Ajouter nouveau dans une sous-grille en mode hors connexion de Dynamics 365 ne s’affiche pas.

• Afficher la liste : la commande avec l’icône ouvre la liste complète où toutes les commandes disponibles peuvent être utilisées.

  Si la sous-grille est associée à l’enregistrement actif, le comportement par défaut de cette commande consiste à ouvrir la vue associée.

  Si la sous-grille n’est pas associée à l’enregistrement actif, le comportement par défaut de cette commande consiste à ouvrir la vue de la vue de la liste principale.

• Effacer : l’icône s’affiche sur le côté droit de la ligne lorsque les personnes survolent les enregistrements de la liste.

  Pour l’enregistrement avec une relation 1-à-N, le comportement par défaut est de supprimer l’enregistrement. La suppression peut être bloquée si elle n’est pas autorisée en raison de configurations de relation. Les activités ouvertes et les factures sont des exemples courants d’enregistrements qui ne peuvent pas être supprimés en raison de configurations de relation.

  Pour les relations affichant des relations N-à-N, le comportement par défaut consiste à supprimer la relation joignant les enregistrements plutôt que l’enregistrement lui-même.

  Vous pouvez modifier le comportement par défaut en modifiant les actions associées à la commande avec <CommandDefinition>, mais vous ne pouvez pas modifier le nom de la commande. Par exemple, vous pouvez modifier l’action de suppression afin qu’elle désactive l’enregistrement plutôt que de le supprimer.

  Il est impossible de modifier les icônes affichées pour ces commandes. Vous pouvez masquer les commandes avec <HideCustomAction>.

Rubans de formulaire

Notes

Cette fonctionnalité n’est pas prise en charge par l’interface unifiée.

Chaque table peut comporter plusieurs formulaires. Vous pouvez définir des modifications du ruban de formulaire pour tous les formulaires de cette table en ajoutant votre définition au niveau de la table (//ImportExportXml/Entities/Entity/RibbonDiffXml).

Chaque formulaire de table peut avoir une définition de ruban spécifique. Dans le fichier customizations.xml exporté, vous devez ajouter votre <RibbonDiffXml> modifié à cet emplacement ://ImportExportXml/Entities/Entity/FormXml/forms/systemform/form/RibbonDiffXml.

Le ruban de formulaire est un ensemble d’onglets avec une valeur d’ID commençant par Mscrm.Form.<entity logical name>. Par exemple, l’onglet avec l’étiquette Compte sur un formulaire est Mscrm.Form.account.MainTab. Tous les onglets affichés sur le formulaire Compte ont une valeur d’ID qui commence par Mscrm.Form.account.

Onglet Accueil de base

L’onglet Accueil de base est affiché sur le ruban de l’application principale chaque fois qu’un autre onglet n’est pas défini en raison du contexte de table ou d’une règle d’affichage qui le supprime pour des pages spécifiques. Par exemple, cet onglet est affiché lorsque vous affichez l’Aide des applications pilotées par modèle. L’ID de l’onglet d’accueil de base est Mscrm.BasicHomeTab.

Personnalisation de la barre de commandes globale

Vous pouvez personnaliser la barre de commandes globale (Mscrm.GlobalTab) en ajoutant les boutons à Mscrm.GlobalTab. Les boutons prêts à l’emploi de la barre de commande globale ne peuvent actuellement pas être modifiés, mais de nouveaux boutons peuvent être ajoutés.

Lorsque l’emplacement de CustomAction est réglé sur Location="Mscrm.GlobalTab.New.Controls._children, le bouton personnalisé est affiché dans la barre de commande globale en haut de la page.

Notes

Cette fonctionnalité est uniquement prise en charge pour Unified Interface.

Autres rubans

Plusieurs autres onglets de ruban à objectif particulier et un groupe contextuel sont définis par les applications pilotées par modèle. Chaque onglet est associé à une <TabDisplayRule> spécifique qui contrôle lorsqu’ils s’affichent. Le tableau suivant répertorie ces onglets.

Onglet	ID de racine	Description
Onglet de page de modification de ressource web.	Mscrm.WebResourceEditTab	S’affiche lors de la modification des ressources web dans une solution.
Onglet Éditeur de formulaires	Mscrm.FormEditorTab	Fournit les groupes d’action Enregistrer, Modifier, Sélectionner et Afficher les formulaires.
Onglet Insertion de l’Éditeur de formulaires	Mscrm.FormEditorInsertTab	Fournit les boutons pour insérer des sections, des onglets et des contrôles dans les formulaires.
Onglet Page d’accueil du tableau de bord	Mscrm.DashboardTab	S’affiche dans la zone Espace de travail.
Groupe contextuel d’outils de visualisation	Mscrm.VisualizationTools	S’affiche lorsque l’utilisateur clique sur le bouton Nouveau graphique sous l’onglet Graphiques affiché dans le ruban de la grille de table.
Onglet de la page d’accueil AptbookTab	Mscrm.AptbookTab	S’affiche lors de l’affichage du calendrier de service dans la zone Service.
Onglet Recherche avancée	Mscrm.AdvancedFind	S’affiche dans la fenêtre Recherche avancée.
Onglet Éditeur de tableau de bord	Mscrm.DashboardEditorTab	S’affiche lors de la modification d’un tableau de bord.
Onglet Documents	Mscrm.DocumentsTab	S’affiche si l’intégration SharePoint a été activée pour l’organisation.
Onglet Éditeur de graphique	Mscrm.VisualizationDesignerTab	S’affiche en modifiant un graphique de la fenêtre de solutions.
Groupe contextuel d’outils de recherche	Mscrm.ArticleSearch	S’affiche en affichant la table KBarticle.

Rubans des pages personnalisées

Vous pouvez afficher les pages personnalisées dans la navigation d’application à l’aide du plan du site. Ces pages afficheront toujours l’Onglet Accueil de base (Mscrm.BasicHomeTab).

Il est impossible d’utiliser un <PageRule> pour activer ou afficher les composants personnalisés de ruban dans les pages personnalisées.

Voir aussi

Personnaliser le ruban
Présentation de la barre de commandes et du ruban

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).