変数・コントロールの出力値との使い分け

以前書いた記事で作成した表の再掲です。
それぞれのスコープや用途を理解して使い分けましょう。

コンポーネントと名前付き計算式の使い分け

(イメージ)右下の黒丸のようにアプリ個別の複雑な要件には名前付き計算式

アプリ個別の特殊な要件やデータソースに依存しているようなロジックのカプセル化には名前付き計算式が向いています。

逆に組織単位で共通部品として持っておくべきような汎用的なロジックは、管理のしやすさという面でもコンポーネントの方が向いています。

名前付き計算式はロジックのみでコントロールなどの画面要素を持ちません。

そのためコントロールのまとまりとして再利用が必要な(カプセル化したい)場合はコンポーネントを利用します。

入力・出力で扱えるデータ型が異なりますが、現時点ではコンポーネントの方が使えるデータ型が多いです。

ユーザー定義関数

コンポーネント(入力)

現時点では引数ありの名前付き計算式(=ユーザー定義関数)・コンポーネントどちらの機能も引数ありの関数作成機能が試験段階の機能であるためご注意ください。

有効化したいアプリの設定をクリックします。

近日公開の機能を選択して、拡張コンポーネントのプロパティをオンにします。

ユーザー定義関数は以下の手順で有効化します。

まずは新しい分析エンジンを有効化します。

その後ユーザー定義関数を有効にします。

こちらは変数ではなく数式(関数)なので、使用するたびに最新化されます。そのため、値に要求される情報鮮度によって変数とFormulasを使い分ける必要があります。

その他の変数同様定義や用途を変数タブから確認できます。

一時的に値を確認するときはボタンのOnSelectが便利です。
また、現在の値をApp.Formulasプロパティではプレビューで確認することはできません。

名前付き計算式はApp.OnStartで定義していた定数の代替手段としての利用が推奨されていますが、グローバル変数と違い動的(常に値が最新)であるため完全な代替手段にはなりません。

App.OnStartは廃止予定みたいですが、以下の記事で検証したところデータソースを都度参照するような定数はApp.OnStartで宣言した方がパフォーマンスよさそうです。

コントロールの出力値とは複数の箇所で利用したり、複雑な数式であるかで使い分けるといいと思います。

複数箇所での利用という観点では、他画面のコントロールを参照するとパフォーマンスが落ちる場合があります。ケースにもよりますが、ユーザー定義関数の使用を検討しましょう。

また複雑な数式という観点では、名前付き計算式に複雑な数式を書いておいてそれを参照することで、数式の可読性が向上します。

前述の通り現時点(2024/5/6)では試験段階の機能となっています。

通常Formulasでは一行目のように引数なしの数式しか作成できませんが、この機能を有効化することで二行目のように入力と出力をもつ関数を作成できます。

引数なし(GA済み)と引数あり(試験段階)の数式は共存可

関数を作成するための構文は以下。通常のFormulasと同様文末の;を忘れないようにしましょう。

<関数名>(<引数名>:<引数の型>):<関数の型> = <数式>;
IsWeekDay(date:Date):Boolean = Not(Weekday(date) in [1, 7]);

引数ありの数式を作成できるようになることで、コントロールの出力値を入力することなどが可能になるためより汎用性の高い数式が作成できるようになります。

If(
    IsWeekDay(DatePickerCanvas1.SelectedDate),
    "平日です",
    "休日です"
)

コンポーネントについては以下の記事をご覧ください。