IPowerPortalsProService

IPowerPortalsProServiceインターフェースは、CRUD操作の実行、クエリの実行、リレーションシップの管理、Dataverseからのメタデータ取得の方法を提供します。PowerPortalsProにおけるサーバー側のデータアクセスの主要なサービスです。

注記
ほとんどの場合、直接電話 IPowerPortalsProService 必要はありません。 RecordContext、 MainContext、グリッドの各コンポーネントはデータ操作を自動的に処理します。標準コンポーネントワークフローの外にあるカスタムロジックにはこのサービスをご利用ください。

サーバーおよびクライアント実装

IPowerPortalsProService フレームワークによって自動的に登録された2つの実装が付属しています — コンポーネントコードは両方で同一であり、ランタイムはアクティブなレンダリングコンテキストに一致するものを注入します:

サーバー実装 (PowerPortalsPro.Web.Server、 AddPowerPortalsProWebServerが登録)— プロセス中で動作し、 IOrganizationServiceを通じてDataverseと直接通信し、読み書き前に ITablePermissionProvider 登録を適用します。ページが InteractiveServerRenderMode または静的SSRでレンダリングされる際に選択されます。
クライアント実装 (PowerPortalsPro.Web.Client、 AddPowerPortalsProWebClient登録)— ブラウザ上でWebAssemblyの下で動作し、Dataverse SDKは一切搭載せず、代わりに各呼び出しをJSONでシリアライズして対応するサーバーサイドのHTTPエンドポイント(/api/table/{name}、 /api/retrieveMultipleなど)に変換します。パーミッションハンドラーは、リクエストがサーバーのエンドポイントに戻るため、依然として適用されます。ワイヤー形式とクライアント実装呼び出しのルートについては、クライアントAPI ページをご覧ください。

契約が同一であるため、同じコンポーネントはサーバー、WebAssembly、Autoのいずれかのインタラクティブモードで動作します。サーバーレンダリングされたページで _powerPortalsProService.RetrieveRecordAsync(...) を呼び出すコードは、進行中のDataverse呼び出しを行います。WASMレンダリングされたページの同じ行がHTTPリクエストを発行します — 分岐は不要です。

サービスの注入

構成ツールやプロパティ注入を通じて、任意のBlazorコンポーネントやサービスに IPowerPortalsProService を注入できます。

React

Blazor

記録の回収

テーブル名とIDで単一のレコードを取得するには、オプションで RetrieveRecordAsync を使えます。どの列を返すかを指定することもできます。省略するとすべての列が返されます。

React

Blazor

複数のレコードのクエリ

FetchXMLクエリ文字列と組み合わせた RetrieveRecordsAsync を使い、フィルタリング、ソート、リンクエンティティのサポートで複数のレコードを取得します。

React

Blazor

記録の作成

CreateRecordAsyncを使ってDataverseで新しいレコードを作成しましょう。応答には新たに作成されたレコードのIDが含まれています。

React

Blazor

記録の更新

既存のレコードを更新するには UpdateRecordAsync を使ってください。 TableRecord に設定されたプロパティのみがDataverseに送信されます。

React

Blazor

記録の削除

DeleteRecordAsyncを使ってテーブル名とIDでレコードを削除してください。

React

Blazor

記録の関連付け

AssociateAsyncとDisassociateAsyncを使って、レコード間の多対多関係を管理しましょう。

React

Blazor

リクエストの実行

ExecuteAsyncを単一のリクエストに使うか、単一のデータベーストランザクションで複数のリクエストを実行するためのExecuteMultipleAsync。トランザクションバッチ内の任意のリクエストが失敗した場合、すべての変更はロールバックされます。

React

Blazor

メタデータの取得

RetrieveTableMetadataAsyncとRetrieveViewMetadataAsyncを使ってテーブルやビューのメタデータを取得してください。キャッシュアクセスの場合は、ITableMetadataCacheとIViewMetadataCacheを優先してください。

React

Blazor

ファイルの扱い方

GetFileInfoAsyncを使ってファイルや画像のメタデータを取得し、必要に応じてファイルや画像の列からバイナリコンテンツを取得します。

React

Blazor

直接データバースアクセス

IPowerPortalsProService ポータルが通常必要としていることをカバーしていますが、サーバーサイドの一部の作業ではDataverse SDK自体が必要です。LINQクエリ(結合や集約、 ExecuteMultiple、カスタムアクション、サービスがラップしないメッセージなど)です。 IOrganizationServiceProvider を注入して ServiceClient を取得し、SDKを直接使うことができます。

2つのクライアントを提供しており、その違いが重要です。

