表示ルール アクション
表示ルール アクションを使用して、フォームに表示する内容、またはフォーム上のコントロールの動作を動的に制御します。
たとえば、フォーム上の 1 つ以上のフィールドを非表示にしたり、フィールドを読み取り専用または無効にしたりできます。ランタイムに、ユーザーが定義済みのアクションで構成されたコントロールをクリックすると、表示ルールが呼び出されます。
ユーザーがフォームに入力した内容に基づいて、コントロールの表示プロパティをリアルタイムで自動的に変更するように構成できます。たとえば、オンラインの保険フォームに入力する際、該当する役職名が職種リストにない場合に、ユーザーが「その他」オプションを選択すると、役職を入力するための追加フィールドが表示されるようにできます。ただし、ユーザーが役職の事前定義リストから職種を選択した場合、追加のテキスト ボックスは表示されません。
表示ルールとは
表示ルールとは、1 つ以上のフィールドに対して定義された条件のセットで、条件を満たす場合または条件を満たさない場合にそれぞれ適用される表示状態です。表示ルールは、次の 4 つの主な要素で構成されます。
要素 | 説明 |
---|---|
フィールド | フォーム、フォーム変数、またはグローバル変数のフィールド。 表示ルールをトリガーするため、次のコントロールを条件に使用します。
ボタン、ツールバー、テーブル、イメージ ボタン、ハイパーリンク、タブ、水平線の各コントロールは、条件内で使用するプロパティを公開しないため、条件では使用できません。
|
演算子 |
|
値 | 静的または動的な値。動的な値として、フォーム フィールド、フォーム変数、またはグローバル変数を使用できます。 |
表示状態 | true または false の条件と使用されるコントロールに基づいて、表示状態は次のいずれかになります。
|
-
フォーム モデリング バーで、[アクション] をクリックし、[新規] をクリックします。
[新しいアクション] ダイアログ ボックスが表示されます。
- [タイプ] リストで、[表示ルール] を選択します。
- デフォルトの [名前] (DisplayRule1) を意味のある名前に変更します。
- この項目は任意です。アクションの [説明] を入力します。
- この項目は任意です。[複数言語] を選択して、言語ごとに固有のアクションを個別に構成します。複数言語の設定アクションを参照してください。
-
コントロールをクリックしたときに呼び出すルールを定義します。
-
ルール エディタを右クリックして、変数を選択します。
- 表示ルールでは、静的な値、動的な値、または静的な値と動的な値の組み合わせを使用できます。
- 表示ルールをコピーして別の表示ルールに貼り付けると、表示ルールを再利用できます。
- [検証] をクリックします。
-
ルール エディタを右クリックして、変数を選択します。
-
[True の結果] で、条件が満たすときに適用する表示状態を設定します。
- をクリックします。
-
[名前] リストで、必要なコントロールを選択します。
結果でテーブル列を使用することもできます。
- [表示] リストで、必要な表示状態を選択します。
-
[追加] をクリックします。
複数のフィールドに同じ表示設定を定義できます。
-
[誤った結果] で、条件が満たされなかったときに適用する表示状態を設定します。
- をクリックします。
- [名前] リストで、必要なコントロールを選択します。
- [表示] リストで、必要な表示状態を選択します。
- [追加] をクリックします。
ルールの実行順序は、イベントで選択された順序に応じて異なります。たとえば、次の 2 つの表示ルールを定義し、その順序を次のように設定します。- 表示ルール 1: フィールド 1 = 10、フィールド 2 = 必須
- 表示ルール 2: フィールド 1 > 5、フィールド 2 = オプション
表示ルール 2 が最後に適用されるため、フィールド 2 はオプションとして設定されます。
-
[追加] をクリックします。
新たに作成されたアクションが [アクション] リストに追加されます。
-
このアクションをトリガーするため、アクションにコントロールを関連付けます。フォーム コントロール イベント用のアクションの構成を参照してください。または、フォーム イベントに対してこのアクションを呼び出すには、アクションをフォームに関連付けます。フォームへのアクションの関連付けを参照してください。
表示ルール アクションの作成中は、次のルールに従ってください。ルールに反している場合、警告メッセージが表示されます。
-
有効なフィールドの値であることが必要です。たとえば、文字列データ型フィールドの値はテキストで、数値データ型フィールドの値は数字である必要があります。
-
ルールに条件を設定しない場合でも、ルール内にはいずれかの表示状態を設定します。
- 少なくとも 1 つの結果 (true または false) を指定します。すべての結果フィールドが完成している必要があります。
「表示ルールを使用したセルの折り畳みまたは展開」を参照してください。
-