Delen via

<ContextualGroup> (RibbonDiffXml)

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

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

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

U kunt de locatie van de lintaanpassing opgeven 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 CRM.

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 CRM 2015 en Microsoft Dynamics CRM Online 2015 Update 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

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht