Définir les règles d’affichage du ruban

Note

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)

Utilisez les règles d’affichage du ruban pour contrôler le moment où les éléments du ruban apparaissent. Les commandes s’affichent uniquement dans le client, le formulaire, la table ou le contexte utilisateur appropriés.

• Utilisez l’élément /RuleDefinitions/DisplayRules/DisplayRule pour définir des règles qui contrôlent quand afficher l’élément du ruban.
• Utilisez l’élément /CommandDefinitions/CommandDefinition/DisplayRules/DisplayRule pour associer des règles d’affichage spécifiques à une définition de commande.

Contrôler quand afficher les éléments du ruban

En définissant des règles d’affichage avec les définitions de règle, vous pouvez utiliser la même règle d’affichage pour plusieurs définitions de commande. Lorsque vous définissez plusieurs règles d’affichage pour une définition de commande, toutes les règles d’affichage doivent être évaluées comme true pour que l’élément du ruban s’affiche.

Toutes les règles d’affichage fournissent un paramètre facultatif pour spécifier si la valeur par défaut de la règle est true ou false, et un paramètre facultatif InvertResult pour activer le retour d’un résultat négatif lorsque l’élément testé retourne true.

L’élément /RuleDefinitions/DisplayRules/DisplayRule prend en charge les types de relation suivants :

<CommandClientTypeRule>

Spécifie une règle détectant le type de présentation utilisée.

Les valeurs Type correspondent à ce qui suit :

active	Présentation
Modern	La barre de commandes est présentée avec Dynamics 365 for tablets.
Refresh	La barre de commandes est présentée à l’aide de l’interface utilisateur mis à jour.
Legacy	Le ruban est présenté dans des formulaires pour les tables qui ne sont pas mises à jour ou dans un affichage de liste dans Dynamics 365 pour Outlook.

<CrmClientTypeRule>

Définissez des règles en fonction du type de client utilisé. Type les options sont les suivantes :

• Web
• Outlook

<CrmOfflineAccessStateRule>

Utilisez ce critère pour afficher un élément de ruban selon que Dynamics 365 for Microsoft Office Outlook avec accès hors connexion est actuellement hors connexion.

<CrmOutlookClientTypeRule>

Utilisez cette règle si vous souhaitez afficher un bouton pour le type spécifique de Dynamics 365 for Outlook. Les options Type sont les suivantes :

• CrmForOutlook
• CrmForOutlookOfflineAccess

<CrmOutlookClientVersionRule>

Détecte la version de Microsoft Dynamics 365 for Microsoft Office Outlook.

Valeurs correctes :

• 2003
• 2007
• 2010

<EntityPrivilegeRule>

Utilisez ce type de règle pour afficher les éléments de ruban lorsqu’un utilisateur a des privilèges spécifiques pour une table. Vous devez spécifier le degré de privilège et le privilège spécifique que vous souhaitez vérifier.

<EntityPropertyRule>

Utilisez cette règle pour définir des règles basées sur les valeurs booléennes des propriétés de table spécifiques. Les PropertyName options sont les suivantes :

• DuplicateDetectionEnabled
• GridFiltersEnabled
• HasStateCode
• IsConnectionsEnabled
• MailMergeEnabled
• WorksWithQueue
• HasActivities
• IsActivity
• HasNotes

<EntityRule>

Utilisez cette règle pour évaluer la table active. Cette règle est utile lorsque vous définissez des actions personnalisées qui s’appliquent au modèle de table au lieu de tables spécifiques. Par exemple, vous pouvez ajouter un élément de ruban à toutes les tables, à l’exception de certaines tables spécifiques. Il est plus facile de définir l’action personnalisée pour le modèle de table qui s’applique à toutes les tables, puis d’utiliser un EntityRule pour filtrer ceux que vous souhaitez exclure.

Inclut EntityRule un paramètre de contexte facultatif pour spécifier si la table est affichée dans le formulaire ou dans une liste (HomePageGrid). Définissez le paramètre PrimaryEntity facultatif AppliesTo sur ou SelectedEntity pour distinguer si la table est affichée dans un sous-réseau.

<FormEntityContextRule>

Spécifie une règle pouvant détecter l'affichage d'un ruban de formulaire dans le contexte d'une entité spécifique.

<FormStateRule

