輸出服務 output-service
概觀 overview
Output服務是AEM Document Services中的OSGi服務。 輸出服務支援各種AEM Forms Designer的輸出格式和輸出設計功能。 輸出服務可以轉換XFA範本和XML資料,以產生多種格式的列印檔案。
Output 服務可讓您建立以下用途的應用程式:
- 使用 XML 資料填寫範本檔案來產生最終表單文件。
- 產生各種格式的輸出表單,包括非互動式PDF、PostScript、PCL和ZPL列印資料流。
- 從 XFA 表單 PDF 產生列印 PDF。
- 將多組資料與提供的範本合併,以大量產生PDF、PostScript、PCL和ZPL檔案。
建立非互動式表單檔案 creating-non-interactive-form-documents
通常使用AEM Forms Designer建立範本。 此 generatePDFOutput
和 generatePrintedOutput
Output服務的API可讓您直接將這些範本轉換為各種格式,包括PDF、PostScript、ZPL和PCL。
此 generatePDFOutput
作業會產生PDF,而 generatePrintedOutput
作業會產生PostScript、ZPL和PCL格式。 這兩個操作的第一個引數都接受範本檔案的名稱(例如, ExpenseClaim.xdp
)或包含範本的Document物件。 當您指定範本檔案的名稱時,請將內容根目錄指定為包含範本的資料夾的路徑。 您可以使用以下任一專案指定內容根: PDFOutputOptions
或 PrintedOutputOptions
引數。 請參閱Javadoc以取得您可以使用這些引數指定之其他選項的詳細資訊。
第二個引數會接受在產生輸出檔案時與範本合併的XML檔案。
此 generatePDFOutput
作業也可以接受XFA型PDF表單作為輸入,並傳回非互動式PDF表單版本作為輸出。
產生非互動式表單檔案 generating-non-interactive-form-documents
假設您有一或多個範本,且每個範本有多個XML資料記錄。
使用 generatePDFOutputBatch
和 generatePrintedOutputBatch
Output服務的作業,用以產生每筆記錄的列印檔案。
您也可以將記錄合併成單一檔案。 這兩個作業都需使用四個引數。
第一個引數是Map,其中包含作為索引鍵的任意字串,以及作為值的範本檔案名稱。
第二個引數是不同的Map,其值是包含XML資料的Document物件。 此鍵與您為第一個引數指定的鍵相同。
的第三個引數 generatePDFOutputBatch
或 generatePrintedOutputBatch
屬於型別 PDFOutputOptions
或 PrintedOutputOptions
(分別)。
引數型別與的引數型別相同 generatePDFOutput
和 generatePrintedOutput
和的作業具有相同的效果。
第四個引數的型別為 BatchOptions
,用來指定是否可以為每個記錄產生個別的檔案。 此引數的預設值為false。
兩者 generatePrintedOutputBatch
和 generatePDFOutputBatch
傳回型別值 BatchResult
. 值包含產生的檔案清單。 它也會包含XML格式的中繼資料檔案,其中包含與產生的每個檔案相關的資訊。