形式設定した出力テンプレートを使用すると、完全なオブジェクトレコードデータをカスタマイズしたテンプレートファイルに素早く転送することができます。形式設定した出力テンプレートを新規作成すると、ユーザがテンプレートファイルを生成・ダウンロードできるオブジェクトレコードにユーザアクションを設定することができます。形式設定した出力テンプレートには、フィールド、関連レコードフィールド、関連ドキュメントフィールドを含むオブジェクトレコードのデータがすべて含まれます。形式設定した出力テンプレートは特定のオブジェクトに関連づけられます。

形式設定した出力テンプレートについて

形式設定した出力テンプレートは、事前設定された XML フォームアーキテクチャ (XFA) PDF ファイルを使用して、特定のフォント、スタイル、レイアウト、画像、およびテンプレートをドキュメントにレンダリングする際に取得する Vault フィールドを管理します。これらは、通常 Adobe LiveCycle Designer または Adobe AEM Forms Designer で作成されるフォーム対応の PDF ファイルです。このファイルは Vault 外で作成し、テンプレートとしてアップロードする必要があります。

XFA PDF ファイルの作成時に形式設定した出力テンプレートを使用する:

  • Vault のフィールドタイプに関係なく、「テキストフィールド」タイプを使って Vault フィールドを追加する必要があります。例えば、オブジェクト名を含めるには、VLT__name__v とラベルされたテキストフィールドを挿入します。Vault は、Vault のオブジェクトレコードのフィールド名と一致しないテキストフィールド名を含むテンプレートは受け付けません。
  • フィールドフォーマットとして「リッチテキスト」を選択して、Vault のリッチテキストフォーマットオプションを組み込むことができます。
  • 会社ロゴなどの画像を含めるには、画像オブジェクトとして追加します。Vault では、画像フィールドオブジェクトはサポートされていません。画像を PDF に埋め込むには、画像オブジェクトをフラグ付けする必要があります。
  • Vault は、形式設定した出力テンプレートに最大 150 のマッピング済みフィールドをサポートすることができます。
  • Vault は、関連するレコードを表すテンプレートの Table および TableRow 要素の VQL WHERE 句などのサブクエリをサポートします。Vault は、クエリ回答に従って関連するレコード情報を関連するページの特定のセクションにグループ化し、出力をレポートします。
  • VQL ORDER BY 句を使用して関連レコードの順序を指定することができます。

理想の仕上がりと機能を備えたテンプレートを作成するためのいくつかのヒントをご紹介します。

  • フォームフィールドを表に配置して、異なる長さのフィールド値で要素の順番およびスペースを保持する。
  • カスタム Adobe オブジェクトスタイルを使って、フォント、フォントサイズ、ウェイトを統一する。
  • 変更できる要素を定義します (サイズ変更、ページの分割、ハイフン)。
  • すべてのページ、マスターページ、テーブル、およびテーブル行に名前を付けます。要素に一意の名前を付けます。データを返さない場合は、任意の命名規則を使用できます。一意の要素名は、アップロード時のランタイムエラーおよび検証エラーを防ぎます。

制限

subformSet 要素に含まれる CJK 文字は、フォーマット済みの出力テンプレートで正しく表示されない場合があります。

フォーマットされた出力と VQL

フォーマットされた出力は、VQL を使用してテンプレートから出力を生成します。限定リリース Vault は VQL の現在のベータバージョンを使用し、一般リリース Vault は VQL の現在の GA バージョンを使用します。これは、VQL への変更がフォーマットされた出力に影響を与える可能性があることを意味します。

例えば、フォーマット済みの出力テンプレートにドキュメント番号フィールド dosage__c が含まれているとします。Vault は VQL ステートメントを実行して、フォーマットされた出力を作成するときにこのフィールドの値を取得します。ユーザが dosage__c に値 10 を入力します。

VQL バージョン v21.1 を使用する Vault バージョン 21R1 では、ドキュメント番号フィールドはユーザが入力したとおりに表示されます。フォーマットされた出力には、dosage__c に対して 10 が表示されます。

VQL バージョン v21.2 を使用する Vault バージョン 21R2 では、ドキュメント番号フィールドは、フィールドで設定された小数点以下の桁数で表示されます。dose__c小数点以下 2 桁で設定されている場合、ユーザが 10 を入力しても、フォーマット済みの出力には 10.00 が表示されます。

開発者ポータルで VQL の詳細をご確認ください開発者リリースノートで VQL の変更について学ぶこともできます。

テンプレート管理へのアクセス

管理オプションは、管理者 > 企業管理者 > 形式設定した出力にあります。すべての管理者は、このページから形式設定した出力テンプレートを管理することができます。

形式設定した出力テンプレートを作成する方法

形式設定した出力テンプレートを作成するには:

  1. 形式設定した出力のページで、形式設定した出力の作成をクリックします。
  2. ラベルを入力します。
  3. 任意の作業: 名前を変更します。この値は、エンドユーザには表示されません。API 経由で使用されます。
  4. ルートオブジェクトの選択リストからオブジェクトを選択します。
  5. オブジェクトにオブジェクトタイプがある場合、ルートオブジェクトタイプの選択リストからオブジェクトタイプを選択します。
  6. 選択をクリックして XFA PDF をアップロードします。添付されたファイル名は選択ボタンの隣に表示されます。Vault は、この時点で自動化されたバリデーションプロセスを実行します。
  7. 選択リストから出力形式を選択します。
  8. 保存をクリックします。

フォーマットされた出力テンプレート

バリデーション

テンプレートファイルをアップロードしたら、Vault は自動バリデーションを実行します。このプロセスでは、XFA ファイルが一連のアップロード要件を満たしているか (例: アップロードされたファイルタイプがサポートされているか) が確認されます。バリデーションが完了すると、ファイルは正常にアップロードされて保存されます。バリデーションに失敗すると、Vault は失敗の理由を記載したエラーメッセージを送信します。

形式設定した出力テンプレートを編集する方法

形式設定した出力テンプレートを編集するには:

  1. 形式設定した出力ページで、リストからテンプレートをクリックします。
  2. 編集をクリックします。
  3. 必要に応じて変更を行います。テンプレートのラベル、名前、出力形式を更新することができます。ルートオブジェクトまたはルートオブジェクトタイプは変更できません。
  4. 保存をクリックします。

形式設定した出力テンプレートを削除する方法

形式設定した出力テンプレートを削除するには、削除したいテンプレートにマウスオーバーして赤い (x) ボタンをクリックします。形式設定した出力テンプレートの削除ウィンドウで続行をクリックします。テンプレートをクリックして削除ボタンをクリックすることもできます。

フォーマット済み出力テンプレートをダウンロードするユーザアクションの設定

オブジェクトのライフサイクル状態でフォーマットされた出力のダウンロードユーザアクションを設定して、ユーザがフォーマット済みの出力テンプレートをダウンロードできるようにすることができます。このユーザアクションを使用して、以下を設定できます:

  • ダウンロードする設定済みの形式設定した出力テンプレートのリストから選択します。
  • レコード添付文書をファイルとパッケージして含める: これは、完了したら生成されたパッケージをレコードに添付します。編集権限が必要です。
  • ルートオブジェクト/オブジェクトタイプレコードにファイルを添付: このオプションは、テンプレートが関連づけられたオブジェクトが添付ファイルをサポートする場合にのみ使用できます。編集権限が必要です。

レコードにファイルを添付しない場合、出力の生成に編集アクセス権限は不要です。これにより、Vault が終了またはロック状態のオブジェクトレコードに出力を生成できるようになります。

フィールド参照構文

ルートオブジェクトフィールド、関連オブジェクトレコードフィールド、関連ドキュメントフィールドの値を参照するには、XFA PDF ファイルを設定します。これらのそれぞれに対して、VQL 標準パターンに従う、使用しなければならない特定の構文があります。すべてのテキストフィールドは VLT__ 接頭辞で始める必要があります。

名前効果
ルートオブジェクトの特定のオブジェクトフィールド参照します。監査オブジェクト (レポートを実行したレコードのオブジェクト) の参照名と番号。name__v
number__v
循環要素の 1 つ以上の参照により、ルートオブジェクトに関連するオブジェクトの特定のフィールドを参照します以下に基づいて監査に関連づけられた各調査の名前を取得します:

監査オブジェクトに内部調査 (internal_investigations__vr) および外部調査 (external_investigations__vr) のオブジェクトとの受信関係がある。

VLT__internal_investigation__vr.name__v
VLT__external_investigaton__vr.name__v
循環要素の 1 つ以上の参照により、ルートオブジェクトに関連するドキュメントのフィールドを参照以下に基づいて製品に関連づけられた各ドキュメントのドキュメント数を取得します:

製品が関連づけられた製品一式 (製品一式の受信関係による関連 primary_suite__vr) および「主製品 (primary_product__c)」ドキュメントフィールドに関連づけられた関連ドキュメント要素。

VLT__product_suite__vr.

primary_suite__vr.

document_primary_product__cr.

document_number__v

出力を作成したユーザを参照フォーマットされた出力を生成したユーザの名前とユーザ名を表示します。VLTR__user__sys.first_name__sys
VLTR__user__sys.last_name__sys
VLTR__user__sys.name__v
VLTR__user__sys.username__sys
ユーザが出力を生成した時間を参照フォーマットされた出力をユーザが生成した日付と時間を表示します。VLTR__fo_generated_datetime
レコードの添付ファイルのリストを参照ルートレコードの添付ファイルのリストを表示します。各添付ファイルは、割り当てられたテキストフィールド内の別々の行に表示されます。このトークンを使用して、ルートレコード以外のレコードに添付ファイルを表示することはできません。VLTF__attachmentsList__v