查看（SavedQuery）表/实体引用（Microsoft Dataverse）

2025-10-04

针对数据库保存的查询。

Messages

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

名称是事件？	Web API 操作	SDK for .NET
`Associate` 事件：True	关联记录	关联记录
`Create` 事件：False	`POST` /savedqueries 请参阅创建	创建记录
`Delete` 事件：False	`DELETE` /savedqueries（savedqueryid）请参阅删除	删除记录
`Disassociate` 事件：True	取消关联记录	取消关联记录
`ExecuteByIdSavedQuery` 事件：True		ExecuteByIdSavedQueryRequest
`ExecuteByIdUserQuery` 事件：True		ExecuteByIdUserQueryRequest
`InstantiateFilters` 事件：False	InstantiateFilters	InstantiateFiltersRequest
`Retrieve` 事件：True	`GET` /savedqueries（savedqueryid）请参阅检索	检索记录
`RetrieveMultiple` 事件：True	`GET` /savedqueries 查看查询数据	查询数据
`RetrieveUnpublished` 事件：False	RetrieveUnpublished	RetrieveUnpublishedRequest
`RetrieveUnpublishedMultiple` 事件：False	RetrieveUnpublishedMultiple	RetrieveUnpublishedMultipleRequest
`SetState` 事件：True	`PATCH` /savedqueries（savedqueryid）更新`statecode` 和 `statuscode` 属性。	SetStateRequest
`Update` 事件：False	`PATCH` /savedqueries（savedqueryid）查看更新	更新记录
`Upsert` 事件：False	`PATCH` /savedqueries（savedqueryid）请参阅更新插入表行	UpsertRequest
`Validate` 事件：False	Validate	ValidateRequest
`ValidateSavedQuery` 事件：False	ValidateSavedQuery	ValidateSavedQueryRequest
`ValidateUnpublished` 事件：False	ValidateUnpublished	ValidateUnpublishedRequest

属性

下表列出了视图（SavedQuery）表的选定属性。

资产	价值
显示名称	View
显示集合名称	Views
架构名称	`SavedQuery`
集合架构名称	`SavedQueries`
实体集名称	`savedqueries`
逻辑名称	`savedquery`
逻辑集合名称	`savedqueries`
PrimaryId属性	`savedqueryid`
PrimaryName属性	`name`
表类型	`Standard`
所有权类型	`OrganizationOwned`

可写列/属性

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

AdvancedGroupBy
CanBeDeleted
ColumnSetXml
ConditionalFormatting
说明
启用交叉分区
FetchXml
Introduced版本
是可定制的
默认值
IsQuickFindQuery
LayoutJson
LayoutXml
名称
OfflineSqlQuery
QueryAppUsage
QueryType
ReturnedTypeCode
RoleDisplayConditionsXml
SavedQueryId
州代码
状态代码

AdvancedGroupBy

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

CanBeDeleted

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

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 （形式有效）	假
IsValidForRead	True
LogicalName	`description`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	True
MaxLength （最大长度）	2000

启用交叉分区

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

FetchXml

资产	价值
Description	使用 Fetch XML 语言指定查询的字符串。
显示名称	获取 XML
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`fetchxml`
RequiredLevel	None
类型	备忘录
Format	文本区域
格式名称	文本区域
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

IntroducedVersion

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

IsCustomizable

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

IsDefault

资产	价值
Description	指示视图是否为指定记录类型（实体）的默认视图。
显示名称	默认
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`isdefault`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`savedquery_isdefault`
默认值	假
真实标签	是的
虚假标签	否

IsQuickFindQuery

资产	价值
Description	选择视图是否与快速查找兼容。当用户搜索特定项时，可以定义在其中搜索的字段。
显示名称	快速查找兼容
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`isquickfindquery`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`savedquery_isquickfindquery`
默认值	假
真实标签	是的
虚假标签	否

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 （形式有效）	假
IsValidForRead	True
LogicalName	`name`
RequiredLevel	系统必填
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	True
MaxLength （最大长度）	200

OfflineSqlQuery

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

QueryAppUsage

资产	价值
Description	仅供内部使用。
显示名称	查询应用程序使用情况
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`queryappusage`
RequiredLevel	None
类型	整数
最大值	1000000000
最小值	0

