通过

安全角色（角色）表/实体引用（Microsoft Dataverse）

对安全权限进行分组。 为用户分配了授权其访问 Microsoft CRM 系统的角色。

Messages

下表列出了安全角色（角色）表的消息。 消息表示可以在表上执行的作。 它们也可能是事件。

名称
是事件？		 Web API 操作 SDK for .NET
AddPrivilegesRole
事件：True		 AddPrivilegesRole AddPrivilegesRoleRequest
Associate
事件：True		 关联记录 关联记录
Create
事件：True		 POST /角色
请参阅 创建		 创建记录
Delete
事件：True		 DELETE /roles（roleid）
请参阅 删除		 删除记录
Disassociate
事件：True		 取消关联记录 取消关联记录
RemovePrivilegeRole
事件：True		 RemovePrivilegeRole RemovePrivilegeRoleRequest
ReplacePrivilegesRole
事件：True		 ReplacePrivilegesRole ReplacePrivilegesRoleRequest
Retrieve
事件：False		 GET /roles（roleid）
请参阅 检索		 检索记录
RetrieveAadUserRoles
事件：False		 RetrieveAadUserRoles RetrieveAadUserRolesRequest
RetrieveMultiple
事件：False		 GET /角色
查看 查询数据		 查询数据
RetrieveRolePrivilegesRole
事件：False		 RetrieveRolePrivilegesRole RetrieveRolePrivilegesRoleRequest
Update
事件：True		 PATCH /roles（roleid）
查看 更新		 更新记录
Upsert
事件：False		 PATCH /roles（roleid）
请参阅更新 插入表行		 UpsertRequest

属性

下表列出了安全角色（角色）表的选定属性。

资产 价值
显示名称 安全角色
显示集合名称 安全角色
架构名称 Role
集合架构名称 Roles
实体集名称 roles
逻辑名称 role
逻辑集合名称 roles
PrimaryId属性 roleid
PrimaryName属性 name
表类型 Standard
所有权类型 BusinessOwned

可写列/属性

这些列/属性为 IsValidForCreate 或 IsValidForUpdate （通常两者） 返回 true。 按 SchemaName 列出。

ApplicationId

资产 价值
Description 创建角色的用户的应用程序 ID
显示名称 应用程序 ID
IsValidForForm （形式有效） True
IsValidForRead True
LogicalName applicationid
RequiredLevel None
类型 Uniqueidentifier

AppliesTo

资产 价值
Description 安全角色适用的角色/许可证
显示名称 适用于
IsValidForForm （形式有效） True
IsValidForRead True
LogicalName appliesto
RequiredLevel 申请必填
类型 String
Format 文本
格式名称 文本
ImeMode Auto
是可本地化的 假
MaxLength （最大长度） 2000

业务单位 ID

资产 价值
Description 与角色关联的业务部门的唯一标识符。
显示名称 业务部门
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName businessunitid
RequiredLevel 系统必填
类型 查找
Targets 业务单位

CanBeDeleted

资产 价值
Description 指示是否可以删除角色。
显示名称 可以删除
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName canbedeleted
RequiredLevel 系统必填
类型 ManagedProperty

Description

资产 价值
Description 安全角色的说明
显示名称 说明
IsValidForForm （形式有效） True
IsValidForRead True
LogicalName description
RequiredLevel 申请必填
类型 String
Format 文本
格式名称 文本
ImeMode Auto
是可本地化的 假
MaxLength （最大长度） 2000

ImportSequenceNumber

资产 价值
Description 创建此记录的数据导入或数据迁移的唯一标识符。
显示名称 导入序列号
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName importsequencenumber
RequiredLevel None
类型 整数
最大值 2147483647
最小值 -2147483648

IsAutoAssigned

资产 价值
Description 指示是否根据用户许可证自动分配安全角色的值
显示名称 是否自动分配
IsValidForForm （形式有效） True
IsValidForRead True
LogicalName isautoassigned
RequiredLevel 申请必填
类型 选择列表
默认表单值
全局选择名称 securityrole_isautoassigned

IsAutoAssigned 选项/选项

价值 标签
0 否
1 是的

IsCustomizable

资产 价值
Description 指定是否可以自定义此组件的信息。
显示名称 定制
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName iscustomizable
RequiredLevel 系统必填
类型 ManagedProperty

IsInherited

资产 价值
Description 如果角色与团队关联，则角色由用户从团队成员身份继承。
显示名称 继承
IsValidForForm （形式有效） True
IsValidForRead True
LogicalName isinherited
RequiredLevel 系统必填
类型 选择列表
默认表单值 1
全局选择名称 isinherited

IsInherited 选项/选项

价值 标签
0 仅限团队权限
1 直接用户（基本）访问级别和团队权限

系统生成

资产 价值
Description 此角色是否由系统生成
显示名称 系统是否生成
IsValidForForm （形式有效） True
IsValidForRead True
LogicalName issytemgenerated
RequiredLevel 系统必填
类型 布尔
全局选择名称 role_issytemgenerated
默认值 假
真实标签 是的
虚假标签 否

Name

资产 价值
Description 角色的名称。
显示名称 名称
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName name
RequiredLevel 系统必填
类型 String
Format 文本
格式名称 文本
ImeMode Auto
是可本地化的 假
MaxLength （最大长度） 100

OverriddenCreatedOn

资产 价值
Description 迁移记录的日期和时间。
显示名称 记录创建时间
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName overriddencreatedon
RequiredLevel None
类型 日期时间
可以更改日期时间行为 假
日期时间行为 用户本地
Format DateOnly
ImeMode 未激活
源类型掩码 0

RoleId

资产 价值
Description 角色的唯一标识符。
显示名称 Role
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName roleid
RequiredLevel 系统必填
类型 Uniqueidentifier

SummaryofCoreTablePermissions

资产 价值
Description 角色的核心表权限摘要
显示名称 核心表权限摘要
IsValidForForm （形式有效） True
IsValidForRead True
LogicalName summaryofcoretablepermissions
RequiredLevel 申请必填
类型 备忘录
Format 文本区域
格式名称 文本区域
ImeMode Auto
是可本地化的 假
MaxLength （最大长度） 2000

只读列/属性

这些列/属性为 IsValidForCreate 和 IsValidForUpdate 返回 false。 按 SchemaName 列出。

组件状态

资产 价值
Description 仅供内部使用。
显示名称 组件状态
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName componentstate
RequiredLevel 系统必填
类型 选择列表
默认表单值 -1
全局选择名称 componentstate

ComponentState 选择/选项

价值 标签
0 已发布
1 未发布
2 已删除
3 已删除，未发布

CreatedBy

资产 价值
Description 创建角色的用户的唯一标识符。
显示名称 创建者
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName createdby
RequiredLevel None
类型 查找
Targets systemuser

CreatedOn

资产 价值
Description 创建角色的日期和时间。
显示名称 创建时间
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName createdon
RequiredLevel None
类型 日期时间
可以更改日期时间行为 假
日期时间行为 用户本地
Format 日期和时间
ImeMode 未激活
源类型掩码 0

创建时BehalfBy

资产 价值
Description 创建角色的委托用户的唯一标识符。
显示名称 由模拟器创建
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName createdonbehalfby
RequiredLevel None
类型 查找
Targets systemuser

IsManaged

资产 价值
Description 指示解决方案组件是否是托管解决方案的一部分。
显示名称 州
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName ismanaged
RequiredLevel 系统必填
类型 布尔
全局选择名称 ismanaged
默认值 假
真实标签 托管
虚假标签 非托管

ModifiedBy

资产 价值
Description 上次修改角色的用户的唯一标识符。
显示名称 修改者
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName modifiedby
RequiredLevel None
类型 查找
Targets systemuser

修改时间

资产 价值
Description 上次修改角色的日期和时间。
显示名称 修改时间
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName modifiedon
RequiredLevel None
类型 日期时间
可以更改日期时间行为 假
日期时间行为 用户本地
Format 日期和时间
ImeMode 未激活
源类型掩码 0

ModifiedOnBehalfBy

资产 价值
Description 上次修改角色的委托用户的唯一标识符。
显示名称 修改者（委托）
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName modifiedonbehalfby
RequiredLevel None
类型 查找
Targets systemuser

组织ID

资产 价值
Description 与角色关联的组织的唯一标识符。
显示名称 组织
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName organizationid
RequiredLevel 系统必填
类型 Uniqueidentifier

OrganizationIdName

资产 价值
Description
显示名称
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName organizationidname
RequiredLevel 系统必填
类型 String
Format 文本
格式名称 文本
ImeMode Auto
是可本地化的 假
MaxLength （最大长度） 100

覆盖时间

资产 价值
Description 仅供内部使用。
显示名称 记录覆盖时间
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName overwritetime
RequiredLevel 系统必填
类型 日期时间
可以更改日期时间行为 假
日期时间行为 用户本地
Format DateOnly
ImeMode 未激活
源类型掩码 0

ParentRoleId

资产 价值
Description 父角色的唯一标识符。
显示名称 父角色
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName parentroleid
RequiredLevel None
类型 查找
Targets 角色

ParentRootRoleId

资产 价值
Description 父根角色的唯一标识符。
显示名称 父根角色
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName parentrootroleid
RequiredLevel 系统必填
类型 查找
Targets 角色

RoleIdUnique

资产 价值
Description 仅供内部使用。
显示名称 唯一 ID
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName roleidunique
RequiredLevel 系统必填
类型 Uniqueidentifier

RoleTemplateId

资产 价值
Description 与角色关联的角色模板的唯一标识符。
显示名称 角色模板
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName roletemplateid
RequiredLevel None
类型 查找
Targets roletemplate

解决方案 ID

资产 价值
Description 关联解决方案的唯一标识符。
显示名称 Solution
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName solutionid
RequiredLevel 系统必填
类型 Uniqueidentifier

支持解决方案 Id

资产 价值
Description 仅供内部使用。
显示名称 Solution
IsValidForForm （形式有效） 假
IsValidForRead 假
LogicalName supportingsolutionid
RequiredLevel None
类型 Uniqueidentifier

版本号

资产 价值
Description 角色的版本号。
显示名称 版本号
IsValidForForm （形式有效） 假
IsValidForRead True
LogicalName versionnumber
RequiredLevel None
类型 BigInt
最大值 9223372036854775807
最小值 -9223372036854775808

多对一关系

这些关系是多对一的。 按 SchemaName 列出。

business_unit_roles

一To-Many 关系： 企业单位business_unit_roles

资产 价值
引用实体 businessunit
引用属性 businessunitid
引用属性 businessunitid
ReferencingEntityNavigationPropertyName businessunitid
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： Cascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

lk_role_createdonbehalfby

一To-Many 关系： systemuser lk_role_createdonbehalfby

资产 价值
引用实体 systemuser
引用属性 systemuserid
引用属性 createdonbehalfby
ReferencingEntityNavigationPropertyName createdonbehalfby
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： NoCascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

lk_role_modifiedonbehalfby

一To-Many 关系： systemuser lk_role_modifiedonbehalfby

资产 价值
引用实体 systemuser
引用属性 systemuserid
引用属性 modifiedonbehalfby
ReferencingEntityNavigationPropertyName modifiedonbehalfby
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： NoCascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

lk_rolebase_createdby

一To-Many 关系： systemuser lk_rolebase_createdby

资产 价值
引用实体 systemuser
引用属性 systemuserid
引用属性 createdby
ReferencingEntityNavigationPropertyName createdby
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： NoCascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

lk_rolebase_modifiedby

单To-Many 关系： systemuser lk_rolebase_modifiedby

资产 价值
引用实体 systemuser
引用属性 systemuserid
引用属性 modifiedby
ReferencingEntityNavigationPropertyName modifiedby
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： NoCascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

organization_roles

一To-Many 关系： 组织organization_roles

资产 价值
引用实体 organization
引用属性 organizationid
引用属性 organizationid
ReferencingEntityNavigationPropertyName organizationid_organization
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： NoCascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

role_parent_role

一To-Many 关系： 角色role_parent_role

