Apps ユーザーガイド

デリバリー:

最終更新日時 2025年10月29日

レガシ式と VB の式

このセクションでは、アプリの要素をバインドする一般的なユースケースと、レガシ式と VB 式を使用してバインドを実現する方法をそれぞれ説明します。

[画像] コントロールで静的文字列の URL を使用する

レガシエクスペリエンス	VB
[画像] コントロールを追加します。 [URL/値のバインド] プロパティを `https://path/to/the/image_file.jpg` に設定します。注: Base64 の画像もサポートされます。	[画像] コントロールを追加します。 [ソース] プロパティを `new AppsFile("https://path/to/the/image_file.jpg")` に設定します。注: Base64 の画像もサポートされます。

[画像] コントロールでエンティティの File フィールドを使用する

レガシエクスペリエンス	VB
アプリで、目的のファイルを保持するエンティティを参照します。エンティティを [表] コントロールにバインドします。 [画像] コントロールを追加します。 [URL/値のバインド] プロパティをファイルに設定します。	アプリで、目的のファイルを保持するエンティティを参照します。エンティティを [表] コントロールにバインドします。 [画像] コントロールを追加します。 [ソース] プロパティを `MainPage.Table.SelectedItem.FileColumn` に設定します。

[画像] コントロールでストレージバケットのファイルを使用する

レガシエクスペリエンス	VB
アプリで、目的のファイルを保持するストレージバケットを参照します。 AppsFile 型のアプリ変数を作成します。たとえば、`fileVar` です。 [ストレージバケットからファイルをダウンロード] ルールを追加します。ダウンロードしたファイルを、先ほど作成したアプリ変数 (`fileVar`) に割り当てます。 [画像] コントロールを追加します。 [URL/値のバインド] プロパティを `fileVar` に設定します。	アプリで、目的のファイルを保持するストレージバケットを参照します。 AppsFile 型のアプリ変数を作成します。たとえば、`fileVar` です。 [ストレージバケットからファイルをダウンロード] ルールを追加します。ダウンロードしたファイルを、先ほど作成したアプリ変数 (`fileVar`) に割り当てます。 [画像] コントロールを追加します。 [ソース] プロパティを `fileVar` に設定します。

レガシエクスペリエンス

アプリで、目的のファイルを保持するストレージバケットを参照します。
AppsFile 型のアプリ変数を作成します。たとえば、fileVar です。
[ストレージバケットからファイルをダウンロード] ルールを追加します。
ダウンロードしたファイルを、先ほど作成したアプリ変数 (fileVar) に割り当てます。
[画像] コントロールを追加します。
[URL/値のバインド] プロパティを fileVar に設定します。

アプリで、目的のファイルを保持するストレージバケットを参照します。
AppsFile 型のアプリ変数を作成します。たとえば、fileVar です。
[ストレージバケットからファイルをダウンロード] ルールを追加します。
ダウンロードしたファイルを、先ほど作成したアプリ変数 (fileVar) に割り当てます。
[画像] コントロールを追加します。
[ソース] プロパティを fileVar に設定します。

チョイスセットを使用して [リスト] コントロールを表示する

レガシエクスペリエンス	VB
チョイスセットを使用してアプリ内でエンティティを活用する方法について詳しくは、こちらをご覧ください。	アプリ内で、チョイスセットを持つエンティティを参照します。 [リスト] コントロールを追加します。 [リストのソース] プロパティを `GetChoiceSet("entity_name")` に設定します。 [列] プロパティにチョイスセットの名前を設定します。詳しくは、こちらの手順をお読みください。

[リスト] コントロールにバインドされたチョイスセットを参照する

レガシエクスペリエンス	VB
こちらのページの手順 4 と 5 をご覧ください。	`<PAGE_NAME>.<CONTROL_NAME>.SelectedItem.<COLUMN_NAME>`<PAGE_NAME>.<CONTROL_NAME>.SelectedItem.<COLUMN_NAME>

単一選択のチョイスセットをコントロールの既定値として設定する

