輸出服務

概覽

輸出服務是AEM檔案服務的一部分的OSGi服務。 輸出服務支援AEM Forms Designer的各種輸出格式和輸出設計功能。 輸出服務可轉換XFA範本和XML資料，以產生各種格式的列印檔案。

輸出服務可讓您建立應用程式，讓您：

• 使用XML資料填入範本檔案，以產生最終表單檔案。
• 以多種格式產生輸出表單，包括非互動式PDF、PostScript、PCL和ZPL列印串流。
• 從XFA表單PDF產生列印PDF。
• 將多組資料與隨附的範本合併，以大量產生PDF、PostScript、PCL和ZPL檔案。

建立非互動式表單文檔

通常，您會使用AEM Forms Designer建立範本。 輸出服務的generatePDFOutput和generatePrintedOutput API可讓您將這些範本直接轉換為各種格式，包括PDF、PostScript、ZPL和PCL。

generatePDFOutput操作生成PDF，而generatePrintedOutput操作生成PostScript、ZPL和PCL格式。 這兩個操作的第一個參數接受模板檔案的名稱（例如ExpenseClaim.xdp）或包含模板的Document對象。 當您指定範本檔案的名稱時，也請指定內容根目錄作為包含範本之資料夾的路徑。 您可以使用PDFOutputOptions或PrintedOutputOptions參數來指定內容根目錄。 有關可以使用這些參數指定的其他選項的詳細資訊，請參見Javadoc。

第二個參數接受與模板合併的XML文檔，同時生成輸出文檔。

generatePDFOutput操作也可以接受以XFA為基礎的PDF表單作為輸入，並傳回非互動版的PDF表單作為輸出。

生成非互動式表單文檔

請考慮一種情況：您擁有一或多個範本，以及每個範本的多個XML資料記錄。

使用輸出服務的generatePDFOutputBatch和generatePrintedOutputBatch操作為每個記錄生成打印文檔。

您也可以將記錄合併為單一檔案。 這兩個操作都採用四個參數。

第一個參數是Map，其中包含任意字串作為鍵，模板檔案的名稱作為值。

第二個參數是不同的Map，其值是包含XML資料的Document物件。 鍵與您為第一個參數指定的鍵相同。

generatePDFOutputBatch或generatePrintedOutputBatch的第三個參數分別為PDFOutputOptions或PrintedOutputOptions類型。

參數類型與generatePDFOutput和generatePrintedOutput操作的參數類型相同，且具有相同的效果。

第四個參數的類型為BatchOptions，可用來指定是否可為每個記錄生成單獨的檔案。 此參數的預設值為false。

generatePrintedOutputBatch和generatePDFOutputBatch都返回類型BatchResult的值。 值包含生成的文檔清單。 它還包含XML格式的元資料文檔，其中包含與生成的每個文檔相關的資訊。