<ContextualGroup> (RibbonDiffXml)

Artikel
03/04/2017

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Bevat een verzameling tabbladen die u wilt weergeven in een specifieke context.

Syntaxis

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

Kenmerken en elementen

In de volgende tabel worden de kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving	Type	Gebruik
Kleur	Hiermee wordt een kleurenschema voor de groep opgegeven. Geldige waarden zijn onder andere: Geen DarkBlue LightBlue Teal Orange Groen Magenta Yellow Purple	Opsomming	Optioneel
Opdracht	Hiermee wordt de id van de lintopdracht voor dit besturingselement opgegeven.	Tekenreeks	Optioneel
ContextualGroupId	Een tekenreeks die de contextuele de groep identificeert, zoals Mscrm.VisualizationTools.	Tekenreeks	Optioneel
Id	Hiermee wordt een unieke id voor de definitie van een lintelement opgegeven. De naamconventie die wij sterk aanbevelen is het gebruik van een punt om delen van de naam te scheiden, als volgt: [solution identifier].[entity].[ribbon].[function].[element name]. Bijvoorbeeld: MyISV.account.form.SendToOtherSystem.Button. Gebruik het token {!EntityLogicalName} in het kenmerk-id bij het definiëren van een lintelement dat wordt gebruikt voor meerdere entiteiten. Hiermee wordt de logische naam van de entiteit ingevoegd in de id-waarde om ervoor te zorgen dat de id-waarde algemeen uniek is. Als u bijvoorbeeld MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button gebruikt met de accountentiteit, wordt de id MyISV.account.form.SendToOtherSystem.Button. Voor de contactpersoonentiteit wordt de id MyISV.contact.form.SendToOtherSystem.Button. Belangrijk Als u geen algemeen unieke id-waarde instelt, wordt het lint mogelijk niet weergegeven.	Tekenreeks	Vereist
Volgorde	Hiermee geeft u de locatie van de lintaanpassing op door de waarde van Volgorde hoger of lager in te stellen dan die van de bestaande lintelementen.	Geheel getal	Optioneel
titel	Dit element wordt niet gebruikt in Microsoft Dynamics 365.	Tekenreeks	Optioneel

Onderliggende elementen

Element	Beschrijving
<Tab> (RibbonDiffXml)	Hiermee wordt een tabblad in het lint opgegeven.

Bovenliggende elementen

Element	Beschrijving
<CommandUIDefinition> (RibbonDiffXml)	Hiermee worden de zichtbare lintelementen opgegeven die in een CustomAction-element worden opgenomen.

Opmerkingen

Als u een ContextualGroup exporteert die u eerder hebt gedefinieerd, ziet u mogelijk dat de ContextualGroup en eventuele hierin opgenomen <Tab> (RibbonDiffXml)-elementen worden geherstructureerd in aparte <CustomAction> (RibbonDiffXml)-elementen. Dit komt door de manier waarop Microsoft Dynamics 365 (online en on-premises) de gegevens in de database opslaat. Het gedrag van de oorspronkelijke definitie verandert niet.

Bijvoorbeeld als u een <CustomAction> (RibbonDiffXml) definieert om een ContextualGroup toe te voegen zoals aangegeven in het volgende pseudocodefragment:

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

Als u later aanpassingen met inbegrip van de definitie exporteert, kunt u verwachten dat de definitie wordt weergegeven zoals in het volgende pseudocodefragment:

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

Gegevens van element

XPath	`//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup`
Schemanaam	ContextualGroupType
Validatiebestand	RibbonWSS.xsd
Kan leeg zijn	Ja

Zie ook

Opdrachten en het lint aanpassen
Ribbon XML reference

Microsoft Dynamics 365

Delen via