アダプティブフォームにおけるレコードのドキュメントの生成

概要

フォームの入力時または送信時には、そのフォームを印刷物またはドキュメント形式で記録しておくことができます。このレコードは、レコードのドキュメント（DoR）と呼ばれる、送信されたフォームの印刷用コピーです。また、顧客が後日入力した情報のレコードのドキュメントを参照したり、レコードのドキュメントを使用してフォームとコンテンツを PDF 形式でアーカイブしたりすることもできます。

レコードのドキュメントを作成するには、XFA または AcroForm ベースのテンプレートを、アダプティブフォームを使用して収集したデータと結合します。レコードのドキュメントは、自動またはオンデマンドで生成できます。オンデマンドオプションを使用すると、XFA または AcroForm ベースのカスタムテンプレートを指定して、レコードのドキュメントの外観をカスタマイズすることができます。

以下の操作を実行できます。

• XFA に基づくレコードのドキュメントの生成
• AcroForm（Acrobat フォーム PDF）に基づくレコードのドキュメントの生成
• レコードのドキュメントの自動生成

事前準備

本題に入る前に、レコードのドキュメントに必要な次のアセットを理解し準備します。

基本テンプレート： Forms Designer または Acrobat フォーム（AcroForm）で作成された XFA テンプレート（XDP ファイル）。基本テンプレートは、レコードのドキュメントのスタイル設定とブランディング情報を指定するために使用されます。XFA テンプレート（XDP ファイル）を AEM Forms インスタンスに先にアップロードします。

アダプティブフォーム：​レコードのドキュメントが生成されるアダプティブフォーム。

XFA に基づくレコードのドキュメントの生成

XFA テンプレート（XDP ファイル）を AEM Forms インスタンスにアップロードします。XFA テンプレート（XDP ファイル）をレコードのドキュメントのテンプレートとして使用するようにアダプティブフォームを設定するには、次の手順を実行します。

1. Experience Manager オーサーインスタンスで、Forms／フォームとドキュメント​をクリックします。
2. フォームを選択し、「プロパティ」をクリックします。
3. 「プロパティ」ウィンドウで、「フォームモデル」をタップします。
4. 「フォームモデル」タブの「モデルを選択」ドロップダウンで、「スキーマ」または「なし」を選択します。フォームモデルの選択は、フォームの作成時にも行うことができます。
5. 「フォームモデル」タブの「レコードのドキュメントテンプレート設定」セクションで、「フォームテンプレートをレコードのドキュメントテンプレートとして関連付ける」を選択します。このオプションを選択すると、マシン上で使用可能なすべての XFA テンプレート（XDP ファイル）が表示されます。適切なファイルを選択します。また、アダプティブフォームと選択した XFA テンプレート（XDP ファイル）で、必ず同じスキーマ（データスキーマ）が使用されるようにします。
6. 「完了」をクリックします。

これで、XDP ファイルをレコードのドキュメントのテンプレートとして使用するように、アダプティブフォームが設定されました。次の手順では、アダプティブフォームコンポーネントを対応するテンプレートフィールドにバインドします。

AcroForm に基づくレコードのドキュメントの生成

Adobe Acrobat PDF（AcroForm）を AEM Forms インスタンスにアップロードします。Adobe Acrobat PDF（AcroForm）をレコードのドキュメントのテンプレートとして使用するようにアダプティブフォームを設定するには、次の手順を実行します。

1. Experience Manager オーサーインスタンスで、Forms／フォームとドキュメント​をクリックします。
2. フォームを選択し、「プロパティ」をクリックします。
3. 「プロパティ」ウィンドウで、「フォームモデル」をタップします。
4. 「フォームモデル」タブの「モデルを選択」ドロップダウンで、「スキーマ」または「なし」を選択します。フォームモデルの選択は、フォームの作成時にも行うことができます。
5. 「フォームモデル」タブの「レコードのドキュメントテンプレート設定」セクションで、「フォームテンプレートをレコードのドキュメントテンプレートとして関連付ける」を選択します。このオプションを選択すると、マシン上で使用可能なすべての Acrobat PDF（AcroForm）が表示されます。適切なファイルを選択します。
6. 「完了」をクリックします。

