AEM Forms におけるフォームセット form-set-in-aem-forms

概要 overview

多くの場合、顧客はサービスや特典を申請するために複数のフォームを送信しなければなりません。それに伴い、関連するすべてのフォームを見つけて、入力および送信し、各フォームを個別にトラッキングする必要があります。また、複数のフォームに同じ内容を何度も入力しなければなりません。フォームの数が多いとこのプロセスは面倒になり、間違いが起こりやすくなります。AEM Forms のフォームセット機能を利用すると、このようなシナリオのユーザーエクスペリエンスをシンプルにすることができます。

フォームセットは HTML5 フォームのコレクションであり、エンドユーザーには 1 つのフォームセットとして提供されます。エンドユーザーがフォームセットへの入力を開始すると、フォームセットは入力された内容をシームレスに別のフォームに移行します。最終的に、顧客はワンクリックですべてのフォームを送信することができます。

AEM Forms では、フォームセットを作成、設定、管理するための直感的なユーザーインターフェイスがフォーム作成者に提供されます。フォーム作成者は、エンドユーザーに入力を促したい特定の順序に、フォームの順番を並べることができます。また、各フォームに条件や適格性の式を設定し、ユーザーの入力に基づいてフォームの表示をコントロールすることもできます。例えば、婚姻区分で既婚が選ばれた場合にのみ、配偶者についての詳細フォームを表示するように設定できます。

さらに、異なるフォーム間で共通フィールドを設定して、共通データバインディングを共有することができます。データバインディングを適切に設定すると、エンドユーザーがフォーム間で共通する情報を一度入力するだけで、他のフォームで自動入力が適用されるようになります。

フォームセットは AEM Forms アプリケーションでもサポートされているので、現場で働く従業員はフォームセットをオフラインにし、顧客を訪問してデータを入力し、後で AEM Forms サーバーと同期させてフォームデータを送信することで、ビジネスプロセスを進めることができます。

フォームセットの作成と管理 creating-and-managing-form-set

複数の XDP ファイルや Designer を使用して作成したフォームテンプレートを一つのフォームセットに関連付けることができます。それから、フォームセットを使用して、ユーザーが最初にフォームに入力した値やプロフィールを基に、必要な情報のみを含む XDP ファイルを生成できます。

AEM Forms ユーザーインターフェイスを使用して、すべてのフォームやフォームセット、および関連アセットを一元的に管理できます。

フォームセットを管理 create-a-form-set

フォームセットを作成するには、次の手順を実行します。

フォームセットの管理 managing-a-form-set

フォームセットを作成すると、作成したフォームセットでは以下の操作を実行できます。

フォームセットを編集 edit-a-form-set

フォームセットを編集するには、次の手順を実行します。

Process Management におけるフォームセット form-set-in-process-management

一度 AEM Forms Management ユーザーインターフェイスを使用してフォームセットを作成すると、Workbench を使用してそのフォームセットを「スタートポイント」または「タスクを割り当て」アクティビティで使用できます。

タスクまたはスタートポイントでのフォームセットの使用 using-form-set-in-task-or-start-point

適任性の式 eligibility-expressions

フォームセットにおける適任性の式は、ユーザーに表示されるフォームを定義し動的に制御するために使用されます。例えば、ユーザーが特定の年齢のグループに属している場合にのみ特定のフォームを表示する場合などに使用できます。Forms manager を使用して、適任性の式を指定または編集します。

適任性の式には、ブール値を返す任意の有効な Javascript ステートメントを使用できます。JavaScript コードスニペットの最後のステートメントはブーリアン値として扱われ、他の部分（それまでの行）で処理中の JavaScript コードスニペットを基にフォームの適任性を決定します。式の値が true の場合、そのフォームはユーザーへの表示に適切であると見なされます。このようなフォームは有効な対象フォームとして知られています。

通常の JavaScript 関数に加えて、フォームセットは、フォームセット内のフォームのフィールドの値にアクセスできる fs.valueOf API も公開します。フォームセットの中のフォームフィールドの値にアクセスするには、この API を使用します。API 構文は fs.valueOf（formUid、fieldSOM）であり、ここでは、

例 examples

API の正しい使用法：

fs.valueOf("form1", "xfa.form.form1.subform1.field1")

API の正しくない使用法：

var formUid = "form1";
 var fieldSOM = "xfa.form.form1.subform1.field1"; fs.valueOf(formUid, fieldSOM);

フォームセットに対する XML の事前入力 prefill-xml-for-form-set

フォームセットは、共通または異なるスキーマを持つ複数の HTML5 フォームのまとまりです。XML ファイルを使用して、フォームフィールドへの事前入力を行うこともできます。XML ファイルをフォームセットに関連付けることで、フォームセットの中のフォームを開いたときに、いくつかのフィールドは事前入力されます。

事前入力XML ファイルは、フォームセットの URL の、dataRef パラメータを使用して指定します。dataRef パラメーターは、フォームセットと結合される XML データファイルの絶対パスを指定します。

例えば、次の構造を持つフォームセット内に 3 つのフォーム（form1、form2、form3）があるとします。

