<PageRule> (RibbonDiffXml)

 

Applies To: Dynamics CRM 2013

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 CRM 2013 and Microsoft Dynamics CRM Online 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 CRM 2013 and Microsoft Dynamics CRM Online 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 CRM 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