资产 价值
引用实体 role
引用属性 roleid
引用属性 parentroleid
ReferencingEntityNavigationPropertyName parentroleid
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： NoCascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

role_parent_root_role

一To-Many 关系： 角色role_parent_root_role

资产 价值
引用实体 role
引用属性 roleid
引用属性 parentrootroleid
ReferencingEntityNavigationPropertyName parentrootroleid
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： Cascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

role_template_roles

一To-Many 关系： 角色模板role_template_roles

资产 价值
引用实体 roletemplate
引用属性 roletemplateid
引用属性 roletemplateid
ReferencingEntityNavigationPropertyName roletemplateid
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： NoCascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

solution_role

一To-Many 关系： 解决方案solution_role

资产 价值
引用实体 solution
引用属性 solutionid
引用属性 solutionid
ReferencingEntityNavigationPropertyName solution_role
是层次结构
级联配置 档案： NoCascade
分配： NoCascade
删除： Cascade
合并： NoCascade
重新父级： NoCascade
RollupView： NoCascade
共享： NoCascade
取消分享： NoCascade

一对多关系

这些关系是一对多的。 按 SchemaName 列出。

Role_AsyncOperations

多To-One 关系： 异步Role_AsyncOperations

资产 价值
引用实体 asyncoperation
引用属性 regardingobjectid
引用实体导航属性名称 Role_AsyncOperations
IsCustomizable False
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

Role_BulkDeleteFailures

多To-One 关系： bulkdeletefailure Role_BulkDeleteFailures

资产 价值
引用实体 bulkdeletefailure
引用属性 regardingobjectid
引用实体导航属性名称 Role_BulkDeleteFailures
IsCustomizable False
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

role_parent_role

多To-One 关系： 角色role_parent_role

资产 价值
引用实体 role
引用属性 parentroleid
引用实体导航属性名称 role_parent_role
IsCustomizable False
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

role_parent_root_role

多To-One 关系： 角色role_parent_root_role

资产 价值
引用实体 role
引用属性 parentrootroleid
引用实体导航属性名称 role_parent_root_role
IsCustomizable False
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

Role_SyncErrors

多To-One 关系： 同步器Role_SyncErrors

资产 价值
引用实体 syncerror
引用属性 regardingobjectid
引用实体导航属性名称 Role_SyncErrors
IsCustomizable True
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

多对多关系

这些关系是多对多的。 按 SchemaName 列出。

application_role

请参阅 应用程序application_role多To-Many 关系

资产 价值
相交实体名称 applicationroles
IsCustomizable 假
SchemaName application_role
相交属性 roleid
导航属性名称 application_role
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

applicationuserrole

请参阅 applicationuser applicationuserrole 多To-Many 关系

资产 价值
相交实体名称 applicationuserrole
IsCustomizable 假
SchemaName applicationuserrole
相交属性 roleid
导航属性名称 applicationuserrole
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

appmoduleroles_association

请参阅 appmodule appmoduleroles_association多To-Many 关系

资产 价值
相交实体名称 appmoduleroles
IsCustomizable 假
SchemaName appmoduleroles_association
相交属性 roleid
导航属性名称 appmoduleroles_association
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

roleprivileges_association

查看 多To-Many 关系的特权roleprivileges_association

资产 价值
相交实体名称 roleprivileges
IsCustomizable 假
SchemaName roleprivileges_association
相交属性 roleid
导航属性名称 roleprivileges_association
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

systemuserroles_association

请参阅 systemuser systemuserroles_association多To-Many 关系

资产 价值
相交实体名称 systemuserroles
IsCustomizable 假
SchemaName systemuserroles_association
相交属性 roleid
导航属性名称 systemuserroles_association
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

teamroles_association

查看 团队teamroles_association多To-Many 关系

资产 价值
相交实体名称 teamroles
IsCustomizable 假
SchemaName teamroles_association
相交属性 roleid
导航属性名称 teamroles_association
关联菜单配置 可用离线：True
行为： DoNotDisplay
群： Details
标签：
MenuId：空
次序：
QueryApi：空
视图 ID： 00000000-0000-0000-0000-000000000000

另请参阅

Dataverse 表/实体引用
Dataverse Web API 参考
role