これで、AcroForm をレコードのドキュメントのテンプレートとして使用するように、アダプティブフォームが設定されました。次の手順では、アダプティブフォームコンポーネントを対応するテンプレートフィールドにバインドします。

レコードのドキュメントの自動生成

レコードのドキュメントを自動的に生成するようにアダプティブフォームを設定すると、フォームが変更されるたびに、そのレコードのドキュメントが直ちに更新されます。例えば、既存のアダプティブフォームからフィールドを削除すると、対応するフィールドも削除され、レコードのドキュメントには表示されません。レコードのドキュメントを自動的に生成する利点は他にも多数あります。：

• フォーム開発者は、データバインディングを手動で管理する必要はありません。自動生成されたレコードのドキュメントは、データバインディング関連の更新を処理します。
• フォーム開発者は、レコードのドキュメントから除外するようにマークされたフィールドを手動で非表示にする必要はありません。自動生成されたレコードのドキュメントは、これらのフィールドを除外するように事前設定されています。
• 自動生成されたレコードのドキュメントオプションを使用すれば、レコードのドキュメント用のフォームテンプレートの作成に要する時間を節約できます。
• 自動生成されたレコードのドキュメントオプションでは、様々な基本テンプレートを使用して、異なるスタイルと外観を使用できます。組織のレコードのドキュメントに最適なスタイルと外観を選択するのに役立ちます。スタイル設定を指定しない場合、システムスタイルがデフォルトとして設定されます。
• 自動生成されたレコードのドキュメントを使用すると、フォーム内の変更がレコードのドキュメントに即座に反映されます。

レコードのドキュメントを自動生成するようアダプティブフォームを設定するには、次の手順を実行します。

1. Experience Manager オーサーインスタンスで、Forms／フォームとドキュメント​をクリックします。
2. フォームを選択し、「プロパティ」をクリックします。
3. 「プロパティ」ウィンドウで、「フォームモデル」をタップします。
4. 「フォームモデル」タブの「モデルを選択」ドロップダウンで、「スキーマ」または「なし」を選択します。フォームモデルの選択は、フォームの作成時にも行うことができます。
5. 「フォームモデル」タブの「レコードのドキュメントテンプレート設定」セクションで、「レコードのドキュメントを生成」を選択します。
6. 「完了」をクリックします。

アダプティブフォームコンポーネントとテンプレートフィールドのバインド

アダプティブフォームフィールドをテンプレートフィールドにバインドすると、取り込んだフォームデータが、対応するレコードのドキュメントフィールドに表示されます。アダプティブフォームコンポーネントを、対応するレコードのドキュメントテンプレートフィールドにバインドするには、次の手順に従います。

1. カスタムフォームテンプレートを使用するように設定されたアダプティブフォームを編集用に開きます。

2. アダプティブフォームコンポーネントを選択し、設定アイコン（）をクリックします。プロパティブラウザーが開きます。

3. プロパティブラウザーで、フィールドを参照して選択します。

   • （AcroForm テンプレートの場合）レコードのドキュメントバインド参照フィールド​プロパティ。
   • （XFA テンプレートの場合）データモデルバインド参照​プロパティ。

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

メール送信、Experience Manager ワークフローの送信アクションを、レコードのドキュメントのステップ、その他の送信アクションと組み合わせて使用し、レコードのドキュメントを受け取ることができます。

レコードのドキュメントテンプレートの増分更新

アダプティブフォームと対応するレコードのドキュメントテンプレートは、期間を経て漸進的に変化します。アダプティブフォームまたはレコードのドキュメントテンプレートに対して、フィールドの追加、削除、変更を選択できます。

レコードのドキュメントテンプレートに変更を加え、変更したレコードのドキュメントテンプレートを AEM Forms にアップロードすると、アダプティブフォームエディターが変更されたバインディングを自動的に検出し、新しいバインディングが必要なアダプティブフォームコンポーネントが通知されます。これにより、レコードのドキュメントテンプレートを増分更新できます。

