출력 서비스 output-service

개요 overview

출력 서비스는 AEM 문서 서비스의 일부인 OSGi 서비스입니다. 출력 서비스는 AEM Forms 디자이너의 다양한 출력 형식 및 출력 디자인 기능을 지원합니다. 출력 서비스는 XFA 템플릿 및 XML 데이터를 변환하여 다양한 형식으로 인쇄 문서를 생성할 수 있습니다.

Output 서비스를 사용하면 다음과 같은 기능을 제공하는 애플리케이션을 만들 수 있습니다.

비대화형 양식 문서 만들기 creating-non-interactive-form-documents

일반적으로 AEM Forms 디자이너를 사용하여 템플릿을 만듭니다. 다음 generatePDFOutput 및 generatePrintedOutput 출력 서비스의 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 각 레코드에 대한 인쇄 문서를 생성하는 출력 서비스의 작업입니다.

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

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

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

에 대한 세 번째 매개 변수 generatePDFOutputBatch 또는 generatePrintedOutputBatch 유형 PDFOutputOptions 또는 PrintedOutputOptions 각각 사용할 수 있습니다.

매개 변수 유형은 generatePDFOutput 및 generatePrintedOutput 작업과 동일한 효과가 있습니다.

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

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