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

概要

フォームに記入して送信した顧客は、印刷するかまたはドキュメント形式で保存するかして、同じ情報を今後の参考用に保存しておきたいと考えるのが一般的です。これを、レコードのドキュメントといいます。

この記事では、アダプティブフォーム向けのレコードのドキュメントを生成する方法について説明します。

アダプティブフォームの種類とレコードのドキュメント

アダプティブフォームの作成時に、フォームのモデルを指定できます。以下のオプションがあります。

• フォームテンプレート

  アダプティブフォームの XFA テンプレートを選択できます。 XFA テンプレートを選択すると、前述のように、レコードのドキュメントに関連付けられた XDP ファイルを使用できます。

• XML スキーマ

  アダプティブフォームの XML スキーマ定義を選択できます。 XML スキーマ アダプティブフォームの XML スキーマ定義を選択すると、次のことができます。

  • レコードのドキュメントに XFA テンプレートを関連付ける。関連する XFA テンプレートで、アダプティブフォームと同じ XML スキーマを使用させる。
  • レコードのドキュメントを自動的に生成

• なし

  フォームモデルを使用せずにアダプティブフォームを作成できます。 レコードのドキュメントは、アダプティブフォーム用に自動的に生成されます。

フォームモデルを選択する場合は、「レコードのドキュメントのテンプレート設定」の下にあるオプションを使用して、レコードのドキュメントを設定します。 レコードのドキュメントのテンプレート設定を参照してください。

自動的に生成されたレコードのドキュメント

レコードのドキュメントを使用すると、顧客は送信したフォームを印刷目的で保存することができます。レコードのドキュメントを自動的に生成すると、フォームを変更するたびに、そのレコードのドキュメントが直ちに更新されます。 例えば、居住国に米国を選択した顧客のレコードでは、年齢のフィールドを削除したとします。このような顧客がレコードのドキュメントを生成する場合、レコードのドキュメントでは年齢フィールドが表示されません。

レコードの自動生成ドキュメントには次の利点があります。

• データ連結が処理されます。
• 送信時にレコードのドキュメントから除外されたとマークされたフィールドは自動的に非表示になります。 余分な労力が不要になります。
• レコードのドキュメントテンプレートのデザインにかかる時間を節約できます。
• 様々な基本テンプレートを使用しながら様々なスタイリングと外観を試すことで、レコードのドキュメントにとって最良のスタイルと外観を選択できます。スタイリングを設定することはオプションです。スタイルを指定しない場合は、システムスタイルがデフォルトとして設定されます。
• フォーム内のすべての変更が、確実かつ即座にレコードのドキュメントに反映されます。

レコードのドキュメントを自動生成するためのコンポーネント

アダプティブフォーム用のレコードのドキュメントを生成するには、次のコンポーネントが必要です。

アダプティブフォーム レコードのドキュメントを生成するアダプティブフォームです。

基本テンプレート（推奨） AEM Designer で作成された XFA テンプレート（XDP ファイル）。基本テンプレートは、レコードのドキュメントテンプレートのスタイルとブランディング情報を指定するために使用されます。

詳しくは、 レコードのドキュメントの基本テンプレート

レコードのドキュメントテンプレート アダプティブフォームから生成された XFA テンプレート（XDP ファイル）。

レコードのドキュメントのテンプレート設定を参照してください。

フォームデータ アダプティブフォームでユーザーが入力した情報。 レコードのドキュメントを生成するために、レコードのドキュメントテンプレートとマージされます。

アダプティブフォームエレメントのマッピング

次のセクションでは、レコードのドキュメント内でアダプティブフォームエレメントがどのように表示されるかについて説明します。

フィールド

コンテナ

静的コンポーネント

テーブル

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

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

基本テンプレートは、レコードのドキュメントにスタイリングと外観の情報を提供します。これにより、自動生成されたレコードのドキュメンに対して、デフォルトの外観をカスタマイズすることができます。例えば、レコードのドキュメントのヘッダーに会社のロゴを、そしてフッターに著作権情報を追加するとします。基本テンプレートから作成されたマスターページは、レコードのドキュメントのマスターページとして使用されています。マスターページには、レコードのドキュメントに適用可能なページヘッダー、ページフッター、ページ番号などの情報を含めることができます。レコードのドキュメントを自動生成するための基本テンプレートを使用して、レコードのドキュメントにそのような情報を適用できます。 基本テンプレートを使用すると、フィールドのデフォルトプロパティを変更することができます。

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

基本テンプレートの規則

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

マスターページの規則

• 基本テンプレートでは、ルートサブフォームに AF_METATEMPLATE、およびマスターページに AF_MASTERPAGE の名前を付ける必要があります。