例えば、We.Retail という組織に、AcroForm ベースのレコードのドキュメントテンプレート we-retail-invoice.pdf があるとします。テンプレートは次のようになります。

このテンプレートをしばらく使用した後、組織は invoice-number フィールドの名前を bill-number フィールドに変更し、購入者のメールアドレスを取り込むことにします。開発者は invoice-number フィールドの名前を更新し、テンプレートに「Email」フィールドを追加します。また、 we-retail-invoice-v2.pdf という新しいバージョンのテンプレートも作成します。

開発者は、更新されたテンプレートをアダプティブフォームにアップロードし、適用します。アダプティブフォームは、バインディングが変更されたフィールドのリストを自動的に検出して表示します。

フォーム開発者は、アダプティブフォームフィールドを、対応するレコードのドキュメントテンプレートとバインドします。

これで、アダプティブフォームが送信されると、更新されたレコードのレコードのドキュメントが作成されるようになりました。

レコードのドキュメントを使用する場合の主な注意点

アダプティブフォーム用のレコードのドキュメントで作業する際は、次の点に注意してください。

• レコードのドキュメントのテンプレートは、リッチテキストをサポートしません。そのため、静的アダプティブフォームまたはエンドユーザー入力情報に含まれるリッチテキストは、レコードのドキュメントではプレーンテキストとして表示されます。
• アダプティブフォーム内のドキュメントフラグメントは、レコードのドキュメントには表示されません。ただし、アダプティブフォームフラグメントはサポートされています。
• XML スキーマベースのアダプティブフォームは、レコードの生成されたドキュメント内でのコンテンツのバインドに対応していません。
• レコードのドキュメントのレンダリングをユーザーが要求すると、レコードのドキュメントのローカライズされたバージョンが、ロケールに合わせてオンデマンドで作成されます。レコードのドキュメントのローカライズは、アダプティブフォームのローカライズと同時に発生します。

アダプティブフォーム要素のマッピング

次の表に、アダプティブフォームのコンポーネントと対応する XFA のコンポーネントおよびそれらがレコードのドキュメントに表示される場合について説明します。

フィールド

コンテナ

静的コンポーネント

テーブル

ヘッダー、フッターおよび列といった、アダプティブフォームのテーブルコンポーネントは、対応する XFA コンポーネントにマッピングされます。繰り返し可能なパネルを、レコードのドキュメントのテーブルにマッピングすることができます。

レコードのドキュメントの基本テンプレート

基本テンプレートは、レコードのドキュメントにスタイリングと外観の情報を提供します。これにより、自動生成されたレコードのドキュメントに対して、デフォルトの外観をカスタマイズすることができます。例えば、基本テンプレートを使用して、レコードのドキュメントのヘッダーに会社のロゴを、フッターに著作権情報を追加できます。

基本テンプレートから作成されたマスターページは、レコードのドキュメントのテンプレートのマスターページとして使用されます。マスターページには、レコードのドキュメントに適用可能なページヘッダー、ページフッター、ページ番号などの情報を含めることができます。レコードのドキュメント自動生成用の基本テンプレートを使用することで、それらの情報をレコードのドキュメントに適用することができます。基本テンプレートを使用すると、フィールドのデフォルトプロパティを変更することができます。

基本テンプレートを設計する際は、基本テンプレートの規則に従ってください。

基本テンプレートの規則

基本テンプレートは、レコードのドキュメントのヘッダー、フッター、スタイル、および外観を定義するために使用されます。ヘッダーとフッターには、会社のロゴや著作権テキストなどの情報を含めることができます。基本テンプレートの最初のマスターページはコピーされ、レコードのドキュメント用のマスターページとして使用されます。この中には、ヘッダー、フッター、ページ番号、またはレコードのドキュメント内のすべてのページに表示される他の情報が含まれています。基本テンプレートの規則に準拠していない基本テンプレートを使用する場合でも、その最初のマスターページはレコードのドキュメントのテンプレートで使用されます。基本テンプレートを規則通りに設計し、レコードのドキュメント自動生成に使用することを強くお勧めします。

マスターページの規則

