檢視 （SavedQuery） 資料表/實體參考 （Microsoft Dataverse）

已儲存針對資料庫的查詢。

Messages

下表列出檢視 （SavedQuery） 資料表的訊息。 訊息代表可以在表格上執行的作業。 它們也可能是事件。

名字 是事件嗎？	Web API 作業	SDK for .NET
Associate 事件：真實	關聯記錄	關聯記錄
Create 事件：False	POST /saved查詢 請參閱 建立	建立記錄
Delete 事件：False	DELETE /savedqueries（savedqueryid） 請參閱 刪除	刪除記錄
Disassociate 事件：真實	取消關聯記錄	取消關聯記錄
ExecuteByIdSavedQuery 事件：真實		ExecuteByIdSavedQueryRequest
ExecuteByIdUserQuery 事件：真實		ExecuteByIdUserQueryRequest
InstantiateFilters 事件：False	InstantiateFilters	InstantiateFiltersRequest
Retrieve 事件：真實	GET /savedqueries（savedqueryid） 請參閱 擷取	擷取記錄
RetrieveMultiple 事件：真實	GET /saved查詢 請參閱 查詢資料	查詢數據
RetrieveUnpublished 事件：False	RetrieveUnpublished	RetrieveUnpublishedRequest
RetrieveUnpublishedMultiple 事件：False	RetrieveUnpublishedMultiple	RetrieveUnpublishedMultipleRequest
SetState 事件：真實	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

屬性

下表列出 View （SavedQuery） 資料表的選取屬性。

房產	價值觀
DisplayName	視圖
顯示集合名稱	Views
結構描述名稱	SavedQuery
集合架構名稱	SavedQueries
實體集名稱	savedqueries
邏輯名稱	savedquery
邏輯集合名稱	savedqueries
PrimaryId屬性	savedqueryid
PrimaryName屬性	name
表格類型	Standard
擁有權類型	OrganizationOwned

可寫入的資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 或 IsValidForUpdate 傳回 true （通常兩者）。 依 SchemaName 列出。

• 進階群組依據
• 可以刪除
• 資料行集 Xml
• 條件式格式設定
• 說明
• 啟用交叉分割區
• FetchXml
• Introduced版本
• 是可自訂的
• 預設值
• IsQuickFind查詢
• 佈局 Json
• 佈局 Xml
• 名稱
• 離線Sql查詢
• QueryApp使用方式
• 查詢類型
• 傳回類型代碼
• RoleDisplayConditionsXml
• SavedQueryId
• 州代碼
• 狀態代碼

進階群組依據

房產	價值觀
Description	輸入直欄名稱，用於將系統視圖中跨多個記錄收集的資料結果分組。
顯示名稱	進階分組依據
IsValidForForm	否
IsValidForRead	對
LogicalName	advancedgroupby
RequiredLevel	None
類型	繩子
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	2000

可以刪除

房產	價值觀
Description	指出是否可以刪除視圖。
顯示名稱	可以刪除
IsValidForForm	否
IsValidForRead	對
LogicalName	canbedeleted
RequiredLevel	系統必要
類型	ManagedProperty

資料行集 Xml

房產	價值觀
Description	包含視圖的欄和排序準則，以 XML 格式儲存。
顯示名稱	資料行集 XML
IsValidForForm	否
IsValidForRead	對
LogicalName	columnsetxml
RequiredLevel	None
類型	備忘錄
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	1073741823

條件式格式設定

房產	價值觀
Description	輸入系統視圖中項目格式化方式的相關資訊。
顯示名稱	條件式格式設定
IsValidForForm	否
IsValidForRead	對
LogicalName	conditionalformatting
RequiredLevel	None
類型	備忘錄
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	1073741823

Description

房產	價值觀
Description	輸入其他資訊來描述檢視，例如篩選條件或預期結果集。
顯示名稱	說明
IsValidForForm	否
IsValidForRead	對
LogicalName	description
RequiredLevel	None
類型	備忘錄
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	對
最大長度	2000

啟用交叉分割區

房產	價值觀
Description	指出視圖是否可以從所有叢集分割區擷取資料。
顯示名稱	預設值
IsValidForForm	否
IsValidForRead	對
LogicalName	enablecrosspartition
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	savedquery_enablecrosspartition
預設值	否
真實標籤	Yes
虛假標籤	否

FetchXml

房產	價值觀
Description	以 Fetch XML 語言指定查詢的字串。
顯示名稱	擷取 XML
IsValidForForm	否
IsValidForRead	對
LogicalName	fetchxml
RequiredLevel	None
類型	備忘錄
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	1073741823

IntroducedVersion