Utilisez la règle d’état de formulaire pour déterminer le type actuel de formulaire qui affiche un enregistrement. Les options State sont les suivantes :

• Create
• Existing
• ReadOnly
• Disabled
• BulkEdit

<FormTypeRule>

Spécifie une règle détectant le type de formulaire Microsoft Dynamics 365.

Les valeurs Type correspondent à ce qui suit :

active	Présentation
Main	Formulaire affiché dans l’application.
Preview	Le formulaire d’aperçu de table s’affiche sous la forme d’un élément de développement dans la grille.
AppointmentBook	Utilisé avec les tables Appointment, Equipment, Serviceappointment et Systemuser pour la planification de l’interface utilisateur Planification des services.
Dashboard	Le formulaire définit un tableau de bord.
Quick	Formulaire d’aperçu rapide.
QuickCreate	Formulaire de création rapide.

<HideForTabletExperienceRule>

Spécifie une règle qui renvoie false lorsque l'application Web s'affiche dans un navigateur mobile sur une tablette.

<MiscellaneousPrivilegeRule>

Utilisez cette règle pour vérifier les privilèges qui ne s’appliquent pas à une table spécifique, telle que ExportToExcel, MailMerge ou GoOffline.

<OrganizationSettingRule>

Utilisez cette règle pour afficher un élément de ruban si des paramètres d’organisation spécifiques sont activés. Les options de paramètre sont les suivantes :

• IsSharepointEnabled
• IsSOPIntegrationEnabled
• IsFiscalCalendarDefined

<OrRule>

Utilisez cette règle pour remplacer la comparaison AND par défaut pour plusieurs types de règles d’affichage. Utilisez l’élément OrRule pour définir plusieurs combinaisons valides possibles à vérifier.

<OutlookRenderTypeRule>

Utilisez cette règle pour afficher un élément de ruban si le ruban est affiché de Outlook d’une manière spécifique. Les Type options sont les suivantes :

• Web
• Outlook

<OutlookVersionRule>

Utilisez cette règle pour afficher un élément de ruban pour une version spécifique de Outlook. Les Version options sont les suivantes :

• 2003
• 2007
• 2010

<PageRule>

Cette règle vérifie l’URL de la page affichée. Elle renvoie « true » si l’adresse correspond.

<ReferencingAttributeRequiredRule>

Une règle qui détecte si l’attribut de référencement d’une entité est requis.

Cette règle concerne un cas très spécifique. Utilisez cette règle lorsqu’il existe une sous-grille liée à une relation ou une grille associée sur la page. Cette règle teste si l’attribut de référencement utilisé dans la relation est requis. Utilisez cette règle pour masquer le bouton Ajouter un type d’enregistrement existant lorsqu’il n’est pas approprié de l’afficher.

Dans une relation d’entité, le champ de recherche dans l’enregistrement associé (l’attribut de référencement) peut être requis ou non. Par exemple, le champ Concernant une activité n’est pas obligatoire, mais le champ Client potentiel d’une opportunité est requis. Le bouton Ajouter une activité existante définit la valeur de champ En ce qui concerne le contexte d’enregistrement actif et ne peut fonctionner que si le champ Concernant n’a pas encore de valeur. Tous les enregistrements d’opportunités ont une valeur dans leur champ Client potentiel . Il n’est donc jamais judicieux d’afficher un bouton Ajouter une opportunité existante . Cette règle détecte que l’attribut de référencement est requis et retourne true.

<RelationshipTypeRule>

Appliquez cette règle aux enregistrements sélectionnés dans une grille. Elle vous permet de déterminer le type de relation, comme suit :

• OneToMany
• ManyToMany
• NoRelationship

<SkuRule>

Utilisez cette règle pour afficher un élément de ruban pour une version spécifique de la référence SKU de Microsoft Dataverse, comme suit :

• OnPremise
• Online
• Spla

<ValueRule>

Utilisez cette règle pour vérifier la valeur d’une colonne spécifique dans l’enregistrement affiché dans le formulaire.

Note

Pour les commandes définies pour le sous-réseau pour les formulaires à l’aide de l’expérience utilisateur mise à jour, vous ne pouvez pas utiliser de règles de valeur dans les règles d’affichage. Utilisez cet élément dans <EnableRule> pour masquer un élément.

Voir aussi

Personnaliser les commandes et le ruban
Définir les règles d'activation du ruban
Définir les actions du ruban