• 基本テンプレートでは、ルートサブフォームに AF_METATEMPLATE、マスターページに AF_MASTERPAGE と名前を付けます。

• ルートサブフォームの AF_METATEMPLATE 下に位置する AF_MASTERPAGE という名前のマスターページは、ヘッダー、フッターおよびスタイル情報を抽出する場合に優先して使用されます。

• AF_MASTERPAGE が存在しない場合は、基本テンプレート中に存在する最初のマスターページが使用されます。

フィールドのスタイリング規則

• レコードのドキュメント内のフィールドにスタイルを適用するため、基本テンプレートは AF_FIELDSSUBFORM ルートサブフォーム内の AF_METATEMPLATE サブフォームにフィールドを作成します。

• これらのフィールドのプロパティは、レコードのドキュメント内のフィールドに適用されます。これらのフィールドは、AF_<name of field in all caps>_XFO の命名規則に従う必要があります。例えば、チェックボックスのフィールド名は AF_CHECKBOX_XFO とする必要があります。

基本テンプレートを作成するには、Forms Designer で次の手順を実行します。

1. ファイル／新規​をクリックします。

2. 「テンプレートに基づく」のオプションを選択します。

3. 「Forms - レコードのドキュメント」のカテゴリを選択します。

4. 「DoR 基本テンプレート」を選択します。

5. 「次へ」をクリックし、必要な情報を入力します。

6. （オプション）レコードのドキュメント内のフィールドに適用する、フィールドのスタイルと外観を変更します。

7. フォームを保存します。

これで、保存されたフォームをレコードのドキュメント用基本テンプレートとして使用することができます。基本テンプレート中に存在するスクリプトについて、いずれも変更したり、削除したりしないでください。

基本テンプレートの変更

• 基本テンプレート内のフィールドに対していずれのスタイルも適用しない場合は、基本テンプレートからそれらのフィールドを削除することをお勧めします。これにより、基本テンプレートのアップグレードを自動的に適用することができます。
• 基本テンプレートを変更するときは、スクリプトを削除、追加、変更しないでください。

基本テンプレートを設計するときは、上記の規則と手順に厳密に従ってください。

レコードのドキュメントにあるブランディング情報のカスタマイズ

レコードのドキュメントの生成中に、「レコードのドキュメント」タブにあるレコードのドキュメントのブランディング情報を変更できます。「レコードのドキュメント」タブには、ロゴ、外観、レイアウト、ヘッダー、フッター、免責事項などのオプションや、選択されていないチェックボックスやラジオボタンを含めるかどうかのオプションが含まれています。

「レコードのドキュメント」タブに入力されたブランディング情報をローカライズするには、ブラウザーのロケールを正しく設定してください。レコードのドキュメントのブランディング情報をカスタマイズするには、次の手順を実行します。

1. レコードのドキュメント内でパネル（ルートパネル）を選択して、 をタップします。

2. をタップします。「レコードのドキュメント」タブが表示されます。

3. レコードのドキュメントをレンダリングするための、デフォルトのテンプレートまたはカスタムのテンプレートのいずれかを選択します。デフォルトのテンプレートを選択すると、レコードのドキュメントのサムネイルが「テンプレート」ドロップダウンの下に表示されます。

