次の方法で共有

Microsoft Dataverse で関数を作成して使用する (プレビュー)

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

Microsoft Dataverse で再利用できる関数を作成して使用します。 関数は、Power Fx を使用してサーバー サイドを実行する Dataverse 内の特定のコマンド セットを実行します。

重要

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

前提条件

Power Platform 環境におけるシステム カスタマイザ― セキュリティ ロールのメンバーシップ。

ソリューションに関数を作成する

  1. Power Apps に移動し、左側のナビゲーション ウィンドウからソリューションを選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
  2. 関数を作成するソリューションを開きます。
  3. コマンド バーで、新規>自動化>関数を選択します。
  4. 表示された 新しい関数サイド パネルで、次の情報を入力します。
    • 関数の [表示名] と [説明] を指定します。
    • 新しい入力パラメーター および 新しい出力パラメーターを選択し、パラメーターの名前とデータ型を指定します。 必要に応じて、さらに入力および出力パラメーターを追加します。
    • テーブル参照 リストでは、必要に応じてテーブルを選択できます。 Filter() および LookUp() などのデータ収集関数の使用を選択して、Dataverse テーブルを参照できます。
    • 数式ボックスに、Power Fx 式を入力します。
  5. 保存 を選びます。
  6. 関数をテストします。

計算式内の入力パラメータをその名前で参照します。

出力パラメーターは、{ Out: "Return value" } のように中括弧内で参照する必要があります。

ヒント

  • 数式ボックスの IntelliSense に注目してください。 赤の下線部は無効です。 黄色の波線は、ロジックが委任制限の影響を受ける可能性があることを意味します。 委任可能な関数 を使用して、委任の問題を回避します。
  • [詳細オプション] を展開して、スキーマ名を確認します。

関数の例

このセクションでは、関数の例をいくつか紹介します。

2 つの整数の合計を計算する

  1. 表示名、たとえばnew_calculateSum、および説明を入力します。

  2. 2 つの入力パラメーター x と y (どちらも整数のデータ型) と 1 つの出力パラメーター z (データ型整数) を追加します。

  3. 数式ボックスに、数式を入力します。
    { z:x+y }

    2つの数値を乗算する関数。

  4. 関数をテストします。

記事のテーブルに新しいタイトルを追加する

  1. 2 つの入力パラメーター title と url (どちらも文字列データ型) と 1 つの出力変数 message (データ型文字列) を作成します。
  2. テーブル参照ドロップダウンで、サポート情報フェデレーション記事 テーブルを選択します。
  3. 数式ボックスに、数式を入力します。
Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

入力文字列に選択した文字列が含まれているかどうかを検証します

  1. 入力パラメーター DocumentTextInput (文字列データ型) とresult (データ型 string) という名前の 1 つの出力変数を作成します。
  2. 数式ボックスに、数式を入力します。
{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

ホテル宿泊料金の計算

  1. nights、rooms、tax、discount、roomservice、ratepernight (すべて文字列データ型) の 6 つの入力パラメーターと、1 つの出力変数 price (データ型浮動) を作成します。
  2. 数式ボックスに、数式を入力します。
{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

その他の関数の例

関数のその他の例については 関数の例 (プレビュー) を参照してください。

関数の編集、テスト、または削除

関数の編集

  1. 関数 領域で関数を選択します。
  2. コマンド バーで、編集を選択します。
  3. 数式を変更し、保存 します。

関数をテストする

  1. 関数 領域で関数を選択します。
  2. コマンド バーで、テストを選択します。
  3. 関数で定義されている入力パラメーターの値を指定し、再生を選択します。

テストが成功すると、組織の URI、関数名、出力パラメーターと値などの情報を含む OData 応答が返されます。

関数をテストする

ヒント

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

関数を削除する

重要

プレビュー中は、コンポーネントが孤立する可能性があるため、ソリューション 領域から関数を削除しないでください。 関数を削除するには、左側のナビゲーション ウィンドウの Power App (make.powerapps.com) >関数 に移動します。

  1. 左のナビゲーション ウィンドウで関数を選択し、自分のソリューションを選択します。 項目がサイド パネル ウィンドウに表示されない場合は、…さらに表示 を選択して、目的の項目を選択します。
  2. コマンド バーで 削除 を選択します。

Microsoft Dataverse の関数 (プレビュー)