フォームの入力時または送信時には、そのフォームを印刷物またはドキュメント形式で記録しておくことができます。このレコードは、レコードのドキュメント(DoR)と呼ばれる、送信されたフォームの印刷用コピーです。また、顧客が後日入力した情報のレコードのドキュメントを参照したり、レコードのドキュメントを使用してフォームとコンテンツを PDF 形式でアーカイブしたりすることもできます。
レコードのドキュメントを作成するには、XFA または AcroForm ベースのテンプレートを、アダプティブフォームを使用して収集したデータと結合します。レコードのドキュメントは、自動またはオンデマンドで生成できます。オンデマンドオプションを使用すると、XFA または AcroForm ベースのカスタムテンプレートを指定して、レコードのドキュメントの外観をカスタマイズすることができます。
以下の操作を実行できます。
本題に入る前に、レコードのドキュメントに必要な次のアセットを理解し準備します。
基本テンプレート: Forms Designer または Acrobat フォーム(AcroForm)で作成された XFA テンプレート(XDP ファイル)。基本テンプレートは、レコードのドキュメントのスタイル設定とブランディング情報を指定するために使用されます。XFA テンプレート(XDP ファイル)を AEM Forms インスタンスに先にアップロードします。
アダプティブフォーム:レコードのドキュメントが生成されるアダプティブフォーム。
XFA テンプレート(XDP ファイル)を AEM Forms インスタンスにアップロードします。XFA テンプレート(XDP ファイル)をレコードのドキュメントのテンプレートとして使用するようにアダプティブフォームを設定するには、次の手順を実行します。
これで、XDP ファイルをレコードのドキュメントのテンプレートとして使用するように、アダプティブフォームが設定されました。次の手順では、アダプティブフォームコンポーネントを対応するテンプレートフィールドにバインドします。
Adobe Acrobat PDF(AcroForm)を AEM Forms インスタンスにアップロードします。Adobe Acrobat PDF(AcroForm)をレコードのドキュメントのテンプレートとして使用するようにアダプティブフォームを設定するには、次の手順を実行します。
これで、AcroForm をレコードのドキュメントのテンプレートとして使用するように、アダプティブフォームが設定されました。次の手順では、アダプティブフォームコンポーネントを対応するテンプレートフィールドにバインドします。
レコードのドキュメントを自動的に生成するようにアダプティブフォームを設定すると、フォームが変更されるたびに、そのレコードのドキュメントが直ちに更新されます。例えば、既存のアダプティブフォームからフィールドを削除すると、対応するフィールドも削除され、レコードのドキュメントには表示されません。レコードのドキュメントを自動的に生成する利点は他にも多数あります。:
レコードのドキュメントを自動生成するようアダプティブフォームを設定するには、次の手順を実行します。
アダプティブフォームフィールドをテンプレートフィールドにバインドすると、取り込んだフォームデータが、対応するレコードのドキュメントフィールドに表示されます。アダプティブフォームコンポーネントを、対応するレコードのドキュメントテンプレートフィールドにバインドするには、次の手順に従います。
カスタムフォームテンプレートを使用するように設定されたアダプティブフォームを編集用に開きます。
アダプティブフォームコンポーネントを選択し、設定アイコン()をクリックします。プロパティブラウザーが開きます。
プロパティブラウザーで、フィールドを参照して選択します。
「保存」をクリックします。
メール送信、Experience Manager ワークフローの送信アクションを、レコードのドキュメントのステップ、その他の送信アクションと組み合わせて使用し、レコードのドキュメントを受け取ることができます。
アダプティブフォームと対応するレコードのドキュメントテンプレートは、期間を経て漸進的に変化します。アダプティブフォームまたはレコードのドキュメントテンプレートに対して、フィールドの追加、削除、変更を選択できます。
レコードのドキュメントテンプレートに変更を加え、変更したレコードのドキュメントテンプレートを AEM Forms にアップロードすると、アダプティブフォームエディターが変更されたバインディングを自動的に検出し、新しいバインディングが必要なアダプティブフォームコンポーネントが通知されます。これにより、レコードのドキュメントテンプレートを増分更新できます。
例えば、We.Retail という組織に、AcroForm ベースのレコードのドキュメントテンプレート we-retail-invoice.pdf があるとします。テンプレートは次のようになります。
このテンプレートをしばらく使用した後、組織は invoice-number
フィールドの名前を bill-number
フィールドに変更し、購入者のメールアドレスを取り込むことにします。開発者は invoice-number
フィールドの名前を更新し、テンプレートに「Email」フィールドを追加します。また、 we-retail-invoice-v2.pdf という新しいバージョンのテンプレートも作成します。
開発者は、更新されたテンプレートをアダプティブフォームにアップロードし、適用します。アダプティブフォームは、バインディングが変更されたフィールドのリストを自動的に検出して表示します。
フォーム開発者は、アダプティブフォームフィールドを、対応するレコードのドキュメントテンプレートとバインドします。
これで、アダプティブフォームが送信されると、更新されたレコードのレコードのドキュメントが作成されるようになりました。
アダプティブフォーム用のレコードのドキュメントで作業する際は、次の点に注意してください。
次の表に、アダプティブフォームのコンポーネントと対応する XFA のコンポーネントおよびそれらがレコードのドキュメントに表示される場合について説明します。
アダプティブフォームコンポーネント | 対応する XFA コンポーネント | レコードのドキュメントのテンプレートにデフォルトで含まれていますか? | 備考 |
---|---|---|---|
ボタン | ボタン | false | |
チェックボックス | チェックボックス | true | |
日付選択 | 日付/時間フィールド | true | |
ドロップダウンリスト | ドロップダウンリスト | true | |
手書き署名 | 手書き署名 | true | |
数値ボックス | 数値フィールド | true | |
パスワードボックス | パスワードフィールド | false | |
ラジオボタン | ラジオボタン | true | |
テキストボックス | テキストフィールド | true | |
リセットボタン | リセットボタン | false | |
送信ボタン | メール送信ボタン HTTP 送信ボタン |
false | |
利用条件 | true | ||
ファイル添付 | false | レコードのドキュメントのテンプレートでは使用できません。添付ファイルを介した場合のみレコードのドキュメントで使用できます。 |
アダプティブフォームコンポーネント | 対応する XFA コンポーネント | 備考 |
---|---|---|
パネル |
サブフォーム |
反復パネルは繰り返しサブフォームにマッピングされます。 |
アダプティブフォームコンポーネント | 対応する 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
とする必要があります。
基本テンプレートを作成するには、Forms Designer で次の手順を実行します。
ファイル/新規をクリックします。
「テンプレートに基づく」のオプションを選択します。
「Forms - レコードのドキュメント」のカテゴリを選択します。
「DoR 基本テンプレート」を選択します。
「次へ」をクリックし、必要な情報を入力します。
(オプション)レコードのドキュメント内のフィールドに適用する、フィールドのスタイルと外観を変更します。
フォームを保存します。
これで、保存されたフォームをレコードのドキュメント用基本テンプレートとして使用することができます。基本テンプレート中に存在するスクリプトについて、いずれも変更したり、削除したりしないでください。
基本テンプレートの変更
基本テンプレートを設計するときは、上記の規則と手順に厳密に従ってください。
レコードのドキュメントの生成中に、「レコードのドキュメント」タブにあるレコードのドキュメントのブランディング情報を変更できます。「レコードのドキュメント」タブには、ロゴ、外観、レイアウト、ヘッダー、フッター、免責事項などのオプションや、選択されていないチェックボックスやラジオボタンを含めるかどうかのオプションが含まれています。
「レコードのドキュメント」タブに入力されたブランディング情報をローカライズするには、ブラウザーのロケールを正しく設定してください。レコードのドキュメントのブランディング情報をカスタマイズするには、次の手順を実行します。
レコードのドキュメント内でパネル(ルートパネル)を選択して、 をタップします。
をタップします。「レコードのドキュメント」タブが表示されます。
レコードのドキュメントをレンダリングするための、デフォルトのテンプレートまたはカスタムのテンプレートのいずれかを選択します。デフォルトのテンプレートを選択すると、レコードのドキュメントのサムネイルが「テンプレート」ドロップダウンの下に表示されます。
デフォルトのテンプレートとカスタムのテンプレートのどちらを選択するかにより異なりますが、以下のプロパティの一部または全部が「レコードのドキュメント」タブに表示されます。以下のプロパティを指定して、レコードのドキュメントの表示方法を定義します。
基本のプロパティ:
フォームフィールドのプロパティ:
マスターページのプロパティ:
バージョン 6.3 より前の Forms Designer で作成されたアダプティブフォームテンプレートを使用している場合、アクセントカラーおよびフォントファミリーのプロパティを適用するには、ルートサブフォームの下にあるアダプティブフォームテンプレートに以下が存在することを確認してください。
<proto>
<font typeface="Arial"/>
<fill>
<color value="4,166,203"/>
</fill>
<edge>
<color value="4,166,203"/>
</edge>
</proto>
ブランディングの変更内容を保存するには、「完了」をタップします。
レコードのドキュメントテンプレートは、アダプティブフォームエディターまたはアダプティブフォームテンプレートエディターから直接設定することができます。
アダプティブフォームエディターのオーサーインスタンスから、以下の手順を実行します。
アダプティブフォームコンテナ(ルート)コンポーネントを選択します。
「」アイコンをクリックして、アダプティブフォームコンテナのプロパティ開きます。
「レコードのドキュメントのテンプレート」タブを開き、次のオプションから選択します。
なし:このオプションを選択すると、アダプティブフォーム用にレコードのドキュメントのテンプレートは作成されません。
フォームテンプレートをレコードのドキュメントのテンプレートとして関連付ける:このオプションを選択すると、XFA フォームがレコードのドキュメントのテンプレートとして使用されます。
レコードのドキュメントを生成:このオプションを選択すると、レコードのドキュメントのテンプレートがアダプティブフォーム用に自動的に生成されます。
「」をタップして、プロパティを保存します。
アダプティブフォームテンプレートエディターを使用してレコードのドキュメントのテンプレートを作成する場合、「レコードのドキュメントのテンプレート」タブで使用できるオプションは、「なし」と「レコードのドキュメントを生成」の 2 つだけです。
いくつかのフォームフィールドを使用すると、アダプティブフォームが長くなる場合があります。その場合、レコードのドキュメントをアダプティブフォームの正確なコピーとして保存することはお勧めしません。ここでは、1 つ以上のアダプティブフォームパネルをレコードのドキュメント PDF に保存するための表または列のレイアウトを選択できます。
レコードのドキュメントを生成する前に、パネルの設定の「レコードのドキュメントのレイアウト」で、パネル用に表または列を選択します。パネル内のフィールドは、レコードのドキュメントに合わせて配置されます。
レコードのドキュメントの表レイアウト内でレンダリングされたパネルのフィールド
レコードのドキュメントの列レイアウト内でレンダリングされたパネルのフィールド
レコードのドキュメントの設定では、レコードのドキュメントに含めるオプションを選択できます。例えば、銀行では、名前、年齢、社会保障番号、電話番号などをフォームから受け取ります。銀行口座番号や支店の詳細は、フォーム上に生成されます。レコードのドキュメントでは、名前、社会保障番号、銀行口座、および支店の詳細のみが表示されるように選択できます。
レコードのドキュメントコンポーネントの設定は、そのプロパティで使用できます。コンポーネントのプロパティにアクセスするには、コンポーネントを選択し、オーバーレイ内の をクリックします。プロパティはサイドバーにリスト表示され、その中で次の設定を検索できます。
フィールドレベルの設定
レコードのドキュメントから除外:プロパティを「true」に設定すると、そのフィールドがレコードのドキュメントから除外されます。これは excludeFromDoR
という名前のスクリプト可能プロパティです。その動作は、非表示の場合はレコードのドキュメントからフィールドを除外フォームレベルプロパティに依存します。
パネルを表として表示:パネルに含まれるフィールドの数が 6 個未満の場合、このプロパティを設定することでパネルが表としてレコードのドキュメントに表示されます。この設定は、パネルにのみ適用されます。
レコードのドキュメントからタイトルを除外:このプロパティを設定すると、レコードのドキュメントからパネルや表のタイトルが除外されます。パネルおよび表に対してのみ適用できます。
レコードのドキュメントから説明を除外:このプロパティを設定すると、レコードのドキュメントからパネルや表の説明が除外されます。パネルおよび表に対してのみ適用できます。
フォームレベルの設定
XCI ファイルは、ドキュメントの様々なプロパティを設定する場合に役立ちます。Forms as a Cloud Service にはマスター XCI ファイルがあります。カスタム XCI ファイルを使用して、マスター XCI ファイルで指定された 1 つ以上のデフォルトのプロパティを上書きできます。例えば、ドキュメントにフォントを埋め込むか、すべてのドキュメントに対してタグ付きプロパティを有効にするかを選択できます。XCI オプションを次の表に示します。
XCI オプション | 説明 |
---|---|
config/present/pdf/creator | ドキュメント情報ディクショナリの Creator エントリを使用して、ドキュメント作成者を識別します。このディクショナリについては、PDF リファレンスガイドを参照してください。 |
config/present/pdf/producer | ドキュメント情報ディクショナリの Producer エントリを使用して、ドキュメントプロデューサーを識別します。このディクショナリについては、PDF リファレンスガイドを参照してください。 |
config/present/layout | 出力を単一ページとするか連続ページとするかを制御します。 |
config/present/pdf/compression/level | PDF ドキュメントの生成時に使用する圧縮レベルを指定します。 |
config/present/pdf/fontInfo/embed | 出力ドキュメントに埋め込むフォントを制御します。 |
config/present/pdf/scriptModel | 出力 PDF ドキュメントに XFA 固有の情報を含めるかどうかを制御します。 |
config/present/common/data/adjustData | 結合後に XFA アプリケーションでデータを調整するかどうかを制御します。 |
config/present/pdf/renderPolicy | ページコンテンツをサーバー側で生成するか、後でクライアント側で生成するかを制御します。 |
config/present/common/locale | 出力ドキュメントで使用するデフォルトのロケールを指定します。 |
config/present/destination | present 要素に含まれている場合は、出力形式を指定します。openAction 要素に含まれている場合は、インタラクティブクライアントでドキュメントを開いたときに実行されるアクションを指定します。 |
config/present/output/type | ファイルに適用する圧縮の種類または生成する出力の種類を指定します。 |
config/present/common/temp/uri | フォームの URI を指定します。 |
config/present/common/template/base | フォームデザインの URI のベースを指定します。この要素がない場合や空の場合は、フォームデザインの場所がベースとして使用されます。 |
config/present/common/log/to | ログデータまたは出力データの書き込み先を制御します。 |
config/present/output/to | ログデータまたは出力データの書き込み先を制御します。 |
config/present/script/currentPage | ドキュメントを開いたときの初期ページを指定します。 |
config/present/script/exclude | 無視するイベントを Forms as a Cloud Service に通知します。 |
config/present/pdf/linearized | 出力 PDF ドキュメントを線形化するかどうかを制御します。 |
config/present/script/runScripts | Forms as a Cloud Service が実行するスクリプトのセットを制御します。 |
config/present/pdf/tagged | 出力 PDF ドキュメントへのタグの組み込みを制御します。タグは、PDF のコンテキストでは、ドキュメントの論理構造を公開するためにドキュメントに組み込まれる追加情報です。タグは、アクセシビリティの支援や書式の再設定に役立ちます。例えば、スクリーンリーダーがテキストの途中でページ番号を読み上げてしまわないように、ページ番号を装飾としてタグ付けすることができます。タグを使用すると、ドキュメントの有用性が高まる反面、ドキュメントのサイズが大きくなり、作成にかかる処理時間も長くなります。 |
config/present/pdf/fontInfo/alwaysEmbed | 出力ドキュメントに埋め込むフォントを指定します。 |
config/present/pdf/fontInfo/neverEmbed | 出力ドキュメントに埋め込まないフォントを指定します。 |
config/present/pdf/pdfa/part | ドキュメントが準拠する PDF/A 仕様のバージョン番号を指定します。 |
config/present/pdf/pdfa/amd | PDF/A 仕様の修正レベルを指定します。 |
config/present/pdf/pdfa/conformance | PDF/A 仕様の適合レベルを指定します。 |
config/present/pdf/version | 生成する PDF ドキュメントのバージョンを指定します |
config/present/pdf/version/map | ドキュメントのフォールバックフォントを指定します |
開発プロジェクトにカスタム XCI ファイルを追加します。
次の inline プロパティを指定します。
{
"xciFilePath": "[path of XCI file]"
}
例:
{
"xciFilePath": "/content/dam/formsanddocuments/customMinionProBoldAndTagged.xci"
}
Cloud Service 環境にコードをデプロイします。