4. デフォルトのテンプレートとカスタムのテンプレートのどちらを選択するかにより異なりますが、以下のプロパティの一部または全部が「レコードのドキュメント」タブに表示されます。以下のプロパティを指定して、レコードのドキュメントの表示方法を定義します。

   1. 基本のプロパティ：

      • テンプレート：カスタムテンプレートを選択する場合は、AEM Forms サーバーで XDP を参照して選択します。お使いの AEM Forms サーバーにまだないテンプレートを使用する場合は、まず XDP を AEM Forms サーバーにアップロードする必要があります。
      • アクセントカラー：ヘッダーテキストおよび区切り線がレコードのドキュメントの PDF でレンダリングされる際のカラー。
      • フォントファミリー：レコードのドキュメントの PDF にあるテキストのフォントファミリー。
      • データモデルにバインドしていないフォームオブジェクトを含める：このプロパティを設定すると、レコードのドキュメント内のスキーマベースのアダプティブフォームからバインドされていないフィールドが、レコードのドキュメントに追加されます。
      • レコードのドキュメントから非表示フィールドを除外：このプロパティを設定すると、レコードのドキュメントから除外する非表示フィールドが識別されます。
      • パネルの説明を非表示：このプロパティを設定すると、レコードのドキュメントからパネルやテーブルの説明が除外されます。パネルとテーブルに対して適用可能です。

      

   2. フォームフィールドのプロパティ:

      • チェックボックスおよびラジオボタンのコンポーネントには、選択した値のみを表示：このプロパティを設定すると、チェックボックスとラジオボタンの選択された値のみがレコードのドキュメントに表示されます。
      • 複数の値の区切り文字：複数の値を表示する場合は、カンマや改行などの任意の区切り文字を選択できます。
      • オプションの位置揃え：目的の整列（水平、垂直、アダプティブフォームと同じ）を選択して、レコードのドキュメントに表示するチェックボックスやラジオボタンなどのフィールドの整列を設定することができます。デフォルトでは、垂直揃えがレコードのドキュメントのフィールドに設定されています。DoR のフォームフィールドのプロパティからプロパティを設定すると、アダプティブフォームのフィールドの項目の整列で設定されたプロパティが上書きされます。例えば「アダプティブフォームと同じ」オプションを使用する場合は、アダプティブフォームのオーサーインスタンスで設定された整列がレコードのドキュメントのフィールドに使用されます。
      • 水平揃えのオプション数：水平揃えの場合にレコードのドキュメントに表示するオプションの数を設定できます。

      

   3. マスターページのプロパティ:

      • ロゴイメージ：アダプティブフォームのロゴイメージを使用するか、DAM から選択するか、またはコンピューターからアップロードすることができます。
      • フォームのタイトル：DoR のタイトル。
      • ヘッダーテキスト：レコードのドキュメントのヘッダーセクションに表示されるテキスト。
      • 免責事項ラベル：免責事項のラベル。
      • 免責事項：レコードのドキュメントに対する権利と義務の範囲を指定するテキスト。
      • 免責事項テキスト：免責事項のテキスト。

      

   メモ

   バージョン 6.3 より前の Forms Designer で作成されたアダプティブフォームテンプレートを使用している場合、アクセントカラーおよびフォントファミリーのプロパティを適用するには、ルートサブフォームの下にあるアダプティブフォームテンプレートに以下が存在することを確認してください。

   <proto>
   <font typeface="Arial"/>
   <fill>
   <color value="4,166,203"/>
   </fill>
   <edge>
   <color value="4,166,203"/>
   </edge>
   </proto>
   

5. ブランディングの変更内容を保存するには、「完了」をタップします。

アダプティブフォームエディターでのレコードのドキュメントのサポート

レコードのドキュメントテンプレートは、アダプティブフォームエディターまたはアダプティブフォームテンプレートエディターから直接設定することができます。

アダプティブフォームエディターのオーサーインスタンスから、以下の手順を実行します。

1. アダプティブフォームコンテナ（ルート）​コンポーネントを選択します。

2. 「」アイコンをクリックして、アダプティブフォームコンテナの​プロパティ​開きます。

3. 「レコードのドキュメントのテンプレート」タブを開き、次のオプションから選択します。

   • なし：このオプションを選択すると、アダプティブフォーム用にレコードのドキュメントのテンプレートは作成されません。

   • フォームテンプレートをレコードのドキュメントのテンプレートとして関連付ける：このオプションを選択すると、XFA フォームがレコードのドキュメントのテンプレートとして使用されます。

   • レコードのドキュメントを生成：このオプションを選択すると、レコードのドキュメントのテンプレートがアダプティブフォーム用に自動的に生成されます。

4. 「」をタップして、プロパティを保存します。

レコードのドキュメントのパネルに表示される表と列のレイアウト

いくつかのフォームフィールドを使用すると、アダプティブフォームが長くなる場合があります。その場合、レコードのドキュメントをアダプティブフォームの正確なコピーとして保存することはお勧めしません。ここでは、1 つ以上のアダプティブフォームパネルをレコードのドキュメント PDF に保存するための表または列のレイアウトを選択できます。

