アダプティブフォームのルールエディタ－

概要

Adobe Experience Manager Forms のルール編集機能により、フォームのビジネスユーザーや開発者がアダプティブフォームオブジェクトにルールを追加できるようになります。これらのルールは、フォームオブジェクト上でトリガーできるアクションを定義します。それらのアクションは、プリセットされた条件、ユーザー入力、およびフォーム上のユーザーアクションに基づいてトリガーされます。さらに、フォーム入力時の作業を合理化することで、正確で素早く入力できるフォームの実現に役立ちます。

ルールエディターでは、ルールを記述するための直感的でシンプルなユーザーインターフェイスを備えています。ルールエディターは、すべてのユーザーに対してビジュアルエディターを提供します。さらに、Forms のパワーユーザーにのみ、ルールとスクリプトを記述するためのコードエディターを提供します。アダプティブフォームオブジェクト上でルールを用いることにより実行できるアクションのうち、主なものは以下のとおりです。

• オブジェクトの表示／非表示を切り替える
• オブジェクトの有効／無効を切り替える
• オブジェクトの値を設定する
• オブジェクトの値を検証する
• 関数を実行することにより、オブジェクトの値を計算する
• フォームデータモデルサービス操作を呼び出し処理を実行する
• オブジェクトのプロパティを設定する

ルールエディターは、AEM 6.1 Forms以前のリリースのスクリプト機能に代わるものです。 ただし、既存のスクリプトは、新しいルールエディターからも利用できます。ルールエディタで既存のスクリプトを編集する方法の詳細については、「既存のスクリプトに対するルールエディタの影響」を参照してください。

forms-power-users グループに追加されたユーザーは、新しいスクリプトの作成と既存のスクリプトの編集を行うことができます。forms-users グループのユーザーは、スクリプトを使用できますが、スクリプトの作成または編集はできません。

ルールを理解する

「ルール」とは、アクションと条件を組み合わせたものを指します。ルールエディターでは、アクションには、フォーム内のオブジェクトの値を非表示、表示、有効化、無効化、または計算するなどのアクティビティが含まれます。「条件」とは、フォームオブジェクトの状態、値、またはプロパティに対して確認や操作を実行し、それによって評価されるブール式を指します。「アクション」は、条件を評価して返された値（True または False）に基づいて実行されます。

ルールエディターでは、事前定義された一連のルールタイプを利用できます。これらのルールには、「When」、「Show」、「Hide」、「Enable」、「Disable」、「Set Value Of」、および「Validate 」などが含まれており、ルールを記述するのに便利です。各ルールタイプでは、ルール内の条件とアクションを定義することができます。この記事では、各ルールタイプについてさらに詳細に説明します。

一般的なルールは、次のいずれかの構文に従います。

条件 - アクション​この構文では、条件を最初に定義し、トリガーするアクションを次に定義します。構文は、プログラミング言語における if-then 文に匹敵します。

ルールエディターで「When」ルールタイプを使用することで、条件 - アクションの構文が適用されます。

アクション - 条件​この構文では、トリガーするアクションを最初に定義し、続いて評価条件を定義します。この構文の別の様式は、「アクション - 条件 - 代替アクション」型です。この中では、条件が False を返した場合にトリガーする代替アクションも定義します。

ルールエディターで「Show」、「Hide」、「Enable」、「Disable」、「Set Value Of」、「Validate 」の各ルールを設定すると、「アクション - 条件」ルール構文が適用されます。デフォルトでは、「Show」の代替アクションは「Hide」、「Enable」の代替アクションは「Disable」（それらの逆も同様）です。デフォルトの代替アクションは変更できません。

ルールエディターで使用可能なルールタイプの詳細については、「ルールエディターで利用できるルールタイプ」を参照してください。

ルール構文の選択ガイドライン

どのルール構文を使用しても大部分の使用例を満たすことはできますが、ここでは特定のルールを選択するための、いくつかのガイドラインを紹介します。ルールエディターで使用可能なルールの詳細については、「ルールエディターで利用できるルールタイプ」を参照してください。

• ルールを作成する際は一般に、ルールを作成するオブジェクトの背景について考えることから始めます。「フィールド A」にユーザーが入力した値に応じて、「フィールド B」の表示・非表示を切り替える場合を想定します。この場合、「フィールド A」の状態を評価し、その戻り値に基づいて「フィールド B」のアクションをトリガーします。

  従って、「フィールド B」（状態を評価するオブジェクト）上にルールを記述する場合、「条件 - アクション」型の構文か、または「When」のルールタイプを使用します。同様に、「フィールド A」についても、「アクション - 条件」構文か、または「Show」・「Hide」のルールタイプを使用します