GetOrganizationService() — デフォルトで手を伸ばすべきもの。その CallerId はサインイン済みユーザーなので、Dataverseはそのユーザー自身の権限を強制し、監査記録に誰が何をしたかを記録します。
GetOrganizationServiceAsApp() ( PowerPortalsPro.Xrm.Extensionsの拡張番号)— は CallerIdをクリアするため、 ConnectionOptionsで設定されたアプリケーションユーザーが通話を実行します。これは、サインインしたユーザーが権限を持たないものを読み取る操作の場合、例えば連絡先支援ユーザーが systemuser レコードを読む必要がある場合などです。

返品された ServiceClient はクローンで使い捨てなので、上記のように using 部品を一つ持つのではなく、上記のように巻くと良いです。

気をつけて
どちらのクライアントもポータルの ITablePermissionProvider コードを実行しません。これは特に IPowerPortalsProService. GetOrganizationServiceAsApp() を経由する呼び出しに当てはまり、Dataverse自体のセキュリティを回避するため、そこに書かれたクエリは環境内の何でも返すことができます。訪問者が到達できるパスで使う場合は、事後ではなくクエリ自体でデータをフィルタリングしてください。

注記
これはサーバー側のみで、Dataverse接続が必要なので、サーバープロジェクト(およびBlazor Serverコンポーネント)では利用可能ですが、WebAssemblyクライアントやReact SPAには含まれません。それらはポータルのAPIを通じてDataverseに到達します。

IPowerPortalsProService Interface

方法

