Share via


Privilege entity messages and methods

 

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

A privilege is a permission to perform an action in Microsoft Dynamics 365. The platform checks for the privilege. It fails if the user doesn’t hold the privilege.

Microsoft Dynamics 365 contains a complete set of privileges for all entities, including custom entities. Privileges can’t be added to the system except that when a custom entity is added, generated custom entity privileges are added for that entity. When a custom entity is deleted, the corresponding privileges are deleted also.

For more information, see Security role and privilege reference. The schema name for this entity is Privilege. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the metadata for your organization. You can also view the metadata for an uncustomized organization in the Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK download.

The following table describes the messages for this entity, which you use with the IOrganizationService.Execute method.

Message

Description

InitializeFromRequest

Initializes a new record from an existing record provided that an attribute map is defined for the two entities. For more information, see Customize entity and attribute mappings.

RetrieveDuplicatesRequest

Detects and retrieves duplicate records for the specified record provided that duplicate detection is enabled and there are published duplicate detection rules for the entity. For more information, see Detect duplicate data.

RetrieveRequest

Retrieves a privilege. You can also call the IOrganizationService.Retrieve method.

RetrieveMultipleRequest

Retrieves a collection of privileges. You can also call the IOrganizationService.RetrieveMultiple method.

RetrievePrivilegeSetRequest

Retrieves the set of privileges defined in the system.

RetrieveUserPrivilegesRequest

Retrieves the set of privileges for a user. Use the RetrieveMultipleRequest method instead.

See Also

How role-based security can be used to control access to entities in Microsoft Dynamics 365
Privilege and role entities
Role (security role) entity messages and methods
Sample: Associate a security role to a team
Privileges by entity

Microsoft Dynamics 365

© 2016 Microsoft. All rights reserved. Copyright