Partager via


<GroupeContextuel> (RibbonDiffXml)

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Contient un ensemble d'onglets à afficher dans un contexte spécifique.

Syntaxe

<ContextualGroup
 Color=[ "None" | "DarkBlue" | "LightBlue" | "Teal" | "Orange" | "Green" | "Magenta" | "Yellow" | "Purple"]
 Command="String"
 ContextualGroupId="String"
 Id="String"
 Sequence="Integer"
 Title="String" >
  <Tab />
</ContextualGroup>

Attributs et éléments

Le tableau suivant répertorie les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut

Description

Type

Utilisation

Couleur

Spécifie un modèle de couleurs pour le groupe.

Les valeurs valides sont :

  • Aucun(e)

  • DarkBlue

  • LightBlue

  • Teal

  • Orange

  • Vert

  • Magenta

  • Yellow

  • Purple

Énumération

Facultatif

Commande

Spécifie l'ID de la commande de ruban pour ce contrôle.

Chaîne

Facultatif

ContextualGroupId

Chaîne qui identifie le groupe contextuel, comme Mscrm.VisualizationTools.

Chaîne

Facultatif

ID

Spécifie un identificateur unique pour la définition d'un élément de ruban. Il est recommandé d'utiliser un point pour séparer les parties du nom, comme suit : [identificateur de solution].[entité].[ruban].[fonction].[nom d'élément]. Par exemple : MyISV.account.form.SendToOtherSystem.Button.

Utilisez le jeton {!EntityLogicalName} de l'attribut ID lorsque vous définissez un élément de ruban destiné à plusieurs entités. Cela insère le nom logique de l'entité dans la valeur d'ID pour garantir que la valeur d'ID soit globalement unique.

Par exemple, si vous utilisez MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button avec l'entité de compte, l'ID est MyISV.account.form.SendToOtherSystem.Button. Pour l'entité de contact, l'ID est MyISV.contact.form.SendToOtherSystem.Button.

Important

Si vous ne définissez pas l'ID de valeur unique globale, le ruban ne peut pas afficher.

Chaîne

Requis

Séquence

Spécifie l'emplacement de la modification du ruban en définissant la valeur Sequence plus haut ou plus bas que les éléments de ruban existants.

Entier

Facultatif

Titre

Cet élément n'est pas utilisé dans Microsoft Dynamics CRM.

Chaîne

Facultatif

Éléments enfants

Élément

Description

<Tab> (RibbonDiffXml)

Spécifie un onglet dans le ruban.

Éléments parents

Élément

Description

<CommandUIDefinition> (RibbonDiffXml)

Spécifie les éléments de ruban visibles à inclure dans un élément CustomAction.

Notes

Lorsque vous exportez un ContextualGroup que vous avez déjà défini, il est possible que le ContextualGroup et tous les éléments <Tab> (RibbonDiffXml) qu'il contient soient refactorisés en éléments <CustomAction> (RibbonDiffXml) distincts. Ceci est dû à la façon dont Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015 stocke les données de la base de données. Le comportement de la définition d'origine n'est pas modifié.

Par exemple, si vous définissez un <CustomAction> (RibbonDiffXml) pour ajouter un ContextualGroup comme indiqué dans le pseudo extrait de code suivant :

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1'>         <Tab Id='T1'>...</Tab>         <Tab Id='T2'>...</Tab>      </ContextualGroup>   </CommandUIDefinition></CustomAction>

Lorsque vous exportez par la suite des personnalisations, y compris cette définition, vous devez escompter que la définition apparaîtra comme illustrée dans le pseudo extrait de code suivant :

<CustomAction Location='Mscrm.ContextualGroups._children' >   <CommandUIDefinition>      <ContextualGroup Id='CG1' />   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T1'>...</Tab>   </CommandUIDefinition></CustomAction><CustomAction Location='CG1._children'>   <CommandUIDefinition>      <Tab Id='T2'>...</Tab>   </CommandUIDefinition></CustomAction>

Informations sur l’élément

Xpath

//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

Nom du schéma

ContextualGroupType

Fichier de validation

RibbonWSS.xsd

Peut être vide

Oui

Voir aussi

Personnaliser les commandes et le ruban
Ribbon XML reference

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