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

概要

フォームを送信した後、顧客は通常、印刷するかまたはドキュメント形式で保存するかのどちらかで、フォームに記入した情報を今後の参考のために記録しておきたいと考えます。これを、レコードのドキュメントといいます。

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

メモ

レコードのドキュメントの自動生成は、XFA ベースのアダプティブフォームではサポートされていません。ただし、アダプティブフォーム作成用の XDP をレコードのドキュメントとして使用することができます。

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

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

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

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

    • レコードのドキュメントに XFA テンプレートを関連付ける。関連する XFA テンプレートで、アダプティブフォームと同じ XML スキーマを使用させる。
    • レコードのドキュメントの自動生成
  • なし
    フォームのモデルを指定せずに、アダプティブフォームを作成できます。レコードのドキュメントは、アダプティブフォーム用に自動的に生成されます。

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

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

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

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

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

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

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

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

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

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

メモ

レコードのドキュメントの基本テンプレートは、レコードのドキュメントのメタテンプレートとも呼ばれます。

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

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

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

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

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

フィールド

アダプティブフォームコンポーネント 対応する XFA コンポーネント レコードのドキュメントテンプレートにデフォルトで含まれるか。 備考
ボタン ボタン false
チェックボックス チェックボックス true
日付選択 日付/時間フィールド true
ドロップダウンリスト ドロップダウンリスト true
手書き署名 手書き署名 true
数値ボックス 数値フィールド true
パスワードボックス パスワードフィールド false
ラジオボタン ラジオボタン true
テキストボックス テキストフィールド true
リセットボタン リセットボタン false
送信ボタン

メール送信ボタン

HTTP 送信ボタン

false
利用条件 true
ファイル添付 false レコードのドキュメントテンプレートでは使用できません。添付ファイルを介した場合のみレコードのドキュメントで使用できます。

コンテナ

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

静的コンポーネント

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

従来の UI では、フィールドプロパティを編集する際に別々のタブを開きます。

テーブル

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

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

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

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

基本テンプレートの規則

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

マスターページの規則

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

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

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

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

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

  • これらのフィールドのプロパティは、レコードのドキュメント内のフィールドに適用されます。これらのフィールドは、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 ファイルが表示されます。適切なファイルを選択します。

    メモ

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

    * アダプティブフォームがスキーマベースの場合
    * レコードのドキュメント用の「**フォームテンプレートをレコードのドキュメントテンプレートとして関連付ける**」オプションを使用している場合
    
  5. 完了」をクリックします。

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

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

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

  1. レコードのドキュメント内でパネル(ルートパネル)を選択して、「設定」をタップします。

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

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

    brandingtemplate

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

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

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

    選択したカスタム XDP テンプレートに複数のマスターページが含まれている場合、これらのページのプロパティは「レコードのドキュメント」タブの「コンテンツ」セクションに表示されます。

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

    マスターページのプロパティには、ロゴ画像、ヘッダーテキスト、フォームタイトル、免責事項ラベル、免責事項テキストが含まれます。アダプティブフォームまたは XDP テンプレートのプロパティは、レコードのドキュメントに適用できます。AEM Forms は、デフォルトでテンプレートのプロパティをレコードのドキュメントに適用します。マスターページのプロパティにカスタム値を定義することもできます。レコードのドキュメントに複数のマスターページを適用する方法については、レコードのドキュメントに複数のマスターページを適用するを参照してください。

    メモ

    バージョン 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 に保存できます。

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

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

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

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

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

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

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

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