QueryType

资产	价值
Description	显示查询的类型。
显示名称	查询类型
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`querytype`
RequiredLevel	系统必填
类型	整数
最大值	1000000000
最小值	0

ReturnedTypeCode

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

RoleDisplayConditionsXml

资产	价值
Description	包含 SavedQuery 的角色显示条件。
显示名称	SavedQuery 的角色显示条件
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`roledisplayconditionsxml`
RequiredLevel	None
类型	备忘录
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	1073741823

SavedQueryId

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

StateCode

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

州代码选择/选项

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

状态码

资产	价值
Description	显示说明记录状态的原因代码。
显示名称	状态描述
IsValidForForm （形式有效）	True
IsValidForRead	True
LogicalName	`statuscode`
RequiredLevel	None
类型	状态
默认表单值	-1
全局选择名称	`savedquery_statuscode`

StatusCode 选择/选项

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

只读列/属性

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

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

组件状态

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

创建时BehalfBy

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

IsCustom

资产	价值
Description	指示用户是否创建了视图。
显示名称	是自定义的
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`iscustom`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`savedquery_iscustom`
默认值	True
真实标签	是的
虚假标签	否

IsManaged

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

IsPrivate

资产	价值
Description	指示整个组织是否可以查看此情况。
显示名称	私人
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`isprivate`
RequiredLevel	系统必填
类型	布尔
全局选择名称	`savedquery_isprivate`
默认值	假
真实标签	是的
虚假标签	否

IsUserDefined

资产	价值
Description	指示视图是否由用户创建。
显示名称	用户定义的
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`isuserdefined`
RequiredLevel	None
类型	布尔
全局选择名称	`savedquery_isuserdefined`
默认值	True
真实标签	是的
虚假标签	否

ModifiedBy

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

修改时间

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

ModifiedOnBehalfBy

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

组织ID

资产	价值
Description	选择与记录关联的组织的 ID。
显示名称	组织
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`organizationid`
RequiredLevel	系统必填
类型	查找
Targets	组织

OrganizationTabOrder

资产	价值
Description	对于组织，键入 Tab 键以确定用户如何使用 Tab 键在屏幕中导航。
显示名称	默认组织选项卡顺序
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`organizationtaborder`
RequiredLevel	None
类型	整数
最大值	2147483647
最小值	0

覆盖时间

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

QueryAPI

资产	价值
Description	仅供内部使用。
显示名称	查询 API
IsValidForForm （形式有效）	假
IsValidForRead	True
LogicalName	`queryapi`
RequiredLevel	None
类型	String
Format	文本
格式名称	文本
ImeMode	Auto
是可本地化的	假
MaxLength （最大长度）	100

SavedQueryIdUnique

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

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

lk_savedquery_createdonbehalfby
lk_savedquery_modifiedonbehalfby
lk_savedquerybase_createdby
lk_savedquerybase_modifiedby
organization_saved_queries

lk_savedquery_createdonbehalfby

一To-Many 关系： systemuser lk_savedquery_createdonbehalfby

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

lk_savedquery_modifiedonbehalfby

一To-Many 关系： systemuser lk_savedquery_modifiedonbehalfby

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

lk_savedquerybase_createdby

单To-Many 关系： systemuser lk_savedquerybase_createdby

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

lk_savedquerybase_modifiedby

一To-Many 关系： systemuser lk_savedquerybase_modifiedby

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

organization_saved_queries

一To-Many 关系：组织organization_saved_queries

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

一对多关系

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

lk_mobileofflineprofileitem_savedquery
SavedQuery_AsyncOperations
SavedQuery_BulkDeleteFailures
SavedQuery_SyncErrors

lk_mobileofflineprofileitem_savedquery

多To-One 关系： mobileofflineprofileitem lk_mobileofflineprofileitem_savedquery

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

SavedQuery_AsyncOperations

多To-One 关系：异步SavedQuery_AsyncOperations

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

SavedQuery_BulkDeleteFailures

多To-One 关系： bulkdeletefailure SavedQuery_BulkDeleteFailures

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

SavedQuery_SyncErrors

多To-One 关系：同步器SavedQuery_SyncErrors

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

另请参阅

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

反馈

此页面是否有帮助？