Dataverse のローコードプラグインを使用する (プレビュー)

[アーティクル]
12/11/2024

[このトピックはプレリリースドキュメントであり、変更されることがあります。]

Microsoft Dataverse は、ローコードプラグインによって、より効率的なデータアーキテクチャを実現し、クライアント側のワークロードを軽減するための強力なソリューションを提供します。これらのプラグインは、Dataverse 内で特定のコマンドセットを実行する再利用可能なリアルタイムワークフローであり、サーバー側で実行され、パーソナライズされたイベントハンドラーによってトリガーされます。

重要

これはプレビュー機能です。
プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。

従来、プラグインは .NET Framework アセンブリにコンパイルされたカスタムクラスとして作成され、Dataverse 内にアップロードされて登録されていました。しかし、ローコードプラグインの導入により、最小限のコーディングで、あるいはコーディングをまったく必要とせず、手動で登録することなく、これらのイベントハンドラーを作成できます。

ローコードプラグインは Dataverse データベース内に保存され、Power Apps と Power Automate にシームレスに統合できます。ワークフローの動作は Power Fx の式言語を使用して定義され、Dataverse コネクタを使用して Power Platform ビジネスデータや外部データソースに直接接続できます。ローコードプラグインを使用すると、作成者は最小限のコーディングの専門知識で複雑なワークフローを迅速に構築でき、その結果、より合理的で効率的なデータアーキテクチャを実現できます。

サーバー側ロジックの利点

サーバー側ビジネスロジックを定義すると、次のようないくつかの利点があります:

セキュリティの強化。サーバー側ロジックはサーバー上で実行されるため、機密データやプロセスへの不正アクセスを防ぐことができます。
パフォーマンスの向上。ビジネスロジックをサーバー上で実行することにより、クライアントとサーバー間で転送する必要があるデータの量を減らすことができ、処理時間が短縮されます。
一貫性と信頼性。サーバー側ロジックは、ビジネスルールがすべてのクライアントに一貫して適用されることを保証し、エラーや不整合のリスクを軽減します。
メンテナンスとアップグレードが容易に。ビジネスロジックをサーバーに一元化することで、複数のクライアントを更新する必要がなく、1 か所で変更を行えるため、メンテナンスや更新が容易になります。
スケーラビリティ。サーバー側ロジックはクライアント側ロジックよりも簡単に拡張でき、パフォーマンスが向上し、より大きなワークロードを処理できます。

ローコードプラグイン

Dataverse でサポートされているローコードプラグインには 2 種類あります:

タイプ	トリガー	パラメーターのサポート	サポート対象スコープ
即時	手動で実行	はい	グローバルとテーブル
自動	Dataverse テーブルイベント	いいえ	テーブル

すべてのローコードプラグインには、次の共通のプロパティがあります:

Property	Description
表示名称	人間が判読できるプラグインの名前。一度作成すると変更できません。
件名	プラグインの内部名。これは、コードおよびデータベース操作のコンポーネントを識別するためにプラットフォームによって使用されます。一度作成すると変更できません。
Description	プラグインに関する追加のコンテキスト (目的、動作、またはその他の重要な詳細) を提供するために使用されます。
ソリューション	コンポーネントをグループ化し、他の環境にエクスポートするために使用されます。ソリューションの詳細をご覧ください。
式	これは、Power Fx の式言語を使用して定義された、アクションまたは計算を実行するために使用できるカスタム関数です。 Power Fx は、Power Apps キャンバスアプリで使用される式言語であり、ローコードプラグインで使用できるように拡張されています。詳細については、サポートされている機能を参照してください。

インスタントプラグイン
自動化されたプラグイン

インスタントローコードプラグインは、ユーザーが手動でトリガーするカスタムコードロジックです。カスタム入出力パラメーターを使用できます。

固有のプロパティ:

