Show Menu
トピック×

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

概要

フォームに記入して送信した顧客は、印刷するかまたはドキュメント形式で保存するかして、同じ情報を今後の参考用に保存しておきたいと考えるのが一般的です。これを、レコードのドキュメントといいます。
この記事では、アダプティブフォーム向けのレコードのドキュメントを生成する方法について説明します。
レコードのドキュメントの自動生成は、XFAベースのアダプティブフォームではサポートされていません。 ただし、アダプティブフォーム作成用の XDP をレコードのドキュメントとして使用することができます。

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

アダプティブフォームの作成時に、フォームのモデルを指定できます。次のオプションがあります。
  • フォームテンプレート アダプティブフォームの XFA テンプレートを選択できます。XFAテンプレートを選択する場合は、前述のように、レコードのドキュメントに関連するXDPファイルを使用できます。
  • XML スキーマ アダプティブフォームの XML スキーマ定義を選択できます。XML スキーマ アダプティブフォームの XML スキーマ定義を選択すると、次のことができます。
    • レコードのドキュメントに XFA テンプレートを関連付ける。関連する XFA テンプレートで、アダプティブフォームと同じ XML スキーマを使用させる。
    • レコードのドキュメントを自動生成
  • なし フォームのモデルを指定せずに、アダプティブフォームを作成できます。レコードのドキュメントはアダプティブフォームに対して自動的に生成されます。
フォームモデルを選択する場合は、「レコードのドキュメントテンプレートの設定」の下にあるオプションを使用して、レコードのドキュメントを設定します。 See Document of Record Template Configuration .

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

レコードのドキュメントを使用すると、顧客は送信したフォームを印刷目的で保存することができます。レコードのドキュメントを自動生成すると、フォームを変更するたびに、そのレコードのドキュメントがすぐに更新されます。 たとえば、居住国に米国を選択した顧客について、年齢のフィールドを削除したとします。このような顧客がレコードのドキュメントを生成する場合、レコードのドキュメントでは年齢フィールドが表示されません。
レコードの自動生成ドキュメントには、次の利点があります。
  • データバインディングが処理されます。
  • 送信時にレコードのドキュメントから除外するとマークされたフィールドを自動的に非表示にします。 余分な労力が不要になります。
  • レコードのドキュメントテンプレートのデザインに要する時間を節約します。
  • 異なるベーステンプレートを使用しながら様々なスタイリングと外観を試すことで、レコードのドキュメントにとって最良のスタイルと外観を選択できます。スタイリングの表示はオプションです。スタイルを指定しない場合は、システムスタイルがデフォルトとして設定されます。
  • フォーム内のすべての変更が、確実かつ即座にレコードのドキュメントに反映されます。

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

アダプティブフォームのレコードのドキュメントを生成するには、次のコンポーネントが必要です。
レコードのドキュメントを生成するアダプティブフォーム 。アダプティブフォームアダプティブフォームを使用します。
AEM Designerで作成された基本テンプレート (推奨) XFAテンプレート(XDPファイル)。 基本テンプレートは、レコードのドキュメントテンプレートのスタイル設定とブランド情報を指定するために使用します。
レコードのドキュメントの基本テンプレートは、レコードのドキュメントのメタテンプレートとも呼ばれます。
アダプティブフォームから生成されたレコード XFAテンプレート(XDPファイル)のドキュメント。
フォームデータ :アダプティブフォームでユーザーが入力した情報。 レコードのドキュメントを生成するために、レコードのドキュメントテンプレートとマージします。

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

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

フィールド

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

コンテナ

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

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

アダプティブフォームコンポーネント
対応する XFA スキンコンポーネント
メモ
画像
画像
TextDrawおよびImageコンポーネントは、連結されているか連結されていないかにかかわらず、XSDベースのアダプティブフォームのレコードのドキュメントに常に表示されます。ただし、レコードのドキュメントを使用して除外される場合は除きます。
テキスト
テキスト
従来の UI では、フィールドプロパティを編集する際に別々のタブを開きます。

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

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

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

基本テンプレートの規則

基本テンプレートは、レコードのドキュメントのヘッダー、フッター、スタイル、および外観を定義するために使用されます。ヘッダーとフッターには、会社のロゴや著作権テキストなどの情報を含めることができます。基本テンプレートの最初のマスターページがコピーされ、レコードのドキュメントのマスターページとして使用されます。このページには、レコードのドキュメント内のすべてのページに表示するヘッダー、フッター、ページ番号などの情報が含まれます。 基本テンプレートの規則に準拠しない基本テンプレートを使用している場合、基本テンプレートの最初のマスターページは、レコードのドキュメントテンプレートで引き続き使用されます。 基本テンプレートを規則通りに設計し、レコードのドキュメント自動生成のためにそれを使用することを強くお勧めします。
マスターページの規則
  • In the base template, you should name the root subform as AF_METATEMPLATE and the master page as AF_MASTERPAGE .
  • The master page with the name AF_MASTERPAGE located under the AF_METATEMPLATE root subform is given preference for extracting header, footer, and styling information.
  • AF_MASTERPAGE が存在しない場合は、基本テンプレート中に存在する最初のマスターページが使用されます。
フィールドのスタイリング規則
  • レコードのドキュメント内のフィールドにスタイルを適用するため、基本テンプレートは AF_FIELDSSUBFORM ルートサブフォーム内の AF_METATEMPLATE サブフォームにフィールドを作成します。
  • これらのフィールドのプロパティは、レコードのドキュメント内のフィールドに適用されます。これらのフィールドは、命名規則に従う AF_<name of field in all caps>_XFO 必要があります。 For example, the field name for check box should be AF_CHECKBOX_XFO .
基本テンプレートを作成するには、AEM Designer で次の手順を実行します。
  1. File/New をクリックします。
  2. 「テンプレートに基づく」 ​のオプションを選択します。
  3. 「フォーム:レコードのドキュメント」 ​のカテゴリを選択します。
  4. 「DoR 基本テンプレート」 ​を選択します。
  5. 「次へ」 ​をクリックし、必要な情報を入力します。
  6. (オプション)レコードのドキュメント内のフィールドに適用する、フィールドのスタイルと外観を変更します。
  7. フォームを保存します。
これで、保存されたフォームをレコードのドキュメント用基本テンプレートとして使用することができます。 基本テンプレート中に存在するスクリプトについて、いずれも変更したり、削除したりしないでください。
基本テンプレートの変更
  • 基本テンプレート内のフィールドに対していずれかのスタイルを適用していない場合は、基本テンプレートからそれらのフィールドを削除することをお勧めします。これにより、基本テンプレートのアップグレードjを自動的に適用することができます。
  • 基本テンプレートを変更する際、スクリプトを削除、追加、または変更しないでください。
基本テンプレート規則を使用し、上記の手順を正確に実行してください。

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

顧客が送信したフォームの印刷用フレンドリコピーをダウンロードできるように、フォームのレコードのドキュメントテンプレートを設定します。 XDPファイルは、レコードテンプレートのドキュメントとして機能します。 顧客がダウンロードしたレコードのドキュメントは、XDPファイルで指定されたレイアウトに従って形式設定されます。
次の手順を実行して、アダプティブフォームのレコードのドキュメントを設定します。
  1. In AEM author instance, click Forms > Forms and Documents.
  2. フォームを選択し、 「プロパティの表示」 ​をクリックします。
  3. In the Properties window, tap Form Model . また、フォームの作成時にフォームモデルを選択することもできます。
    「フォームモデル」のタブで、必ず​ 「フォームの選択」 ​ドロップダウンから​ 「 スキーマ」 ​または​ 「なし」 ​を選択します。 レコードのドキュメントは、XFAベースのフォームや、フォームテンプレートをフォームモデルとして持つアダプティブフォームではサポートされていません。
  4. 「フォームモデル」タブの「レコードのドキュメントのテンプレート設定」セクションで、次のいずれかのオプションを選択します。
    ** #フォームのレコードのドキュメントを設定しない場合は、このオプションを選択します。
    フォームテンプレートをレコードのドキュメントとして関連付ける :レコードのドキュメントのテンプレートとして使用するXDPファイルがある場合は、このオプションを選択します。 このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
    選択された XDP ファイルは、アダプティブフォームに関連付けられます。
    レコードのドキュメントを生成 :レコードのドキュメントのスタイルと外観を定義する基本テンプレートとしてXDPファイルを使用する場合は、このオプションを選択します。 このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
    レコードのドキュメントのスタイルと外観が定義された基本テンプレートとして XDP ファイルを使用するには、このオプションを選択します。このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
    レコードのドキュメントを生成する基本テンプレートとしてフォームテンプレートを選択 XDPファイルをレコードのドキュメントのスタイルと外観を定義する基本テンプレートとして使用する場合は、このオプションを選択します。 このオプションを選択すると、AEM Forms リポジトリで利用可能なすべての XDP ファイルが表示されます。必要なファイルを選択します。
    アダプティブフォーム作成するために使用されるスキーマと、XFA フォームのスキーマ(データスキーマ)が同じであることを確認します。
    • アダプティブフォームがスキーマベースの場合
    • You are using Associate Form Template as the Document of Record Template option for document of record
  5. Click Done.

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

レコードのドキュメントの生成中に、「レコードのドキュメント」タブにあるレコードのドキュメントのブランディング情報を変更できます。「レコードのドキュメント」タブには、ロゴ、外観、レイアウト、ヘッダー、フッター、免責事項などのオプションや、選択されていないチェックボックスやラジオボタンを含めるかどうかのオプションが含まれています。
「レコードのドキュメント」タブに入力するブランディング情報をローカライズするには、ブラウザーのロケールを正しく設定する必要があります。レコードのドキュメントのブランディング情報をカスタマイズするには、次の手順を実行します。
  1. Select a panel (root panel) in the document of record and then tap .
  2. ドータ 。 「レコードのドキュメント」タブが表示されます。
  3. レコードのドキュメントをレンダリングする、デフォルトのテンプレートまたはカスタムのテンプレートのいずれかを選択します。デフォルトのテンプレートを選択すると、レコードのドキュメントのサムネイルが「テンプレート」ドロップダウンの下に表示されます。
    カスタムのテンプレートを選択する場合は、AEM Forms サーバーで XDP を参照して選択します。使用する AEM Forms サーバーにないテンプレートを使用する場合は、最初に XDP を AEM Forms サーバーにアップロードする必要があります。
  4. デフォルトのテンプレートとカスタムのテンプレートのどちらを選択するかにより異なりますが、以下のプロパティの一部または全部が「レコードのドキュメント」タブに表示されます。これらを正しく設定します。
    • Logo Image :アダプティブフォームのロゴ画像の使用、DAMからのロゴ画像の選択、またはコンピューターからのロゴ画像のアップロードを選択できます。
    • フォームタイトル
    • ヘッダーテキスト
    • 免責事項ラベル
    • 免責事項
    • 免責事項テキスト
    • アクセントの色 :ヘッダーテキストおよび区切り線の色は、レコードのドキュメント PDF でレンダリングされます
    • Font Family :レコード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 に保存できます。
レコードのドキュメントを生成する前に、パネルの設定の「レコードのドキュメントのレイアウト」で、パネル用にテーブルまたは列を選択します。パネル内のフィールドは、レコードのドキュメントに合わせて配置されます。
レコードのドキュメントのテーブルレイアウト内でレンダリングされたパネルのフィールド
レコードのドキュメントの列レイアウト内でレンダリングされたパネルのフィールド

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

レコードのドキュメントの設定では、レコードのドキュメントに含めるオプションを選択できます。 例えば、銀行では、名前、年齢、マイナンバー番号、電話番号などをフォームから受け取ります。銀行口座番号や支店の詳細は、フォーム上に生成されます。レコードのドキュメントでは、名前、マイナンバー番号、銀行口座、および支店の詳細のみが表示されるように選択できます。
コンポーネントのレコード設定のドキュメントは、そのプロパティの下で使用できます。 To access the properties a component, select the component and click in the overlay. プロパティがサイドバーに表示され、次の設定を確認できます。
フィールドレベルの設定
  • レコードのドキュメントから除外 :プロパティを「true」に設定すると、そのフィールドがレコードのドキュメントから除外されます。これは excludeFromDoR という名前のスクリプト可能プロパティです。その動作は、 非表示の場合はレコードのドキュメントからフィールドを除外 ​フォームレベルプロパティに依存します。
  • ​パネルを表として表示:パネルに含まれるフィールドが6個未満の場合、このプロパティを設定すると、パネルがレコードのドキュメント内のテーブルとして表示されます。 この設定は、パネルにのみ適用されます。
  • レコードのドキュメントからタイトルを除外: ​このプロパティを設定すると、レコードのドキュメントからパネルやテーブルのタイトルが除外されます。パネルおよびテーブルに対してのみ適用できます。
  • レコードのドキュメントから説明を除外: ​このプロパティを設定すると、レコードのドキュメントからパネルやテーブルの説明が除外されます。パネルおよびテーブルに対してのみ適用できます。
フォームレベルの設定
  • バインドされていないフィールドをレコードのドキュメントに含める: ​このプロパティを設定すると、スキーマベースのアダプティブフォームのバインドされていないフィールドがレコードのドキュメントに追加されます。デフォルトでは true になっています。
  • 非表示の場合はレコードのドキュメントからフィールドを除外 :このプロパティを設定すると、「レコードのドキュメントから除外」フィールドレベルプロパティが true でないときにその動作が上書きされます。フォームの送信時にフィールドが非表示の場合、「レコードのドキュメントから除外」プロパティが設定されていない限り、プロパティがtrueに設定されていると、レコードのドキュメントから除外されます。

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

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