Rubans disponibles dans Microsoft Dynamics CRM 2015

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Cette rubrique décrit où les rubans sont définis et modifiés dans Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015.

Contenu de la rubrique

Définitions du ruban

Rubans de l’entité

Onglet Accueil de base

Microsoft Dynamics CRM pour les rubans Microsoft Office Outlook

Autres rubans

Rubans des pages personnalisées

Définitions du ruban

Microsoft Dynamics 365 contient les définitions <RibbonDiffXml> (RibbonDiffXml) 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> (RibbonDiffXml) ou <HideCustomAction> (RibbonDiffXml). Ces éléments sont appliqués sur les définitions par défaut du ruban fournies par Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015.

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, les définitions des définitions de ruban par défaut sont incluses dans les fichiers téléchargeables du SDK Microsoft Dynamics CRM. Le dossier SDK\Resources\ExportedRibbonXml inclut les fichiers de sortie que vous pouvez avoir pour une organisation avec un ruban qui n’a pas été personnalisé. Inutile d’exécuter l’application exemple pour exporter ces données. Si vous avez un ruban personnalisé, vous devez exécuter l’exemple d’application pour actualiser les fichiers de ce dossier avec toutes les personnalisations précédemment appliquées pour votre 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 entité spécifique. Ils correspondent au composant de solution Rubans de l’application. Pour chaque entité, vous trouverez un fichier nom d’entitéribbon.xml. Cela correspond au RibbonDiffXml inclus dans chaque entité. Pour modifier le ruban pour une entité spécifique, vous devez localiser le fichier XML du ruban pour cette entité.

Rubans de l’entité

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

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

• Mscrm.Form.{!EntityLogicalName}.MainTab

  L’onglet affiche le nom complet de l’entité 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 l’entité 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 l’entité au pluriel.

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

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

Rubans de grille

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

Rubans de sous-grille

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

Lorsqu’une liste d’enregistrements pour une entité est affichée dans une sous-grille sur le formulaire d’une autre entité 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 dépend si les enregistrements de la sous-grille sont liés à l’enregistrement actif.

  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 l’entité 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.

• Afficher la liste La commande avec l’icône ouvre la liste complète dans laquelle 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.

• Supprimer L’icône apparaît sur le côté droit de la ligne lorsque les utilisateurs pointent sur 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> (RibbonDiffXml), 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> (RibbonDiffXml).

Rubans de formulaire

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

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

Le ruban de formulaire d’entité est un ensemble d’onglets avec une valeur d’attribut d’identifiant commençant par Mscrm.Form.<entity logical name>. Par exemple, l’onglet avec l’étiquette Account sur un formulaire d’entité Account est Mscrm.Form.account.MainTab. Tous les onglets affichés sur le formulaire de l’entité Account 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 d’entité ou d’une règle d’affichage qui le supprime pour des pages spécifiques. Par exemple, cet onglet s'affiche lorsque vous affichez l’Aide de Microsoft Dynamics 365. L’ID de l’onglet d’accueil de base est Mscrm.BasicHomeTab.

Microsoft Dynamics CRM pour les rubans Microsoft Office Outlook

Microsoft Office Outlook 2007 n'affiche pas de ruban.Microsoft Office Outlook 2010 utilise le ruban. Vous pouvez utiliser les définitions de ruban Microsoft Dynamics 365 pour ajouter des contrôles.

Microsoft Office Outlook 2007

Les contrôles Microsoft Dynamics CRM pour Outlook pour prendre en charge les versions antérieures des menus et barres d’outils Microsoft Office Outlook sont définis comme onglets avec, respectivement, les valeurs d’ID Mscrm.LegacyOfficeToolbar et Mscrm.LegacyOfficeMenubar.

Microsoft Office Outlook 2010

Les contrôles Microsoft Dynamics CRM pour Outlook pour prendre en charge les menus et barres d’outils Microsoft Office Outlook 2010 sont définis comme onglets avec, respectivement, les valeurs d’ID Mscrm.Outlook14GlobalToolbar et Mscrm.Outlook14GlobalMenubar.

Autres rubans

Plusieurs autres onglets de ruban à objectif particulier et un groupe contextuel sont définis par Microsoft Dynamics 365. Chaque onglet est associé à une <TabDisplayRule> (RibbonDiffXml) spécifique qui contrôle lorsqu’ils s’affichent. Le tableau suivant répertorie ces onglets.

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 verront toujours l’Onglet Accueil de base (Mscrm.BasicHomeTab). Il est impossible d’utiliser un <PageRule> (RibbonDiffXml) pour activer ou afficher les composants personnalisés de ruban dans les pages personnalisées.

Voir aussi

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

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