<MiscellaneousPrivilegeRule> (RibbonDiffXml)

 

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

Specifies a rule that can detect whether the user possesses a specific Microsoft Dynamics 365 privilege.

Syntax

<MiscellaneousPrivilegeRule
 Default=["0" | "1" | "true" | "false"]
 InvertResult=["0" | "1" | "true" | "false"]
 PrivilegeDepth=["None" | "Basic" | "Local"  | "Deep"  | "Global"]
 PrivilegeName="String" 
/>

Attributes and Elements

The following table lists the attributes, child elements, and parent elements.

Attributes

Attribute	Description	Type	Usage
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
PrivilegeDepth	The Privilege Depth to check. Valid values: Value Description Basic This access level exposes to a user entity instances he or she owns, objects that are shared with the user, and objects that are shared with a team of which the user is a member. The application refers to this access level as User. Local This access level exposes to a user entity instances in the user's business unit. The application refers to this access level as Business Unit. Deep This access level exposes to a user entity instances in the user's business unit and all business units subordinate to the user's business unit. The application refers to this access level as Parent: Child Business Units. Global This access level exposes to a user all entity instances within the organization, regardless of the business unit hierarchical level to which the instance or the user belongs. The application refers to this access level as Organization.	Enumeration	Optional
PrivilegeName	The name of the privilege to evaluate. See Remarks.	String	Required

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.
<Or> (RibbonDiffXml)	Specifies a set of rules that must be evaluated together.

Remarks

The string used to specify the privilege not associated with an entity. The PrivilegeName must correspond to a valid privilege name. See Security role UI to privilege mapping. The privileges listed in that table include the prefix ‘prv’. Remove that prefix and use the remaining privilege name. For example, for the privilege name prvCreateEntity, just use CreateEntity.

For privileges associated with an entity use <EntityPrivilegeRule> (RibbonDiffXml).

Element Information

XPath	//RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/MiscellaneousPrivilegeRule | //RibbonDiffXml/RuleDefinitions/DisplayRules/DisplayRule/OrRule/Or/MiscellaneousPrivilegeRule
Schema Name	MiscellaneousPrivilegeRuleType
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