출력 서비스

주의

AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

개요

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

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

  • XML 데이터로 템플릿 파일을 채워 최종 양식 문서를 생성합니다.
  • 비대화형 PDF, PostScript, PCL 및 ZPL 인쇄 스트림을 포함하여 다양한 형식으로 출력 양식을 생성합니다.
  • XFA 양식 PDF에서 인쇄 PDF를 생성합니다.
  • 여러 데이터 세트를 제공된 템플릿과 병합하여 PDF, PostScript, PCL 및 ZPL 문서를 일괄적으로 생성합니다.
노트

출력 서비스는 32비트 응용 프로그램입니다. Microsoft Windows에서는 32비트 응용 프로그램에서 최대 2GB의 메모리를 사용할 수 있습니다. 출력 서비스에도 제한이 적용됩니다.

비대화형 양식 문서 만들기

usingoutput_modified

일반적으로 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 양식 버전을 출력으로 반환할 수 있습니다.

비대화형 양식 문서 생성

각 템플릿에 대해 하나 이상의 템플릿과 여러 개의 XML 데이터 레코드가 있는 시나리오를 생각해 보십시오.

를 사용하십시오 generatePDFOutputBatch 및 generatePrintedOutputBatch 각 레코드에 대한 인쇄 문서를 생성하는 출력 서비스의 작업입니다.

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

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

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

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

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

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

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

이 페이지에서는