<CommandDefinition> (RibbonDiffXml)

Article
11/28/2016

Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Specifies a set of rules that control how a ribbon element is displayed and actions to perform that can be referenced by ribbon elements and controls.

Syntax

<CommandDefinition
Id="String">
 <EnableRules />
 <DisplayRules />
 <Actions />
</CommandDefinition>

Attributes and Elements

The following table lists the attributes, child elements, and parent elements.

Attributes

Attribute	Description	Type	Usage
Id	Specifies a unique identifier for the definition of a ribbon element. The strongly recommended naming convention is to use a period to separate the parts of the name like so: [solution identifier].[entity].[ribbon].[function].[element name]. For example: MyISV.account.form.SendToOtherSystem.Button.	String	Required

Child Elements

Element	Description
<EnableRules> (RibbonDiffXml)	Contains a collection of enable rules.
<DisplayRules> (RibbonDiffXml)	Contains a collection of display rules.
<Actions> (RibbonDiffXml)	Specifies the actions that a command will perform.

Parent Elements

Element	Description
<CommandDefinitions> (RibbonDiffXml)	Contains a collection of commands that can be referenced by ribbon controls.

Remarks

This element must contain all child elements even when no enable rules, display rules, or actions are defined.

Element Information

XPath	`//RibbonDiffXml/CommandDefinitions/CommandDefinition`
Schema Name	CommandDefinitionType
Validation File	RibbonTypes.xsd
Can be Empty	No