フォーム

フォームは、アクションのパラメーターの値を入力し実行できる画面を作成するためのコンポーネントです。ビューの利用者は、必要に応じてパラメーターの値を入力し、実行ボタンを押すことでアクションを実行できます。

アクションの実行結果は「テーブル」「詳細テーブル」から利用できます。詳しい利用方法についてはそれぞれのドキュメントをご参照ください。

アクション設定

ビューの利用者が実行するアクションを選択します。

以下の条件に該当するアクションは選択できません。

パラメーターを持つアクションを選択すると、アクションのパラメーターの初期値を入力できます。入力した初期値は、ビューを開いたときに自動的にフォームの各要素に入力される値です。ビューの利用者は初期値のままでもアクションを実行できますし、編集してからの実行も可能です。

⚠️

ファイルパラメーターに対しては初期値を設定できません。

パラメーターの初期値は、アクション実行画面と同じフォームでの入力が可能です。利用できるフォームについては、各種パラメーターをご覧ください。

また、「値を式で設定する」を有効にすると、JavaScriptを使って柔軟に値を設定できます。詳細については「式」をご覧ください。

なお、式では以下の値が使用できます。値の詳しい説明についてはドキュメントの各セクションをご覧ください。

resultsは「初期値用アクション」を設定すると利用可能になります。

「フォームの表示時に初期値で実行する」オプションを有効にすると、フォームコンポーネントの表示時に初期値を使ってアクションを自動実行します。

このオプションは例えば、開いたときには全件を表示しその後絞り込みを行なえる検索画面を作るようなケースでご活用いただけます。実行結果は「フォームで実行」を設定している「テーブル」や「詳細テーブル」で表示されます。

ビューからフォームを手動で実行すると、新しい結果で上書きされます。

⚠️

ファイルパラメーターを持つアクションでは、ファイルに初期値を設定できないため、このオプションを有効にしても表示時の自動実行はスキップされます。

⚠️

レビュー設定が有効なアクションでは、このオプションは使用できません。

初期値用アクションはフォームの初期値にアクションの実行結果を設定できる機能で、データを更新する画面などを作る際に使用できます。

以下の条件に該当するアクションは選択できません。

パラメーターを持つ初期値用アクションを実行するために、パラメーターの値を入力する必要があります。初期値用アクションはビューが表示されたときに自動で実行されます。入力した初期値用アクションのパラメーターの値はその際に使用され、ビューの利用者からは見えません。

入力方法は「アクション設定」のパラメーターの初期値と同様です。ただし、「値を式で設定する」において初期値用アクションの結果を使うことはできません。

レビュー設定が紐づいているアクションをフォームに設定すると、ビューの利用者はアクションを直接実行する代わりにレビュー依頼ができます。

レビュー設定が紐づいているアクションは、アクション選択のドロップダウンリストで「（レビュー設定あり）」というラベルが表示されます。

レビュー設定が紐づいているアクションを選択すると、設定画面に「レビューが有効な環境」が表示されます。ここでは、どの環境でレビューが必要になるかを確認できます。

レビューが有効な環境でビューを開くと、通常の「実行する」ボタンの代わりに「レビューを依頼する」ボタンが表示されます。ビューの利用者は、パラメーターの値を入力した後にレビュー依頼を作成できます。

レビュー依頼の詳細については「レビュー設定」をご覧ください。