<ContextualGroup> (RibbonDiffXml)

  • [アーティクル]

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

特定のコンテキスト内に表示するタブのコレクションを格納します。

構文

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

属性と要素

次の表では、属性、子要素および親要素について示します。

属性

属性

説明

種類

使用法

色

グループに対して配色を指定します。

有効な値には次が含まれます:

  • なし​​

  • 濃紺

  • 淡いブルー

  • 緑色がかった青

  • オレンジ

  • 緑

  • マゼンタ

  • 黄

  • 紫

列挙

任意出席者

Command

このコントロールのリボン コマンドの ID を指定します。

文字列

任意出席者

ContextualGroupId

Mscrm.VisualizationToolsなどのコンテキスト グループを識別する文字列。

文字列

任意出席者

ID

リボン要素の定義の一意の識別子を指定します。 [solution identifier].[entity].[ribbon].[function].[element name] のように、命名規則として、名前の各部をピリオドを使用して分割することを強くお勧めします。 たとえば、MyISV.account.form.SendToOtherSystem.Button のように指定します。

複数のエンティティで使用されるリボン要素を定義するときには、ID 属性の {!EntityLogicalName} トークンを使用します。 これにより、ID 値にエンティティの論理名を挿入して、グローバルに一意な ID 値を設定します。

たとえば、取引先企業のエンティティで MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button を使用する場合、ID は MyISV.account.form.SendToOtherSystem.Button となります。 取引先担当者のエンティティの場合、ID は MyISV.contact.form.SendToOtherSystem.Button となります。

重要

グローバル一意の ID 値を設定しない場合、リボンは表示されないことがあります。

文字列

必須出席者

シーケンス

Sequence の値を既存のリボン要素よりも大きく、または小さく設定することによってリボンの変更の場所を指定します。

整数

任意出席者

敬称

この要素は Microsoft Dynamics 365 では使用されません。

文字列

任意出席者

子要素

Element

説明

<Tab> (RibbonDiffXml)

リボンのタブを指定します。

親要素

Element

説明

<CommandUIDefinition> (RibbonDiffXml)

CustomAction 要素内に収まる、表示可能な Ribbon 要素を指定します。

備考

以前に定義した、ContextualGroup をエクスポートすると、それに含まれる ContextualGroup と <Tab> (RibbonDiffXml) 要素は、別の <CustomAction> (RibbonDiffXml) 要素にリファクタリングされます。 これは、Microsoft Dynamics 365 (オンラインおよび設置型) がデータベースにデータを格納する方法によります。 元の定義の動作は変更されません。

たとえば、次の擬似コードスニペットに示されるように ContextualGroup を追加するのに、<CustomAction> (RibbonDiffXml)を定義する場合:

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

この定義を含むカスタマイズを後ほどエクスポートする場合、次の擬似コード スニペットが示すように、定義が表示されるはずです。

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

要素情報

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/ContextualGroup

スキーマ名

ContextualGroupType

検証ファイル

RibbonWSS.xsd

空も可能

はい

関連項目

コマンドおよびリボンをカスタマイズする
Ribbon XML reference

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権