<EntityRule> (RibbonDiffXml)
Updated: November 29, 2016
Applies To: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Specifies a rule that can detect whether a specific entity is in context.
<EntityRule AppliesTo=["PrimaryEntity" | "SelectedEntity"] Context=["Form" | "HomePageGrid" | "SubGridStandard" |"SubGridAssociated"] Default=["0" | "1" | "true" | "false"] EntityName="String" InvertResult=["0" | "1" | "true" | "false"] />
Attributes and Elements
The following table lists the attributes, child elements, and parent elements.
Attributes
Attribute | Description | Type | Usage | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AppliesTo | Determines whether the rule applies to the entity record being displayed in the form or entity records being displayed in a sub-grid. Valid values:
| Enumeration | Optional | ||||||||||
Context | Specifies the context of the ribbon. Valid values:
| String | Optional | ||||||||||
Default | Sets the default return value for the rule if the actual value cannot be determined. This attribute is not valid when this element is a child of <TabDisplayRule> (RibbonDiffXml) | Boolean | Optional | ||||||||||
EntityName | Specifies the entity that this rule will apply to. Use the entity logical name, for example, "new_customentity". | String | Required | ||||||||||
InvertResult | Negates the return value of the rule. This attribute is not valid when this element is a child of <TabDisplayRule> (RibbonDiffXml) | Boolean | Optional |
Child Elements
This element has no child elements.
Parent Elements
Element | Description |
|---|---|
Specifies conditions when a tab will display. | |
Specifies either the definition of a rule used to display a ribbon element or a reference to a DisplayRule from a command definition. | |
Specifies either the definition of a rule used to enable or disable a ribbon element or a reference to an EnableRule from a command definition. | |
Specifies a set of rules that must be evaluated together. |
The InvertResult and Default attributes are not valid when this element is a child of <TabDisplayRule> (RibbonDiffXml)
Element Information
XPath |
//RibbonDiffXml/RuleDefinitions/TabSelectionRules/TabSelectionRule/EntityRule | //RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/EntityRule | //RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/EntityRule | //RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/OrRule/Or/EntityRule | //RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/OrRule/Or/EntityRule |
Schema Name | EntityRuleType |
Validation File | RibbonTypes.xsd |
Can be Empty | Yes |
Microsoft Dynamics 365
© 2016 Microsoft. All rights reserved. Copyright