form1

field form1field

form2

field form2field

form3

field form3field

各フォームには「field」という共通の名前が付いたフィールドと、「form<i>Field」という一意の名前を持ったフィールドがあります。

次の構造を持った XML を使用してこのフォームセットに事前入力できます。

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <field>common field value</field>
 <form1field>value1</form1field>
 <form2field>value2</form2field>
 <form3field>value3</form3field>
</formSetRootTag>

上記の XML のスニペットでは、フォームセットの事前入力 XML が、個々のフォームの事前入力 XML のスニペットのまとまりであることがわかります。異なるフォームの特定のフィールドがお互いに類似したデータ階層 / スキーマを持つ場合、それらのフィールドは同じ値が事前入力されます。この例では、3 つのすべてのフォームにおいて、共通のフィールド「field」に同じ値が事前入力されています。これは、あるフォームから次のフォームにデータを転送する簡単な方法です。これは、フィールドを同じスキーマまたはデータ参照に連結することでも実現できます。フォームのスキーマに基づいてフォームセットのデータを区別する場合、これは、フォームセットの作成時に、フォームの「データルート」属性を指定することで実現できます（デフォルト値は「/」で、フォームセットのルートタグにマッピングされます）。

前の例では、3 つのフォームに対してそれぞれ「/form1」、「/form2」、「/form3」のデータルートを指定する場合、次の構造の事前入力 XML を使用する必要があります。

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <form1>
  <field>field value1</field>
  <form1field>value1</form1field>
 </form1>
 <form2>
  <field>field value2</field>
  <form2field>value2</form2field>
 </form2>
 <form3>
  <field>field value3</field>
  <form3field>value3</form3field>
 </form3>
</formSetRootTag>

フォームセットにおいて、XML スキーマは以下の構文で定義されます。

<formset>
 <fs_data>
  <xdp:xdp xmlns:xdp="https://ns.adobe.com/xdp/">
  <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
   <xfa:data>
   <rootElement>
    ... data ....
   </rootElement>
   </xfa:data>
  </xfa:datasets>
  </xdp:xdp>
 </fs_data>
 <fs_draft>
  ... private data...
 </fs_draft>
</formset>

XML 要素の事前入力の説明 prefill-xml-elements-description

事前入力 XML ファイルを作成する際の構文ルール

FORMSET formset

parent elements:

null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: fs_data

フォームセット XML のルート要素。 フォームセット内のフォームの rootSubform の名前としてこの単語を使用しないことをお勧めします。

FS_DATA fs-data

parent elements:

formset

基数：[1]

submitXML：P

prefillXML：O

children: xdp:xdp/rootElement

サブツリーはフォームセット内のフォームのデータを示します。この要素は、フォームセット要素が存在しない場合にのみ、事前入力 XML でのオプションです。

XDP:XDP xdp-xdp

parent elements: fs_data/null

cardinality: [0,1]

submitXML: O

prefillXML: O

children: xfa:datasets

このタグは、HTML5 フォーム XML の開始を示します。事前入力 XML にこのタグがある場合、または事前入力 XML がない場合、このタグが送信 XML に追加されます。このタグは、事前入力 XML から削除できます。

XFA:DATASETS xfa-datasets

parent elements: xdp:xdp

cardinality: [1]

submitXML: O

prefillXML: O

children: xfa:data

XFA:DATA xfa-data

parent elements: xfa:datasets

cardinality: [1]

submitXML: O

prefillXML: O

children: rootElement

ROOTELEMENT rootelement

parent elements: xfa:datasets/fs_data/null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: controlled by the Forms in Form set

「rootElement」という名前はプレースホルダーでしかありません。実際の名前はフォームセットで使用されているフォームから選択されます。「rootElement」で始まるサブツリーは、フォームセットのフォーム内にフィールドのデータとサブフォームを含んでいます。rootElement とその子の構造を決定する複数の要因があります。

事前入力 XML ではこのタグはオプションです。ただし、このタグがない場合、XML 全体が無視されます。

ルート要素タグの名前

事前入力 XML にルート要素がある場合、その要素の名前は送信 XML でも引き継がれます。事前入力 XML がない場合、「/」に設定された dataRoot プロパティを持っているフォームセット内の最初のフォームのルートサブフォーム名が rootElement の名前になります。そのようなフォームがない場合は、予約されたキーワードである fs_dummy_root が rootElement 名になります。

AEM Forms アプリにおけるフォームセット formset-in-workspace-app

AEM Forms アプリを使用すると、フィールドワーカーはモバイルデバイスを AEM Forms サーバーと同期し、タスクを実行できます。デバイスでローカルにデータを保存することで、デバイスがオフラインの場合でもアプリケーションは機能します。フィールドワーカーは、写真などの注釈機能を使用して、ビジネスプロセスに統合する正確な情報を提供します。

既知の制限事項 - フォームセットではパターンは完全にはサポートされていません known-limitations-patterns-not-fully-supported-in-form-set

フォームセットでは、以下のデータパターンは完全にはサポートされていません。