[AEM Forms]{class="badge positive" title="AEM Formsに適用）。"}

コアコンポーネントに基づくアダプティブフォームのルールエディターでの演算子のタイプとイベント

AEM Forms as a Cloudでは、ルールエディターにさまざまなオペレータータイプとイベントが含まれており、複雑な条件やアクションを簡単に定義および実行できます。

アダプティブフォームのルールエディターで使用できるオペレータータイプは、正確な条件を作成するための堅牢なフレームワークを提供します。 データを操作し、計算を実行し、複数の条件を論理的かつ一貫した方法で組み合わせることができます。 値の比較、算術演算の実行、文字列の操作など、これらの演算子を使用すると、ルールが柔軟で強力であることを確認できます。

ルールエディターのイベントは、ルールをアクティブ化するトリガーとして機能します。 特定の条件が満たされたときに発生する特定のアクションを定義します。 さまざまなタイプのイベントを活用することで、ユーザーインタラクション、予定時間、データの変更、システムの状態など、幅広いシナリオへの対応を自動化できます。 これらのトリガーを指定して、特定の要件に合わせた動的かつレスポンシブなルールを作成できます。

利用可能なオペレータータイプとイベントを理解し、使用することで、ルールエディターの可能性を最大限に引き出すことができます。これにより、独自のニーズを満たす効率的で効果的なルールを作成し、システム全体の機能を向上させることができます。

ルールエディターで使用可能な演算子の種類とイベント available-operator-types-and-events-in-rule-editor

ルールエディターでは、次のような論理演算子やイベントを使用してルールを作成することができます。

ルールエディターで利用可能なルールタイプ available-rule-types-in-rule-editor

ルールエディターでは、ルールを記述するための、事前定義された一連のルールタイプを利用できます。ここからは、各ルールタイプについて詳しく説明します。ルール エディターでのルールの作成について詳しくは、​ ルールの作成を参照してください。

When whenruletype

「When」のルールタイプは、「条件 - アクション - 代替アクション」のルール構文に従います。また、単に「条件 - アクション」構文が使用されることもあります。このルールタイプでは、評価条件を指定し、条件が満たされた（True）場合にトリガーするアクションを記述します。「When」のルールタイプの使用中、複数の「AND」および「OR」演算子を使用してネスト式を作成することができます。

「When」のルールタイプを使用することで、フォームオブジェクトの状態を評価し、1 つ以上のオブジェクトに対してアクションを実行することができます。

代表的な「When」のルール構文は、次のようになります。

When on Object A:

(Condition 1 AND Condition 2 OR Condition 3) is TRUE;

Then, do the following:

Action 2 on Object B;
AND
Action 3 on Object C;

Else, do the following:

Action 2 on Object C;

ラジオボタンやリストなどの複数値コンポーネントに対してルールを作成する場合、オプションが自動的に取得され、それらのオプションを使用してルールを作成できるようになりました。これらのオプションの値を再入力する必要はありません。

例えばリストの場合、赤、青、緑、黄という 4 つのオプションがあります。ルールの作成中に、オプション（ラジオボタン）が自動的に取得され、ルール作成者は次のように利用できるようになります。

「When」ルールを記述するときに、「Clear Value Of」アクションをトリガーできます。「Clear Value Of」アクションは、指定したオブジェクトの値をクリアします。「When」ステートメントのオプションとして「Clear Value of」を指定すると、複数のフィールドを持つ複雑な条件を作成できます。 Else文を追加して、さらに条件を追加できます

When で許可された複数のフィールド allowed-multiple-fields

When 条件では、ルールが適用されるフィールドとは別に他のフィールドを追加するオプションがあります。

例えば、「When」のルールタイプを使用すると、様々なフォームオブジェクトの条件を評価し、アクションを実行できます。

次の場合：

（オブジェクト A条件1）

AND/OR

（オブジェクト Bの条件2）

次に、次の操作を行います。

オブジェクト Aのアクション 1

_

条件が機能​の許可された複数のフィールドを使用する際の考慮事項

When 条件機能で許可された複数のフィールドで問題が発生した場合は、次のトラブルシューティング手順に従います。

Hide （非表示）：指定したオブジェクトを非表示にします。

Show （表示）：指定したオブジェクトを表示します。

Enable （有効）：指定したオブジェクトを有効にします。

Disable （無効）：指定したオブジェクトを無効にします。

Invoke service （サービスを起動）：フォームデータモデル（FDM）で設定されたサービスを起動します。「サービスを起動」オプションを選択すると、フィールドが表示されます。このフィールドをタップすると、Experience Manager インスタンス上のすべてのフォームデータモデル（FDM）で設定されたすべてのサービスが表示されます。フォームデータモデルサービスを選択すると、指定したサービスの入力パラメーターを使用してフォームオブジェクトをマッピングできる、より多くのフィールドが表示されます。 指定したサービスのイベントペイロードオプションを使用して、出力パラメーターをマッピングできます。 また、ルールエディターを使用して、呼び出しサービス操作の成功および失敗応答を処理するためのルールを作成することもできます。

フォームデータモデル（FDM）サービスを呼び出すルールの例を参照してください。

フォームデータモデルサービスに加えて、Web サービスを呼び出すための直接WSDL URLを指定できます。 ただし、フォームデータモデルサービスには数多くの利点があるので、この方法でサービスを起動することをお勧めします。

フォームデータモデル（FDM）でのサービス設定について詳しくは、Experience Manager Forms のデータ統合機能を参照してください。

「次の値を設定」は、指定したオブジェクトの値を計算して設定します。オブジェクトの値は、文字列、別のオブジェクトの値、数式または関数を使用した計算値、オブジェクトのプロパティの値、または設定されたフォームデータモデルサービスからの出力値に設定できます。 Web サービスオプションを選択すると、Experience Manager インスタンス上のすべてのフォームデータモデル（FDM）で設定されたすべてのサービスが表示されます。フォームデータモデルサービスを選択すると、さらにフィールドが表示され、指定したサービスに対する入出力パラメーターを使用して、ここでフォームオブジェクトをマップすることができます。

フォームデータモデル（FDM）でのサービス設定について詳しくは、Experience Manager Forms のデータ統合機能を参照してください。

プロパティを設定​のルールタイプを使用すると、条件アクションに基づいて、指定したオブジェクトのプロパティの値を設定できます。プロパティは、次のいずれかに設定できます。

例えば、ボタンがクリックされたときにテキストボックスを表示するルールを定義できます。 カスタム関数、フォームオブジェクト、オブジェクトプロパティまたはサービス出力を使用して、ルールを定義できます。

カスタム関数に基づいてルールを定義するには、ドロップダウンリストから「関数の出力」を選択し、「関数」タブからカスタム関数をドラッグアンドドロップします。条件アクションが満たされると、テキスト入力ボックスが表示されます。

フォームオブジェクトに基づいてルールを定義するには、ドロップダウンリストから「フォームオブジェクト」を選択し、「フォームオブジェクト」タブからフォームオブジェクトをドラッグ＆ドロップします。条件アクションが満たされると、アダプティブフォームにテキスト入力ボックスが表示されます。

オブジェクトプロパティに基づくプロパティ設定ルールを使用すると、アダプティブフォームに含まれている別のオブジェクトプロパティに基づいて、テキスト入力ボックスをアダプティブフォームに表示できます。

次の図は、アダプティブフォームのテキストボックスの非表示または表示に基づいて、チェックボックスを動的に有効にする例を示しています。

Clear value of （値のクリア）：指定したオブジェの値をクリアします。

Set Focus （フォーカスの設定）：指定したオブジェクトにフォーカスを設定します。

フォームを送信：フォームを送信します。

リセット：フォームまたは指定されたオブジェクトをリセットします。

検証：フォームまたは指定されたオブジェクトを検証します。

Add Instance （インスタンスの追加）：指定した繰り返し可能なパネルまたは表の行のインスタンスを追加します。

Remove Instance （インスタンスの削除）：指定した繰り返し可能なパネルまたは表の行のインスタンスを削除します。

関数出力​定義済みの関数またはカスタム関数に基づいてルールを定義します。

に移動​他のアダプティブ Forms、画像やドキュメントフラグメントなどの他のアセット、または外部URLに移動します。

イベントのディスパッチ：定義済みの条件またはイベントに基づいて、特定のアクションまたは動作をトリガーします。