房產	價值觀
Description	引入表格的版本。
顯示名稱	引進版本
IsValidForForm	否
IsValidForRead	對
LogicalName	introducedversion
RequiredLevel	None
類型	繩子
格式	版本編號
格式名稱	版本編號
Ime模式	Auto
是可本地化	否
最大長度	48

IsCustomizable

房產	價值觀
Description	告知元件是否可以自訂。
顯示名稱	可定制
IsValidForForm	否
IsValidForRead	對
LogicalName	iscustomizable
RequiredLevel	系統必要
類型	ManagedProperty

IsDefault

房產	價值觀
Description	指出檢視是否為指定記錄類型 （實體） 的預設檢視。
顯示名稱	預設值
IsValidForForm	否
IsValidForRead	對
LogicalName	isdefault
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	savedquery_isdefault
預設值	否
真實標籤	Yes
虛假標籤	否

IsQuickFind查詢

房產	價值觀
Description	選擇檢視是否與「快速尋找」相容。 當使用者搜尋特定項目時，您可以定義要搜尋的欄位。
顯示名稱	快速查找兼容
IsValidForForm	否
IsValidForRead	對
LogicalName	isquickfindquery
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	savedquery_isquickfindquery
預設值	否
真實標籤	Yes
虛假標籤	否

佈局 Json

房產	價值觀
Description	以 JSON 格式配置資料。
顯示名稱	以 JSON 格式配置資料。
IsValidForForm	否
IsValidForRead	對
LogicalName	layoutjson
RequiredLevel	None
類型	備忘錄
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	1073741823

佈局 Xml

房產	價值觀
Description	僅供內部使用。
顯示名稱	版面配置 XML
IsValidForForm	否
IsValidForRead	對
LogicalName	layoutxml
RequiredLevel	None
類型	備忘錄
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	1073741823

名稱

房產	價值觀
Description	輸入視圖的名稱，以描述視圖將包含哪些結果。 此名稱對「檢視」清單中的使用者可見。
顯示名稱	名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	name
RequiredLevel	系統必要
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	對
最大長度	200

離線Sql查詢

房產	價值觀
Description	指定指定離線使用的提取 xml 對應 SQL 查詢的字串。
顯示名稱	離線 SQL 查詢
IsValidForForm	否
IsValidForRead	對
LogicalName	offlinesqlquery
RequiredLevel	None
類型	備忘錄
格式	文字區域
格式名稱	文字區域
Ime模式	Auto
是可本地化	否
最大長度	1073741823

QueryApp使用方式

房產	價值觀
Description	僅供內部使用。
顯示名稱	查詢應用程式使用情況
IsValidForForm	否
IsValidForRead	對
LogicalName	queryappusage
RequiredLevel	None
類型	整數
最大值	1000000000
最小值	0

QueryType

房產	價值觀
Description	顯示查詢的類型。
顯示名稱	查詢類型
IsValidForForm	否
IsValidForRead	對
LogicalName	querytype
RequiredLevel	系統必要
類型	整數
最大值	1000000000
最小值	0

傳回類型代碼

房產	價值觀
Description	檢視中顯示的實體類型。
顯示名稱	實體名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	returnedtypecode
RequiredLevel	系統必要
類型	實體名稱

RoleDisplayConditionsXml

房產	價值觀
Description	包含 SavedQuery 的角色顯示條件。
顯示名稱	SavedQuery 的角色顯示條件
IsValidForForm	否
IsValidForRead	對
LogicalName	roledisplayconditionsxml
RequiredLevel	None
類型	備忘錄
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	1073741823

SavedQueryId

房產	價值觀
Description	檢視的唯一識別碼。
顯示名稱	視圖
IsValidForForm	否
IsValidForRead	對
LogicalName	savedqueryid
RequiredLevel	系統必要
類型	Uniqueidentifier

StateCode

房產	價值觀
Description	顯示視圖的狀態。
顯示名稱	狀態
IsValidForForm	對
IsValidForRead	對
LogicalName	statecode
RequiredLevel	系統必要
類型	State
預設形式值	0
GlobalChoiceName	savedquery_statecode

StateCode 選擇/選項

價值觀	詳細資訊
0	標籤： 活躍 預設狀態：1 不變量名稱： Active
1	標籤： 非活動 預設狀態：2 不變量名稱： Inactive

StatusCode（狀態碼）

房產	價值觀
Description	顯示說明記錄狀態的原因代碼。
顯示名稱	狀態原因
IsValidForForm	對
IsValidForRead	對
LogicalName	statuscode
RequiredLevel	None
類型	地位
預設形式值	-1
GlobalChoiceName	savedquery_statuscode

StatusCode 選項/選項

價值觀	詳細資訊
1	標籤： 活躍 狀態：0 TransitionData：無
2	標籤： 非活動 狀態：1 TransitionData：無

唯讀資料行/屬性

這些資料行/屬性會針對 IsValidForCreate 和 IsValidForUpdate 傳回 false。 依 SchemaName 列出。

• 元件狀態
• 建立者
• 創建日期
• CreatedOnBehalfBy
• 是自訂
• 是受控
• 是私人的
• IsUser定義
• 修改者
• 修改時
• ModifiedOnBehalfBy
• 組織標識符
• 組織索引標籤順序
• 覆蓋時間
• 查詢API
• SavedQueryIdUnique
• 解決方案標識碼
• 支援解決方案標識碼
• 版本編號

元件狀態

房產	價值觀
Description	僅供內部使用。
顯示名稱	元件狀態
IsValidForForm	否
IsValidForRead	對
LogicalName	componentstate
RequiredLevel	系統必要
類型	選擇清單
預設形式值	-1
GlobalChoiceName	componentstate

ComponentState 選擇/選項

價值觀	標籤
0	已發佈
1	已解除發佈
2	已刪除
3	已刪除，未發布

CreatedBy

房產	價值觀
Description	顯示記錄的建立者。
顯示名稱	創建者
IsValidForForm	否
IsValidForRead	對
LogicalName	createdby
RequiredLevel	None
類型	查詢
Targets	systemuser

創建日期

房產	價值觀
Description	顯示建立記錄的日期和時間。 日期和時間會以 Microsoft Dynamics 365 選項中選取的時區顯示。
顯示名稱	建立時間
IsValidForForm	否
IsValidForRead	對
LogicalName	createdon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

CreatedOnBehalfBy

房產	價值觀
Description	顯示誰代表其他使用者建立記錄。
顯示名稱	建立者 （委派）
IsValidForForm	否
IsValidForRead	對
LogicalName	createdonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

是自訂

房產	價值觀
Description	指出使用者是否建立檢視。
顯示名稱	是客製化的
IsValidForForm	否
IsValidForRead	對
LogicalName	iscustom
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	savedquery_iscustom
預設值	對
真實標籤	Yes
虛假標籤	否

IsManaged

房產	價值觀
Description	指出記錄是否為受管理解決方案的一部分。
顯示名稱	州
IsValidForForm	否
IsValidForRead	對
LogicalName	ismanaged
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	ismanaged
預設值	否
真實標籤	受控
虛假標籤	未受管理

IsPrivate

房產	價值觀
Description	指出整個組織是否可檢視此專案。
顯示名稱	是私人的
IsValidForForm	否
IsValidForRead	對
LogicalName	isprivate
RequiredLevel	系統必要
類型	布林值
GlobalChoiceName	savedquery_isprivate
預設值	否
真實標籤	Yes
虛假標籤	否

IsUser定義

房產	價值觀
Description	指出檢視是否是由使用者建立的。
顯示名稱	使用者定義
IsValidForForm	否
IsValidForRead	對
LogicalName	isuserdefined
RequiredLevel	None
類型	布林值
GlobalChoiceName	savedquery_isuserdefined
預設值	對
真實標籤	Yes
虛假標籤	否

ModifiedBy

房產	價值觀
Description	顯示上次更新記錄的人員。
顯示名稱	修改者
IsValidForForm	否
IsValidForRead	對
LogicalName	modifiedby
RequiredLevel	None
類型	查詢
Targets	systemuser

修改時

房產	價值觀
Description	顯示記錄上次更新的日期和時間。 日期和時間會以 Microsoft Dynamics 365 選項中選取的時區顯示。
顯示名稱	修改於
IsValidForForm	否
IsValidForRead	對
LogicalName	modifiedon
RequiredLevel	None
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	日期與時間
Ime模式	停用
來源類型遮罩	0

ModifiedOnBehalfBy

房產	價值觀
Description	顯示上次代表其他使用者更新記錄的人員。
顯示名稱	修改者 （委派）
IsValidForForm	否
IsValidForRead	對
LogicalName	modifiedonbehalfby
RequiredLevel	None
類型	查詢
Targets	systemuser

組織識別碼

房產	價值觀
Description	選擇與記錄相關聯之組織的 ID。
顯示名稱	組織
IsValidForForm	否
IsValidForRead	對
LogicalName	organizationid
RequiredLevel	系統必要
類型	查詢
Targets	組織

組織索引標籤順序

房產	價值觀
Description	對於組織，請鍵入 Tab 順序，以決定使用者如何僅使用 Tab 鍵瀏覽畫面。
顯示名稱	預設組織 Tab 鍵順序
IsValidForForm	否
IsValidForRead	對
LogicalName	organizationtaborder
RequiredLevel	None
類型	整數
最大值	2147483647
最小值	0

