IViewメタデータキャッシュ

IViewMetadataCacheサービスはDataverseビュー(保存されたクエリ)メタデータへのキャッシュアクセスを提供します。ビューは初回アクセス時にDataverseから取得され、その後のリクエストのためにキャッシュされます。

IDによるビューの取得

ビューのGUIDと GetAsync を組み合わせて、単一のビューのメタデータ(FetchXMLクエリ、列、表示設定など)を取得します。

React

Blazor

テーブルの全ビューを取得する方法

GetAllViewsForTableAsyncを使って特定のテーブルのすべてのビューを取得します。公開閲覧、クイック検索閲覧、検索閲覧のみをViewTypeで絞り込むことができます。

React

Blazor

ヒント
閲覧用ビューメタデータにはIPowerPortalsProService.RetrieveViewMetadataAsyncよりIViewMetadataCacheを好む。キャッシュは冗長なネットワーク呼び出しを避け、すべてのPowerPortalsProグリッドコンポーネントで内部的に利用されます。

IViewMetadataCache Interface

方法

名称	パラメータ	種類	概要
`GetAllViewsForTableAsync`	string tableName	Task<IEnumerable<ViewMetadata>>	指定されたテーブルのすべてのキャッシュされたビューメタデータ(公開ビュー、システムビュー、ユーザー定義ビューを含む)を返します。
`GetAsync`	Guid key CancellationToken token	Task<ViewMetadata>	キーでキャッシュからアイテムを取得します。もしアイテムがキャッシュされていない場合は、基底のソースからフェッチされ、キャッシュされて返されます。

名称: GetAllViewsForTableAsync

パラメータ: string tableName

種類: Task<IEnumerable<ViewMetadata>>

概要: 指定されたテーブルのすべてのキャッシュされたビューメタデータ(公開ビュー、システムビュー、ユーザー定義ビューを含む)を返します。

名称: GetAsync

パラメータ: Guid key
CancellationToken token

種類: Task<ViewMetadata>

概要: キーでキャッシュからアイテムを取得します。もしアイテムがキャッシュされていない場合は、基底のソースからフェッチされ、キャッシュされて返されます。

ViewMetadata クラス

性質

名称	種類	デフォルト	概要
`Columns`	List<ViewColumn>		グリッドに表示される列、論理名やピクセル幅も含めて。
`DisplayName`	string?		このビューの表示名はオプションです。設定すると、これはデフォルトのラベルとして使われます。「選択機能のドロップダウンを見る」ローカライゼーション項目はテーブル。{TableName}.views。{Id}.label が存在する場合は優先されます。
`FetchXml`	string		このビューでどのレコードや列が取得されるかを定義するFetchXMLクエリです。
`IsDefault`	bool	False	これがテーブルのデフォルトビューかどうかを示します。
`Name`	string		ビューの表示名。
`QuickFindCompatible`	bool	False	このビューがクイックファインド検索に対応しているかどうかを示します。
`TableName`	string		このビューがクエリするDataverseテーブルの論理名。
`Type`	ViewType?		ビューの種類(Public、AdvancedFind、Associated、QuickFind、Lookupなど)。
`UserDefined`	bool	False	このビューがユーザーによって作成された(true)かシステムビュー(false)かを示します。

名称: Columns

種類: List<ViewColumn>

概要: グリッドに表示される列、論理名やピクセル幅も含めて。

名称: DisplayName

種類: string?

概要: このビューの表示名はオプションです。設定すると、これはデフォルトのラベルとして使われます。「選択機能のドロップダウンを見る」ローカライゼーション項目はテーブル。{TableName}.views。{Id}.label が存在する場合は優先されます。

名称: FetchXml

種類: string

概要: このビューでどのレコードや列が取得されるかを定義するFetchXMLクエリです。

名称: IsDefault

種類: bool

デフォルト: False

概要: これがテーブルのデフォルトビューかどうかを示します。

名称: Name

種類: string

概要: ビューの表示名。

名称: QuickFindCompatible

種類: bool

デフォルト: False

概要: このビューがクイックファインド検索に対応しているかどうかを示します。

名称: TableName

種類: string

概要: このビューがクエリするDataverseテーブルの論理名。

名称: Type

種類: ViewType?

概要: ビューの種類(Public、AdvancedFind、Associated、QuickFind、Lookupなど)。

名称: UserDefined

種類: bool

デフォルト: False

概要: このビューがユーザーによって作成された(true)かシステムビュー(false)かを示します。