<ContextualGroup> (RibbonDiffXml)

Artikel
03/04/2017

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Indeholder en samling faner, der skal vises i en bestemt sammenhæng.

Syntaks

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

Attributter og elementer

I følgende tabel vises attributterne, underordnede elementer og overordnede elementer.

Attributter

Attribut	Beskrivelse	Skriv	Brug
Farve	Angiver et farveskema til gruppen. Gyldige værdier omfatter: Intet Mørkeblå Lyseblå Blågrøn Orange Grøn Magenta Gul Lilla	Optælling	Valgfri
Kommando	Angiver id'et for kommandoen på båndet for dette kontrolelement.	Streng	Valgfri
ContextualGroupId	En streng, der identificerer den kontekstafhængige gruppe, f.eks. Mscrm.VisualizationTools.	Streng	Valgfri
Id	Angiver et entydigt id for definitionen på et element på båndet. Det anbefales på det kraftigste at bruge navnekonventionen, der adskiller delene i navnet med et punktum som f.eks.: [løsnings-id].[objekt].[bånd].[funktion].[elementnavn]. Eksempelvis: MyISV.account.form.SendToOtherSystem.Button. Brug {!EntityLogicalName}-tokenet i id-attributten, når du definerer et element på båndet, der skal bruges til flere objekter. Dette indsætter objektets logiske navn i id-værdien for at sikre, at id-værdien er globalt entydig. For eksempel, hvis du bruger MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button med firmaobjektet, er id'et MyISV.account.form.SendToOtherSystem.Button. For objektet kontaktperson er id'et MyISV.contact.form.SendToOtherSystem.Button. Vigtigt Hvis du ikke angiver en globalt entydig id-værdi, vises båndet muligvis ikke.	Streng	Krævet
Sekvens	Angiv placeringen af det ændrede bånd ved at angive sekvensværdien til at være højere eller lavere end eksisterende elementer på båndet.	Heltal	Valgfri
titel	Dette element bruges ikke i Microsoft Dynamics 365.	Streng	Valgfri

Underordnede elementer

Element	Beskrivelse
<Tab> (RibbonDiffXml)	Angiver en fane på båndet.

Overordnede elementer

Element	Beskrivelse
<CommandUIDefinition> (RibbonDiffXml)	Angiver de synlige elementer på båndet, der skal inkluderes i et CustomAction-element.

Bemærkninger

Når du eksporterer en ContextualGroup, som du tidligere har defineret, kan du se, at ContextualGroup og eventuelle <Tab> (RibbonDiffXml)-elementer, som den indeholder, omstruktureres til separate <CustomAction> (RibbonDiffXml)-elementer. Dette skyldes den måde, hvorpå Microsoft Dynamics 365 (online og i det lokale miljø) gemmer dataene i databasen. Det ændrer ikke den oprindelige definitions funktionsmåde.

Hvis du f.eks. definerer en <CustomAction> (RibbonDiffXml) til at tilføje en ContextualGroup, som vist i følgende pseudo-kodestykke:

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

Hvis du senere eksporterer tilpasninger, herunder denne definition, kan du forvente, at definitionen vises som vist i følgende pseudo-kodestykke:

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

Oplysninger om element

XPath	`//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup`
Skemanavn	ContextualGroupType
Valideringsfil	RibbonWSS.xsd
Må gerne være tom	Ja

Se også

Tilpasse kommandoer og båndet
Ribbon XML reference

Microsoft Dynamics 365

Del via