<PageRule> (RibbonDiffXml)

 

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

A rule that evaluates the address of the current page.

Syntax

<PageRule 
 Address="String" 
 Default=["0" | "1" | "true" | "false"]
 InvertResult=["0" | "1" | "true" | "false"]
 />

Attributes and Elements

The following describes the attributes, child elements, and parent elements.

Attributes

Attribute	Description	Type	Usage
Address	The address of the page to evaluate. It should be a relative path to the page. Only Microsoft Dynamics 365 (online & on-premises) pages can be evaluated.	String	Required
Default	Sets the default return value for the rule if the actual value cannot be determined.	Boolean	Optional
InvertResult	Negates the return value of the rule.	Boolean	Optional

Child Elements

This element has no child elements.

Parent Elements

Element	Description
<DisplayRule> (RibbonDiffXml)	Specifies either the definition of a rule used to display a ribbon element or a reference to a DisplayRule from a command definition.
<EnableRule> (RibbonDiffXml)	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.
<TabDisplayRule> (RibbonDiffXml)	Specifies conditions when a tab will display.
<Or> (RibbonDiffXml)	Specifies a set of rules that must be evaluated together.

Remarks

Only Microsoft Dynamics 365 (online & on-premises) pages can be evaluated to apply a page rule. External pages or HTML Web resources cannot be used.

This rule cannot be used with Microsoft Dynamics 365 for tablets because it will always refer to the same page.

Element Information

XPath	//RibbonDiffXml/RuleDefinitions/TabDisplayRules/TabDisplayRule/PageRule | //RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/PageRule | //RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/PageRule | //RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/OrRule/Or/PageRule | //RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/OrRule/Or/PageRule
Schema Name	PageRuleType
Validation File	RibbonTypes.xsd
Can be Empty	Yes

See Also

Ribbon XML reference
Customize commands and the ribbon

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright