连接角色（ConnectionRole）表/实体引用（Microsoft Dataverse）

2025-10-31

描述两条记录之间关系的角色。

Messages

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

名称是事件？	Web API 操作	SDK for .NET
`Associate` 事件：True	关联记录	关联记录
`Create` 事件：True	`POST` /connectionroles 请参阅创建	创建记录
`Delete` 事件：True	`DELETE` /connectionroles（connectionroleid）请参阅删除	删除记录
`Disassociate` 事件：True	取消关联记录	取消关联记录
`Retrieve` 事件：True	`GET` /connectionroles（connectionroleid）请参阅检索	检索记录
`RetrieveMultiple` 事件：True	`GET` /connectionroles 查看查询数据	查询数据
`SetState` 事件：True	`PATCH` /connectionroles（connectionroleid）更新`statecode` 和 `statuscode` 属性。	SetStateRequest
`Update` 事件：True	`PATCH` /connectionroles（connectionroleid）查看更新	更新记录
`Upsert` 事件：False	`PATCH` /connectionroles（connectionroleid）请参阅更新插入表行	UpsertRequest

属性

下表列出了连接角色（ConnectionRole）表的选定属性。

资产	价值
显示名称	连接角色
显示集合名称	连接角色
架构名称	`ConnectionRole`
集合架构名称	`ConnectionRoles`
实体集名称	`connectionroles`
逻辑名称	`connectionrole`
逻辑集合名称	`connectionroles`
PrimaryId属性	`connectionroleid`
PrimaryName属性	`name`
表类型	`Standard`
所有权类型	`OrganizationOwned`

可写列/属性

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

类别
ConnectionRoleId
说明
导入序列号
Introduced版本
是可定制的
名称
州代码
状态代码

类别

资产	价值
Description	连接角色的类别。
显示名称	连接角色类别
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`category`
RequiredLevel	None
类型	选择列表
默认表单值	1
全局选择名称	`connectionrole_category`

类别选择/选项

价值	标签
1	业务
2	系列
3	社交
4	销售
5	其他
1000	利益相关者
1001	销售团队
1002	服务

ConnectionRoleId

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

Description

资产	价值
Description	连接角色的说明。
显示名称	说明
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`description`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1000

ImportSequenceNumber

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

IntroducedVersion

资产	价值
Description	引入表格的版本。
显示名称	引入版本
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`introducedversion`
RequiredLevel	None
类型	String
Format	版本号
格式名称	版本号
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	48

IsCustomizable

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

Name

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

StateCode

资产	价值
Description	连接角色的状态。
显示名称	地位
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statecode`
RequiredLevel	系统必填
类型	State
默认表单值	0
全局选择名称	`connectionrole_statecode`

州代码选择/选项

价值	详细信息
0	标签：活跃默认状态：1 不变量名称： `Active`
1	标签：不活跃默认状态：2 不变量名称： `Inactive`

状态码

资产	价值
Description	连接角色状态的原因。
显示名称	状态描述
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statuscode`
RequiredLevel	None
类型	状态
默认表单值	-1
全局选择名称	`connectionrole_statuscode`

StatusCode 选择/选项

价值	详细信息
1	标签：活跃状态：0 TransitionData：无
2	标签：不活跃状态：1 TransitionData：无

只读列/属性

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

组件状态
ConnectionRoleIdUnique
CreatedBy
创建时间
创建时BehalfBy
是托管的
ModifiedBy
修改时间
ModifiedOnBehalfBy
组织 ID
覆盖时间
解决方案 ID
支持解决方案 Id
版本编号

组件状态

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

ComponentState 选择/选项

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

ConnectionRoleIdUnique

资产	价值
Description	已发布或未发布的连接角色记录的唯一标识符。
显示名称	唯一 ID
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`connectionroleidunique`
RequiredLevel	系统必填
类型	Uniqueidentifier

CreatedBy

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

CreatedOn

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

创建时BehalfBy

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

IsManaged

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

ModifiedBy

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

修改时间

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

ModifiedOnBehalfBy

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

组织ID

资产	价值
Description	此连接角色所属的组织的唯一标识符。
显示名称	组织
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`organizationid`
RequiredLevel	系统必填
类型	查找
Targets	组织

覆盖时间

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

解决方案 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 列出。

createdby_connection_role
lk_connectionrolebase_createdonbehalfby
lk_connectionrolebase_modifiedonbehalfby
modifiedby_connection_role
organization_connection_roles

createdby_connection_role

一To-Many 关系： systemuser createdby_connection_role

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

lk_connectionrolebase_createdonbehalfby

一To-Many 关系： systemuser lk_connectionrolebase_createdonbehalfby

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

lk_connectionrolebase_modifiedonbehalfby

一To-Many 关系： systemuser lk_connectionrolebase_modifiedonbehalfby

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

modifiedby_connection_role

一To-Many 关系： systemuser modifiedby_connection_role

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

organization_connection_roles

一To-Many 关系：组织organization_connection_roles

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

一对多关系

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

Connection_Role_AsyncOperations
connection_role_connections1
connection_role_connections2
ConnectionRole_ProcessSessions
ConnectionRole_SyncErrors

Connection_Role_AsyncOperations

多To-One 关系：异步Connection_Role_AsyncOperations

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

connection_role_connections1

多To-One 关系：连接connection_role_connections1

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

connection_role_connections2

多To-One 关系：连接connection_role_connections2

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

ConnectionRole_ProcessSessions

多To-One 关系：进程限制ConnectionRole_ProcessSessions

资产	价值
引用实体	`processsession`
引用属性	`regardingobjectid`
引用实体导航属性名称	`ConnectionRole_ProcessSessions`
IsCustomizable	`False`
关联菜单配置	可用离线：True 行为： `UseCollectionName` 群： `Details` 标签： MenuId：空订货量： 110 QueryApi：空视图 ID： `00000000-0000-0000-0000-000000000000`

ConnectionRole_SyncErrors

多To-One 关系：同步器ConnectionRole_SyncErrors

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

多对多关系

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

connectionroleassociation_association

这是一种自我引用的多对多关系。

资产	价值
相交实体名称	`connectionroleassociation`
IsCustomizable	假
SchemaName	`connectionroleassociation_association`
实体 1IntersectAttribute	`connectionroleid`
实体 2 相交属性	`associatedconnectionroleid`
实体1导航属性名称	`connectionroleassociation_association`
实体2导航属性名称	`connectionroleassociation_association`
实体 1AssociatedMenuConfiguration	可用离线：True 行为： `DoNotDisplay` 群： `Details` 标签： MenuId：空次序： QueryApi：空视图 ID： `00000000-0000-0000-0000-000000000000`
Entity2AssociatedMenuConfiguration	可用离线：True 行为： `DoNotDisplay` 群： `Details` 标签： MenuId：空次序： QueryApi：空视图 ID： `00000000-0000-0000-0000-000000000000`

另请参阅

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

反馈

此页面是否有帮助？