<GroupeContextuel> (RibbonDiffXml)
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
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 :
|
É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 |
Nécessaire |
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 |
votre fonction |
Cet élément n'est pas utilisé dans Microsoft Dynamics 365. |
Chaîne |
Facultatif |
Éléments enfants
Élément |
Description |
|---|---|
Spécifie un onglet dans le ruban. |
Éléments parents
Élément |
Description |
|---|---|
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 Microsoft Dynamics 365 (Online et local) 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 |
|
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
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright