role EntityType
Description: Grouping of security privileges. Users are assigned roles that authorize their access to the Microsoft CRM system.
Entity Set path: [organization URI]/api/data/v8.0/roles
Base Type: crmbaseentity EntityType
Display Name: Security Role
Primary Key: roleid
Primary Name Attribute: name
Properties
Single-valued navigation properties
Collection-valued navigation properties
Operations bound to role
Operations using the role entity type.
Properties
Properties represent fields of data stored in the entity. Some properties are not writable.
| Name | Type | Details |
|---|---|---|
_businessunitid_value |
Edm.Guid |
Description: Unique identifier of the business unit with which the role is associated. Computed property Read-only property |
_createdby_value |
Edm.Guid |
Description: Unique identifier of the user who created the role. Computed property Read-only property |
_createdonbehalfby_value |
Edm.Guid |
Description: Unique identifier of the delegate user who created the role. Computed property Read-only property |
_modifiedby_value |
Edm.Guid |
Description: Unique identifier of the user who last modified the role. Computed property Read-only property |
_modifiedonbehalfby_value |
Edm.Guid |
Description: Unique identifier of the delegate user who last modified the role. Computed property Read-only property |
_parentroleid_value |
Edm.Guid |
Description: Unique identifier of the parent role. Computed property Read-only property |
_parentrootroleid_value |
Edm.Guid |
Description: Unique identifier of the parent root role. Computed property Read-only property |
_roletemplateid_value |
Edm.Guid |
Description: Unique identifier of the role template that is associated with the role. Computed property Read-only property |
componentstate |
Edm.Int32 |
Description: For internal use only. Default Options: 0 : Published Display Name: Component State Read-only property |
createdon |
Edm.DateTimeOffset |
Description: Date and time when the role was created. Display Name: Created On Read-only property |
importsequencenumber |
Edm.Int32 |
Description: Unique identifier of the data import or data migration that created this record. Display Name: Import Sequence Number |
iscustomizable |
mscrm.BooleanManagedProperty |
Description: Information that specifies whether this component can be customized. Display Name: Customizable |
ismanaged |
Edm.Boolean |
Description: Indicates whether the solution component is part of a managed solution. Default Options: 1 : Managed Display Name: State Read-only property |
modifiedon |
Edm.DateTimeOffset |
Description: Date and time when the role was last modified. Display Name: Modified On Read-only property |
name |
Edm.String |
Description: Name of the role. Display Name: Name |
organizationid |
Edm.Guid |
Description: Unique identifier of the organization associated with the role. Display Name: Organization Read-only property |
overriddencreatedon |
Edm.DateTimeOffset |
Description: Date and time that the record was migrated. Display Name: Record Created On |
overwritetime |
Edm.DateTimeOffset |
Description: For internal use only. Display Name: Record Overwrite Time Read-only property |
roleid |
Edm.Guid |
Description: Unique identifier of the role. Display Name: Role |
roleidunique |
Edm.Guid |
Description: For internal use only. Display Name: Unique Id Read-only property |
solutionid |
Edm.Guid |
Description: Unique identifier of the associated solution. Display Name: Solution Read-only property |
versionnumber |
Edm.Int64 |
Description: Version number of the role. Display Name: Version number Read-only property |
Single-valued navigation properties
Single-valued navigation properties represent lookup fields where a single entity can be referenced.
| Name | Type | Partner |
|---|---|---|
businessunitid |
business_unit_roles |
|
createdby |
lk_rolebase_createdby |
|
createdonbehalfby |
lk_role_createdonbehalfby |
|
modifiedby |
lk_rolebase_modifiedby |
|
modifiedonbehalfby |
lk_role_modifiedonbehalfby |
|
organizationid_organization |
organization_roles |
|
parentroleid |
role_parent_role |
|
parentrootroleid |
role_parent_root_role |
|
roletemplateid |
role_template_roles |
Collection-valued navigation properties
Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.
| Name | Type | Partner |
|---|---|---|
Role_AsyncOperations |
regardingobjectid_role |
|
Role_BulkDeleteFailures |
regardingobjectid_role |
|
role_parent_role |
parentroleid |
|
role_parent_root_role |
parentrootroleid |
|
roleprivileges_association |
roleprivileges_association |
|
systemuserroles_association |
systemuserroles_association |
|
teamroles_association |
teamroles_association |
Operations bound to role
The following operations are bound to the role entity type.
| Name | Bound to |
|---|---|
Entity |
|
Entity |
|
Entity |
Operations using the role entity type.
The following operations use the role entity type in a parameter or return type.
| Name | How used | Description |
|---|---|---|
entity Parameter |
Adds a set of existing privileges to an existing role. |
|
entity Parameter |
Removes a privilege from an existing role. |
|
entity Parameter |
Replaces the privilege set of an existing role. |
Siehe auch
Weitere Ressourcen
Web API Action Reference
Web API Function Reference
Web API Query Function Reference
Web API EnumType Reference
Web API ComplexType Reference
Web API Metadata EntityType Reference
Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.