名称	パラメータ	種類	概要
`AssociateAsync`	TableRecordReference record string relationshipName IEnumerable<TableRecordReference> relatedRecords EntityRole? role CancellationToken cancellationToken	Task<AssociateResponse>	多対多関係を通じて、1つまたは複数の関連レコードとレコードを関連付けます。
`ClearAllCachesAsync`	CancellationToken cancellationToken	Task<IReadOnlyList<CacheClearResult>>	サーバー側のすべての `Services.IClearableCache` (テーブル/ビュー/特権)をクリアしますメタデータ、ユーザーごとの権限、環境ファイル設定)をまとめて再構築します。局所化された文字列は原子的にキャッシュされます — 読者は以前のものを引き続き見ることができます新しい状態が完全に埋め尽くされるまでデータを読み込みます。レイジーキャッシュは次に彼らが必要なリクエストです。この呼び出しの背後にあるHTTPエンドポイントは、 [AuthorizeSystemAdmin]。サーバー側の直接発信者は自分の境界線で適切にゲートを設置してください。
`ClearCacheAsync`	string name CancellationToken cancellationToken	Task<CacheClearResult>	名前付きのキャッシュを1つクリアします。登録されていないと `null` 返しますキャッシュマッチは `name` (大文字に区別されません);失敗は以下の通りです。結果に巻き込まれ、スローされるのではなく、認証ゲートは同じです。 `Threading.CancellationToken)`。
`CreateFileArchiveAsync`	CreateFileArchiveRequest request CancellationToken cancellationToken	Task<FileArchiveResult>	アーカイブを構築する(現在はzipファイル、将来のフォーマットは `CreateFileArchiveRequest.Format` 列挙)を含むすべてのレコードの名前付きテーブル/列ペアのファイルペイロード。同じレコードごとの処理を使用します許可チェーンを `Threading.CancellationToken)` として — 不正/欠落行はアーカイブから静かに削除されます。重複ファイル名は接尾辞「(2)」「 (3)」で曖昧さを解消して...つまりアーカイブエントリーを上書きしないでください。
`CreateRecordAsync`	TableRecord record CancellationToken cancellationToken	Task<CreateResponse>	Dataverseで新しいレコードを作成します。
`DeleteRecordAsync`	string tableLogicalName Guid id CancellationToken cancellationToken	Task<DeleteResponse>	Dataverseからテーブル名とレコードIDでレコードを削除します。
`DisassociateAsync`	TableRecordReference record string relationshipName IEnumerable<TableRecordReference> relatedRecords EntityRole? role CancellationToken cancellationToken	Task<DisassociateResponse>	多対多の関係を通じて、レコードと1つ以上の関連レコードとの関連付けを除去します。
`DownloadLocalizationSourceAsync`	string sourceId string culture CancellationToken cancellationToken	Task<LocalizationDownload>	鍵のダウンロードは、最も多くの文化に貢献した一つのソースです最近のウォームアップで、同じ入れ子オブジェクト形状のJSONのコンシューマーとして app.{culture}.json ファイルが使います。翻訳の引き継ぎを意図しています — ファイルを翻訳者に渡し、翻訳版を取り戻し、それを投函します元のソースを上書きするローカライゼーションフォルダですその鍵のために用意された。
`DownloadMergedLocalizationsAsync`	string culture CancellationToken cancellationToken	Task<LocalizationDownload>	ある文化の統合済みローカリゼーションキーをダウンロードします — ポストマージキャッシュに保存されているすべての鍵に対して勝利値が、どの鍵であっても元々はソースが提供していました。これを完全なスナップショットに使ってください参考資料(ポータルがその文化で実際に機能するすべての情報) 上記の各情報源視点ではなく、
`ExecuteAsync`	OrganizationRequest request CancellationToken cancellationToken	Task<OrganizationResponse>	Dataverseに対して単一の組織リクエストを実行します。
`ExecuteMultipleAsync`	IEnumerable<OrganizationRequest> requests bool returnResponses CancellationToken cancellationToken	Task<List<OrganizationResponse>>	単一のデータベーストランザクションで複数の組織リクエストを実行します。リクエストが失敗した場合、バッチ内のすべての変更がロールバックされます。
`GetCacheNamesAsync`	CancellationToken cancellationToken	Task<IReadOnlyList<string>>	適切なサーバー側の `Services.IClearableCache`の名前を返しますキャッシュごとにクリアボタンをレンダリングしたい管理者UI用です。同じ認証ゲート HTTPエンドポイントに適用される `Threading.CancellationToken)` 。
`GetFileInfoAsync`	string tableName Guid recordId string columnName bool includeData CancellationToken cancellationToken	Task<FileInfo>	Dataverseのファイルや画像列からファイル情報およびオプションでバイナリコンテンツを取得します。
`GetFileInfosAsync`	string tableName IEnumerable<Guid> recordIds string columnName bool includeData CancellationToken cancellationToken	Task<IEnumerable<FileInfo>>	同じテーブル/カラムの多くのレコードのファイル情報をバッチで取得する往復で。内部では、レコードごとのフィートが並列に並列でフェッチアウトされ、結合されたリストを返します。レコードごとの権限ハンドラーチェーンは、の場合と同じように動作しますシングルレコードコール;検索に失敗した場合は応答から除外されます。バッチ全体が失敗した。 FileGridの「すべてダウンロード」/「選択済みダウンロード」で使われ、クライアントが N個のHTTPリクエストを発生させずにzipを送ること。
`GetLocalizationOverviewAsync`	CancellationToken cancellationToken	Task<LocalizationOverview>	文字列ローカリゼーションパイプラインの管理者向けスナップショットを返します: ウォームアップを駆動する静的設定とソースごとの負荷記録最新のウォームアップによって制作されました。ローカリゼーション管理者を支持しています。 component in PowerPortalsPro.Web.Blazor.FluentUI. HTTPエンドポイントは [AuthorizeSystemAdmin]によってゲートされています。
`GetMergedLocalizationEntriesAsync`	string culture CancellationToken cancellationToken	Task<IReadOnlyList<MergedLocalizationEntry>>	1つの文化の統合されたローカライゼーションキーを構造化されたリストとして返します — キャッシュが提供するキー、マージ後の勝利値、そしてどのソースが提供されるかその値です。 `Threading.CancellationToken)` と同じデータですが、キーごとに管理者が作成元(ファイル/ウェブリソース/Dataverseメタデータ)を注釈付けし、グリッドで出所を調べます。エントリーはキー順に並べ替えられます。
`GetOrganizationSettingsAsync`	CancellationToken cancellationToken	Task<OrganizationSettings>	Dataverseから得た組織全体の設定を取得組織記録: DefaultCurrency — 組織の基本通貨で、作成モードで使用されます編集者(MoneyEdit)が新しいレコードに正しいシンボルを表示します。 BlockedFileExtensions + MaxUploadFileSizeInBytes — ファイルアップロード制約はクライアントが往復前に無効なファイルを拒否するためにミラーします。レガシーの GetEnvironmentFileSettingsAsync — 2つのファイルフィールドを置き換えますこの複合的な回答で暴露されています。
`GetTablePermissionsForCurrentUserAsync`	string tableLogicalName CancellationToken cancellationToken	Task<TableSecurityPermission>	現在のユーザーのテーブルレベルの複合マスク `Models.TableSecurityPermission` 返します `tableLogicalName` — Read / Create / Write / のビットごとの和集合 Delete / Append / AppendTo は、登録済みの ITablePermissionProvider が許可するフラグを付けますそのテーブルのユーザーのためです。サーバー側では、キャッシュされた ITablePermissionCacheに委任されます。WASMクライアント同じサーバー上のキャッシュを呼び出すHTTPエンドポイントに当たる。ミラーリング table-cache lookup Blazor's NewRecordGridButton / DeleteRecordGridButton すでにDIで直接行っており、GridDataResponseが持つ新しい値は次のようになります。 TablePermissions — ここではグリッドパス外の消費者(カスタム)を公開していますツールバー、条件付きUI、「ユーザーがXを作成できますか?」ゲートなど、ページ上のどこでも)などで、グリッドクエリを発射せずに同じ答えに到達できます。
`GetTablePermissionWebRolesAsync`	Guid tablePermissionId CancellationToken cancellationToken	Task<IReadOnlyList<Guid>>	テーブル権限が適用されるPower Pagesのウェブロールのidを、強化版で返します承認。許可証の記録から読み上げてください。なぜなら、Power Pagesがそこにそれらを保管しているからです: mspp_entitypermission 仮想テーブルの mspp_webrole との関係は空と読まれますロールがリンクされていても。サインインユーザーとして動作するため、Dataverseはその権限を適用します。
`GetTranslationAvailabilityAsync`	CancellationToken cancellationToken	Task<TranslationAvailability>	ローカライズ・翻訳機能が現在の環境で使用可能かどうかを返します: Azure翻訳サービスが設定されているか、翻訳が管理されているかソリューションがインストールされ、候補言語(ポータルがサポートする文化)が対象となります Azure翻訳性で注釈付き)。 LocalizationTranslator UIの決定を支持します翻訳パネルやインストールプロンプトを表示する、あるいは何も表示しない。
`GetUserTablePermissionsAsync`	string tableLogicalName CancellationToken cancellationToken	Task<UserTablePermissions>	現在のユーザーのテーブル上の操作と列権限はレコードとして記録されます彼らは「開始」を作成します — 作成時に設定できる列ではなく既存の記録の `TableRecord.ColumnPermissions` には変更があると書かれています。作成モードでフォームが表示するために必要なカラムは、ユーザーが読み取り専用に設定できない場合があります。
`RetrieveRecordAsync`	string tableLogicalName Guid id IEnumerable<string> columns CancellationToken cancellationToken	Task<TableRecord>	Dataverseからテーブル名とレコードIDで単一のレコードを取得します。
`RetrieveRecordsAsync`	string fetchXml CancellationToken cancellationToken	Task<RetrieveRecordsResponse>	FetchXMLクエリを用いてDataverseから複数のレコードを取得します。フィルタリング、ソート、ページング、リンクエンティティ、集約クエリをサポートしています。
`RetrieveTableHeadersAsync`	CancellationToken cancellationToken	Task<IReadOnlyList<TableHeader>>	論理、スキーマ、表示名に加え、識別レベルのメタデータを取得します環境内の各テーブルごとにいくつかのフラグを設置します。 `Threading.CancellationToken)`の安価な対応物として、呼び出し者がテーブルを検査するのではなくリストアップする必要がある場合。A 「差出人」ピッカーを入力するクエリデザイナーは、そうでなければ取得しなければなりません環境内のすべてのテーブルの完全なメタデータで、これには数十倍のコストがかかります数秒;これは単一往復で、進行中のキャッシュから提供されます。最初の電話。すべてのテーブルを返し、権限フィルタリングされた部分集合ではなく、同じポーズを返します。 `Threading.CancellationToken)`、認証済みの誰にも対応します呼び出し元は任意のテーブルの形状です。より絞り込むリストが必要な呼び出し者は `TableHeader.IsValidForAdvancedFind` でフィルターをかけるか、彼らの適用を行ってください自分のルールだ。
`RetrieveTableMetadataAsync`	string tableLogicalName CancellationToken cancellationToken	Task<TableMetadata>	Dataverseからテーブルのメタデータを取得し、列定義、関係、表示設定などを含みます。
`RetrieveTableMetadataBatchAsync`	IReadOnlyList<TableMetadataRequest> requests CancellationToken cancellationToken	Task<IReadOnlyList<TableMetadata>>	複数のテーブルのメタデータを1回の呼び出しで返し、それぞれを列に絞り込み、関係性、そのリクエスト名。多くのテーブルから少しずつ欲しい発信者のために。表示の解決テーブルの関係の背後に名前があるのが動機となる例です:検索列各テーブルの反対側のテーブルに住んでいるので、答えを `Threading.CancellationToken)` は関連するテーブルごとの往復を意味し、テーブル全体を返して、ラベルを読むために。狭めることで、どの列が戻ってくるかが変わりますが、それぞれが何を運ぶかではなく、名前付きの列が変わりますテーブル全体で読んだときと同じくらい完全に説明されたものが届きます。カラム発信者ここでも正確には読まれないかもしれないので、これは方法ではありません列の権限に関することです。環境にない表や、リクエストのスペルミスが欠けているエラーではなく結果から;テーブル名で結果を照合します。
`RetrieveViewMetadataAsync`	Guid viewId CancellationToken cancellationToken	Task<ViewMetadata>	Dataverseからビューメタデータを取得し、ビューのFetchXMLクエリ、列、表示設定などが含まれます。
`RetrieveViewsForTableAsync`	string tableLogicalName CancellationToken cancellationToken	Task<IEnumerable<ViewMetadata>>	テーブルのすべてのビューメタデータレコードを取得します。必要なグリッドで使われる利用可能なビュー(ビューピッカー、デフォルトビュー解像度など)を列挙します。サーバー側の実装は、進行中の IViewMetadataCacheから読み込みます。 WASMクライアントはHTTPエンドポイントに到達し、そのエンドポイントはサーバー上で同じ処理を行います。
`SetTablePermissionWebRolesAsync`	Guid tablePermissionId IReadOnlyCollection<Guid> webRoleIds CancellationToken cancellationToken	Task<bool>	テーブル権限が強化認可のもとで適用されるPower Pagesのウェブロールを置き換えます。権限の記録に書き込まれており、これがPower Pagesがセキュリティを再同期させる理由ですロールをそれらのウェブロールと組み合わせて、変更は通常はDataverseの権限に到達します。 1分ほど。仮想テーブルの関係を通じた関連付けはそうではありません:保存済みに見え、何も付与されません。追加されるすべてのIDはポータルのサイトのウェブロールでなければなりません。そのうちの一つが許可リストはリクエストに応じて保持または削除されます。たとえそのウェブロールがその後削除されていてもです削除されました。
`TranslateLocalizationFileAsync`	TranslationRequest request CancellationToken cancellationToken	Task<TranslationResult>	アップロードされたローカライゼーションファイルをAzure経由で1つ以上のターゲット言語に機械翻訳します TranslatorはDataverse翻訳メモリを再利用し、文字列数を報告します。新たに翻訳されたものと再利用されたもの。ターゲット言語ごとに1つのファイルとすべてのzipファイルを返します。
`UpdateRecordAsync`	TableRecord record CancellationToken cancellationToken	Task<UpdateResponse>	Dataverseの既存のレコードを更新します。レコード上に設定されたプロパティのみがDataverseに送信されます。

