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

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)

Lorsque vous configurez les éléments du ruban, vous pouvez définir des règles spécifiques pour contrôler à quel moment les éléments du ruban s’affichent.

• Utilisez l’élément /RuleDefinitions/DisplayRules/<DisplayRule> pour définir les règles contrôlant le moment où l’élément de ruban doit s’afficher.
• Utilisez l’élément /CommandDefinitions/CommandDefinition/DisplayRules/<DisplayRule> pour associer des règles d’affichage spécifiques à une définition de commande.

Contrôler à quel moment les éléments du ruban sont affichés

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 plusieurs règles d’affichage sont définies 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 soit affiché.

Toutes les règles d’affichage offrent 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 InvertResult facultatif pour permettre le retour d’un résultat négatif si l’élément en cours de test renvoie « 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 :

Value	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 les formulaires de tables qui n’ont pas été mises à jour ou dans un affichage de liste dans Dynamics 365 for Outlook.

<CrmClientTypeRule>

Permet de définir des règles selon le type de client utilisé. Les options Type 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>

Permet de définir des règles en fonction des valeurs booléennes des propriétés de table spécifiques. Les options PropertyName sont les suivantes :

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

<EntityRule>

Cette règle permet l’évaluation de la table actuelle. Cette opération est utile lorsque vous définissez les actions personnalisées qui s’appliquent au modèle de table plutôt que pour des tables spécifiques. Par exemple, vous souhaitez ajouter un élément du ruban à toutes les tables, hormis pour 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 une EntityRule pour filtrer celles qui doivent être exclues.

La EntityRule comprend aussi un paramètre Context en option pour spécifier si la table est affichée dans le formulaire ou dans une liste (HomePageGrid). Le paramètre facultatif AppliesTo peut être défini sur PrimaryEntity ou SelectedEntity pour distinguer si la table est affichée dans une sous-grille.

<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 :

• Créer
• Existant
• ReadOnly
• Désactivé(e)
• BulkEdit

<FormTypeRule>

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

Les valeurs Type correspondent à ce qui suit :

valeur	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 ce type de règle pour vérifier les privilèges qui ne s’appliquent pas à une table spécifique, comme 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ètres sont les suivantes :

• IsSharepointEnabled
• IsSOPIntegrationEnabled
• IsFiscalCalendarDefined

<OrRule>

Cette règle vous permet de remplacer l’opérateur de comparaison AND par défaut pour plusieurs types de règle d’affichage. Utilisez l’élément OrRule pour définir plusieurs combinaisons valides possibles à vérifier.

<OutlookRenderTypeRule>

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

• web
• Outlook

<OutlookVersionRule>

Utilisez cette option pour afficher un élément du ruban pour une version spécifique d’Outlook. Les options Version sont les suivantes :

• 2003
• 2007
• 2010

<PageRule>

Ce type de règle vérifie l’URL de la page en cours d’affichage. 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.

Il s’agit d’une règle très spécifique pour 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 vérifie si l’attribut de référencement utilisé dans la relation est obligatoire. Cette règle est utilisée 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 de l’enregistrement lié (l’attribut de référence) peut être obligatoire ou non. Par exemple, le champ Concernant d’une activité n’est pas obligatoire alors que le champ Client potentiel d’une opportunité l’est. Le bouton Ajouter une activité existante définit la valeur du champ Concernant en fonction du contexte de l’enregistrement actuel et ne peut fonctionner que si le champ Concernant n’a pas déjà de valeur. Tous les enregistrements d’opportunités ont une valeur dans leur champ Client potentiel, il n’est donc pas utile d’afficher un bouton Ajouter une opportunité existante. Cette règle détecte que l’attribut de référencement est obligatoire et renvoie donc un résultat positif.

<RelationshipTypeRule>

Ce type de règle est appliqué 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 ce type de règle pour afficher un élément du ruban pour une version de référence (SKU) spécifique 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.

Notes

Pour les commandes définies pour la sous-grille des formulaires avec l’expérience utilisateur mise à jour, les règles de valeur ne peuvent pas être utilisées 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

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é).