M365Con 2027 – 無料オンラインカンファレンス · 11–22 Jan 2027 · 120 sessions m365con.net

Dataverse plug-in

Concept

Dataverse イベントパイプラインに登録されるカスタムのサーバーサイドコードで、データ操作の発生時に実行され、Dynamics 365 でトランザクション検証や計算に使用されます。

✦ CONCEPTDataverse plug-inM365.FM
Title graphic: Dataverse plug-in (Concept)

あわせて取り上げられたテーマ

Dataverse plug-inに関するエピソードでは、Saga pattern、Transactional outbox pattern、Database normalization、Dataverse business skills、Dataverse business units、PSDataverseも取り上げられています。

Description

Dataverse プラグインは、Microsoft Dataverse でのデータ操作の処理中に特定のイベントに応答するカスタムイベントハンドラーです。.NET Framework アセンブリ内のクラスとして記述され、そのアセンブリが Dataverse に登録されます。1 つのアセンブリに複数のクラスを含めることができ、それぞれがイベントフレームワークの異なるステップに登録されます。Dynamics 365 では、プラグインは、データの作成、更新、その他の処理時に実行する必要があるトランザクション検証や計算などのサーバーサイドのロジックに使用されます。

それぞれのプラグインクラスは IPlugin インターフェイスを実装しており、このインターフェイスは単一の Execute メソッドを定義しています。登録されたイベントが発生すると、Dataverse はそのメソッドを呼び出し、処理中の操作に関するコンテキストデータを渡します。その後、コードは実行中のパイプライン操作をキャンセルしたり、処理中のビジネスデータを変更したり、さらなるデータ操作を呼び出したり、外部システムに接続したり、同じパイプライン内の後続のプラグインに情報を渡したりできます。プラグインは同期的に実行することも、操作の完了後に非同期的に実行することもできます。同期的に実行する場合は、操作がプラグインの完了を待ちます。

これらのモードの選択は、実際には重要です。不正なデータが保存されないようにするロジックはパイプラインの同期部分で実行する必要があり、保存後に行える処理は非同期で実行できます。Microsoft Learn には、同期プラグインは迅速に実行する必要があり、実行には厳格な時間制限があると記載されています。また、不適切に記述されたコードはパフォーマンスを低下させる可能性があります。さらに、プラグインの構築には開発者のスキルが必要であるため、宣言型のオプションにはない負担が伴います。

こうした欠点があるため、Microsoft のドキュメントでは、まず宣言型のオプションを確認することを推奨しています。挙げられている代替手段には、カスタムアクション、計算列およびロールアップ列、Webhook、Power Automate などがあります。プラグインは、これらのオプションで要件を満たせない場合、たとえばロジックをトランザクション内部で確実に適用する必要がある場合に適したツールになります。

M365.FM のエピソード「Customize Dataverse for Complex Business Apps」では、Dataverse プラグインをビジネスルールの意思決定マトリックス内に位置付けています。エピソードによると、判断の流れはおおむね次のとおりです。不正なデータをブロックする必要がある場合は、同期のサーバーサイドロジックを使用します。保存後に実行できる場合は、非同期のサーバーサイドロジックを使用します。アプリ間のメッセージングや承認の場合は、Flow または Teams を使用します。高負荷の計算や複雑な結合の場合は、Dataverse プラグインまたは Dataflow を使用します。また、このエピソードでは、各ルールのテーブル、トリガー、条件、アクション、所有者を記録するルールカタログを維持することを推奨しています。さらに、決定論的な計算や関連レコードにわたる合計には、コードに頼るのではなく計算フィールドとロールアップフィールドを使用するよう助言しています。

エピソード「Why Power Platform Is Your Real Automation Layer — Not Custom Code」は、同じトピックをカスタマイズの履歴という観点から取り上げています。従来の Dynamics モデルでは、標準アプリケーションとビジネスプロセスの違いがそれぞれ別のカスタマイズになると説明しています。その内容には、Dataverse プラグイン、フォームに付加された JavaScript、カスタムのワークフローアクティビティ、スケジュールされたジョブ、別の統合サービスなどが含まれます。エピソードでは、各機能は単独では正しく動作する場合があるものの、プロセス全体は徐々にアセンブリ、スクリプト、ワークフロー、API、構成値、専門知識へと分散していくと述べています。その結果、プロセス所有者はポリシーを理解していても、その実装を確認することはできません。これは、プラグインをプロセス変更への既定の対応ではなく、意図的な選択として扱うべきだという主要な論点です。

Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.

TypeConcept

Frequently asked questions

Questions marked with AI were written with AI from the facts on this page.

Dataverse プラグインとは何ですか? (AI)

Dataverse プラグインは、データ操作中の特定のイベントに応答して実行される、Dataverse に登録された .NET Framework アセンブリ内のクラスとして記述されたカスタムイベントハンドラーです。各クラスは、単一の Execute メソッドを持つ IPlugin インターフェイスを実装します。

Dataverse プラグインは同期と非同期の両方で実行できますか? (AI)

はい。プラグインは同期的に実行することも、操作の完了後に非同期的に実行することもできます。同期的に実行する場合は操作がプラグインの完了を待ちます。Microsoft Learn には、同期プラグインは迅速に実行する必要があり、実行には厳格な時間制限があると記載されています。

他のオプションではなく Dataverse プラグインを使用すべきなのはどのような場合ですか? (AI)

Microsoft Learn は、まずカスタムアクション、計算列およびロールアップ列、Webhook、Power Automate などの宣言型オプションを確認することを推奨しています。エピソード「Customize Dataverse for Complex Business Apps」では、高負荷の計算や複雑な結合にはプラグインまたは Dataflow の使用を提案しています。

Glossary

Community wiki

Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.

Experts and companies for this topic

Nobody has listed this topic yet. Add it to your profile.

Maintained by Mirko Peters (Microsoft MVP) · Last updated: