Output サービス

概要

出力サービスは、AEM ドキュメントサービスの一部である OSGi サービスの一種です。Outputサービスは、AEM Formsデザイナーの様々な出力形式と出力設計機能をサポートしています。 出力サービスでは、XFA テンプレートと XML データを変換することにより、様々な形式の印刷ドキュメントを生成することができます。

出力サービスにより、以下のような機能を備えたアプリケーションを作成することができます。

  • テンプレートファイルに XML データを格納することで、最終形式のドキュメントを生成する
  • 非インタラクティブ PDF、ポストスクリプト、PCL、および ZPL のプリントストリームを含む様々な形式でフォームを出力する
  • XFA フォームの PDF ファイルから印刷用 PDF を生成する
  • 複数のデータセットと付属のテンプレートをマージして、PDF、PostScript、PCLおよびZPLドキュメントを一括生成します。
メモ

Output サービスは、32 ビットアプリケーションです。Microsoft Windows では、32 ビットアプリケーションが使用できるメモリは最大 2 GB です。この制限は Output サービスにも適用されます。

非インタラクティブ形式のドキュメントを作成する

usingoutput_modified

通常、テンプレートは AEM Forms Designer を使用して作成します。これらのテンプレートは、出力サービスの generatePDFOutputgeneratePrintedOutput の各 API により、PDF、ポストスクリプト、ZPL や PCL などの様々な形式に直接変換することができます。

The generatePDFOutput operation generates PDFs, while the generatePrintedOutput operation generates PostScript, ZPL, and PCL formats. 各演算の最初のパラメータは、テンプレートファイルの名前(例えば、ExpenseClaim.xdp)、またはテンプレートが含まれているドキュメントオブジェクトのいずれかを受け取ります。テンプレートファイルの名前を指定した場合は、テンプレートを含むフォルダへのパスとしてのコンテンツルートも指定します。You can specify content root using either the PDFOutputOptions or the PrintedOutputOptions parameter. これらのパラメータを使用して指定できる他のオプションの詳細については、Javadoc を参照してください。

2番目のパラメータは、出力ドキュメントを生成しながら、テンプレートに結合された XML 文書を受け取ります。

generatePDFOutput 演算では、XFA ベースの PDF フォームを入力として受け取り、出力として非インタラクティブの PDF フォームを返すこともできます。

非インタラクティブ形式のドキュメントを作成する

たとえば、1 つ以上のテンプレートが存在しており、各テンプレートには XML データの複数のレコードがあるシナリオを考えてみましょう。

各レコードの印刷文書を生成するために、出力サービスの generatePDFOutputBatchgeneratePrintedOutputBatch の演算を使用します。

また、単一のドキュメントにレコードを組み合わせることもできます。いずれの演算でも、4 つのパラメータが必要です。

最初のパラメータはマップであり、この中には、任意の文字列が鍵として、およびテンプレートファイルの名前が値として収められています。

2番目のパラメータは別のマップです。この値は、XML データを含むドキュメントオブジェクトです。この鍵は、最初のパラメータに指定したものと同じものです。

The third parameter for generatePDFOutputBatch or generatePrintedOutputBatch is of type PDFOutputOptions or PrintedOutputOptions respectively.

The parameter types are the same as types of the parameters for the generatePDFOutput and generatePrintedOutput operations and have the same effect.

The fourth parameter is of type BatchOptions, which you use to specify whether a separate file can be generated for each record. このパラメータのデフォルト値は false です。

Both generatePrintedOutputBatch and generatePDFOutputBatch return a value of type BatchResult. 値には、生成されたドキュメントのリストが含まれています。また、XML形式のメタデータドキュメントも含まれており、この中には、生成された各ドキュメントに関連する情報が収められています。

このページ