Share via


<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