• 時には、1 つの条件に基づいて複数のアクションを実行する必要があるかもしれません。そのような場合は、「条件 - アクション」構文の使用を推奨します。この構文では、一度条件を評価し、その後に複数のアクション文を指定することができます。

  たとえば、ユーザーが「フィールド A」に入力した値を確認する条件を設け、その戻り値に応じて「B」、「C」、「D」の各フィールドを非表示にするには、まず、「フィールド A」に対して「条件 - アクション」の構文を記述するか、あるいは「When」のルールタイプを使用し、「B」、「C」、「D」の各フィールドについて表示状態を制御するアクションを作成します。この形式を取らない場合は、「B」、「C」、「D」のフィールドごとに別々のルールを3つ記述し、それぞれ「フィールド A」の状態を確認させる必要が生じます。この例では、3つのオブジェクトに「Show」・「Hide」のルールのタイプを記述するよりも、むしろ単一のオブジェクトに「When」のルールタイプを記述する方が効率的です。

• 複数の条件に基づいてアクションをトリガーする場合は、「アクション - 条件」構文の使用を推奨します。たとえば、「B」、「C」、「D」の各フィールドの状態を評価し、その戻り値に応じて「フィールド A」の表示・非表示を切り替える場合は、「フィールド A」に「表示・非表示」のルールタイプを記述します。

• 1つの条件に対して1つのアクションが指定されているルールでは、「条件 - アクション」または「アクション - 条件」構文を使用してください。

• フィールドに値を入力した直後や、フィールドを閉じた直後にルールによって条件を確認し、アクションを実行する場合は、条件を評価するフィールドに対して「条件=アクション」型の構文か、「When」のルールタイプを記述することが奨励されます。

• 「When」のルール内に記述した条件は、その条件が適用されるオブジェクトの値をユーザが変更した際に評価されます。しかし、値が変更された場合にサーバ側でアクションをトリガする場合（値を事前入力する場合など）は、フィールドの初期化時にアクションをトリガーする「When」ルールを記述することが推奨されます。

• ドロップダウン、ラジオボタン、チェックボックスの各オブジェクトに対してルールを記述する場合、フォーム内のこれらのフォームオブジェクトのオプションや値はルールエディターで事前入力されます。

ルールエディターで使用可能な演算子の種類とイベント

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

• Is Equal To（次と等しい）
• Is Not Equal To（次と等しくない）
• Starts With（次の値で始まる）
• Ends With（次の値で終わる）
• Contains（次を含む）
• Is Empty（空である）
• Is Not Empty（空ではない）
• Has Selected（選択済み）：​チェックボックス、ドロップダウン、ラジオボタンの特定のオプションをユーザーが選択した場合に true を返します。
• Is Initialized (event)（初期化（イベント型））​フォームオブジェクトがブラウザでレンダリングされたときに true を返します。
• Is Changed (event)（変更（イベント型））：​フォームオブジェクトに入力された値または選択したオプションをユーザーが変更したときに true を返します。

ルールエディターで利用可能なルールタイプ

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

セッションに他のセッション属性

「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;

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

例えばリストの場合、赤、青、緑、黄という 4 つのオプションがあります。ルールを作成する場合、オプション（ラジオボタン）が自動的に取得され、これらのオプションを使用してルールを作成することができます。以下に例を示します。

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

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

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

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

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

Invoke service （サービスを起動）​フォームデータモデルで設定されたサービスを起動します。「サービスを起動」オプションを選択すると、フィールドが表示されます。このフィールドをタップすると、AEM インスタンス上のすべてのフォームデータモデルで設定されたすべてのサービスが表示されます。フォームデータモデルサービスを選択すると、追加のフィールドが表示され、指定したサービスに対する入力パラメータと出力パラメータを使用して、フォームオブジェクトをマップできる追加のフィールドが表示されます。フォームデータモデルサービスの呼び出しについては、「ルール例」を参照してください。

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

フォームデータモデルでサービスを設定する方法について詳しくは、「AEM Formsデータ統合」を参照してください。

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

フォームデータモデルでサービスを設定する方法について詳しくは、「AEM Formsデータ統合」を参照してください。

Set property指定したオブジェクトのプロパティの値を設定します。

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

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

Save Form （フォームの保存）：フォームを保存します。

Submit Forms （フォームの送信）：フォームを送信します。

Reset Form （フォームのリセット）：フォームをリセットします。

Validate Form （フォームの検証）：フォームを検証します。

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

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

Set Value of

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

「Set Value Of」のルールタイプは、パネルやツールバーボタンなどの一部のフォームオブジェクトでは利用できないことに注意してください。標準的な「Set Value Of」ルールは、次の構文を有します。