覆蓋時間

房產	價值觀
Description	僅供內部使用。
顯示名稱	記錄覆蓋時間
IsValidForForm	否
IsValidForRead	對
LogicalName	overwritetime
RequiredLevel	系統必要
類型	DateTime
CanChangeDateTime行為	否
日期時間行為	使用者本機
格式	DateOnly
Ime模式	停用
來源類型遮罩	0

查詢API

房產	價值觀
Description	僅供內部使用。
顯示名稱	查詢 API
IsValidForForm	否
IsValidForRead	對
LogicalName	queryapi
RequiredLevel	None
類型	繩子
格式	文字
格式名稱	文字
Ime模式	Auto
是可本地化	否
最大長度	100

SavedQueryIdUnique

房產	價值觀
Description	僅供內部使用。
顯示名稱
IsValidForForm	否
IsValidForRead	對
LogicalName	savedqueryidunique
RequiredLevel	系統必要
類型	Uniqueidentifier

解決方案標識碼

房產	價值觀
Description	相關聯解決方案的唯一識別碼。
顯示名稱	Solution
IsValidForForm	否
IsValidForRead	對
LogicalName	solutionid
RequiredLevel	系統必要
類型	Uniqueidentifier

支援解決方案標識碼

房產	價值觀
Description	僅供內部使用。
顯示名稱	Solution
IsValidForForm	否
IsValidForRead	否
LogicalName	supportingsolutionid
RequiredLevel	None
類型	Uniqueidentifier

版本編號

房產	價值觀
Description	檢視的版本號碼。
顯示名稱	版本號碼
IsValidForForm	否
IsValidForRead	對
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
ReferencingAttribute	createdonbehalfby
ReferencingEntityNavigationPropertyName	createdonbehalfby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_savedquery_modifiedonbehalfby

一To-Many 關係： systemuser lk_savedquery_modifiedonbehalfby

房產	價值觀
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	modifiedonbehalfby
ReferencingEntityNavigationPropertyName	modifiedonbehalfby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_savedquerybase_createdby

一To-Many 關係： systemuser lk_savedquerybase_createdby

房產	價值觀
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	createdby
ReferencingEntityNavigationPropertyName	createdby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

lk_savedquerybase_modifiedby

一To-Many 關係： 系統使用者lk_savedquerybase_modifiedby

房產	價值觀
參考實體	systemuser
參考屬性	systemuserid
ReferencingAttribute	modifiedby
ReferencingEntityNavigationPropertyName	modifiedby
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

organization_saved_queries

一To-Many 關係： 組織organization_saved_queries

房產	價值觀
參考實體	organization
參考屬性	organizationid
ReferencingAttribute	organizationid
ReferencingEntityNavigationPropertyName	organizationid
是階層式
CascadeConfiguration	存檔： NoCascade 指派： NoCascade 刪除： NoCascade 合併： NoCascade 重新父項： NoCascade RollupView： NoCascade 共： NoCascade 取消分享： NoCascade

一對多關係

這些關係是一對多的。 依 SchemaName 列出。

• lk_mobileofflineprofileitem_savedquery
• SavedQuery_AsyncOperations
• SavedQuery_BulkDeleteFailures
• SavedQuery_SyncErrors

lk_mobileofflineprofileitem_savedquery

多To-One 關係： mobileofflineprofile項目lk_mobileofflineprofileitem_savedquery

房產	價值觀
ReferencingEntity	mobileofflineprofileitem
ReferencingAttribute	profileitemrule
參考實體導航屬性名稱	lk_mobileofflineprofileitem_savedquery
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

SavedQuery_AsyncOperations

多To-One 關係： 非同步操作SavedQuery_AsyncOperations

房產	價值觀
ReferencingEntity	asyncoperation
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	SavedQuery_AsyncOperations
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

SavedQuery_BulkDeleteFailures

多To-One 關係： bulkdeletefailure SavedQuery_BulkDeleteFailures

房產	價值觀
ReferencingEntity	bulkdeletefailure
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	SavedQuery_BulkDeleteFailures
IsCustomizable	False
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

SavedQuery_SyncErrors

多To-One 關係： syncerror SavedQuery_SyncErrors

房產	價值觀
ReferencingEntity	syncerror
ReferencingAttribute	regardingobjectid
參考實體導航屬性名稱	SavedQuery_SyncErrors
IsCustomizable	True
關聯功能表配置	可用離線：True 態度： DoNotDisplay 隊： Details 標籤： MenuId：空值 次： QueryApi：空 檢視標識碼： 00000000-0000-0000-0000-000000000000

另請參閱

Dataverse 資料表/實體參考
Dataverse Web API 參考
savedquery