次の値を設定 set-value-of

「Set Value Of」のルールタイプを使用すると、指定した条件に応じてフォームオブジェクトの値を設定できます。この値には、他のオブジェクトの値や、リテラル文字列、数式や関数から算出された値、または他のオブジェクトのプロパティ値、フォームデータモデルサービスの出力値を指定することができます。同様に、関数や数式から算出された構成要素、文字列、プロパティ、または値を確認することもできます。

「Set Value Of」のルールタイプは、パネルやツールバーボタンなどのすべてのフォームオブジェクトで使用できるわけではありません。標準的な「Set Value Of」ルールは、次の構文を有します。

オブジェクト Aの値を次のように設定します。

（String ABC） OR
（オブジェクト Cのオブジェクト プロパティ X） OR
（関数の値） OR
（数式の値） OR
（データモデルサービスの出力値）;

When （オプション）：

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

次の例では、Question2 の値を True に、Result の値を correct に設定しています。

フォームデータモデルサービスを使用した設定値ルールの例。

Show（表示） show

「Show」のルールタイプでは、条件を満たしているかどうかに基づいて、フォームオブジェクトの表示・非表示を切り替えることができます。「Show」のルールタイプでは、条件が満たされていないか、あるいは False が返された場合に、「Show」アクションをトリガーします。

代表的な「Show」のルール構文は、次のようになります。

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

Hide（非表示） hide

「Hide」のルールタイプでは、「Show」のルールタイプと同様に、条件を満たしているかどうか基づいて、フォームオブジェクトの表示・非表示を切り替えることができます。「Hide」のルールタイプでは、条件が満たされていないか、あるいは False が返された場合に、「非表示」アクションをトリガーします。

代表的な「Hide」のルール構文は、次のようになります。

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

Enable（有効） enable

「Enable」のルールタイプを使用すると、条件を満たしているか否かに基づいて、フォームオブジェクトを有効または無効にすることができます。「Enable」のルールタイプでは、条件が満たされていないか、あるいは False が返された場合に、「Disable」アクションをトリガーします。

代表的な「Enable」のルール構文は、次のようになります。

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

Disable（無効） disable

「Disable」のルールタイプでは、「Enable」のルールタイプと同様に、条件を満たしているか否かに基づいて、フォームオブジェクトを有効または無効にすることができます。「Disable」のルールタイプでは、条件が満たされていないか、あるいは False が返された場合に、「Disable」アクションをトリガーします。

代表的な「Disable」のルール構文は、次のようになります。

Disable Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Enable Object A;

Validate（検証） validate

「検証」ルールタイプでは、式を使用してフィールド内の値を検証します。例えば、名前を指定するテキストボックスに特殊文字や数字が含まれていないことを確認する式を記述できます。

代表的な「検証」ルールは、次のようになります。

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

​ パネル間を移動

パネル間を移動 ルールタイプを使用すると、フォーム内の様々なパネル間でフォーカスを移動できます。 例えば、エクスプレッションを作成して、次のパネルにフォーカスを移動できます。

次のパネルにフォーカスを移動するための一般的な​パネル間の移動 ルールは、次のように構成されています。

Navigate among the panels

Shift focus to the next item Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

同様に、前のパネルにフォーカスを移動する場合は、パネル間を移動する ルールを記述できます。

Navigate among the panels

Shift focus to the previous item Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

パネルで移動するルールを作成する方法の詳細については、ここをクリック ​してください。

非同期関数呼び出し

これはプレリリース機能で、プレリリースチャネルを通してアクセスできます。

非同期関数呼び出し ルール タイプを使用すると、非同期関数を実行できます。 これにより、メインの実行スレッドとは独立して動作する関数呼び出しを開始でき、非同期関数が完了するのを待たずに他のプロセスが実行を続行できます。

非同期関数を実行するための一般的な非同期関数呼び出しルールは、次のように構造化されています。

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Async Function call

[Callback Function];

ビジュアルルールエディターで非同期関数呼び出しを使用する方法について詳しくは、「​ ルールエディターでの非同期関数呼び出しの使用」の記事を参照してください。

次の手順

コアコンポーネント に基づくアダプティブフォームのルールエディターの様々な例を理解しましょう。

関連トピック