名称: AssociateAsync

パラメータ: TableRecordReference record
string relationshipName
IEnumerable<TableRecordReference> relatedRecords
EntityRole? role
CancellationToken cancellationToken

種類: Task<AssociateResponse>

概要: 多対多関係を通じて、1つまたは複数の関連レコードとレコードを関連付けます。

名称: ClearAllCachesAsync

パラメータ: CancellationToken cancellationToken

種類: Task<IReadOnlyList<CacheClearResult>>

概要: サーバー側のすべての Services.IClearableCache (テーブル/ビュー/特権)をクリアしますメタデータ、ユーザーごとの権限、環境ファイル設定)をまとめて再構築します。局所化された文字列は原子的にキャッシュされます — 読者は以前のものを引き続き見ることができます新しい状態が完全に埋め尽くされるまでデータを読み込みます。レイジーキャッシュは次に彼らが必要なリクエストです。この呼び出しの背後にあるHTTPエンドポイントは、 [AuthorizeSystemAdmin]。サーバー側の直接発信者は自分の境界線で適切にゲートを設置してください。

名称: ClearCacheAsync

パラメータ: string name
CancellationToken cancellationToken

種類: Task<CacheClearResult>

概要: 名前付きのキャッシュを1つクリアします。登録されていないと null 返しますキャッシュマッチは name (大文字に区別されません);失敗は以下の通りです。結果に巻き込まれ、スローされるのではなく、認証ゲートは同じです。 Threading.CancellationToken)。

名称: CreateFileArchiveAsync

パラメータ: CreateFileArchiveRequest request
CancellationToken cancellationToken

種類: Task<FileArchiveResult>

概要: アーカイブを構築する(現在はzipファイル、将来のフォーマットは CreateFileArchiveRequest.Format 列挙)を含むすべてのレコードの名前付きテーブル/列ペアのファイルペイロード。同じレコードごとの処理を使用します許可チェーンを Threading.CancellationToken) として — 不正/欠落行はアーカイブから静かに削除されます。重複ファイル名は接尾辞「(2)」「 (3)」で曖昧さを解消して...つまりアーカイブエントリーを上書きしないでください。

名称: CreateRecordAsync

パラメータ: TableRecord record
CancellationToken cancellationToken

種類: Task<CreateResponse>

概要: Dataverseで新しいレコードを作成します。

名称: DeleteRecordAsync

パラメータ: string tableLogicalName
Guid id
CancellationToken cancellationToken

種類: Task<DeleteResponse>

概要: Dataverseからテーブル名とレコードIDでレコードを削除します。

名称: DisassociateAsync

パラメータ: TableRecordReference record
string relationshipName
IEnumerable<TableRecordReference> relatedRecords
EntityRole? role
CancellationToken cancellationToken

種類: Task<DisassociateResponse>

