Power Fx 関数の構築の基礎

  • 5 分

ローコードの Power Fx と直感的なインターフェイスにより、Dataverse での関数構築が簡単になりました。 関数は、Dataverse のサーバー側でロジックを実行する再利用可能なソリューション オブジェクトであり、アプリを効率化するための強力なツールになります。 キャンバス アプリ、モデル駆動型アプリ、カスタム ページ、フローなどから関数を呼び出すことができます。

Power Fx 関数を初めて使用する場合、次のセクションで関数を作成するときに考慮すべき重要な要素について説明します。

Power Fx 関数の主なプロパティ

Power Fx 関数の主なプロパティは、次のとおりです。

  • 表示名 (必須) - 関数のユーザーフレンドリ名。 明確でわかりやすい名前を使用すると、複数の関数を管理するときに役立ちます。 整理するため、一貫した命名規則を検討してください。 関数を作成した後は、名前を変更できないことに注意してください。

  • スキーマ名 - 関数に対するシステムの論理名。 表示名を入力すると、システムによってスキーマ名が自動的に生成されます。表示名と同様、後で変更することはできません。

  • 説明 (必須) - 関数の実行内容の簡単な説明。 明確な説明を追加すると、他の人 (および自分自身) がその目的を理解しやすくなります。 名前と同様、このプロパティは作成後に編集することはできません。

  • 式 (必須) - アクションや計算を実行するために Power Fx 式を入力する場所。 記述時、IntelliSense が問題のフラグ付けに役立ちます。 赤い下線は、数式にエラーがあることを意味しています。 下線部分にカーソルを合わせると、IntelliSense によって問題点が示されます。

  • テーブル参照 (オプション) - 関数を最大 5 つの Dataverse テーブルにリンクし、Filter() または LookUp() を使用してデータを取得できます。 関数はユーザーのコンテキストで実行されるため、関数を呼び出すユーザーが参照先のテーブルにアクセスできることを確認してください。 関数は、Dataverse のセキュリティをオーバーライドできません。

  • パラメーター (オプション) - 関数は、入力パラメーター (関数にデータを送るため) と出力パラメーター (結果を返すため) を受け取ることができます。 これらのパラメーターは、動的な入力を受け入れるという点で変数と同様に機能し、これにより関数の柔軟性を高めて、さまざまなアプリ間で再利用可能になります。

    入力パラメーターと出力パラメーターのスクリーンショット。

サポートされているパラメーター タイプ

関数は、次のデータ型を受け入れて返すことができます。

  • ブール値
  • 文字列
  • 浮動小数点数
  • 10 進
  • 日時
  • 整数

注意すべきこと

Power Fx 関数を使用するときは、次の点に注意してください。

  • 一部の Power Fx 数式には制限があり、または Dataverse 関数ではサポートされていません。 始める前に、予期せぬ事態を避けるため、サポートされている関数のリストを確認してください。
  • 関数を Dataverse ソリューションに保存できるため、環境間で移植可能になります。 管理ソリューションで作業している場合、既存の関数の変更または削除に制限があることがあります。
  • 関数が他の Dataverse テーブルまたは関数に依存している場合、特に環境間でソリューションを移動するときには、依存関係に注意してください。
  • 後で関数を変更したときに依存関係が壊れないよう、関数が使用されている場所 (アプリやフロー内など) を追跡します。
  • バージョン管理関数は自動ではないため、更新を行った場合は、ドキュメントを維持することを検討してください。
  • 孤立したコンポーネントが残る可能性があるため、ソリューション領域から関数を削除しないでください。 代わりに、Power Apps の関数領域から関数を削除する必要があります。 削除する関数を選択し、コマンド バーで 削除 を選択します。

これらの基本を理解すれば、独自の Power Fx 関数を作成する準備が整います。 試行とテストを行いながら、構築のプロセスを進めていきましょう。