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

概要

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

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

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

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

• フォームテンプレート

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

• XML スキーマ

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

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

• なし

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

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

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

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

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

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

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

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

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

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

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

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

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

アダプティブフォームでユーザーが入力したForm dataInformation。レコードのドキュメントを生成するために、レコードのドキュメントと結合します。

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

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

フィールド

アダプティブフォームコンポーネント	対応する XFA スキンコンポーネント	レコードのドキュメントにデフォルトで含まれますか？	備考
ボタン	ボタン	false
チェックボックス	チェックボックス	true
日付選択	日付／時間フィールド	true
ドロップダウンリスト	コンボボックス	true
手書き署名	手書き署名	true
数値ボックス	数値フィールド	true
パスワードボックス	パスワードフィールド	false
ラジオボタン	ラジオボタン	true
テキストボックス	テキストフィールド	true
リセットボタン	リセットボタン	false
送信ボタン	電子メール送信ボタン HTTP 送信ボタン	false
利用条件		true
添付ファイル		false	レコードテンプレートのドキュメントでは使用できません。 添付ファイルを介したレコードのドキュメントでのみ使用できます。

コンテナ

アダプティブフォームコンポーネント	対応する XFA スキンコンポーネント	備考
パネル	Subform	反復パネルは繰り返しサブフォームにマッピングされます。

スタティックコンポーネント

アダプティブフォームコンポーネント	対応する XFA スキンコンポーネント	備考
画像	画像	TextDrawとImageのコンポーネントは、連結または連結解除にかかわらず、レコードのドキュメント設定で除外されない限り、XSDベースのアダプティブフォームのレコードのドキュメントに常に表示されます。
テキスト	テキスト

表

ヘッダー、フッター、および列といった、アダプティブフォームのテーブルコンポーネントは、対応する 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にする必要があります。

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

1. File／New をクリックします。

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

3. 「フォーム：レコードのドキュメント」​のカテゴリを選択します。

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

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

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

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

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

基本テンプレートの変更

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

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

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

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

1. AEMオーサーインスタンスで、Forms/Formsとドキュメントをクリックします。

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 翻訳ワークフローを使用したアダプティブフォールおよびレコードのドキュメントのローカライズ」を参照してください。