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

 

Date de publication : janvier 2017

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

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> (RibbonDiffXml) 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> (RibbonDiffXml) pour associer les 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 attribut facultatif pour spécifier si la valeur par défaut de la règle est « true » ou « false » et un attribut 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> (RibbonDiffXml)
  Spécifie une règle détectant le type de présentation utilisée.

  Les valeurs Type correspondent à ce qui suit :

  Valeur	Présentation
  Modern	La barre de commandes est présentée à l’aide de Microsoft Dynamics 365 pour tablettes.
  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 d’entités qui n’ont pas été mises à jour ou dans un affichage de liste dans Microsoft Dynamics 365 pour Outlook.

• <CrmClientTypeRule> (RibbonDiffXml)
  Permet de définir des règles selon le type de client utilisé. Les options Type sont les suivantes :

  • Web

  • Outlook

• <CrmOfflineAccessStateRule> (RibbonDiffXml)
  Utilisez ce critère pour afficher un élément de ruban selon que Microsoft Dynamics 365 pour Microsoft Office Outlook avec accès hors connexion est actuellement hors connexion.

• <CrmOutlookClientTypeRule> (RibbonDiffXml)
  Utilisez cette règle si vous souhaitez afficher un bouton pour le type spécifique de Microsoft Dynamics 365 pour Outlook. Les options Type sont les suivantes :

  • CrmForOutlook

  • CrmForOutlookOfflineAccess

• <CrmOutlookClientVersionRule> (RibbonDiffXml)
  Détecte la version de Microsoft Dynamics 365 pour Microsoft Office Outlook.

  Valeurs correctes :

  • 2003

  • 2007

  • 2010

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

• <EntityPropertyRule> (RibbonDiffXml)
  Permet de définir des règles en fonction des valeurs booléennes des propriétés d’entité spécifiques. Les options PropertyName sont les suivantes :

  • DuplicateDetectionEnabled

  • GridFiltersEnabled

  • HasStateCode

  • IsConnectionsEnabled

  • MailMergeEnabled

  • WorksWithQueue

  • HasActivities

  • IsActivity

  • HasNotes

• <EntityRule> (RibbonDiffXml)
  Les règles d’entité permettent l’évaluation de l’entité actuelle. Cette opération est utile lorsque vous définissez les actions personnalisées qui s’appliquent au modèle d’entité plutôt que pour des entités spécifiques. Par exemple, vous souhaitez ajouter un élément du ruban à toutes les entités, hormis pour quelques entités spécifiques. Il est plus facile de définir l’action personnalisée pour le modèle d’entité qui s’applique à toutes les entités, puis d’utiliser une règle d’entité pour filtrer celles qui doivent être exclues.

  La règle d’entité comprend aussi un attribut contextuel en option pour spécifier si l’entité est affichée dans le formulaire ou dans une liste (HomePageGrid). L’attribut facultatif AppliesTo peut être défini sur PrimaryEntity ou SelectedEntity pour distinguer si l’entité est affichée dans une sous-grille.

• <FormEntityContextRule> (RibbonDiffXml)
  Spécifie une règle pouvant détecter l'affichage d'un ruban de formulaire dans le contexte d'une entité spécifique.

• <FormStateRule> (RibbonDiffXml)
  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> (RibbonDiffXml)
  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 d’entité affiché dans l’application.
  Preview	Le formulaire d’aperçu d’entité s’affiche sous la forme d’un élément de développement dans la grille.
  AppointmentBook	Utilisé avec les entités 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> (RibbonDiffXml)
  Spécifie une règle qui renvoie false lorsque l'application Web s'affiche dans un navigateur mobile sur une tablette.

• <MiscellaneousPrivilegeRule> (RibbonDiffXml)
  Utilisez ce type de règle pour vérifier les privilèges qui ne s’appliquent pas à une entité spécifique, comme ExportToExcel, MailMerge ou GoOffline.

• <OrganizationSettingRule> (RibbonDiffXml)
  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> (RibbonDiffXml)
  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> (RibbonDiffXml)
  Utilisez cette option pour afficher un élément de ruban si le ruban est affiché dans Microsoft Outlook de manière spécifique. Les options Type sont les suivantes :

  • Web

  • Outlook

• <OutlookVersionRule> (RibbonDiffXml)
  Utilisez cette option pour afficher un élément du ruban pour une version spécifique de Microsoft Outlook. Les options Version sont les suivantes :

  • 2003

  • 2007

  • 2010

• <PageRule> (RibbonDiffXml)
  Ce type de règle vérifie l’URL de la page en cours d’affichage. Elle renvoie « true » si l’adresse correspond.

• <RelationshipTypeRule> (RibbonDiffXml)
  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> (RibbonDiffXml)
  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 Dynamics 365, comme suit :

  • OnPremise

  • Online

  • Spla

• <ValueRule> (RibbonDiffXml)
  Utilisez cette règle pour vérifier la valeur d’un champ 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> (RibbonDiffXml) 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

Microsoft Dynamics 365

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