<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