このページでは、ルールを操作するための次の方法について説明します。
ルールは、ロジックを制御し、別のフィールドのデータが変更されたときに 1 つのフィールドを自動的に更新するなど、フォーム内の機能を自動化するのに役立つ強力なツールです。ルールでは、数式をデータに適用したり、データを変更したり、フォーム内のデータの外観を変更したりできます。
たとえば、ルールを使用して、データベースに対する検索、Web サービスのアクティブ化、フィールド値の設定など、特定の機能をボタンでトリガーするようにします。また、ルールを使用して、フィールドの色を赤に変更して誤った値を示すことにより、データの誤入力を警告することもできます。
高度なルールの場合
ソリューション ビルダーがルールの作成に必要な柔軟性を提供しない場合、上級者のユーザーはカスタム JavaScript を使用してルールを作成できます。サポートされている JavaScript ラッパー、構文などについては、JavaScript リファレンス ガイド を参照してください。
ルール アクション
すべてのルールは、1 つ以上のアクションで構成されます。上記の例では、単一のルールを使用して両方の関数を処理できます。各関数は個別のアクションになります。たとえば、ルールを使用して、ユーザーが項目の価格フィールドと数量フィールドに入力した値に基づいて、合計価格フォーム フィールドを自動的に計算して更新できます。
フィールドまたはボタンに複数のルールを適用する場合、次のアクションは 1 回しか使用できず、シーケンスの最後のルールである必要があります。
- クエリの実行
- Web サービスの実行
- フォームの送信
これは、サーバーに対してリクエストが行われるため、リクエストが行われると追加のルールを実行できないためです。
ルールが適用されたフィールドは、[ソリューション] タブの [ソリューション] ペインで名前の横にチェック アイコンが表示されます。例:
ルールは、ルール タイプ (アクション、フォーマット、または検証)、1 つ以上の条件、または 1 つ以上のアクションで構成されます。
新しいルールの追加
- [プロパティ] ペインで [プロパティ] をクリックします。
- [プロパティ] タブの [ルール] の横にある [オプション] [...] ボタンをクリックします。
- [プロパティ] ペインに [ルール インスペクター] が開きます。
- [ルールの追加] をクリックします。
- ルールの情報を以下のように入力します。
- ラベル: ルールのわかりやすい名前を入力します。
- フォームの読み込み時にルールを実行: フォームが読み込まれてすぐにルールを実行するには、これを選択します。
- タイプ: ルール タイプ (検証、フォーマット、またはアクション) を選択します。
- 条件: クリックして、特定のフォーム フィールドが変更されたときなど、ルールがトリガーされる条件を作成します。詳細は、条件の使用 (以下) を参照してください。
- メッセージ: ルールの実行時にユーザーに表示するメッセージを入力します。
- ポップアップを使用する: ポップアップを使用してユーザーにメッセージを表示するには、このボックスをオンにします。
- ポップアップ タイトル: [ポップアップを使用] を選択した場合は、このフィールドにポップアップ ウィンドウの名前を入力します。
- [OK] をクリックして終了します。
既存のルールの変更または削除
変更するルールがあるフィールドまたは要素をクリックします。
- [プロパティ] ペインで [プロパティ] をクリックします。
- [プロパティ] タブの [ルール] の横にある [オプション] [...] ボタンをクリックします。
- ルール エディタで:
- [追加] をクリックしてルール アクションを追加します。
- [編集] アイコンをクリックして、エディターでルールを開きます。
- [削除] (ゴミ箱) アイコンをクリックして、ルールを削除します。
- [条件] をクリックして、ルール条件を変更します。詳細は、条件の使用 (以下) を参照してください。
- [条件の削除] (ゴミ箱) をクリックして、条件を削除します。
- [OK] をクリックして変更を終了します。
ルール インスペクターの使用
ルール インスペクターを使用して、ソリューション内のすべてのルールのスナップショットまたは「ダッシュボード」を取得します。
ルール インスペクターから、次のことができます。
- 検索バーで特定のルールを検索して、結果をフィルタリングします。
- 結果を印刷します。
- 名前をクリックして ルールを編集 します。
- フィールドの名前をクリックして、フィールドに適用されているすべてのルールを表示します。
条件の使用
[条件ビルダー] は、条件のロジックとルールを作成するためのシンプルなグラフィカル インターフェイスを提供します。
- [条件を追加] をクリックして、条件を追加します。
- [グループを追加] をクリックして、条件のサブグループを追加します。
- ドロップ ダウン メニューから [フォーム フィールド] と論理演算子 (「is equal to」や「not equal to」など) を選択します。
- 条件またはグループを削除するには、[削除] をクリックします。
下: ルール条件ビルダーの条件例
ルールのタイプ
ルールには、次の 4 つの基本的なタイプがあります。検証、フォーマット、アクション、および JavaScript (JavaScript ルールの詳細については、JavaScript リファレンス ガイドを参照してください)。各タイプのルールは、一般的なプロパティの共通セットによっても管理されます。
次の詳細については、以下を参照してください。
- 一般ルール プロパティ
- 検証ルール
- フォーマット ルール
- アクション ルール
- アクション ルール クイック リファレンス テーブル
一般ルール プロパティ
フォームの読み込み時にルールを実行フォームが読み込まれたときにルールをすぐに実行する必要があるかどうかを示します。
このルールを実行する前に、デバッガーで実行を停止してください
このオプションは、ルールのトラブルシューティングに適しています。このオプションを有効にすると、ルールを実行する直前に JavaScript コードにデバッグ ブレークポイントが挿入されます。ブラウザ開発ツールがアクティブで、このルールが実行されると、コードをさらに問い合わせるために、ルールを実行する直前にブラウザのデバッグ セッションが停止します。
ルールの無効化
このオプションを有効にすると、フォームの実行時にルールの実行が停止します。
タイプ 作成するルールのタイプを指定します。選択したルールのタイプに応じて、追加のオプションが表示されます。詳細は、以下を参照してください。
- 検証
- フォーマット
- アクション
条件 指定された条件 条件が true の場合、このルールが実行されます。それ以外の場合、このルールは実行されません。
リファレンス データ リストの Yes/No 列と比較するために条件を使用する場合 Yes/No 列: 値は True または False である必要があります。 (引用符などは除きます。) 最初の文字は 大文字にする必要があります。つまり、True または False であり、true/false ではありません。
1. 検証ルール
|
2. フォーマット ルール
|
3. アクション ルール
アクション ルールは最も用途の広いルールです。アクション ルールは、特定のフィールドでの値の設定、フィールドでの値の比較、数式に基づく値の計算など、さまざまな機能を実行できます。
|
[アクション] ルールの基本情報と条件を指定した後:
|
アクション ルール - クイック リファレンス テーブル
各アクション ルールの機能と、アクションに関連付けられているパラメーターの説明については、以下を参照してください。
アクション | 説明 |
---|---|
新しい行の追加 |
繰り返しテーブルまたはグループに新しい行を追加します。 パラメーター
|
フィールド プロパティの変更 |
フィールド プロパティを変更して、表示/非表示、有効/無効、入力の必要/不要などを設定できます。 パラメーター
|
グループ表示の変更 |
グループ内の指定されたフィールドに基づいて、グループを表示、非表示、展開するか、折りたたむかを切り替えます。 パラメーター
|
同様の行をコピー |
このルールを使用して、1 つの繰り返しテーブルまたは繰り返しグループからターゲットの繰り返しテーブルまたは繰り返しグループに行をコピーできます。 このルールは、ソース繰り返し要素の列値と一致し、セレクター フィールドのプロパティに基づいてコピーする行を決定します。 行のコピー アクションは、一致する行を上書きするか、新しい行としてターゲットの繰り返し要素に追加するかを決定します。 |
テーブル データをコピー |
ソリューション ビルダーのユーザー インターフェイスで使用できる [テーブル データのコピー] ルールを使用して、テーブル間でデータをコピーできます。 この機能にアクセスしたい場合は、詳細について営業アカウント担当者にお問い合わせください。 パラメーター
注意点と制限事項
|
行の削除オプション |
パラメーター
|
空のテーブル |
繰り返しテーブルまたはグループからすべてのデータを消去します。 パラメーター
|
クエリの実行 |
フォームでクエリ コントロールを実行します。 パラメーター
|
フィールドのルールを実行 |
別のフィールドでルールを実行します。これは、2 つのフィールドに相互に関連するルールがある場合に役立ちます。 パラメーター
|
Web サービスの実行 |
フォームで Web サービス コントロールを実行します。 パラメーター
|
繰り返しコンテンツのフィルタリング |
繰り返しテーブル/グループのコンテンツを保持したままフィルタリングを有効にします。「条件」を設定することができます。例: field1="this"、field2 !="that "。条件を満たした行のみが繰り返しテーブル/グループに表示されます。 パラメーター
|
新しい行オプション |
パラメーター
|
ドロップ ダウン オプションの再読み込み |
ドロップ ダウン リストまたはコンボ ボックスのオプションを再読み込みします。これは、動的オプション リストに使用できます。 パラメーター
|
マップのレンダリング |
フォームのマップ コントロールに新しい住所を送信します。 パラメーター
|
繰り返しコンテンツの検索 |
これにより、すべてのフィールドで「パターン」を検索するメカニズムが提供されます (たとえば、いずれかのフィールドに「abcd」が含まれている場合)。この場合、少なくとも 1 つのフィールドにパターンが含まれているすべての行が、繰り返しテーブル/グループに表示されます。 パラメーター
|
フィールド値の設定 |
このアクションにより、フォームのフィールドの値を変更できます。 パラメーター
|
ラベルの設定 |
このルール アクションは、フィールド値の設定 (上記) に似ていますが、フォーム要素のラベル (またはサブラベル) を変更します。 パラメーター
|
メッセージの表示 |
これにより、ルールで指定されたメッセージ テキストを含むポップアップ ボックスが表示されます。このルールのプロパティは、デフォルトでフォームのフィールドから取得されます。 |
繰り返しコンテンツのソート |
繰り返しテーブルの項目をソートします。 パラメーター
|
フォームの送信 |
このアクションにより、フォームの [送信] ボタンをシミュレートできます。 パラメーター
|