保存的视图（UserQuery）表/实体引用（Microsoft Dataverse）

2025-10-04

已保存的用户拥有的数据库查询。

Messages

下表列出了保存的视图（UserQuery）表的消息。消息表示可以在表上执行的作。它们也可能是事件。

名称是事件？	Web API 操作	SDK for .NET
`Assign` 事件：True	`PATCH` /userqueries（userqueryid）更新`ownerid`属性。	AssignRequest
`Associate` 事件：True	关联记录	关联记录
`Create` 事件：True	`POST` /userqueries 请参阅创建	创建记录
`Delete` 事件：True	`DELETE` /userqueries（userqueryid）请参阅删除	删除记录
`Disassociate` 事件：True	取消关联记录	取消关联记录
`ExecuteByIdSavedQuery` 事件：True		ExecuteByIdSavedQueryRequest
`ExecuteByIdUserQuery` 事件：True		ExecuteByIdUserQueryRequest
`GrantAccess` 事件：True	GrantAccess	GrantAccessRequest
`ModifyAccess` 事件：True	ModifyAccess	ModifyAccessRequest
`Retrieve` 事件：True	`GET` /userqueries（userqueryid）请参阅检索	检索记录
`RetrieveMultiple` 事件：True	`GET` /userqueries 查看查询数据	查询数据
`RetrievePrincipalAccess` 事件：True	RetrievePrincipalAccess	RetrievePrincipalAccessRequest
`RetrieveSharedPrincipalsAndAccess` 事件：True	RetrieveSharedPrincipalsAndAccess	RetrieveSharedPrincipalsAndAccessRequest
`RevokeAccess` 事件：True	RevokeAccess	RevokeAccessRequest
`SetState` 事件：True	`PATCH` /userqueries（userqueryid）更新`statecode` 和 `statuscode` 属性。	SetStateRequest
`Update` 事件：True	`PATCH` /userqueries（userqueryid）查看更新	更新记录
`Upsert` 事件：False	`PATCH` /userqueries（userqueryid）请参阅更新插入表行	UpsertRequest

属性

下表列出了已保存视图（UserQuery）表的选定属性。

资产	价值
显示名称	保存的视图
显示集合名称	保存的视图
架构名称	`UserQuery`
集合架构名称	`UserQueries`
实体集名称	`userqueries`
逻辑名称	`userquery`
逻辑集合名称	`userqueries`
PrimaryId属性	`userqueryid`
PrimaryName属性	`name`
表类型	`Standard`
所有权类型	`UserOwned`

可写列/属性

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

AdvancedGroupBy
ColumnSetXml
ConditionalFormatting
说明
启用交叉分区
FetchXml
LayoutJson
LayoutXml
名称
OfflineSqlQuery
所有者 ID
所有者 IdType
ParentQueryId
QueryType
ReturnedTypeCode
州代码
状态代码
UserQueryId

AdvancedGroupBy

资产	价值
Description	键入列名称，用于对用户视图中跨多个记录收集的数据的结果进行分组。
显示名称	高级分组依据
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`advancedgroupby`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	20

ColumnSetXml

资产	价值
Description	显示保存的视图的列和排序条件，以 XML 格式存储。
显示名称	列集 XML
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`columnsetxml`
RequiredLevel	None
类型	备忘录
Format	文本区域
格式名称	文本区域
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

ConditionalFormatting

资产	价值
Description	键入有关如何设置用户视图中项目格式的信息。
显示名称	用户组依据
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`conditionalformatting`
RequiredLevel	None
类型	备忘录
Format	文本区域
格式名称	文本区域
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

Description

资产	价值
Description	键入其他信息来描述保存的视图，例如筛选条件或预期结果集。
显示名称	说明
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`description`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	2000

启用交叉分区

资产	价值
Description	指示视图是否可以从所有群集分区检索数据。
显示名称	默认
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`enablecrosspartition`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`userquery_enablecrosspartition`
默认值	假
真实标签	是的
虚假标签	否

FetchXml

资产	价值
Description	包含提取 XML 查询，该查询定义保存的视图中包括的实体和属性。
显示名称	获取 XML
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`fetchxml`
RequiredLevel	系统必填
类型	备忘录
Format	文本区域
格式名称	文本区域
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

LayoutJson

资产	价值
Description	采用 JSON 格式布局数据。
显示名称	采用 JSON 格式布局数据。
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`layoutjson`
RequiredLevel	None
类型	备忘录
Format	文本区域
格式名称	文本区域
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

LayoutXml

资产	价值
Description	仅供内部使用。
显示名称	布局 XML
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`layoutxml`
RequiredLevel	None
类型	备忘录
Format	文本区域
格式名称	文本区域
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

Name

资产	价值
Description	键入已保存视图的描述性名称。
显示名称	名称
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`name`
RequiredLevel	系统必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	200