レコードのドキュメントを生成する前に、パネルの設定の「レコードのドキュメントのレイアウト」で、パネル用に表または列を選択します。パネル内のフィールドは、レコードのドキュメントに合わせて配置されます。

レコードのドキュメントの表レイアウト内でレンダリングされたパネルのフィールド

レコードのドキュメントの列レイアウト内でレンダリングされたパネルのフィールド

レコードのドキュメントの設定

レコードのドキュメントの設定では、レコードのドキュメントに含めるオプションを選択できます。例えば、銀行では、名前、年齢、社会保障番号、電話番号などをフォームから受け取ります。銀行口座番号や支店の詳細は、フォーム上に生成されます。レコードのドキュメントでは、名前、社会保障番号、銀行口座、および支店の詳細のみが表示されるように選択できます。

レコードのドキュメントコンポーネントの設定は、そのプロパティで使用できます。コンポーネントのプロパティにアクセスするには、コンポーネントを選択し、オーバーレイ内の をクリックします。プロパティはサイドバーにリスト表示され、その中で次の設定を検索できます。

フィールドレベルの設定

• レコードのドキュメントから除外：プロパティを「true」に設定すると、そのフィールドがレコードのドキュメントから除外されます。これは excludeFromDoR という名前のスクリプト可能プロパティです。その動作は、非表示の場合はレコードのドキュメントからフィールドを除外​フォームレベルプロパティに依存します。

• パネルを表として表示：​パネルに含まれるフィールドの数が 6 個未満の場合、このプロパティを設定することでパネルが表としてレコードのドキュメントに表示されます。この設定は、パネルにのみ適用されます。

• レコードのドキュメントからタイトルを除外：​このプロパティを設定すると、レコードのドキュメントからパネルや表のタイトルが除外されます。パネルおよび表に対してのみ適用できます。

• レコードのドキュメントから説明を除外：​このプロパティを設定すると、レコードのドキュメントからパネルや表の説明が除外されます。パネルおよび表に対してのみ適用できます。

フォームレベルの設定

• バインドされていないフィールドをレコードのドキュメントに含める：​このプロパティを設定すると、スキーマベースのアダプティブフォームのバインドされていないフィールドがレコードのドキュメントに追加されます。デフォルトでは true になっています。
• 非表示の場合に DoR からフィールドを除外： フォーム送信時にレコードのドキュメントから非表示フィールドを除外するプロパティを設定します。 有効にする場合 サーバーで再検証を指定した場合、サーバーは非表示のフィールドを再計算してから、レコードのドキュメントからこれらのフィールドを除外します。

カスタム XCI ファイルの使用

XCI ファイルは、ドキュメントの様々なプロパティを設定する場合に役立ちます。Forms as a Cloud Service にはマスター XCI ファイルがあります。カスタム XCI ファイルを使用して、マスター XCI ファイルで指定された 1 つ以上のデフォルトのプロパティを上書きできます。例えば、ドキュメントにフォントを埋め込むか、すべてのドキュメントに対してタグ付きプロパティを有効にするかを選択できます。XCI オプションを次の表に示します。

Forms as a Cloud Service 環境でのカスタム XCI ファイルの使用

1. 開発プロジェクトにカスタム XCI ファイルを追加します。

2. 次の inline プロパティを指定します。

    {
     "xciFilePath": "[path of XCI file]"
    }
   

   例：

    {
     "xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci"
    }
   

3. Cloud Service 環境にコードをデプロイします。

ローカルの Forms as a Cloud Service 開発環境でのカスタム XCI ファイルの使用

1. XCI ファイルをアップロード環境にローカル開発します。
2. Cloud Service SDK 設定マネージャーを開きます。デフォルトの URL は http://localhost:4502/system/console/configMgr です。
3. 「アダプティブフォームおよびインタラクティブ通信 Web チャネル」の設定を検索して開きます。
4. XCI ファイルのパスを指定し、「保存」をクリックします。

Business.Adobe.com リソース