Property	Description
範囲	プラグインを特定のテーブルに関連付けるために使用されます。テーブル (エンティティとして表示) またはグローバルのいずれかに設定できます。テーブル (エンティティ) スコープはプラグインが特定のテーブルレコードのコンテキストでトリガーされることを意味し、グローバルスコープは操作がテーブルに関連付けられていないことを意味します (詳細)。
Parameters	パラメーターを使用すると、プラグインとプラグインを実行するコンテキストの間で情報を受け渡すことができ、さまざまな状況で再利用できるビジネスロジックを設計しやすくなります。入力パラメーターは、プラグインにデータを提供するために使用され、Power Fx の式で指定したさまざまな値を渡すことで関数の動作を制御できます。出力パラメーターは、関数またはメソッドの結果を取得してプログラムでさらに使用できるようにします。サポート対象データ型: ブール型 String 浮動 10 進法 DateTime 整数

Property

Description

範囲

プラグインを特定のテーブルに関連付けるために使用されます。テーブル (エンティティとして表示) またはグローバルのいずれかに設定できます。テーブル (エンティティ) スコープはプラグインが特定のテーブルレコードのコンテキストでトリガーされることを意味し、グローバルスコープは操作がテーブルに関連付けられていないことを意味します (詳細)。

Parameters

パラメーターを使用すると、プラグインとプラグインを実行するコンテキストの間で情報を受け渡すことができ、さまざまな状況で再利用できるビジネスロジックを設計しやすくなります。

入力パラメーター は、プラグインにデータを提供するために使用され、Power Fx の式で指定したさまざまな値を渡すことで関数の動作を制御できます。

出力パラメーター は、関数またはメソッドの結果を取得してプログラムでさらに使用できるようにします。

サポート対象データ型:

ブール型
String
浮動
10 進法
DateTime
整数

キャンバスアプリから、または Power Automate クラウドフローで統合する方法の詳細: ローコードプラグインを統合する

自動化されたローコードプラグインは、特定のデータイベントの処理中に実行されるカスタムコードです。

固有のプロパティ:

Property	Description
データイベント ('行がある場合にこのプラグインを実行する')	どのデータイベントがプラグインをトリガーするかを指定します。次のイベントのいずれかを選択してプラグインを呼び出すことができます: Create 更新する Delete
段階 ('これを実行するべきタイミング')	データイベントの完了前または完了後にプラグインを実行するかどうかを設計できるため、イベントの主要な段階で値に柔軟にアクセスして変更できます。事前操作。フォーム検証の後、値が Dataverse に挿入または変更される前にプラグインロジックを実行する場合は、このオプションを選択します。事後操作。 Dataverse に値が挿入または変更された後にプラグインロジックを実行するには、このオプションを選択します。

Property

Description

データイベント
('行がある場合にこのプラグインを実行する')

どのデータイベントがプラグインをトリガーするかを指定します。次のイベントのいずれかを選択してプラグインを呼び出すことができます:

Create
更新する
Delete

段階
('これを実行するべきタイミング')

データイベントの完了前または完了後にプラグインを実行するかどうかを設計できるため、イベントの主要な段階で値に柔軟にアクセスして変更できます。

事前操作。フォーム検証の後、値が Dataverse に挿入または変更される前にプラグインロジックを実行する場合は、このオプションを選択します。
事後操作。 Dataverse に値が挿入または変更された後にプラグインロジックを実行するには、このオプションを選択します。

プラグインのアクセス許可

設計時

Power Platform 環境でシステムカスタマイザーまたはシステム管理者のセキュリティロールメンバーシップを持つ作成者は、その環境にあるすべてのプラグインにアクセスできます。カスタムセキュリティロールを使用して、ローコードプラグインへのアクセスを制限できます。

実行時間

プラグインが呼び出されると、呼び出したユーザーのコンテキストでプラグイン定義に含まれるテーブルデータ (式の一部であるテーブル、またはテーブルが自動プラグインの設定に関連付けられている場合) にアクセスします。

つながり

セキュリティロールを使用すると、プラグイン内のコネクタアクセスを組織内の特定のユーザーセットに制限できます。作成、読み取り、更新、または削除の権限を持つロールを指定します。

ローコードプラグインを作成するための前提条件

Power Platform 環境におけるシステム管理者またはシステムカスタマイザーのセキュリティロールメンバーシップ。
Dataverse アクセラレータアプリへのアクセス。

チップ

2023 年 10 月 1 日より、すべての新しい環境には Dataverse アクセラレータアプリが自動的にインストールされます。すでに Dataverse アクセラレータがインストールされている場合は、Dataverse アクセラレータを手動で更新できます。

Dataverse アクセラレータを更新する

手順に従って環境内のライセンスされたアプリを表示します。
Dataverse Accelerator がすでにインストールされており、アップデートが利用可能な場合は、項目の横の表にその旨が示されています。
Dataverse Accelerator を選択し、コマンドバーで更新を選択します。

チップ

Microsoft - Power CAT パブリッシャーのアプリの自動更新を有効にして、利用可能な場合にアップデートを自動的に受信します (2023 年 10 月 1 日より後に作成された新しい環境には必要ありません)。

ヒント

以前にオプションの コネクタ用ローコードプラグイン ソリューションをインストールしている場合は、2023 年 6 月 29 日より後に更新すると、そのソリューションは自動的に削除されます。これらの機能はメインソリューションで利用できるようになります。

インスタントローコードプラグインを作成する

Dataverse アクセラレータアプリを再生します。
インスタントプラグインの作成 カードを選択します。
表示名 を入力します。
必要に応じて、パラメーターを定義します:
- 新しい入力パラメーター または 新しい出力パラメーター を選択し、ラベルとデータ型を入力します。
- 必要に応じて、さらに入力および出力パラメーターを追加します。
式エディターに Power Fx の式を入力します。
- 式の入力パラメーターをラベル名で参照します。
- 出力パラメーターは、{ Out: "Return value" } のように中括弧内で参照する必要があります。
- Filter() や LookUp() などのデータ収集関数を使用して Dataverse テーブルを参照します。
- スコープがエンティティに設定されている場合は、ThisRecord を使用して、ThisRecord.'Account Name' などのプラグイン実行に関連付けられたテーブル行の列値にアクセスします。
チップ

式ボックスで intellisense に注意してください。赤の下線部は無効です。黄色の波線は、ロジックが委任制限の影響を受ける可能性があることを意味します。委任可能な関数を使用して、委任の問題を回避します。
必要に応じて、詳細オプション を展開して、ソリューション、スコープ、または説明を修正します。
保存を選択します。
インスタントローコードプラグインをテストします。

例: 2 つの整数の合計を計算します。

2 つの入力パラメーター X と Y (両方とも整数型) と 1 つの出力パラメーター Z (文字列型) を作成します。
次の数式を使用します: {Z: X + Y }

Dataverse アクセラレータアプリのインスタントプラグインの例

自動ローコードプラグインを作成する

Dataverse アクセラレータアプリを再生します。
自動プラグインの作成 カードを選択します。
次の値を指定します:
- 名前: インスタントプラグインの名前 (入力検証 など) を入力します。
- テーブル: アカウント など、プラグインを関連付けるテーブルを選択します。
- 行がある場合にこのプラグインルールを実行。プラグインを呼び出すデータイベントを指定します。
式エディターに Power Fx の式を入力します。
- Filter() や LookUp() などのデータ収集関数を使用して Dataverse テーブルを参照します。
- ThisRecord を使用して、ThisRecord.'Account Name' などのプラグイン実行に関連付けられたテーブル行の列値にアクセスします。
必要に応じて、詳細オプション を展開して、プラグインが保存されている ステージ (実行する必要がある場合) と ソリューション を修正します。
保存を選びます。
自動化されたローコードプラグインをテストします。

ローコードプラグインで Power Platform コネクタを使用する

Power Platform コネクタをローコードプラグインで使用すると、SQL Server、Salesforce、SharePoint などの Dataverse 以外のシステムからのデータや機能を、複雑なコーディングやカスタム開発を必要とせずに簡単に統合できます。

ローコードプラグインでコネクタを使用するための前提条件

ローコードプラグインを作成するための前提条件
アクティブな接続を持つ接続参照。

ローコードプラグインでコネクタアクションを使用する

コネクタとカスタムコネクタをローコードプラグインの Power Fx の式から簡単に使用できます。

使用するコネクタへの接続を作成します。
Dataverse 環境で接続への接続参照を追加します。
ローコードプラグインの Power Fx 式エディターで、接続参照の名前 (表示名ではなく、new_connectorName のような接頭辞とアンダースコアが付いた内部名) を入力します。
Intellisense には、利用可能なアクションが表示されます。必要なアクションを選択し、必須パラメーターを入力します。

ローコードプラグインでコネクタを使用する前に、コネクタのドキュメントを確認して、入力および出力パラメーターが正しく渡されていることを確認します。

詳細: 例

ヒント

現時点では、すべてのコネクタアクションがサポートされているわけではありません。
プラグインの式から Dataverse テーブルに接続するために Dataverse コネクタを使用しないでください。代わりに、ネイティブの Power Fx 関数を使用してコレクションを操作します: Filter、Search、LookUp、 Patch、Collect、および Set。ここでは、列はグローバル変数として扱われます。

ローコードプラグインをテストする

インスタントプラグインをテストする

ホーム画面 で、リストからインスタントプラグインを選択し、コマンドバーの テスト を選択します。保存後にコマンドバーのインスタントプラグインエディターからこの画面にアクセスすることもできます。
ローコードプラグインで定義されている入力パラメータの値を指定し、実行を選択します。

応答を確認します。

チップ

出力パラメーターを使用して、予想される動作と結果を検証します。それ以外の場合は、テスト時に成功または失敗のみが表示されます。

自動プラグインをテストする

データイベントを呼び出して自動プラグインをテストします。式で定義された予想される変更を検証して、プラグインが正常に実行されたかどうかを確認します。

チップ

プレビュー中に、Power Apps でテーブルエディタを使用して、関連するデータイベントを呼び出すことができます。

Power Appsにサインインし、テーブル に移動して、プラグイン テーブルを選択します。
コマンドバーで編集を選択します。
このビューから直接行を作成、更新、または削除します。または、行を選択して既定のフォームで行を開き、コマンドバーの フォームを使用して行を編集 を選択します。

ローコードプラグイン統合する

キャンバスアプリまたはカスタムページからインスタントプラグインを呼び出す

Dataverse アクセラレータ アプリで:
1. リストでインスタントプラグインを選択します。
2. コマンドバーで コードスニペットのコピー を選択します。
3. コピーした数式をテキストエディターまたはメモ帳 (簡単に参照できる場所) に貼り付けて保存します。
Power Apps の場合
1. Power Apps studio でキャンバスアプリ (またはカスタムページ) を作成または編集します。
2. 左側のナビゲーションの データソース タブで、+ 新しいデータソース を選択し、Dataverse コネクタから環境オプションを検索します。
3. 次のコンポーネントをキャンバスに挿入します:
- テキストまたは数値のテキスト入力、ブール値のトグルなど、各パラメーターのデータ型に対応する入力コントロールを追加します。
- プラグインのスコープがテーブルにバインドされている場合は、同じテーブルに関連付けられたコンボボックスを追加して、入力を選択できるようにします。
- ボタンを追加してプラグインを呼び出します。
コピーしたプラグインの式をボタンの OnSelect プロパティに貼り付けます。
各入力パラメーター Value をマップして、対応する入力コントロールを参照します:
- 式が Environment.new_CalculateSum({ X: Value, Y: Value }); の場合、次のように書き換えることができます: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
- 式がバインドされている場合は、Environment をテーブル表示名に置き換え、プラグインにアクセスします。
出力パラメーターがローコードプラグインに定義されている場合:
1. Set() または UpdateContext() の式で応答をキャプチャします: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );。変数をラベルに表示します。あるいは、Notify() の式を使用して、通知にデータを表示します。
アプリを再生し、コマンドバーでコマンドを選択してローコードプラグインを実行します。

キャンバスアプリで Power Fx から直接 Dataverse アクションを呼び出す方法について詳細をご確認ください。

Power Automate クラウドフローからインスタントプラグインを呼び出す

クラウドフローで、Microsoft Dataverse コネクタから新しいアクションを追加します。
バインドしていないアクションを実行するまたはバインド済みアクションを実行するというアクションを選択します。
プラグイン (接頭辞付きで固有の名前を持つ) を選択します。
すべての入力パラメータ (存在する場合) に値を指定します。

Dataverse Web APIからインスタントプラグインを呼び出す

Web API ドキュメントからカスタム API を呼び出すの 非バウンドアクション または テーブルにバインドされた関数 セクションの手順に従います (プラグインの適切なスコープに応じて)。

ローコードプラグインに関するサポートを受ける

ローコードプラグインの作成または実行中に問題が発生した場合は、発生する可能性のある一般的な問題について、次のヒントを参照してください: Microsoft Dataverse ローコードプラグインのヒントと既知の問題

ヘルプ + サポートに問い合わせる

Dataverse アクセラレータソリューションのインストールまたはローコードプラグインに関する問題で、Microsoft Dataverse ローコードプラグインのヒントおよび既知の問題 (文書化されていないエラーの受信など) に記載されていないものについては、ヘルプ + サポート・エクスペリエンスを使用し、以下の情報を含めてください:

問題の種類 - Dataverse Web API および SDK
問題のサブタイプ - Dataverse 用アクセラレータキット

作成できるローコードプラグインの例

ローコードプラグインの作成方法の例については、Dataverse ローコードプラグインの例 (プレビュー) を参照してください

制限

既存のキャンバスアプリ内の新しいプラグインにアクセスするには、環境言語オブジェクトを再追加する必要があります。環境テーブルデータソースを既存のキャンバスアプリに追加した後に作成されたプラグインについては、Power Fx 環境言語オブジェクトを削除して再追加する必要があります。そうすれば、更新されたプラグインのリストがアクションとして表示されます。
Intellisense では、式のテーブルを参照する場合、自動プラグインで明示的な表記が必要です。 [@Accounts] のように、(Accounts ではなく) 角かっこと @ 記号を用いた、次の曖昧さ回避構文を使用します。
ネスト化されたサポート。プラグインは、Power Fx 式から Microsoft が公開したファーストパーティーのアクションを呼び出すことしかできません。
Collect のシナリオには Patch が必要なものもあります。一部、Collect() が機能しないシナリオがあります。回避策は、以下の列の入力例に示すように Patch() を使用することです。自動化プラグインを作成する場合は、Power Fx 式で参照される各テーブルに @ を追加します。
```
Patch(Faxes,
    Collect(Faxes, { Subject : "Sub1" } ),
    { Regarding : First(Accounts) }
)
```
ローコードプラグインがコネクタとやり取りし、DLP が使用されている場合、管理者は DLP を使用した接続の作成をブロックできます。ただし、Dataverse 環境内の既存の接続参照は引き続き機能します。管理者がコネクタとのローコードプラグインのやり取りをすべてブロックする必要がある場合は、組織設定 Allowconnectorsonpowerfxactions を無効にすることができます。この設定はデフォルトで有効になっており、通常の SDK メソッド (WebAPI、SDK、PowerShell など) によって無効にすることができます。次のように、ローコードインスタントプラグインを使用してこれを無効にできます:
```
Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
```
コネクタを使用するプラグインは、特定のフィールドからの結果のみを出力できます。このため、コネクタ応答からの特定のプリミティブ値を出力値にマップする必要があります。

カスタムコネクタの制限があるローコードプラグイン

カスタムコネクタを備えたローコードプラグインがある場合は、接続参照またはフローの前に、最初にカスタムコネクタをインポートする必要があります。

ご利用環境で、カスタムコネクターがソリューションに含まれていない場合は、カスタムコネクターのみを含む別のソリューションをインポートしてください。このインポートは、実際のソリューションをインポートする前に実行してください。これを最初にする必要があります。なぜなら、その他のソリューションコンポーネントをインポートできる前に、Azure は事前にカスタムコネクタを登録する必要があるからです。

カスタムコネクタとフローを含むソリューションをインポートすると、Azure は、接続参照またはフローの登録中にカスタムコネクタを登録できなくなります。これは、以前は別のソリューションにインポートされていなかったカスタムコネクタの接続参照にも当てはまります。 Azure がカスタムコネクタを登録していない場合、インポートは失敗するか、インポートを開始できません。

詳細: ソリューションでのカスタムコネクタの作成: 既知の制限事項

参照

ローコードプラグイン Power Fx (プレビュー)

Power Apps の Dataverse ローコードプラグインで事前構築済みプロンプトを使用する

Power Apps を使って自動ローコードプラグインを作成する (ビデオ)

Power Apps を使ってインスタントローコードプラグインを作成する (ビデオ)