<RecordPrivilegeRule> (RibbonDiffXml)

 

Applies To: Dynamics CRM 2013

A rule that detects a user’s privileges for a specific record in order to enable a ribbon element.

Syntax

<RecordPrivilegeRule 
 AppliesTo="PrimaryEntity" 
 Default=["0" | "1" | "true" | "false"]
 InvertResult=["0" | "1" | "true" | "false"]
 PrivilegeType=[ "Create" | "Read"  | "Write" | "Delete" | "Assign" | "Share" | "Append" | "AppendTo" ]
 />

Attributes and Elements

The following describes 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:

Value

Description

PrimaryEntity

For a form or Subgrid ribbon, the rule applies to the entity displayed in the form. This will option does not apply for a Grid Ribbon.

Enumeration

Optional

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

PrivilegeType

Describes the type of operation for the privilege.

Valid values:

Value

Description

Create

To create new entity instances for this entity.

Read

To view a records of this entity.

Write

To update an entity instance.

Delete

To delete a record for this entity.

Assign

To change the owner of user-owned instances of an entity.

Share

To assign specific privileges to another user for an entity instance.

Append

To associate a selected entity instance to another entity instance.

AppendTo

To associate an entity instance to this entity instance.

Enumeration

Required

Child Elements

This element has no child elements.

Parent Elements

Element

Description

<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.

<Or> (RibbonDiffXml)

Specifies a set of rules that must be evaluated together.

Element Information

XPath

//RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/RecordPrivilegeRule
//RibbonDiffXml/RuleDefinitions/EnableRules/EnableRule/OrRule/Or/RecordPrivilegeRule

Schema Name

RecordPrivilegeRuleType

Validation File

RibbonTypes.xsd

Can be Empty

Yes

See Also

Ribbon XML reference
Customize commands and the ribbon