Role (Security Role) Entity Metadata
The following information is for the role entity in a default, uncustomized installation of Microsoft Dynamics CRM. The schema name and early bound class for this entity is Role.
To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the Metadata for Your Organization.
In This Topic
Entity Metadata
The following table shows the metadata for the role entity.
| Metadata property | Value |
|---|---|
|
OTC |
1036 |
|
EntityLogicalName |
role |
|
DisplayName |
Security Role |
|
OwnershipType |
BusinessOwned |
|
IsCustomizable |
True |
|
Description |
Grouping of security privileges. Users are assigned roles that authorize their access to the Microsoft CRM system. |
|
IsAvailableOffline |
True |
|
IsAuditEnabled |
False |
|
AutoRouteToOwnerQueue |
False |
|
CanBeInManyToMany |
False |
|
CanBePrimaryEntityInRelationship |
True |
|
CanBeRelatedEntityInRelationship |
False |
|
CanCreateAttributes |
False |
|
CanCreateCharts |
False |
|
CanCreateForms |
False |
|
CanCreateViews |
False |
|
CanModifyAdditionalSettings |
True |
|
CanTriggerWorkflow |
False |
|
IsActivity |
False |
|
IsActivityParty |
False |
|
IsChildEntity |
False |
|
IsConnectionsEnabled |
canmodifyconnectionsettings |
|
IsCustomEntity |
False |
|
IsDocumentManagementEnabled |
False |
|
IsDuplicateDetectionEnabled |
False |
|
IsEnabledForCharts |
False |
|
IsImportable |
True |
|
IsIntersect |
False |
|
IsMailMergeEnabled |
False |
|
IsManaged |
True |
|
IsMappable |
True |
|
IsReadingPaneEnabled |
True |
|
IsRenameable |
False |
|
IsValidForAdvancedFind |
True |
|
IsValidForQueue |
False |
|
IsVisibleInMobile |
False |
|
PrimaryIdAttribute |
roleid |
|
PrimaryNameAttribute |
name |
|
ReportViewName |
FilteredRole |
|
RecurrenceBaseEntityLogicalName |
|
|
DisplayCollectionName |
Security Roles |
Privilege Metadata
The following table shows the privilege metadata for the role entity.
| PrivilegeName | Id | Type | CanBeBasic | CanBeDeep | CanBeGlobal | CanBeLocal |
|---|---|---|---|---|---|---|
|
prvAppendRole |
8fdeea95-80ab-47dc-974b-52d71b88c8af |
Append |
False |
True |
True |
True |
|
prvAppendToRole |
eaa02b5b-dc56-4aa3-a889-718f25aa0075 |
AppendTo |
False |
True |
True |
True |
|
prvAssignRole |
836d6c7b-cf1d-47f0-8021-8e41091c489c |
Assign |
False |
True |
True |
True |
|
prvCreateRole |
7398c78c-29a5-4982-9ada-73390f64fe99 |
Create |
False |
True |
True |
True |
|
prvDeleteRole |
34abe1b8-e9bc-4be0-9ef3-09459ca7ae57 |
Delete |
False |
True |
True |
True |
|
prvReadRole |
222a920a-2778-4564-85cb-e78dde8e4276 |
Read |
False |
True |
True |
True |
|
prvWriteRole |
bd123e14-17ba-40f6-8d8b-18f4bffa7e50 |
Write |
False |
True |
True |
True |
Attribute Metadata
The following table shows the attribute metadata for the role entity.
| LogicalName | Description | Type | SchemaName | IsCustomAttribute | IsCustomizable | RequiredLevel | IsValidForCreate | IsValidForRead | IsValidForUpdate | CanBeSecuredForCreate | CanBeSecuredForRead | CanBeSecuredForUpdate | IsAuditEnabled | IsManaged | IsPrimaryId | IsPrimaryName | IsRenameable | IsSecured | IsValidForAdvancedFind | DisplayName | DeprecatedVersion |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
businessunitid |
Unique identifier of the business unit with which the role is associated. |
Lookup |
BusinessUnitId |
False |
True |
SystemRequired |
True |
True |
False |
False |
False |
False |
True |
True |
False |
False |
False |
False |
True |
Business Unit |
|
|
componentstate |
For internal use only. |
Picklist |
ComponentState |
False |
True |
SystemRequired |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Component State |
|
|
createdby |
Unique identifier of the user who created the role. |
Lookup |
CreatedBy |
False |
False |
None |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
True |
Created By |
|
|
createdon |
Date and time when the role was created. |
DateTime |
CreatedOn |
False |
False |
None |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
True |
Created On |
|
|
createdonbehalfby |
Unique identifier of the delegate user who created the role. |
Lookup |
CreatedOnBehalfBy |
False |
True |
None |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
True |
Created By Impersonator |
|
|
importsequencenumber |
Unique identifier of the data import or data migration that created this record. |
Integer |
ImportSequenceNumber |
False |
True |
None |
True |
True |
False |
False |
False |
False |
True |
True |
False |
False |
False |
False |
True |
Import Sequence Number |
|
|
iscustomizable |
Information that specifies whether this component can be customized. |
ManagedProperty |
IsCustomizable |
False |
False |
SystemRequired |
True |
True |
True |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Customizable |
|
|
ismanaged |
Indicates whether the solution component is part of a managed solution. |
Boolean |
IsManaged |
False |
True |
SystemRequired |
False |
True |
False |
False |
False |
False |
True |
True |
False |
False |
False |
False |
False |
State |
|
|
modifiedby |
Unique identifier of the user who last modified the role. |
Lookup |
ModifiedBy |
False |
False |
None |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
True |
Modified By |
|
|
modifiedon |
Date and time when the role was last modified. |
DateTime |
ModifiedOn |
False |
False |
None |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
True |
Modified On |
|
|
modifiedonbehalfby |
Unique identifier of the delegate user who last modified the role. |
Lookup |
ModifiedOnBehalfBy |
False |
True |
None |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
True |
Modified By (Delegate) |
|
|
name |
Name of the role. |
String |
Name |
False |
True |
SystemRequired |
True |
True |
True |
False |
False |
False |
True |
True |
False |
True |
False |
False |
True |
Name |
|
|
organizationid |
Unique identifier of the organization associated with the role. |
Uniqueidentifier |
OrganizationId |
False |
False |
SystemRequired |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Organization |
|
|
overriddencreatedon |
Date and time that the record was migrated. |
DateTime |
OverriddenCreatedOn |
False |
True |
None |
True |
True |
False |
False |
False |
False |
True |
True |
False |
False |
False |
False |
True |
Record Created On |
|
|
overwritetime |
For internal use only. |
DateTime |
OverwriteTime |
False |
True |
SystemRequired |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Record Overwrite Time |
|
|
parentroleid |
Unique identifier of the parent role. |
Lookup |
ParentRoleId |
False |
True |
None |
False |
True |
False |
False |
False |
False |
True |
True |
False |
False |
False |
False |
True |
Parent Role |
|
|
parentrootroleid |
Unique identifier of the parent root role. |
Lookup |
ParentRootRoleId |
False |
True |
SystemRequired |
False |
True |
False |
False |
False |
False |
True |
True |
False |
False |
False |
False |
True |
Parent Root Role |
|
|
roleid |
Unique identifier of the role. |
Uniqueidentifier |
RoleId |
False |
False |
SystemRequired |
True |
True |
False |
False |
False |
False |
False |
True |
True |
False |
False |
False |
True |
Role |
|
|
roleidunique |
For internal use only. |
Uniqueidentifier |
RoleIdUnique |
False |
False |
SystemRequired |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Unique Id |
|
|
roletemplateid |
Unique identifier of the role template that is associated with the role. |
Lookup |
RoleTemplateId |
False |
True |
None |
False |
True |
False |
False |
False |
False |
True |
True |
False |
False |
False |
False |
False |
Role Template |
|
|
solutionid |
Unique identifier of the associated solution. |
Uniqueidentifier |
SolutionId |
False |
False |
SystemRequired |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Solution |
|
|
supportingsolutionid |
For internal use only. |
Uniqueidentifier |
SupportingSolutionId |
False |
False |
None |
False |
False |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Solution |
|
|
versionnumber |
Version number of the role. |
BigInt |
VersionNumber |
False |
False |
None |
False |
True |
False |
False |
False |
False |
False |
True |
False |
False |
False |
False |
False |
Version number |
|
One-to-Many Relationships
The following table shows the entities that are the referencing entity in a one-to-many relationship with the role entity.
| Relationship schema name | Referencing entity |
|---|---|
|
Role_AsyncOperations |
asyncoperation |
|
Role_BulkDeleteFailures |
bulkdeletefailure |
|
role_parent_role |
role |
|
role_parent_root_role |
role |
|
userentityinstancedata_role |
userentityinstancedata |
Many-to-Many Relationships
The following table shows the many-to-many relationships for the role entity.
| Relationship schema name | Entity 1 | Entity 2 | Intersect entity |
|---|---|---|---|
|
roleprivileges_association |
privilege |
role |
roleprivileges |
|
systemuserroles_association |
systemuser |
role |
systemuserroles |
|
teamroles_association |
team |
role |
teamroles |
For information about using intersect entities, see Retrieve Records for Many-To-Many Relationships Using Intersect Entities.
Many-to-One Relationships
The following table shows the entities that are the referenced entity in a many-to-one relationship with the role entity.
| Relationship schema name | Referenced entity |
|---|---|
|
business_unit_roles |
businessunit |
|
organization_roles |
organization |
|
role_parent_role |
role |
|
role_parent_root_role |
role |
|
role_template_roles |
roletemplate |
|
lk_rolebase_modifiedby |
systemuser |
|
lk_role_createdonbehalfby |
systemuser |
|
lk_role_modifiedonbehalfby |
systemuser |
|
lk_rolebase_createdby |
systemuser |
See Also
Microsoft Dynamics CRM 2011 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2012 Microsoft Corporation. All rights reserved.