単一選択のチョイスセットは、[ドロップダウン] コントロール、[ラジオボタン] コントロール、[リスト] コントロールでサポートされます。

レガシエクスペリエンス	VB
	`<PageName>.<ControlName>.DataSource.data.Select(Function(x) x.NumberId).ToList(0)`<PageName>.<ControlName>.DataSource.data.Select(Function(x) x.NumberId).ToList(0)

複数選択のチョイスセットをコントロールの既定値として設定する

複数選択のチョイスセットは、[複数選択ドロップダウン] コントロールでサポートされます。

レガシエクスペリエンス	VB
	`<PAGE_NAME>.<MULTISELECT_CONTROL_NAME>.DataSource.data.Where(Function(x) <VARIABLENAME>.<ENTITY_FIELD_OF_TYPE_CS>.contains(x.NumberId)).toList()`<PAGE_NAME>.<MULTISELECT_CONTROL_NAME>.DataSource.data.Where(Function(x) <VARIABLENAME>.<ENTITY_FIELD_OF_TYPE_CS>.contains(x.NumberId)).toList() 注: この式を使用するには、[値を設定] ルールを使用してエンティティ変数が `selectedItem` に設定されていることを確認してください。

レガシエクスペリエンス

<PAGE_NAME>.<MULTISELECT_CONTROL_NAME>.DataSource.data.Where(Function(x) <VARIABLENAME>.<ENTITY_FIELD_OF_TYPE_CS>.contains(x.NumberId)).toList()<PAGE_NAME>.<MULTISELECT_CONTROL_NAME>.DataSource.data.Where(Function(x) <VARIABLENAME>.<ENTITY_FIELD_OF_TYPE_CS>.contains(x.NumberId)).toList()

注:

この式を使用するには、[値を設定] ルールを使用してエンティティ変数が selectedItem に設定されていることを確認してください。

静的文字列を使用して [リスト] コントロールを表示する

レガシエクスペリエンス	VB
`=["Value1", "Value2", "Value3"]`=["Value1", "Value2", "Value3"]	`AppsDataSource.from({"Value1", "Value2", "Value3"})`AppsDataSource.from({"Value1", "Value2", "Value3"})

日付を [日付の選択] コントロールにバインドする

レガシエクスペリエンス	VB
今日の日付をバインドするには、[既定の日付] プロパティを `=Now()` に設定します。	今日の日付をバインドするには、[既定の日付] プロパティを `DateOnly.FromDateTime(Now)` に設定します。
特定の日付 (2021 年 5 月 5 日など) をバインドするには、[既定の日付] プロパティを `2021-01-05` のように設定します。	特定の日付 (2021 年 5 月 5 日など) をバインドするには、[既定の日付] プロパティを `new DateOnly(2021,1,25)` のように設定します。

エンティティの Date-Time フィールドを [日付の選択] コントロールで使用する

レガシエクスペリエンス	VB
必要なエンティティフィールドを [日付の選択] コントロールにバインドします。	`DateOnly.FromDateTime(customerEntityVar.DOB.Value.Date)`DateOnly.FromDateTime(customerEntityVar.DOB.Value.Date)

[日付の選択] の 2 つの値の差を計算する

レガシエクスペリエンス	VB
N/A	`MainPage.Datepicker1.Value.Value.DayNumber - MainPage.Datepicker.Value.Value.DayNumber`MainPage.Datepicker1.Value.Value.DayNumber - MainPage.Datepicker.Value.Value.DayNumber

エラーを参照する

エラーは、以下のルールから参照できます。

プロセスを開始
エンティティのルール
キューのルール
[トリガーワークフロー] ルール

レガシエクスペリエンス	VB
[プロセスを開始] ルールの「エラーを処理する」	VB の式では、ルールの出力にエラーが表示されます。次のようにエラーを参照します。 `<PAGENAME>.<RULENAME>.Error.Message`<PAGENAME>.<RULENAME>.Error.Message `<PAGENAME>.<CONTROLNAME>.<RULENAME>.Error.Message`<PAGENAME>.<CONTROLNAME>.<RULENAME>.Error.Message