Freigeben über

<ContextualGroup> (RibbonDiffXml)

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Enthält eine Sammlung von Registerkarten, die in einem bestimmten Kontext angezeigt werden sollen.

Syntax

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

Attribute und Elemente

In der folgenden tabelle werden die Attribute, untergeordneten Elemente und übergeordneten Elemente beschrieben.

Attribute

Attribut

Beschreibung

Typ

Verwendung

Farbe

Gibt ein Farbschema für die Gruppe an.

Gültige Werte sind:

  • keine

  • Dunkelblau

  • Hellblau

  • Blaugrün

  • Orange

  • Grün

  • Magentarot

  • Gelb

  • Purpurrot

Enumeration

Optional

Befehl

Gibt die ID des Menübandbefehls für dieses Steuerelement an.

Zeichenfolge

Optional

ContextualGroupId

Eine Zeichenfolge, die die kontextbezogene Gruppe angibt, wie Mscrm.VisualizationTools.

Zeichenfolge

Optional

Kennung

Gibt einen eindeutigen Bezeichner für die Definition eines Menübandelements an. Die dringend empfohlene Namenskonvention sieht die Verwendung eines Punkts zum Trennen der Teile des Namens vor: [Lösungsbezeichner].[Entität].[Menüband].[Funktion].[Elementname]. Beispiel: MyISV.account.form.SendToOtherSystem.Button.

Verwenden Sie das {!EntityLogicalName}-Token im ID-Attribut, wenn Sie ein Menübandelement definieren, das für mehrere Entitäten verwendet wird. Dadurch wird der logische Name der Entität in den ID-Wert eingefügt, um sicherzustellen, dass der ID-Wert global eindeutig ist.

Wenn Sie z.B. MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button mit der Firmenentität verwenden, ist die ID MyISV.account.form.SendToOtherSystem.Button. Für die Kontaktentität ist die ID MyISV.contact.form.SendToOtherSystem.Button.

Wichtig

Wenn Sie keinen global eindeutigen ID-Wert festlegen, wird das Menüband möglicherweise nicht angezeigt.

Zeichenfolge

Erforderlich

Sequenz

Geben Sie die Position der Menübandänderung an, indem Sie den Sequenzwert höher oder niedriger als vorhandene Menübandelemente festlegen.

Ganze Zahl

Optional

Titel

Dieses Element wird in Microsoft Dynamics 365 nicht verwendet.

Zeichenfolge

Optional

Untergeordnete Elemente

Element

Beschreibung

<Tab> (RibbonDiffXml)

Gibt eine Registerkarte auf dem Menüband an.

Übergeordnete Elemente

Element

Beschreibung

<CommandUIDefinition> (RibbonDiffXml)

Gibt die sichtbaren Menübandelemente an, die in einem CustomAction-Element enthalten sein sollen.

Hinweise

Wenn Sie eine ContextualGroup exportieren, die Sie bereits zuvor definiert haben, beachten Sie, dass die ContextualGroup und alle <Tab> (RibbonDiffXml)-Elemente, die es enthält, in separate <CustomAction> (RibbonDiffXml)-Elemente umfaktoriert werden. Diese Möglichkeit ergibt sich aus der Art, wie Microsoft Dynamics 365 (online und lokal) die Daten in der Datenbank speichert. Es ändetrt nicht das Verhalten der ursprünglichen Definition.

Wenn Sie z. B. ein <CustomAction> (RibbonDiffXml) definieren, um eine ContextualGroup hinzuzufügen, wie im folgenden Pseudocodeausschnitt gezeigt:

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

Wenn Sie später Anpassungen exportieren, einschließlich dieser Definition, sollten Sie erwarten, dass die Definition angezeigt wird, wie im folgenden Pseudocodeausschnitt gezeigt:

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

Elementinformationen

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

Schemaname

ContextualGroupType

Validierungsdatei

RibbonWSS.xsd

Kann leer sein

Ja

Siehe auch

Anpassen von Befehlen und des Menübands
Ribbon XML reference

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright