仮想エンティティの概要

重要

この機能には、バージョン 10.0.12 の財務と運用アプリ、および Microsoft Dataverse のサービス更新プログラム 189 が必要です。 Dataverse のリリース情報は、最新バージョンの利用可能性ページに発行されています。

財務と運用アプリの仮想エンティティ

財務と運用アプリは、Dataverse の仮想データ ソースであり、Dataverse および Microsoft Power Platform からの完全な作成、読み取り、更新、削除 (CRUD) 操作を可能にし ます。 定義上、仮想エンティティのデータは、Dataverse には存在しません。 その代わりに、属しているアプリで引き続き存在します。 Dataverse から財務と運用エンティティに対して CRUD 操作を実行する前に、エンティティを Dataverse の仮想エンティティとして使用可能にする必要があります。 これにより、財務と運用アプリに存在するデータに対して、Dataverse と Microsoft Power Platform から CRUD 処理を実行できるようになります。

財務と運用アプリ内のすべての Open Data Protocol (OData) エンティティは、Dataverse の仮想エンティティとして使用でき、したがって Microsoft Power Platform でも使用できます。 これで、作成者は財務と運用アプリからデータを直接使用して、Cuntomer Engagement アプリでエクスペリエンスを構築できます。 これらのエクスペリエンスは完全な CRUD 機能をオファーしており、Dataverse へのコピーを要求しません。 Power Apps ポータルは、財務と運用アプリで業務プロセスのコラボレーション シナリオを可能にする外部向けの Web サイトを構築するために使用できます。

アーキテクチャ

仮想エンティティは、財務と運用アプリ以外にも有用な Dataverse の概念です。 次の図は、仮想エンティティの財務と運用プロバイダーを実装する方法を示しています。 6 つの主要メソッドがプロバイダーによって実装されます。 最初の 5 つのメソッドは、Create、Update、Delete、Retrieve、RetrieveMultiple という標準的な CRUD 操作です。 最後のメソッドである PerformAction は、この記事で後述するように OData アクションを呼び出すために使用されます。 財務と運用仮想エンティティ データ プロバイダー (図では 「仮想エンティティ プラグイン」 と表示) を呼び出すと、財務と運用アプリの CDSVirtualEntityService Web API エンドポイントに対して Secure Sockets Layer (SSL)/トランスポート層セキュリティ (TLS) 1.2 セキュア Web 呼び出しが行われます。 その後、この Web サービスは、クエリを財務と運用アプリ内の関連する物理エンティティへの呼び出しに変換し、それらのエンティティで CRUD 操作または OData 操作を呼び出します。 財務と運用エンティティはすべての操作で直接呼び出されるため、エンティティまたはバッキング テーブルのビジネス ロジックも呼び出されます。

呼び出し時、Dataverse から財務と運用アプリまで 2 つの変換点があります。 変換の最初のポイントは、エンティティの物理名などの概念を財務と運用エンティティ名に変換する VE プラグインにあります。 また、会社の参照などの既知の概念も変換されます。 Web サービス呼び出しでは、引き続き EntityCollection、Entity、および QueryExpression オブジェクトを使用して、実行される操作が表されます。このとき、VE プラグインから変換されたエンティティ名と概念が使用されます。 最後に、財務と運用アプリの CDSVirtualEntityAdapterService Web API によって、QueryExpression から QueryBuildDataSource およびその他の内部財務と運用言語構成要素への変換が完了します。

仮想エンティティの一部としての Dataverse および財務と運用アプリ間での呼び出しはすべて、コンフィギュレーションで指定されている Microsoft Entra アプリケーションを使用して、サービス間 (S2S) 呼び出しとして実行されます。 このアプリケーションのユーザーは、CDSVirtualEntityAdapterService Web API とカタログ エンティティ CDSVirtualEntityListEntity にのみアクセスできる必要があります。 これらの特権は、CDSVirtualEntityApplication という名前の、標準のセキュリティ ロールに含まれています。 S2S 呼び出し中に、アクションを呼び出す Dataverse のユーザーの ID が Dataverse により提供されます。 CDSVirtualEntityAdapterService Web API は、財務と運用アプリで関連したユーザーを検索し、そのユーザーのコンテキストでクエリを実行します。 したがって、S2S 呼び出しでは、すべての財務と運用エンティティに明示的にアクセスする必要はありません。 代わりに、データ アクセスを決定するには、アクションを呼び出すユーザーの特権が必要な場合があります。

メモ

仮想エンティティの呼び出しの待機時間を最適化するために、同じ Azure リージョンに財務と運用アプリおよび Dataverse の両方を同一配置することをお勧めします。 財務と運用アプリおよび Dataverse を同一配置する場合、仮想エンティティの間接費は 1 回の呼び出しあたり 30 ミリ秒 (ms) 未満である予定です。

Power Apps ポータルでは、仮想エンティティにもアクセスできます。 Power Apps ポータル認証は連絡先レコードに基づいているため、連絡先レコードおよび財務と運用ユーザーの間のマッピングは Dataverse での dyn_externalportalusermapping テーブルで管理されます。 このテーブルは、Dataverse の高度な特権を持つユーザーのみが編集でき、このユーザーは、財務と運用仮想エンティティに対してポータル ユーザーが持つセキュリティ アクセスを制御する権限を持っています。 Power Apps ポータル アクセス用に設定されたすべての財務と運用ユーザーには、CDSVirtualEntityAuthorizedPortalUser セキュリティ ロールが割り当てられている必要があります。また、システム管理者またはセキュリティ管理者ロールを割り当てることはできません。 仮想エンティティに適用される Power Apps ポータル セキュリティ設定に関係なく、財務と運用アプリへの結果のクエリは常に関連付けられた財務と運用ユーザーとして実行され、そのユーザーのエンティティと行のセキュリティ設定に従います。 匿名ポータルのアクセスもサポートされます。 このタイプのアクセスとその実行方法については、Power Apps ポータル参照を参照してください。

承認

財務と運用アプリと Microsoft Power Platform は個別のユーザー セキュリティを維持するため、Dataverse で仮想エンティティ レコードを使用して運用する場合に重要です。適切なユーザー コンテキストは、財務と運用のデータにアクセスするための適切なアクセス許可を使用して使用されます。 詳細については、認証と承認 を参照してください。

つまり、Dataverse プラグインで財務と運用の仮想エンティティを読み取る組織コンテキストを作成する場合、その組織コンテキストは、財務と運用の仮想エンティティへのアクセス許可を持つ適切なアプリケーションたエンド ユーザーに関連付けられます。 Dataverse システム ユーザーには、財務と運用のすべてのエンティティにアクセスできるアクセス権がなく、また、既製のサービス間アプリにもそのようなアクセス権はありません。 適切なユーザーまたはアプリ ユーザー コンテキストの使用に失敗するとエラーになり、Unable to determine the user in CDS のようなメッセージが表示されることがあります