フィールドレベルの設定

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

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

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

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

  • ページネーション場所:パネルを配置する場所を指定します。

    • 場所前に従う:親パネル内の前のオブジェクトの後にパネルを配置します。
    • 場所コンテンツ領域内 /コンテンツ領域名:指定したコンテンツ領域にパネルを配置します。
    • 場所次のコンテンツ領域の先頭:パネルを次のコンテンツ領域の先頭に配置します。
    • 場所コンテンツ領域の先頭/コンテンツ領域名:指定したコンテンツ領域の先頭にパネルを配置します。
    • 場所ページ上/マスターページの名前:指定したページにパネルを配置します。改ページが自動的に挿入されない場合、AEM Forms は改ページを追加します。
    • 場所次のページの先頭:パネルを次のページの先頭に配置します。改ページが自動的に挿入されない場合、AEM Forms は改ページを追加します。
    • 場所ページの先頭/マスターページの名前:指定したページがレンダリングされる際に、パネルをページの先頭に配置します。改ページが自動的に挿入されない場合、AEM Forms は改ページを追加します。
  • ページネーション:パネルを配置した後に入力する領域を決定します。​セクションでは次のフィールドを使用できます。

    • 親の入力を続行:親パネルに入力されたまま残っているすべてのオブジェクトのデータを引き続き結合します。
    • 次のコンテンツ領域に移動:パネルを配置した後に、次のコンテンツ領域の埋め込みを開始します。
    • コンテンツ領域に移動/コンテンツ領域名:パネルを配置した後に、指定したコンテンツ領域の入力を開始します。
    • 次のページに移動:パネルを配置した後で、次のページへの入力を開始します。
    • ページに移動/ページ名:パネルを配置した後に、指定したページへの入力を開始します。
  • ページネーションオーバーフロー:パネルまたはページに広がるテーブルのオーバーフローを設定します。「オーバーフロー」セクションでは次のフィールドを使用できます。

    • オーバーフローなし:次のページへの入力を開始します。改ページが自動的に挿入されない場合、AEM Forms は改ページを追加します。
    • オーバーフローコンテンツ領域に移動/コンテンツ領域名:指定したコンテンツ領域への入力を開始します。
    • オーバーフローページに移動/ページ名:指定したページへの入力を開始します。

レコードのドキュメントで改ページを適用し、複数のマスターページを適用する方法について詳しくは、 レコードのドキュメントに対する改ページの適用およびレコードのドキュメントに対する複数のマスターページの適用を参照してください。

フォームレベルの設定

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

レコードのドキュメントに対する改ページの適用

複数の方法を使用して、レコードのドキュメントに改ページを適用できます。

レコードのドキュメントに改ページを適用するには:

  1. パネルをタップし、「設定」を選択します。

  2. レコードのドキュメント」を展開すると、プロパティが表示されます。

  3. ページネーション」セクションで、場所​フィールドの「フォルダー」をタップします。

  4. 次のページの先頭」/「選択」をタップします。また、「ページの先頭」をタップしてマスターページを選択し、「選択」をタップして改ページを適用することもできます。

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

選択したパネルは次のページに移動します。

レコードのドキュメントに対する複数のマスターページの適用

選択したカスタム XDP テンプレートに複数のマスターページが含まれている場合、これらのページのプロパティは、「 レコードのドキュメント」タブの「コンテンツ」セクションに表示されます。詳しくは、レコードのドキュメントにあるブランディング情報のカスタマイズを参照してください。

アダプティブフォームのコンポーネントに異なるマスターページを適用することで、レコードのドキュメントに複数のマスターページを適用できます。複数のマスターページを適用する場合は、レコードのドキュメントプロパティの「ページネーション」セクションを使用します。

レコードのドキュメントに複数のマスターページを適用する方法の例を以下に示します。
4 つのマスターページを含む XDP テンプレートを AEM Forms サーバーにアップロードします。AEM Forms は、デフォルトでレコードのドキュメントにテンプレートのプロパティを適用します。また、AEM Forms はテンプレートにおける最初のマスターページのプロパティをレコードのドキュメントに適用します。

2 つ目のマスターページのプロパティをパネルに適用し、3 つ目のマスターページのプロパティをそれ以降のパネルに適用するには、以下の手順を実行します。

  1. パネルをタップして 2 つ目のマスターページを適用し、「 設定.」を選択します。
  2. ページネーション」セクションで、場所​フィールドの「フォルダー」をタップします。
  3. ページ上」をタップして、2 つ目のマスターページを選択し、「選択」をタップします。
    AEM Forms は、アダプティブフォーム内の該当するパネルとそれ以降のすべてのパネルに 2 つ目のマスターページを適用します。
  4. ページネーション」セクションで、​フィールドの「フォルダー」をタップします。
  5. 移動先ページ」をタップして、3 つ目のマスターページを選択し、「選択」をタップします。
  6. 保存」をタップして、プロパティを保存します。
    AEM Forms は、アダプティブフォーム内の該当するパネルとそれ以降のすべてのパネルに 3 つ目のマスターページを適用します。

レコードのドキュメントで作業する場合の主な注意点

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

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

このページ