OfflineSqlQuery

资产	价值
Description	指定用于脱机使用的提取 xml 的相应 sql 查询的字符串。
显示名称	脱机 SQL 查询
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`offlinesqlquery`
RequiredLevel	None
类型	备忘录
Format	文本区域
格式名称	文本区域
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

OwnerId

资产	价值
Description	输入分配用于管理记录的用户或团队。每次将记录分配给其他用户时都会更新此字段。
显示名称	Owner
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`ownerid`
RequiredLevel	系统必填
类型	所有者
Targets	系统用户，团队

所有者 IdType

资产	价值
Description	已保存视图的所有者类型，例如用户、团队或业务部门。
显示名称
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`owneridtype`
RequiredLevel	系统必填
类型	实体名称

ParentQueryId

资产	价值
Description	选择从中创建记录的已保存查询的 ID。
显示名称	父查询
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`parentqueryid`
RequiredLevel	None
类型	查找
Targets

QueryType

资产	价值
Description	显示查询类型的代码，以指示保存的视图是通讯簿筛选器、高级搜索还是其他视图。
显示名称	查询类型
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`querytype`
RequiredLevel	系统必填
类型	整数
最大值	1000000000
最小值	0

ReturnedTypeCode

资产	价值
Description	保存的视图显示的实体的类型。
显示名称	返回的类型
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`returnedtypecode`
RequiredLevel	系统必填
类型	实体名称

StateCode

资产	价值
Description	显示保存的视图是活动视图还是非活动视图。
显示名称	地位
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statecode`
RequiredLevel	系统必填
类型	State
默认表单值	0
全局选择名称	`userquery_statecode`

州代码选择/选项

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

状态码

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

StatusCode 选择/选项

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

UserQueryId

资产	价值
Description	已保存视图的唯一标识符。
显示名称	用户查询
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`userqueryid`
RequiredLevel	系统必填
类型	Uniqueidentifier

只读列/属性

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

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

CreatedBy

资产	价值
Description	显示记录的创建者。
显示名称	创建者
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdby`
RequiredLevel	系统必填
类型	查找
Targets	systemuser

CreatedOn

资产	价值
Description	显示创建记录的日期和时间。日期和时间显示在 Microsoft Dynamics 365 选项中选择的时区中。
显示名称	创建时间
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdon`
RequiredLevel	系统必填
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

创建时BehalfBy

资产	价值
Description	显示代表其他用户创建记录的人员。
显示名称	创建者（委托）
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`createdonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

ModifiedBy

资产	价值
Description	显示上次更新记录的人员。
显示名称	修改者
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`modifiedby`
RequiredLevel	系统必填
类型	查找
Targets	systemuser

修改时间

资产	价值
Description	显示上次更新记录的日期和时间。日期和时间显示在 Microsoft Dynamics 365 选项中选择的时区中。
显示名称	上次修改时间
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`modifiedon`
RequiredLevel	系统必填
类型	日期时间
可以更改日期时间行为	假
日期时间行为	用户本地
Format	日期和时间
ImeMode	未激活
源类型掩码	0

ModifiedOnBehalfBy

资产	价值
Description	显示上次代表其他用户更新记录的人员。
显示名称	修改者（委托）
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`modifiedonbehalfby`
RequiredLevel	None
类型	查找
Targets	systemuser

所有者名称

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

OwnerIdYomiName

资产	价值
Description
显示名称
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_userquery
lk_userquery_createdby
lk_userquery_createdonbehalfby
lk_userquery_modifiedby
lk_userquery_modifiedonbehalfby
owner_userquerys
team_userquery
user_userquery

business_unit_userquery

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

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

lk_userquery_createdby

单To-Many 关系： systemuser lk_userquery_createdby

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

lk_userquery_createdonbehalfby

一To-Many 关系： systemuser lk_userquery_createdonbehalfby

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

lk_userquery_modifiedby

一To-Many 关系： systemuser lk_userquery_modifiedby

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

lk_userquery_modifiedonbehalfby

一To-Many 关系： systemuser lk_userquery_modifiedonbehalfby

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

owner_userquerys

一To-Many 关系：所有者owner_userquerys

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

team_userquery

一To-Many 关系：团队team_userquery

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

user_userquery

一To-Many 关系： systemuser user_userquery

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

一对多关系

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

UserQuery_AsyncOperations
UserQuery_BulkDeleteFailures
UserQuery_SyncErrors

UserQuery_AsyncOperations

多To-One 关系：异步UserQuery_AsyncOperations

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

UserQuery_BulkDeleteFailures

多To-One 关系： bulkdeletefailure UserQuery_BulkDeleteFailures

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

UserQuery_SyncErrors

多To-One 关系：同步器UserQuery_SyncErrors

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

另请参阅

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

反馈

此页面是否有帮助？