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

概要

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

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

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

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

事前準備

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

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

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

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

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

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

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

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

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

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

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

1. Experience Managerオーサーインスタンスで、 Forms > 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. レコードのドキュメントをレンダリングするための、デフォルトのテンプレートまたはカスタムのテンプレートのいずれかを選択します。デフォルトのテンプレートを選択すると、レコードのドキュメントのサムネイルが「テンプレート」ドロップダウンの下に表示されます。

   

   カスタムのテンプレートを選択する場合は、AEM Forms サーバーで XDP を参照して選択します。まだ AEM Forms サーバー上で、最初に XDP を AEM Forms サーバー。

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

   • ロゴイメージ：アダプティブフォームのロゴイメージを使用するか、DAM から選択するか、またはコンピューターからアップロードすることができます。
   • フォームタイトル
   • ヘッダーテキスト
   • 免責事項ラベル
   • 免責事項
   • 免責事項テキスト
   • アクセントの色：ヘッダーテキストおよび区切り線の色は、レコードのドキュメントの PDF でレンダリングされます
   • フォントファミリー：レコードのドキュメントの PDF にあるテキストフォントファミリー
   • チェックボックスおよびラジオボタンのコンポーネントには、選択した値のみが表示されます
   • 複数選択されている値のセパレーター
   • データモデルにバインドしていないフォームオブジェクトを含める
   • レコードのドキュメントから非表示フィールドを除外
   • パネルの説明を非表示
   メモ

   6.3 より前のバージョンの Designer で作成されたアダプティブフォームテンプレートを使用している場合、Accent Color プロパティと Font Family プロパティを機能させるには、アダプティブフォームテンプレートのルートサブフォームの下に次の内容が存在することを確認します。

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

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

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

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

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

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

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

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

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

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

フィールドレベルの設定

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

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

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

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

フォームレベルの設定

• バインドされていないフィールドをレコードのドキュメントに含める：​このプロパティを設定すると、スキーマベースのアダプティブフォームのバインドされていないフィールドがレコードのドキュメントに追加されます。デフォルトでは true になっています。
• 非表示の場合はレコードのドキュメントからフィールドを除外：このプロパティを設定すると、「レコードのドキュメントから除外」フィールドレベルプロパティが true でないときにその動作が上書きされます。フォームの送信時にフィールドが非表示になっている場合、「レコードのドキュメントから除外」プロパティが設定されていない場合、プロパティが true に設定されていれば、レコードのドキュメントから除外されます。

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

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

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

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

2. 以下を指定します。 inline プロパティ:

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

   例：

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

3. プロジェクトをCloud Service環境にデプロイします。

ローカルのFormsas a Cloud Service開発環境でカスタム XCI ファイルを使用する

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