Set value of Object A to:

（ABC文字列）または
（オブジェクトCのオブジェクトプロパティX） OR
（関数の値） OR
（数式から得た値） OR
（データモデルサービスまたはWebサービスの出力値）

When （オプション）：

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

次の例では、dependentid フィールドの値を入力とし、Relation フィールドの値を Relation フォームデータモデルサービスの getDependent 引数の出力に設定します。

フォームデータモデルサービスを使用した Set Value Of ルールの例

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」のルールタイプでは、「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」のルールタイプでは、条件が満たされていないか、あるいは False が返された場合に、「Disable」アクションをトリガーします。

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

Enable Object A;

When:

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

Else:

Disable Object A;

無効

「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」のルール構文は、次のようになります。

Validate Object A;

Using:

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

ルールエディターのユーザーインターフェイスを理解する

ルールエディターでは、ルールの記述や管理のための、総合的でシンプルなユーザインタフェイスが用意されています。ルールエディターのユーザインターフェイスは、オーサリングモードで開いたアダプティブフォーム内から起動できます。

ルールエディターのユーザインターフェイスを起動するには：

1. アダプティブフォームをオーサリングモードで開きます。

2. ルールを記述するフォームオブジェクトをタップし、コンポーネントツールバーで「]をタップします。ルールエディターのユーザーインターフェイスが表示されます。

   

   選択したフォームオブジェクト上に既に存在するルールは、このビューに表示されます。既存ルールの詳細な管理方法については、「ルール管理」を参照してください。

3. 「作成」をタップして、新しいルールを追加します。ルールエディターの初回起動時は、ルールエディターの UI がビジュアルエディターモード（デフォルト）で表示されます。
   

   クリックし
     て拡大ルールエディターのUIの各コンポーネントについて詳しく見てみましょう。

A. コンポーネントルールの表示

ルールエディターを起動したアダプティブフォームオブジェクトのタイトルと、現在選択されているルールタイプを表示します。上記の例では、ルールエディターは「Salary（給与） 」と名付けられたアダプティブフォームオブジェクトから起動されており、「When」のルールタイプが選択されています。

B. フォームオブジェクトと関数

ルールエディターのユーザーインターフェイスの左側のペインには、「フォームオブジェクト」と「関数」の2つのタブが含まれています。

「フォームオブジェクト」タブには、アダプティブフォームに含まれているオブジェクトがすべて階層表示されます。ここには、オブジェクトのタイトルとタイプが表示されます。ルールの作成時は、フォームオブジェクトをルールエディターまでドラッグ＆ドロップすることができます。オブジェクトまたは関数をプレースホルダーにドラッグ＆ドロップしてルールの作成や編集を行うと、適切な値の型がプレースホルダーに自動的に取り込まれるます。

1つ以上の有効なルールが適用されているフォームオブジェクトには、緑のドットが付いています。フォームオブジェクトに適用されているルールのいずれかが無効な場合、フォームオブジェクトには黄色のドットが付きます。

「関数」タブには、「合計」、「最小値」、「最大値」、「平均値」、「個数」や「検査フォーム」などの組み込み関数のセットが含まれます。これらの関数をルールに記述することで、繰り返しパネルや表の行の値を計算し、計算結果をアクションや条件文の中で使用することができます。また、カスタム関数を作成することもできます。

フォームオブジェクトの左側のツリーでは、フォームオブジェクトをタップすることで、各オブジェクトに適用されるルールを表示することができます。ここでは、各フォームオブジェクトのルール間を移動できるだけでなく、フォームオブジェクト間でルールをコピー＆ペーストすることもできます。詳しくは、「ルールのコピー＆ペースト」を参照してください。

C. フォームオブジェクトと関数の切り替え

トグルボタンをタップすると、フォームオブジェクトペインと関数ペインを切り替えることができます。

D. ルールのビジュアルエディター

ルールを記述するビジュアルエディターは、ルールエディターのユーザーインターフェイスをビジュアルエディタモードに切り替えると表示されます。ここでは、ルールの種類を選択し、それに応じて条件とアクションを定義することができます。ルール内の条件とアクションを定義するときは、「フォームオブジェクト」ペインや「関数」ペインから、フォームオブジェクトや関数をドラッグ＆ドロップすることができます。

ルールのビジュアルエディターの詳細については、「ルールの作成」を参照してください。

E. ビジュアルコードエディターの切り替えボタン

forms-power-users グループに含まれるユーザーは、コードエディターにアクセスできます。その他のユーザーは、コードエディターを使用できません。この権限があれば、ルールエディターの右上にある切り替えボタンを押すことで、ビジュアルエディターモードからルールエディター（またはその逆）に切り替えることができます。ルールエディターの初回起動時は、ビジュアルエディタモードで開きます。ルールを記述する際はビジュアルエディターモードに、ルールスクリプトを記述する際はコードエディタモードに切り替えて使用します。ただし、コードエディターからルールを変更や記述した場合は、コードエディタをクリアしない限り、同じルールをビジュアルエディターから表示することはできません。

AEM Forms では、ルールを記述するために最後に使用したルールエディタモードを記憶します。これにより、ルールエディタの次回起動時も同じモードで開きます。ただし、デフォルトモードを設定することで、ルールエディタを指定されたモードで開くこともできます。この作業を行うには、以下の手順を実行します。

1. AEM Webコンソール(https://[host]:[port]/system/console/configMgr)に移動します。

2. 「アダプティブフォームとインタラクティブ通信Webチャネルの設定」をクリックして編集します。

3. 「ルールエディターのデフォルトモード」のドロップダウンから、「ビジュアルエディター」または「コードエディター」を選択します。

4. 「保存」をクリックします。

F. 「完了」ボタンと「キャンセル」ボタン

ルールを保存するには、「完了」ボタンを押します。ルールは、不完全な状態でも保存することができます。ただし、不完全なルールは無効なため、実行されることはありません。フォームオブジェクトに対して保存されたルールは、次回に同じフォームオブジェクトからルールエディターを起動すると一覧表示されます。このビューでは、既存のルールを管理することができます。詳しくは、「ルール管理」を参照してください。

「キャンセル」ボタンを押すと、ルールに加えた変更を破棄し、ルールエディターを閉じます。

ルールの記述

ルールを記述するには、ビジュアルルールエディターまたはコードエディターを使用します。ルールエディターの初回起動時は、ビジュアルエディタモードで開きます。その後は、コードエディターモードに切り替えてルールを記述することもできます。ただし、コードエディターからルールを変更や記述した場合は、コードエディターをクリアしない限り、同じルールをビジュアルエディターから表示することはできません。これにより、ルールエディターの次回起動時も、前回ルールの作成に使用したのと同じモードで開きます。

最初に、ビジュアルエディターを使用してルールを作成する方法を説明します。

ビジュアルエディターを使用する

ここでは、次のフォーム例を使って、ビジュアルエディターでルールを作成する方法について説明します。

フォーム例のローン申込書における「Loan Requirements（融資要件）」のセクションでは、配偶者の有無や自身の給与（および既婚者の場合は配偶者の給与）を入力することが要求されます。ルールでは、ユーザー入力に基づいて融資適格金額を算出し、「Loan Eligibility（融資適格額）」フィールドに表示します。次のルールを適用して、シナリオを実装します。

• 配偶者の「Salary（給与）」フィールドは、婚姻状況に結婚を選んだ場合にのみ表示されます。
• 融資適格額は、全給与の50パーセントとして計算されます。

ルールを記述する際は、以下の手順を実行します。

1. まず、「Marital Status（配偶者の有無）」のラジオボタンの選択内容に応じて「Spouse Salary（配偶者の給与）」フィールドの表示・非表示を制御するためのルールを記述します。

   融資申請フォームをオーサリングモードで開きます。「Marital Status（配偶者の有無）」コンポーネントをタップし、「」をタップします。次に、ルールエディターを起動し「作成」をタップします。

   

   ルールエディターの起動時は、デフォルトで「When」ルールが選択されています。また、ルールエディターを起動したフォームオブジェクト（この場合は「Marital Status（配偶者の有無）」）は、「When」文に入力されています。

   選択したオブジェクトを変更することはできませんが、ルールのドロップダウンを使用することで別のルールタイプを選択することはできます（以下を参照）。別のオブジェクトに新しいルールを作成する場合は、「キャンセル」をタップしてルールエディターを終了し、そのオブジェクトから再びルールエディターを起動します。

2. 「状態の選択」のドロップダウンをタップし、「is equal to （に等しい）」を選択します。「文字列を入力」フィールドが表示されます。

   

   「Marital Status（配偶者の有無）」のラジオボタンでは、「Married （既婚）」と「Single （独身）」のオプションに対して、それぞれ 0 と 1 の値が割り当てられています。以下に示すように、割り当てられた値は、「編集」ラジオボタンダイアログの「タイトル」タブから確認することができます。

   

3. ルール内の「文字列を入力」フィールドで、0 を指定します。

   

   条件をWhen Marital Status is equal to Marriedと定義しました。次に、この条件が True の場合に実行するアクションを定義します。

4. その後の文では、「アクションの選択」ドロップダウンから「表示」を選択します。

   

5. 「オブジェクトをドロップするか、または次から選択」フィールドの「フォームオブジェクト」タブから「Spouse Salary （配偶者の給与）」フィールドをドラッグ・ドロップします。あるいは、「オブジェクトをドロップするか、または次から選択」フィールドをタップし、ポップアップメニューから「Spouse Salary （配偶者の給与）」フィールドを選択します。この中には、フォーム内のすべてのフォームオブジェクトが一覧表示されます。

   

   ルールエディターでは、ルールが次のように表示されます。

   

   「完了」をクリックして、ルールを保存します。

6. 配偶者の有無が「Single（独身）」の場合は「Spouse Salary（配偶者の給与）」フィールドを非表示にするため、手順 1～5 を繰り返して別のルールを定義します。ルールエディターでは、ルールが次のように表示されます。

   

   メモ

   また、同じ動作を実装する場合は、「Marital Status（配偶者の有無）」フィールドに 2 つの「いつ」ルールを記述する代わりに、「Spouse Salary（配偶者の給与）」フィールド上に 1 つの「表示」ルールを設けることもできます。

   

7. 次に、融資適格金額を算出するためのルールを記述します。ここでは、総給与の 50% として計算され、「Loan Eligibility（貸付資格）」フィールドに表示されます。これをするには、「Loan Eligibility」フィールド上に「指定値」ルールを作成します。

   オーサリングモードで「Loan Eligibility （貸付資格）」フィールドをタップし、 をタップします。次に、ルールエディターを起動し「作成」をタップします。

8. ルールのドロップダウンから「指定値」ルールを選択します。

   

9. 「オプションの選択」をタップして「数式」を選択します。数式記述用のフィールドが表示されます。

   

10. 数式記述用のフィールドでは：

    • 「フォームオブジェクト」タブで、最初の「オブジェクトをドロップするか、または次から選択」フィールドから「Salary（給与）」フィールドを選択するか、またはドラッグ＆ドロップします。
    • 「演算子の選択」フィールドから「プラス」を選択します。
    • 「フォームオブジェクト」タブから、他の​ドロップオブジェクトの「 Spouse Salary （配偶者の給与）」フィールドを選択またはドラッグ＆ドロップするか、「ここ」​フィールドを選択します。

    

11. 次に、式フィールドの周りの強調表示された領域をタップし、「拡張式」をタップします。

    

    拡張式フィールドでは、「演算子の選択」フィールドから「divided by（割り算）」を選択し、「オプションの選択」フィールドから「Number（数字）」を選択します。次に、数字フィールドに 2 を入力します。

    

    メモ

    「オプションの選択」フィールドから、コンポーネント、関数、数式、およびプロパティの各値を使用することで、複雑な式を作成することもできます。

    次に、True が返された場合に式を実行する条件を作成します。

12. 「条件の追加」をタップして、「When」文を追加します。

    

    「When」文内で：

    • 「フォームオブジェクト」タブで、最初の「オブジェクトをドロップするか、または次から選択」フィールドから「Marital Status（婚姻状況）」フィールドを選択します。
    • 「演算子の選択」フィールドから「is equal to」を選択します。
    • 他の「オブジェクトをドロップまたは次から選択」フィールドから「文字列」を選択し、「文字列を入力」フィールドに「Married （既婚）」を入力します。

    ルールは、ルールエディターで最終的には次のように表示されます。

    「完了」をクリックして、ルールを保存します。

13. ステップ 7～12 を繰り返し、配偶者の有無が「Single（独身）」であれば融資適格額を計算する別のルールを定義します。ルールエディターでは、ルールが次のように表示されます。

    

コードエディターを使用する

forms-power-users グループに追加されたユーザーは、コードエディターを使用できます。ルールエディターでは、ビジュアルエディターを使用して作成したルールの JavaScript コードを自動的に生成します。生成されたコードを表示するには、ビジュアルエディターからコードエディターに切り替えます。ただし、コードエディターでルールコードを変更した場合、ビジュアルエディターに戻すことはできません。ビジュアルエディターではなく、コードエディターでルールを記述することを希望する場合は、コードエディターで新たにルールを記述することもできます。これら2つのモードは、ビジュアルコードエディターの切り替えボタンから切り替えることができます。

コードエディターのJavaScriptは、アダプティブフォームの式言語です。 すべての数式は有効なJavaScriptの数式で、アダプティブフォームのスクリプトモデルAPIを使用しています。これらの式は、特定のタイプの値を返します。アダプティブフォームクラス、イベント、オブジェクト、パブリック API の完全なリストについては、「アダプティブフォームの JavaScript ライブラリ API リファレンス」を参照してください。

コードエディターでルールを記述する際の詳細なガイドラインは、「アダプティブフォームの数式」を参照してください。

ルールエディターで JavaScript コードを記述する際、次の表示キューが構造と構文に役立ちます。

• 構文のハイライト表示機能
• 自動インデント機能
• フォームオブジェクト、関数、それらのプロパティについてヒントを表示する機能
• フォームコンポーネントの名前と一般的な JavaScript 関数を自動的に入力する機能

ルールエディターでのカスタム関数

「関数出力」の下にリストされている「合計」などの既製の関数に加え、頻繁に必要なカスタム関数を記述することができます。 記述した関数は、その上に jsdoc が付記されていることを確認してください。

この jsdoc は、

• カスタムの設定や説明を使用する場合に必須です。
• JavaScript,では関数を宣言する方法が複数存在するためコメントを活用して関数を区別することが大切です。

詳しくは、usejsdoc.org を参照してください。

サポートされるjsdocタグ：

• プライベート

  構文: @private

  プライベート関数は、カスタム関数として含まれていません。

• Name

  構文: @name funcName <Function Name>

  ,の代わりに、次を使用できます。@function funcName <Function Name> または @func funcName <Function Name>。

  funcName ：関数の名前です（スペースは使用不可）。

  <Function Name>：関数の表示名です。

• メンバー

  構文: @memberof namespace

  （メンバー構文）：関数に名前空間を追加します。

• パラメーター

  構文: @param {type} name <Parameter Description>

  または、次のURLを使用できます。@argument {type} name <Parameter Description> または @arg {type} name <Parameter Description>

  関数で使用されるパラメータを表示します。関数には、複数のパラメータタグを設けることができます。各パラメーターは、実行順序に応じて 1 個のタグを設けることができます。

  {type} は、パラメータータイプを表します。許可されているパラメータータイプは、以下のとおりです。

  1. 文字列
  2. 数値
  3. ブール型

  他のすべてのパラメータの種類は、上記のいずれかに分類されます。「なし」はサポートされていません。上記のタイプのいずれかを選択していることを確認してください。タイプでは、大文字と小文字は区別されません。パラメーターでは、スペースは使用できませんname。<Parameter Descrption>

• 戻り値の型

  構文: @return {type}

  または、@returns {type}を使用することもできます。

  目的などの、関数に関する情報を追加します。

  {type} は、関数の戻り値のタイプを表します。許可されている戻り値のタイプは次のとおりです。

  1. 文字列
  2. 数値
  3. ブール型
  4. date
  5. 配列

  他のすべての戻り値のタイプは、上記のいずれかに分類されます。「なし」はサポートされていません。上記のタイプのいずれかを選択していることを確認してください。戻り値の型では、大文字と小文字は区別されません。

カスタム関数を追加する

たとえば、正方形の面積を計算するカスタム関数を追加するとします。横の長さは、ユーザの入力を使用します。ユーザ入力は、フォーム内の数値ボックスを通して受け取ります。計算された出力は、フォーム内の別の数値ボックスに表示されます。カスタム機能を追加するには、最初にクライアントライブラリを作成し、次に CRX リポジトリに追加する必要があります。

次の手順を実行してクライアントライブラリを作成し、それを CRX リポジトリに追加します。

1. クライアントライブラリを作成します。詳しくは、「クライアント側ライブラリの使用」を参照してください。

2. CRXDE 上で、categories文字列タイプの値を持つプロパティをcustomfunctionとしてclientlibフォルダーに追加します。

   メモ

   customfunctionはカテゴリの例です。clientlib フォルダーで作成したカテゴリには、任意の名前を付けることができます。

CRXリポジトリにクライアントライブラリを追加した後は、アダプティブフォームでそれを使用します。これにより、カスタム関数をルールとしてフォーム内で使用することができます。次の手順を実行して、アダプティブフォームにクライアントライブラリを追加します。

1. フォームを編集モードで開きます。

   フォームを編集モードで開くには、フォームを選択し、「開く」をタップします。

2. 編集モードで、コンポーネントを選択し、／アダプティブフォームコンテナ​をタップしてから、 をタップします。

3. サイドバーの「クライアントライブラリの名前」の下から、クライアントライブラリを追加します。（この例では、「customfunction」）。

   

4. 入力数値ボックスを選択し、 をタップしてルールエディターを開きます。

5. 「ルールを作成」をタップします。フォームの出力フィールドに入力の自乗値を保存するルールを、次のオプションを使用して作成します。
   了」 をタップします。これでカスタム機能が追加されました。

関数の宣言でサポートされるタイプ

文関数

function area(len) {
    return len*len;
}

この関数は、jsdoc コメント無しで追加されています。

関数式

var area;
//Some codes later
/** */
area = function(len) {
    return len*len;
};

関数式と文関数

var b={};
/** */
b.area = function(len) {
    return len*len;
}

変数の関数宣言

/** */
var x1,
    area = function(len) {
        return len*len;
    },
    x2 =5, x3 =true;

制限：関数宣言をリストにまとめた場合、カスタム関数では、変数リストから最初の関数宣言のみが選択されます。関数式は、すべての関数宣言に使用することができます。

オブジェクトの関数宣言

var c = {
    b : {
        /** */
        area : function(len) {
            return len*len;
        }
    }
};

ルール管理

オブジェクトをタップして をタップすると、フォームオブジェクトの既存のルールが一覧表示されます。ここでは、タイトルを表示し、ルール概要をプレビュー表示することができます。また、UI からルール概要を拡大して全体を表示したり、ルール順序を変更したり、ルールを編集・削除したりすることもできます。

ルールに対しては、以下の操作を実行できます。

• 展開／折りたたみ：ルールリスト内の「コンテンツ」の列には、ルールの内容が表示されます。デフォルトビューにルール内容の全体が表示されていない場合は、 をタップしてビューを展開します。

• 並べ替え：作成した新しいルールは、すべてルールリストの一番下に追加されます。ルールは上から下に順に実行されます。一番上のルールが最初に実行され、続けて同じタイプの他のルールが実行されます。たとえば、「When」、「Show」、「Enable」、および「When」の各ルールが、リストの 1～4 番目にある場合、一番上にある「When」ルールが最初に実行され、次に　4　番目の「When」ルールが実行されます。そして、「Show」ルールおよび「Enable」ルールが実行されます。

  ルールの順序を変更するには、 をタップするか、リスト内の目的の位置にドラッグアンドドロップします。

• 編集：ルールを編集するには、ルールタイトルの横にあるチェックボックスを選択します。ルールを編集・削除するための追加オプションが表示されます。「​を編集」をタップし、選択したルールをルールの作成に使用したモードに応じて、ビジュアルエディターモードまたはコードエディターモードでルールエディターで開きます。

• 削除：ルールを削除するには、ルールを選択し「削除」をタップします。

• 有効 / 無効：ルールの使用を一時的に中止しなければならないことがあります。その際、1 つ以上のルールを選択し、アクションツールバーで「無効」をタップすると、それらのルールが無効になります。ルールが無効化されている場合は、ランタイムには実行されません。無効化されたルールを有効化するには、そのルールを選択し、アクションツールバーで「有効」をタップします。ルールの「ステータス」列には、そのルールが有効になっているのか無効になっているのかが表示されます。

ルールのコピー＆ペースト

時間を節約するために、フィールドのルールを別の類似したフィールドにコピー＆ペーストすることができます。

ルールをコピー＆ペーストするには、次の手順を実行します。

1. ルールのコピー元となるフォームオブジェクトをタップし、コンポーネントツールバーでをタップします。 フォームオブジェクトが選択された状態でルールエディターのユーザーインタフェースが表示され、既存のルールが表示されます。

   

   既存ルールの詳細な管理方法については、「ルール管理」を参照してください。

2. ルールタイトルの横にあるチェックボックスを選択します。ルールを管理するための追加オプションが表示されます。「コピー」をタップします。

   

3. ルールを貼り付ける別のフォームオブジェクトを選択し、「貼り付け」をタップします。また、貼り付けたルールは編集して変更を加えることもできます。

   メモ

   別のフォームオブジェクトにルールを貼り付けることができるのは、コピーされたルールのイベントを、貼り付け先のフォームオブジェクトがサポートしている場合に限られます。たとえば、ボタンはクリックイベントをサポートします。ボタンのクリックイベントにはルールを貼り付けることができますが、チェックボックスには貼り付けできません。

4. 「完了」をクリックして、ルールを保存します。

ネスト式

ルールエディターでは、複数の「AND」と「OR」演算子を使用して、ネストしたルールを作成することができます。ルール内には、複数の「AND」と「OR」演算子を混在させることもできます。

以下の例では、ネストされたルールを紹介します。ここでは、必要な条件が満たされた際に、子供の親権適格性についてのメッセージをユーザーに表示します。

ルール内で条件をドラッグアンドドロップして編集することもできます。条件の前のハンドル（）をタップし続けます。次に示すようにポインターが手の形になったら、ルール内の任意の場所に条件をドラッグ＆ドロップします。ルール構造が変化します。

日付式の条件

ルールエディターでは、日付比較を使用して条件を作成できます。

次に示す条件の例では、ユーザーが日付フィールドに入力することによって指定する家屋の住宅ローンが既に取得されている場合、静的テキストオブジェクトを表示します。

ユーザーが入力した物件の住宅ローンの日付が過去のものである場合、アダプティブフォームは収入計算に関する注記を表示します。次のルールは、ユーザーが入力した日付を現在の日付と比較し、ユーザーが入力した日付が現在の日付より前の場合、フォームは（Income という名前の）テキストメッセージを表示します。

入力された日付が現在の日付よりも前の場合、フォームはテキストメッセージ（Income）を次のように表示します。

数値比較条件

ルールエディターでは、2 つの数値を比較する条件を作成できます。

次の例では、申込者が現在の住所に滞在する月数が36未満の場合にスタティックテキストオブジェクトを表示します。

現在の居住地住所に住んでいる期間が 36 か月に満たないことをユーザーが指定した場合、フォームは、追加の居住地証明が要求される場合があるという通知を表示します。

既存のスクリプトに対するルールエディタの影響

AEM 6.1 Forms 機能パック 1 より前のバージョンの AEM Forms では、フォームの作成者や開発者がダイナミック動作をアダプティブフォームに追加する際に、「編集」コンポーネントダイアログの「スクリプト」タブを使用して式を記述していました。現行バージョンでは、「スクリプト」タブの代わりにルールエディターが導入されています。

「スクリプト」タブで記述する必要があったスクリプトや式は、ルールエディターからすべて利用できます。forms-power-users グループに含まれるユーザーは、ビジュアルエディターでは表示や編集ができませんが、コードエディターからはスクリプトを編集できます。

ルールの例

フォームデータモデルサービスを呼び出し

Web サービス GetInterestRates で、ローン総額、加入年数、申込者の信用度を入力内容から取得し、EMI 総額および年利などのローン計画を返すものとします。Web サービスをデータソースとして使用し、フォームデータモデルを作成します。データモデルオブジェクトと get サービスをフォームモデルに追加します。フォームデータモデルの「サービス」タブにサービスが表示されます。その後、データモデルオブジェクトのフィールドを含むアダプティブフォームを作成し、ローン総額、加入年数、申込者の信用度についてユーザーの入力を取得します。計画の詳細を取得するために Web サービスをトリガーするボタンを追加します。適切なフィールドで出力が算出されます。

次のルールは、「サービスを起動」アクションを設定してシナリオ例を実行する方法を示しています。

「When」ルールを使用して複数のアクションをトリガーする

ローン申込フォームでは、ローンの申請者が既存の顧客であるかどうかを判断する必要があります。この情報に基づいて、顧客 ID フィールドの表示・非表示を切り替えます。また、申請者が既存の顧客であれば、顧客 ID フィールドにフォーカスを置きます。ローン申込フォームは、次のコンポーネントから構成されます。

• 「Are you an existing Geometrixx customer?（Geometrixxに既に登録されていますか？）」のラジオボタンでは、「はい」と「いいえ」のオプションが設けられています。「はい」の値は 0、「いいえ」の値は 1 です。

• 「Geometrixx customer ID（Geometrixx 顧客 ID）」のテキストフィールドには、顧客 ID が入力されます。

この動作を実装するためラジオボタンに「When」ルールを記述すると、ビジュアルルールエディターにはルールが次のように表示されます。

上のルール例では、「When」セクション内の文は条件に当たります。これが True を返すと、「Then」セクションで指定されたアクションが実行されます。

コードエディターでは、ルールが次のように表示されます。

ルール内で関数出力を使用する

発注フォームでは、次の表が表示されます。この中には、発注者が注文を入力します。表の内容：

• 最初の行は反復可能です。このため、ユーザーは複数の製品を注文し、それぞれ異なる量を指定することができます。このエレメントの名前は、「Row1」です。
• 反復可能な行と「Product Quantity（製品数量）」の列が重なるセルでは、タイトルが「Quantity（数量）」になっています。このセルのエレメント名は「productquantity」です。
• 表の 2 行目は反復しません。また、この行と「Product Quantity（製品数量）」の列が重なるセルでは、タイトルが「Total Quantity（合計数量）」になっています。

A. 行 1 B. 数量 C. 合計数量

ここでは、「Product Quantity（製品数量）」列で指定された数量を全製品について合計し、「Total Quantity（合計数量）」セルに合計値を表示する必要があります。この動作は、以下に示すように、「Total Quantity（合計数量）」セルに「Set Value Of」ルールを記述することにより実装できます。

式を使用してフィールド値を検証する

上の例で説明した発注書フォームでは、価格が 10000 を超える商品について、1 個を超える数量は発注が制限されています。この動作を実装するには、以下に示すように「Validate」ルールを記述します。