概要: 多対多の関係を通じて、レコードと1つ以上の関連レコードとの関連付けを除去します。

名称: DownloadLocalizationSourceAsync

パラメータ: string sourceId
string culture
CancellationToken cancellationToken

種類: Task<LocalizationDownload>

概要: 鍵のダウンロードは、最も多くの文化に貢献した一つのソースです最近のウォームアップで、同じ入れ子オブジェクト形状のJSONのコンシューマーとして app.{culture}.json ファイルが使います。翻訳の引き継ぎを意図しています — ファイルを翻訳者に渡し、翻訳版を取り戻し、それを投函します元のソースを上書きするローカライゼーションフォルダですその鍵のために用意された。

名称: DownloadMergedLocalizationsAsync

パラメータ: string culture
CancellationToken cancellationToken

種類: Task<LocalizationDownload>

概要: ある文化の統合済みローカリゼーションキーをダウンロードします — ポストマージキャッシュに保存されているすべての鍵に対して勝利値が、どの鍵であっても元々はソースが提供していました。これを完全なスナップショットに使ってください参考資料(ポータルがその文化で実際に機能するすべての情報) 上記の各情報源視点ではなく、

名称: ExecuteAsync

パラメータ: OrganizationRequest request
CancellationToken cancellationToken

種類: Task<OrganizationResponse>

概要: Dataverseに対して単一の組織リクエストを実行します。

名称: ExecuteMultipleAsync

パラメータ: IEnumerable<OrganizationRequest> requests
bool returnResponses
CancellationToken cancellationToken

種類: Task<List<OrganizationResponse>>

概要: 単一のデータベーストランザクションで複数の組織リクエストを実行します。リクエストが失敗した場合、バッチ内のすべての変更がロールバックされます。

名称: GetCacheNamesAsync

パラメータ: CancellationToken cancellationToken

種類: Task<IReadOnlyList<string>>

概要: 適切なサーバー側の Services.IClearableCacheの名前を返しますキャッシュごとにクリアボタンをレンダリングしたい管理者UI用です。同じ認証ゲート HTTPエンドポイントに適用される Threading.CancellationToken) 。

名称: GetFileInfoAsync

パラメータ: string tableName
Guid recordId
string columnName
bool includeData
CancellationToken cancellationToken

種類: Task<FileInfo>

概要: Dataverseのファイルや画像列からファイル情報およびオプションでバイナリコンテンツを取得します。

名称: GetFileInfosAsync

パラメータ: string tableName
IEnumerable<Guid> recordIds
string columnName
bool includeData
CancellationToken cancellationToken

種類: Task<IEnumerable<FileInfo>>

概要: 同じテーブル/カラムの多くのレコードのファイル情報をバッチで取得する往復で。内部では、レコードごとのフィートが並列に並列でフェッチアウトされ、結合されたリストを返します。レコードごとの権限ハンドラーチェーンは、の場合と同じように動作しますシングルレコードコール;検索に失敗した場合は応答から除外されます。バッチ全体が失敗した。 FileGridの「すべてダウンロード」/「選択済みダウンロード」で使われ、クライアントが N個のHTTPリクエストを発生させずにzipを送ること。

名称: GetLocalizationOverviewAsync

パラメータ: CancellationToken cancellationToken

種類: Task<LocalizationOverview>

概要: 文字列ローカリゼーションパイプラインの管理者向けスナップショットを返します: ウォームアップを駆動する静的設定とソースごとの負荷記録最新のウォームアップによって制作されました。ローカリゼーション管理者を支持しています。 component in PowerPortalsPro.Web.Blazor.FluentUI. HTTPエンドポイントは [AuthorizeSystemAdmin]によってゲートされています。

名称: GetMergedLocalizationEntriesAsync

パラメータ: string culture
CancellationToken cancellationToken

種類: Task<IReadOnlyList<MergedLocalizationEntry>>

概要: 1つの文化の統合されたローカライゼーションキーを構造化されたリストとして返します — キャッシュが提供するキー、マージ後の勝利値、そしてどのソースが提供されるかその値です。 Threading.CancellationToken) と同じデータですが、キーごとに管理者が作成元(ファイル/ウェブリソース/Dataverseメタデータ)を注釈付けし、グリッドで出所を調べます。エントリーはキー順に並べ替えられます。

名称: GetOrganizationSettingsAsync

パラメータ: CancellationToken cancellationToken

種類: Task<OrganizationSettings>

概要: Dataverseから得た組織全体の設定を取得組織記録: DefaultCurrency — 組織の基本通貨で、作成モードで使用されます編集者(MoneyEdit)が新しいレコードに正しいシンボルを表示します。 BlockedFileExtensions + MaxUploadFileSizeInBytes — ファイルアップロード制約はクライアントが往復前に無効なファイルを拒否するためにミラーします。レガシーの GetEnvironmentFileSettingsAsync — 2つのファイルフィールドを置き換えますこの複合的な回答で暴露されています。

名称: GetTablePermissionsForCurrentUserAsync

パラメータ: string tableLogicalName
CancellationToken cancellationToken

種類: Task<TableSecurityPermission>

概要: 現在のユーザーのテーブルレベルの複合マスク Models.TableSecurityPermission 返します tableLogicalName — Read / Create / Write / のビットごとの和集合 Delete / Append / AppendTo は、登録済みの ITablePermissionProvider が許可するフラグを付けますそのテーブルのユーザーのためです。サーバー側では、キャッシュされた ITablePermissionCacheに委任されます。WASMクライアント同じサーバー上のキャッシュを呼び出すHTTPエンドポイントに当たる。ミラーリング table-cache lookup Blazor's NewRecordGridButton / DeleteRecordGridButton すでにDIで直接行っており、GridDataResponseが持つ新しい値は次のようになります。 TablePermissions — ここではグリッドパス外の消費者(カスタム)を公開していますツールバー、条件付きUI、「ユーザーがXを作成できますか?」ゲートなど、ページ上のどこでも)などで、グリッドクエリを発射せずに同じ答えに到達できます。

名称: GetTablePermissionWebRolesAsync

パラメータ: Guid tablePermissionId
CancellationToken cancellationToken

種類: Task<IReadOnlyList<Guid>>

概要: テーブル権限が適用されるPower Pagesのウェブロールのidを、強化版で返します承認。許可証の記録から読み上げてください。なぜなら、Power Pagesがそこにそれらを保管しているからです: mspp_entitypermission 仮想テーブルの mspp_webrole との関係は空と読まれますロールがリンクされていても。サインインユーザーとして動作するため、Dataverseはその権限を適用します。

名称: GetTranslationAvailabilityAsync

パラメータ: CancellationToken cancellationToken

種類: Task<TranslationAvailability>

概要: ローカライズ・翻訳機能が現在の環境で使用可能かどうかを返します: Azure翻訳サービスが設定されているか、翻訳が管理されているかソリューションがインストールされ、候補言語(ポータルがサポートする文化)が対象となります Azure翻訳性で注釈付き)。 LocalizationTranslator UIの決定を支持します翻訳パネルやインストールプロンプトを表示する、あるいは何も表示しない。

名称: GetUserTablePermissionsAsync

パラメータ: string tableLogicalName
CancellationToken cancellationToken

種類: Task<UserTablePermissions>

概要: 現在のユーザーのテーブル上の操作と列権限はレコードとして記録されます彼らは「開始」を作成します — 作成時に設定できる列ではなく既存の記録の TableRecord.ColumnPermissions には変更があると書かれています。作成モードでフォームが表示するために必要なカラムは、ユーザーが読み取り専用に設定できない場合があります。

名称: RetrieveRecordAsync

パラメータ: string tableLogicalName
Guid id
IEnumerable<string> columns
CancellationToken cancellationToken

種類: Task<TableRecord>

概要: Dataverseからテーブル名とレコードIDで単一のレコードを取得します。

名称: RetrieveRecordsAsync

パラメータ: string fetchXml
CancellationToken cancellationToken

種類: Task<RetrieveRecordsResponse>

概要: FetchXMLクエリを用いてDataverseから複数のレコードを取得します。フィルタリング、ソート、ページング、リンクエンティティ、集約クエリをサポートしています。

名称: RetrieveTableHeadersAsync

パラメータ: CancellationToken cancellationToken

種類: Task<IReadOnlyList<TableHeader>>

概要: 論理、スキーマ、表示名に加え、識別レベルのメタデータを取得します環境内の各テーブルごとにいくつかのフラグを設置します。 Threading.CancellationToken)の安価な対応物として、呼び出し者がテーブルを検査するのではなく リストアップ する必要がある場合。A 「差出人」ピッカーを入力するクエリデザイナーは、そうでなければ取得しなければなりません環境内のすべてのテーブルの完全なメタデータで、これには数十倍のコストがかかります数秒;これは単一往復で、進行中のキャッシュから提供されます。最初の電話。すべてのテーブルを返し、権限フィルタリングされた部分集合ではなく、同じポーズを返します。 Threading.CancellationToken)、認証済みの誰にも対応します呼び出し元は任意のテーブルの形状です。より絞り込むリストが必要な呼び出し者は TableHeader.IsValidForAdvancedFind でフィルターをかけるか、彼らの適用を行ってください自分のルールだ。

名称: RetrieveTableMetadataAsync

パラメータ: string tableLogicalName
CancellationToken cancellationToken

種類: Task<TableMetadata>

概要: Dataverseからテーブルのメタデータを取得し、列定義、関係、表示設定などを含みます。

名称: RetrieveTableMetadataBatchAsync

パラメータ: IReadOnlyList<TableMetadataRequest> requests
CancellationToken cancellationToken

種類: Task<IReadOnlyList<TableMetadata>>

概要: 複数のテーブルのメタデータを1回の呼び出しで返し、それぞれを列に絞り込み、関係性、そのリクエスト名。多くのテーブルから少しずつ欲しい発信者のために。表示の解決テーブルの関係の背後に名前があるのが動機となる例です:検索列各テーブルの反対側のテーブルに住んでいるので、答えを Threading.CancellationToken) は関連するテーブルごとの往復を意味し、テーブル全体を返して、ラベルを読むために。狭めることで、どの列が戻ってくるかが変わりますが、それぞれが何を運ぶかではなく、名前付きの列が変わりますテーブル全体で読んだときと同じくらい完全に説明されたものが届きます。カラム発信者ここでも正確には読まれないかもしれないので、これは方法ではありません列の権限に関することです。環境にない表や、リクエストのスペルミスが欠けているエラーではなく結果から;テーブル名で結果を照合します。

名称: RetrieveViewMetadataAsync

パラメータ: Guid viewId
CancellationToken cancellationToken

種類: Task<ViewMetadata>

概要: Dataverseからビューメタデータを取得し、ビューのFetchXMLクエリ、列、表示設定などが含まれます。

名称: RetrieveViewsForTableAsync

パラメータ: string tableLogicalName
CancellationToken cancellationToken

種類: Task<IEnumerable<ViewMetadata>>

概要: テーブルのすべてのビューメタデータレコードを取得します。必要なグリッドで使われる利用可能なビュー(ビューピッカー、デフォルトビュー解像度など)を列挙します。サーバー側の実装は、進行中の IViewMetadataCacheから読み込みます。 WASMクライアントはHTTPエンドポイントに到達し、そのエンドポイントはサーバー上で同じ処理を行います。

名称: SetTablePermissionWebRolesAsync

パラメータ: Guid tablePermissionId
IReadOnlyCollection<Guid> webRoleIds
CancellationToken cancellationToken

種類: Task<bool>

概要: テーブル権限が強化認可のもとで適用されるPower Pagesのウェブロールを置き換えます。権限の記録に書き込まれており、これがPower Pagesがセキュリティを再同期させる理由ですロールをそれらのウェブロールと組み合わせて、変更は通常はDataverseの権限に到達します。 1分ほど。仮想テーブルの関係を通じた関連付けはそうではありません:保存済みに見え、何も付与されません。追加されるすべてのIDはポータルのサイトのウェブロールでなければなりません。そのうちの一つが許可リストはリクエストに応じて保持または削除されます。たとえそのウェブロールがその後削除されていてもです削除されました。

名称: TranslateLocalizationFileAsync

パラメータ: TranslationRequest request
CancellationToken cancellationToken

種類: Task<TranslationResult>

概要: アップロードされたローカライゼーションファイルをAzure経由で1つ以上のターゲット言語に機械翻訳します TranslatorはDataverse翻訳メモリを再利用し、文字列数を報告します。新たに翻訳されたものと再利用されたもの。ターゲット言語ごとに1つのファイルとすべてのzipファイルを返します。

名称: UpdateRecordAsync

パラメータ: TableRecord record
CancellationToken cancellationToken

種類: Task<UpdateResponse>

概要: Dataverseの既存のレコードを更新します。レコード上に設定されたプロパティのみがDataverseに送信されます。