Share via


<CommandDefinition> (RibbonDiffXml)

 

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

See Also

Ribbon XML reference
Customize commands and the ribbon
Define ribbon commands

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright