操作の実行

11 分

Dataverse データの作成、更新、削除、クエリという基本的な操作のほかに、カスタムなアクションも使用することができます。 AISummarize のように汎用的なユーティリティロジックもあれば、何らかのソリューション専用に作られたカスタムロジックもあります。たとえば、ScheduleVisit というアクションを呼び出すと、対応可能な技術者を検索し、訪問への割り当てが行われるとします。そのアクションを使用し、情報を入力すると結果が出力として返されるようにも作成できます。通常、タスクの実行時にアクション内部で使用されるロジックを心配する必要はありません。これらのアクションには、複数のフローやアプリで使用できるため、一貫して同じ方法で作業を行えるという重大なメリットがあります。ロジックを変更する場合も、アクションを変更するだけで、すべてのアプリとフローにその変更を適用できます。

Dataverse カスタム API を使用し、主にコーディングを行って Dataverse にネイティブな状態で開発されるアクションもあれば、インスタントローコードプラグインと Power Fx を使用して作成されるアクションもあります。アクションを使用してクラウドフローを作成する際に、そのアクションがどのように作成されたかを知る必要はなく、クラウドフローにそのまま含めることができます。アクションを使用して、Dataverse に行を作成したり行を更新したりできます。再利用可能なロジックをアクションに含めることもできます。

アクションにはバインドされたものと、バインドされていないものがあります。バインドされたアクションは、指定されたテーブル行に対して実行されます。バインドされたアクションを使用する場合は、そのテーブルの行への参照を指定する必要があります。バインドされていないアクションは特定のテーブルをターゲットとせず、テーブルやを指定せずに使用します。 Dataverse コネクタにはバインドされたアクションの実行とバインドされていないアクションの実行という 2 つの操作があり、アクションを呼び出すために使用できます。クラウドフローを作成する際には、バインドされたアクションまたはバインドされていないアクションをステップに選択します。

ローコードプラグインを使用して、計算を実行するアクションを作成する場合もあります。たとえば、テーブルで選択した通貨列に入力されたデータを使用して負債比率を計算する場合に、計算結果に基づいてポリシーを適用するロジックを追加できます。次の例では、Power Automate のバインドされていないアクションでこの処理を行っています。

次の演習では、クラウドフローに作成したアクションを使用して、アクティブな寄付に関する要約が記載されたメールを週に一度送信します。それにはまず、アクションをローコードプラグインとして作成する必要があります。

演習 - ローコードプラグインを作成してクラウドフローから使用する

この演習では、寄付金の平均額を計算するインスタントローコードプラグインを作成します。その後、このロジックをクラウドフローから呼び出します。

前提条件

次の演習を行う場合は、Dataverse とサンプルアプリがインストールされた環境を使用してください

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

Power Platform Maker Portalに移動して、環境を正しく選択します。
左側のナビゲーションからアプリを選択し、すべてを選択して、Dataverse Accelerator App を起動します。
インスタントプラグインを作成するを選択します。
[表示名] に寄付金の平均額の計算と入力し、新しい入力パラメーター ボタンを選択します。
ラベルに TargetFundraiser と入力し、データタイプに EntityReference を選択します。sample_fundraiser を選択して、新しい出力パラメーター ボタンを選択します。
ラベルに AverageDonation と入力し、データタイプに 10 進数を選択します。
この式を式フィールドに貼り付けて、保存ボタンを選択します。

{AverageDonation: LookUp(Fundraisers, sample_fundraiserid = TargetFundraiser.sample_fundraiserid).'Total Donations' / CountIf(Donations, Regarding = TargetFundraiser)}
以上で寄付 ID を取得し、プラグインのテストに使用できます。ブラウザーで新しいセッションを開始し、Power Platform Maker Portalに移動して、環境を正しく選択します。
左側のナビゲーションからアプリを選択し、すべてを選択して、Fundraiser アプリケーションを起動します。
左側のナビゲーションから寄付を選択し、奨学金基金を開きます。
URL に移動し、この寄付の ID をコピーします。
Fundraiser アプリケーションを閉じてください。
プラグインに戻り、テスト ボタンを選択します。
コピーした ID を値フィールドに貼り付けて、実行を選択します。
プラグインが実行され、寄付の平均額が返されるはずです。
Dataverse Accelerator App を閉じてください。

タスク - フローを作成してプラグインを使用する

このタスクではプラグインを作成して使用します。

Power Automate に移動し、プラグインを作成したのと同じ環境を選択します。
左のナビゲーションから作成を選択して、スケジュール済みクラウドフローを選択します。
フロー名に週次寄付レポートと入力し、週に一度月曜日に実行するよう選択して、作成を選択します。
新しい手順を挿入ボタンを選択してから、アクションの追加を選択します。
「一覧表示」で検索し、Microsoft Dataverse コネクタから行の一覧表示を選択します。必要であれば、画面に表示される指示に従って接続を作成します。
アクション名を寄付の一覧表示に変更し、テーブル名に Fundraisers を選択します。
新しい手順を挿入ボタンを選択してから、アクションの追加を選択します。
「初期化」を検索して、変数の初期化を選択します。
アクションの名前を平均額の初期化に変更し、名前に寄付の平均額と入力し、タイプに配列を選択します。
新しい手順を挿入ボタンを選択してから、アクションの追加を選択します。
「バインドされていないアクションの実行」で検索し、Microsoft Dataverse コネクタからバインドされていないアクションの実行を選択します。
ステップの名前を平均額の計算に変更し、作成した CaluculateAverageDonation プラグインの名前をアクション名として選択し、すべて表示ボタンを選択します。
Item/TargetFundraiser/Sample_fundraiser フィールドに / と入力し、動的コンテンツの挿入を選択します。
「fund」で検索し、動的コンテンツペインから Fundraiser を選択します。
Power Automate によって For each が作成され、For each の内部に平均額の計算アクションが作成されます。
For each を選択し、名前を For each fundraiser に変更します。
平均額の計算アクションの下にある新しいステップの挿入 ボタンを選択してから、アクションの追加を選択します。
「追加」で検索し、配列変数に追加を選択します。
アクションの名前を寄付の平均額に追加するに変更し、名前に寄付の平均額を選択して、この JSON を値フィールドに貼り付けます。この JSON に動的な値が追加されます。

{"Name":, "Total Donation":, "Average Donation":}
"名前": の後に / を入力して、動的コンテンツの挿入を選択します。
[動的コンテンツ] ペインから Name を選択します。
"Total Donation" の後に / を入力して、動的コンテンツの挿入を選択します。
動的コンテンツウィンドウから Total Donation を選択します。
"寄付平均額" の後に / を入力して、動的コンテンツの挿入を選択します。
動的コンテンツウィンドウから AverageDonation を選択します。
For each はこの画像のようになります。 For each fundraiser アクションの外部で新しいステップの挿入を選択し、アクションの追加を選択します。
「HTML テーブル」で検索し、データ操作コネクタから HTML テーブルを作成するを選択します。
[送信元] フィールドに / と入力し、動的コンテンツの挿入を選択します。
動的コンテンツペインから Donation averages を選択します。
HTML テーブルの作成アクションの後に新しいステップの挿入ボタンを選択してから、アクションの追加を選択します。
「メールの送信」で検索し、メールの送信 (V2) を選択します。必要であれば、画面に表示される指示に従って接続を作成します。
メール送信アクションの名前をレポートの送信に変更し、ユーザーのメールアドレスを入力して、件名に寄付レポートと入力します。
[本文] フィールドに / と入力し、動的コンテンツの挿入を選択します。
動的コンテンツペイントから HTML テーブルの作成の出力を選択します。
保存を選択し、フローが保存されるまで待ちます。
このページから移動しないでください。