フォームに記入して送信した顧客は、印刷するかまたはドキュメント形式で保存するかして、同じ情報を今後の参考用に保存しておきたいと考えるのが一般的です。これを、レコードのドキュメントといいます。
この記事では、アダプティブフォーム向けのレコードのドキュメントを生成する方法について説明します。
レコードのドキュメントの自動生成は、XFAベースのアダプティブフォームではサポートされていません。 ただし、アダプティブフォーム作成用の XDP をレコードのドキュメントとして使用することができます。
アダプティブフォームの作成時に、フォームのモデルを指定できます。次のオプションがあります。
アダプティブフォームのXFAテンプレートを選択できます。 XFAテンプレートを選択する場合、前述のように、レコードのドキュメントに関連付けられたXDPファイルを使用できます。
アダプティブフォームのXMLスキーマ定義を選択できます。 XML スキーマ アダプティブフォームの 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ベースのアダプティブフォームのレコードのドキュメントに常に表示されます。 |
テキスト | テキスト |
従来の UI では、フィールドプロパティを編集する際に別々のタブを開きます。
ヘッダー、フッター、および列といった、アダプティブフォームのテーブルコンポーネントは、対応する 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 で次の手順を実行します。
File/New をクリックします。
「テンプレートに基づく」のオプションを選択します。
「フォーム:レコードのドキュメント」のカテゴリを選択します。
「DoR 基本テンプレート」を選択します。
「次へ」をクリックし、必要な情報を入力します。
(オプション)レコードのドキュメント内のフィールドに適用する、フィールドのスタイルと外観を変更します。
フォームを保存します。
これで、保存されたフォームをレコードのドキュメント用基本テンプレートとして使用することができます。
基本テンプレート中に存在するスクリプトについて、いずれも変更したり、削除したりしないでください。
基本テンプレートの変更
基本テンプレート規則を使用し、上記の手順を正確に実行してください。
フォームのレコードドキュメントテンプレートを設定して、顧客が送信したフォームの印刷用フレンドリコピーをダウンロードできるようにします。 XDPファイルは、レコードテンプレートのドキュメントとして機能します。 顧客がダウンロードしたレコードのドキュメントは、XDPファイルで指定されたレイアウトに従ってフォーマットされます。
次の手順を実行して、アダプティブフォームのレコードのドキュメントを設定します。
AEMオーサーインスタンスで、Forms/Formsとドキュメントをクリックします。
フォームを選択し、「プロパティの表示」をクリックします。
プロパティウィンドウで、フォームモデルをタップします。
また、フォームの作成時にフォームモデルを選択することもできます。
「フォームモデル」のタブで、必ず**「フォームの選択」ドロップダウンから「 スキーマ」または「なし」**を選択します。レコードのドキュメントは、XFAベースのフォームや、フォームテンプレートをフォームモデルとして使用するアダプティブフォームではサポートされていません。
「フォームモデル」タブの「レコードのドキュメントのテンプレート設定」セクションで、次のいずれかのオプションを選択します。
なしフォームのレコードのドキュメントを設定しない場合は、このオプションを選択します。
フォームテンプレートをレコードのドキュメントとして関連付け るレコードのドキュメントのテンプレートとして使用するXDPファイルがある場合は、このオプションを選択します。このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
選択された XDP ファイルは、アダプティブフォームに関連付けられます。
レコードのドキュメントの生成 レコードのドキュメントのスタイルと外観を定義する基本テンプレートとしてXDPファイルを使用する場合は、このオプションを選択します。このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
レコードのドキュメントのスタイルと外観が定義された基本テンプレートとして XDP ファイルを使用するには、このオプションを選択します。このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
レコードのドキュメントを生成する基本テンプレートとしてFormsテンプレートを選択します。レコードのテンプレートのスタイルと外観を定義する基本テンプレートとしてXDPファイルを使用する場合は、このオプションを選択します。 このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
アダプティブフォーム作成するために使用されるスキーマと、XFA フォームのスキーマ(データスキーマ)が同じであることを確認します。
「完了」をクリックします。
レコードのドキュメントの生成中に、「レコードのドキュメント」タブにあるレコードのドキュメントのブランディング情報を変更できます。「レコードのドキュメント」タブには、ロゴ、外観、レイアウト、ヘッダー、フッター、免責事項などのオプションや、選択されていないチェックボックスやラジオボタンを含めるかどうかのオプションが含まれています。
「レコードのドキュメント」タブに入力するブランディング情報をローカライズするには、ブラウザーのロケールを正しく設定する必要があります。レコードのドキュメントのブランディング情報をカスタマイズするには、次の手順を実行します。
レコードのドキュメントでパネル(ルートパネル)を選択し、をタップします。
をタップします。 「レコードのドキュメント」タブが表示されます。
レコードのドキュメントをレンダリングする、デフォルトのテンプレートまたはカスタムのテンプレートのいずれかを選択します。デフォルトのテンプレートを選択すると、レコードのドキュメントのサムネイルが「テンプレート」ドロップダウンの下に表示されます。
カスタムのテンプレートを選択する場合は、AEM Forms サーバーで XDP を参照して選択します。使用する AEM Forms サーバーにないテンプレートを使用する場合は、最初に 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>
ブランディングの変更内容を保存するには、「完了」をタップします。
アダプティブフォームは、複数のフォームフィールドを持つ長い場合があります。 その場合、レコードのドキュメントをアダプティブフォームの正確なコピーとして保存することはお勧めしません。テーブルまたは列のレイアウトを 1 つ選択し、このレイアウトを適用して、1 つ以上のアダプティブフォームパネルをレコードのドキュメント PDF に保存できます。
レコードのドキュメントを生成する前に、パネルの設定の「レコードのドキュメントのレイアウト」で、パネル用にテーブルまたは列を選択します。パネル内のフィールドは、レコードのドキュメントに合わせて配置されます。
レコードのドキュメントのテーブルレイアウト内でレンダリングされたパネルのフィールド
レコードのドキュメントの列レイアウト内でレンダリングされたパネルのフィールド
レコードのドキュメントの設定では、レコードのドキュメントに含めるオプションを選択できます。 例えば、銀行では、名前、年齢、マイナンバー番号、電話番号などをフォームから受け取ります。銀行口座番号や支店の詳細は、フォーム上に生成されます。レコードのドキュメントでは、名前、マイナンバー番号、銀行口座、および支店の詳細のみが表示されるように選択できます。
コンポーネントのレコード設定のドキュメントは、そのプロパティの下で使用できます。 コンポーネントのプロパティにアクセスするには、コンポーネントを選択し、オーバーレイのをクリックします。 プロパティはサイドバーに一覧表示され、その中で次の設定を見つけることができます。
フィールドレベルの設定
レコードのドキュメントから除外:プロパティを「true」に設定すると、そのフィールドがレコードのドキュメントから除外されます。これは excludeFromDoR
という名前のスクリプト可能プロパティです。その動作は、非表示の場合はレコードのドキュメントからフィールドを除外フォームレベルプロパティに依存します。
パネルをテーブルとして表示:パネルに含まれるフィールドの数が6個未満の場合、このプロパティを 設定すると、パネルがレコードドキュメントのテーブルとして表示されます。この設定は、パネルにのみ適用されます。
レコードのドキュメントからタイトルを除外:このプロパティを設定すると、レコードのドキュメントからパネルやテーブルのタイトルが除外されます。パネルおよびテーブルに対してのみ適用できます。
レコードのドキュメントから説明を除外:このプロパティを設定すると、レコードのドキュメントからパネルやテーブルの説明が除外されます。パネルおよびテーブルに対してのみ適用できます。
フォームレベルの設定
アダプティブフォームのレコードのドキュメントを操作する際は、次の点に注意してください。