출력 서비스

개요

출력 서비스는 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 작업을 사용하여 각 레코드에 대한 인쇄 문서를 생성합니다.

또한 레코드를 하나의 문서로 결합할 수도 있습니다. 두 작업 모두 4개의 매개 변수를 사용합니다.

첫 번째 매개 변수는 임의의 문자열을 키로 포함하고 템플릿 파일의 이름을 값으로 포함하는 맵입니다.

두 번째 매개 변수는 값이 XML 데이터가 포함된 Document 객체인 다른 Map입니다. 키는 첫 번째 매개 변수에 대해 지정한 키와 동일합니다.

generatePDFOutputBatch 또는 generatePrintedOutputBatch에 대한 세 번째 매개 변수는 각각 PDFOutputOptions 또는 PrintedOutputOptions 유형입니다.

매개 변수 유형은 generatePDFOutput 및 generatePrintedOutput 작업에 대한 매개 변수의 유형과 동일하며 동일한 효과를 갖습니다.

네 번째 매개 변수는 각 레코드에 대해 별도의 파일을 생성할 수 있는지 여부를 지정하는 데 사용하는 BatchOptions 유형입니다. 이 매개 변수의 기본값은 false입니다.

generatePrintedOutputBatch 및 generatePDFOutputBatch 모두 BatchResult 유형의 값을 반환합니다. 이 값에는 생성된 문서 목록이 포함되어 있습니다. 또한 생성된 각 문서와 관련된 정보를 포함하는 XML 형식의 메타데이터 문서가 포함되어 있습니다.