特征表/实体引用（Microsoft Dataverse）

2025-10-04

Messages

下表列出了特征表的消息。消息表示可以在表上执行的作。它们也可能是事件。

名称是事件？	Web API 操作	SDK for .NET
`Assign` 事件：True	`PATCH` /traits（traitid）更新`ownerid`属性。	AssignRequest
`Associate` 事件：True	关联记录	关联记录
`Create` 事件：True	`POST` /性状请参阅创建	创建记录
`CreateMultiple` 事件：True	CreateMultiple	CreateMultipleRequest
`Delete` 事件：True	`DELETE` /traits（traitid）请参阅删除	删除记录
`DeleteMultiple` 事件：True	DeleteMultiple	了解如何将消息与 SDK for .NET 配合使用
`Disassociate` 事件：True	取消关联记录	取消关联记录
`Retrieve` 事件：True	`GET` /traits（traitid）请参阅检索	检索记录
`RetrieveEntityChanges` 事件：True		RetrieveEntityChangesRequest
`RetrieveMultiple` 事件：True	`GET` /性状查看查询数据	查询数据
`RetrievePrincipalAccess` 事件：True	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
`Update` 事件：True	`PATCH` /traits（traitid）查看更新	更新记录
`UpdateMultiple` 事件：True	UpdateMultiple	UpdateMultipleRequest
`Upsert` 事件：True	`PATCH` /traits（traitid）请参阅更新插入表行	UpsertRequest
`UpsertMultiple` 事件：True	UpsertMultiple	UpsertMultipleRequest

事件

下表列出了特征表的事件。事件是可供订阅的消息。除非您添加了该事件，否则不应调用该消息，仅可订阅它。

Name	Web API 操作	SDK for .NET
`BulkRetain`	BulkRetain	了解如何将消息与 SDK for .NET 配合使用
`PurgeRetainedContent`	PurgeRetainedContent	了解如何将消息与 SDK for .NET 配合使用
`Retain`	Retain	了解如何将消息与 SDK for .NET 配合使用
`RollbackRetain`	RollbackRetain	了解如何将消息与 SDK for .NET 配合使用
`ValidateRetentionConfig`	ValidateRetentionConfig	了解如何将消息与 SDK for .NET 配合使用

属性

下表列出了特征表的选定属性。

资产	价值
显示名称	特性
显示集合名称	性状
架构名称	`trait`
集合架构名称	`traits`
实体集名称	`traits`
逻辑名称	`trait`
逻辑集合名称	`traits`
PrimaryId属性	`traitid`
PrimaryName属性	`name`
表类型	`Elastic`
所有权类型	`UserOwned`

可写列/属性

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

AlternativeKey
内容
导入序列号
name
覆盖创建时间
所有者 ID
所有者 IdType
分区 ID
性能
traitId
TraitType
TTL秒数
UserId

AlternativeKey

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

内容

资产	价值
Description
显示名称	内容
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`contents`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	Json
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1048576

ImportSequenceNumber

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

姓名

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

OverriddenCreatedOn

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

OwnerId

资产	价值
Description	所有者 ID
显示名称	Owner
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`ownerid`
RequiredLevel	系统必填
类型	所有者
Targets	系统用户，团队

所有者 IdType

资产	价值
Description	所有者 ID 类型
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owneridtype`
RequiredLevel	系统必填
类型	实体名称

分区 ID

资产	价值
Description	逻辑分区 ID。逻辑分区由一组具有相同分区 ID 的记录组成。
显示名称	分区 ID
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`partitionid`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

属性

资产	价值
Description
显示名称	性能
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`properties`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	Json
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1048576

traitId

资产	价值
Description	实体实例的唯一标识符
显示名称	TraitId
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`traitid`
RequiredLevel	系统必填
类型	Uniqueidentifier

TraitType

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

TTL秒数

资产	价值
Description	生存时间以秒为单位。
显示名称	活着的时间
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`ttlinseconds`
RequiredLevel	None
类型	整数
最大值	2147483647
最小值	1

UserId

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

只读列/属性

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

CreatedBy
创建时间
创建时BehalfBy
ModifiedBy
修改时间
ModifiedOnBehalfBy
所有者名称
OwnerIdYomiName
拥有业务单位
拥有团队
拥有用户
版本编号

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

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

所有者名称

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

OwnerIdYomiName

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

拥有业务单位

资产	价值
Description	拥有记录的业务部门的唯一标识符
显示名称	拥有业务单位
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`owningbusinessunit`
RequiredLevel	None
类型	查找
Targets	业务单位

拥有团队

资产	价值
Description	拥有记录的团队的唯一标识符。
显示名称	拥有团队
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owningteam`
RequiredLevel	None
类型	查找
Targets	团队

拥有用户

资产	价值
Description	拥有记录的用户的唯一标识符。
显示名称	拥有用户
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owninguser`
RequiredLevel	None
类型	查找
Targets	systemuser

版本号

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

多对一关系

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

business_unit_trait
lk_trait_createdby
lk_trait_createdonbehalfby
lk_trait_modifiedby
lk_trait_modifiedonbehalfby
owner_trait
team_trait
user_trait

business_unit_trait

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

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

lk_trait_createdby

一To-Many 关系： systemuser lk_trait_createdby

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

lk_trait_createdonbehalfby

一To-Many 关系： systemuser lk_trait_createdonbehalfby

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

lk_trait_modifiedby

单To-Many 关系： systemuser lk_trait_modifiedby

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

lk_trait_modifiedonbehalfby

一To-Many 关系： systemuser lk_trait_modifiedonbehalfby

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

owner_trait

一To-Many 关系：所有者owner_trait

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

team_trait

一To-Many 关系：团队team_trait

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

user_trait

单To-Many 关系： systemuser user_trait

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

另请参阅

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

反馈

此页面是否有帮助？