• ルートサブフォームの AF_MASTERPAGE 下に位置する AF_METATEMPLATE という名前のマスターページには、ヘッダー、フッター、およびスタイル情報を抽出するための優先順位が与えられています。

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

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

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

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

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

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

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

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

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

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

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

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

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

基本テンプレートの変更

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

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

フォームのレコードのドキュメントテンプレートを設定して、顧客が送信したフォームの印刷用にわかりやすいコピーをダウンロードできるようにします。 XDP ファイルは、レコードのドキュメントテンプレートとして機能します。 顧客がダウンロードしたレコードのドキュメントは、XDP ファイルで指定されたレイアウトに従ってフォーマットされます。

次の手順を実行して、アダプティブフォーム用にレコードのドキュメントを設定します。

1. AEM オーサーインスタンスで、フォーム／フォームとドキュメント​をクリックします。

2. フォームを選択し、「プロパティの表示」をクリックします。

3. 「プロパティ」ウィンドウで、「フォームモデル」をタップします。

   フォームモデルの選択は、フォームの作成時にも行うことができます。

   メモ

   「フォームモデル」のタブで、必ず「次から選択」ドロップダウンから「スキーマ」または「なし」を選択します。レコードのドキュメントは、フォームテンプレートをフォームモデルとして使用した XFA ベースのフォームやアダプティブフォームではサポートされていません。

4. 「フォームモデル」タブの「レコードのドキュメントのテンプレート設定」セクションで、次のいずれかのオプションを選択します。

   なし フォームのレコードのドキュメントを設定しない場合は、このオプションを選択します。

   フォームテンプレートをレコードのドキュメントテンプレートとして関連付ける レコードのドキュメントのテンプレートとして使用する XDP ファイルがある場合は、このオプションを選択します。 このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。適切なファイルを選択します。

   選択された XDP ファイルは、アダプティブフォームに関連付けられます。

   レコードのドキュメントを生成 レコードのドキュメントのスタイルと外観を定義する基本テンプレートとして XDP ファイルを使用する場合は、このオプションを選択します。 このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。適切なファイルを選択します。

   レコードのドキュメントのスタイルと外観が定義された基本テンプレートとして XDP ファイルを使用するには、このオプションを選択します。このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。適切なファイルを選択します。

   レコードのドキュメントを生成する基本テンプレートとしてFormsテンプレートを選択 レコードのドキュメントのスタイルと外観を定義する基本テンプレートとして XDP ファイルを使用する場合は、このオプションを選択します。 このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。適切なファイルを選択します。

   メモ

   アダプティブフォーム作成するために使用されるスキーマと、XFA フォームのスキーマ（データスキーマ）が同じであることを確認します。

   • アダプティブフォームがスキーマベースの場合
   • 次を使用している： フォームテンプレートをレコードのドキュメントテンプレートとして関連付ける レコードのドキュメントのオプション

5. 「完了」をクリックします。

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

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

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

1. レコードのドキュメント内のパネル（ルートパネル）を選択し、 .

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

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

   

   カスタムのテンプレートを選択する場合は、AEM Forms サーバーで XDP を参照して選択します。使用する AEM Forms サーバーにないテンプレートを使用する場合は、最初に XDP を AEM Forms サーバーにアップロードする必要があります。

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

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

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

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

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

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

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

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

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

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

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

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

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

フィールドレベルの設定

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

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

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

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

フォームレベルの設定

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

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

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

• レコードのドキュメントテンプレートは、リッチテキストをサポートしていません。 そのため、スタティックアダプティブフォームまたはエンドユーザー入力情報に含まれるリッチテキストは、レコードのドキュメントではプレーンテキストとして表示されます。
• アダプティブフォーム内のドキュメントフラグは、レコードのドキュメントには表示されません。ただし、アダプティブフォームフラグメントはサポートされています。
• レコードのドキュメントは、印刷目的でのみ使用されます。
• XML スキーマベースのアダプティブフォームは、レコードの生成されたドキュメント内でのコンテンツのバインドに対応していません。
• XML スキーマベースのアダプティブフォームは、レコードの生成されたドキュメント内でのコンテンツのバインドに対応していません。
• レコードのドキュメントのレンダリングをユーザーが要求すると、レコードのドキュメントのローカライズされたバージョンが、ロケールに合わせてオンデマンドで作成されます。レコードのドキュメントのローカライズは、アダプティブフォームのローカライズと同時に発生します。レコードのドキュメントおよびアダプティブフォームのローカライズについて詳しくは、「AEM 翻訳ワークフローを使用したアダプティブフォールおよびレコードのドキュメントのローカライズ」を参照してください。