AEM 워크플로우에서 문서 서비스 API 시작

어셈블러

AEM Forms에서는 다음 어셈블러 서비스 API를 호출하는 사용자 지정 워크플로우를 제공합니다.

• 호출:제공된 입력에서 입력 DDX에 지정된 작업을 호출합니다.
• toPDFA:입력 PDF 문서를 PDF/A 문서로 변환합니다.

DDX 워크플로우 호출

DDX 호출 워크플로우는 Invoke 어셈블러 서비스 API를 호출합니다. 이 API는 문서를 어셈블하거나 디스어셈블하고, 워터마크를 PDF에 추가하는 데 사용할 수 있습니다.

1. 사이드 킥의 Forms Workflow 탭 아래에서 DDX 호출 워크플로우 단계를 드래그합니다.
2. 추가된 워크플로우 단계를 두 번 클릭하여 구성 요소를 편집합니다.
3. 구성 요소 편집 대화 상자에서 입력 문서, 환경 옵션 및 출력 문서를 구성하고 확인​을 클릭합니다.

입력 문서

DDX 호출 워크플로우에는 다음과 같은 입력 문서가 필요합니다.

• DDX:DDX 호출 워크플로우 단계에 대한 필수 입력이며 DDX 입력 드롭다운에서 다음 옵션 중 하나를 선택하여 지정할 수 있습니다.

  • 페이로드에 상대적:DDX 입력 파일은 워크플로우 항목의 페이로드 폴더를 기준으로 합니다.
  • 페이로드 사용:워크플로우 항목의 페이로드는 입력 DDX 문서로 사용됩니다.
  • 절대 경로:CRX 저장소의 DDX 문서에 대한 절대 경로입니다.

• PayLoad에서 맵 생성:선택하면 페이로드 폴더 아래의 모든 문서가 어셈블러의 API에 대한 입력 문서의 invoke 맵에 추가됩니다. 맵에서 각 문서의 노드 이름은 키로 사용됩니다.

• 입력 문서의 맵:입력 문서의 맵을 지정합니다. 임의 개수의 항목을 추가할 수 있습니다. 여기서 각 항목은 맵의 문서 키와 문서의 소스를 지정합니다.

환경 옵션

환경 옵션 탭에서는 API 호출에 대한 다양한 처리 옵션을 설정할 수 있습니다.

• 작업 로그 수준:처리 로그에 대한 로그 수준을 지정합니다.

• 유효성 검사만:입력 DDX의 유효성을 확인합니다.

• 오류 시 실패:오류가 발생한 경우 어셈블러 서비스 호출 실패 여부를 지정합니다. 기본값은 False입니다.

출력 문서

입력 DDX에 따라 호출 API가 여러 출력 문서를 생성할 수 있습니다. 출력 문서 탭에서는 출력 문서를 저장할 위치를 선택할 수 있습니다.

1. 페이로드에서 출력 저장:페이로드 폴더에 출력 문서를 저장하거나 페이로드가 파일인 경우 페이로드를 덮어씁니다.

2. 출력 문서의 맵:출력 문서당 하나의 항목을 추가하여 각 출력 문서를 저장할 위치를 명시적으로 지정할 수 있습니다. 각 항목은 문서와 저장할 위치를 지정합니다. 출력 문서는 페이로드를 덮어쓰거나 페이로드 폴더 아래에 저장할 수 있습니다. 여러 출력 문서가 있는 경우 유용합니다.

3. 작업 로그:작업 로그 문서를 저장할 위치를 지정합니다. 이 문서는 문제 해결에 유용합니다.

PDF/A 워크플로우로 변환

PDF로 변환/A 워크플로우 단계는 toPDFA 어셈블러 서비스 API를 호출합니다. PDF 문서를 PDF/A 규격 문서로 변환하는 데 사용됩니다.

1. 사이드 킥의 Forms Workflow 탭 아래에서 ConvertToPDFA 워크플로우 단계를 드래그합니다.

2. 추가된 워크플로우 단계를 두 번 클릭하여 구성 요소를 편집합니다.

3. 구성 요소 편집 대화 상자에서 입력 문서, 변환 옵션 및 출력 문서를 구성하고 확인​을 클릭합니다.

입력 문서

다음 방법 중 하나로 PDF/A 호환 문서로 변환할 문서의 소스를 지정합니다.

• 페이로드에 상대적:입력 문서는 워크플로우 항목의 페이로드 폴더를 기준으로 합니다.
• 페이로드 사용:워크플로우 항목의 페이로드가 입력 문서로 사용됩니다.
• 절대 경로:CRX 저장소에 있는 입력 문서의 절대 경로입니다.

전환 옵션

변환 옵션을 사용하면 PDF/A 변환 프로세스를 변경하는 옵션을 지정할 수 있습니다.

• 규정 준수 :출력 PDF/A가 준수해야 하는 PDF/A 표준을 지정합니다.

• *결과 수준 *:PDF/A 변환 로그에 사용할 로그 수준을 지정합니다.

• 서명 :변환 중에 입력 문서의 서명을 처리하는 방법을 지정합니다.

• 색상 공간 :출력 PDF/A 문서에 사용할 사전 정의된 색상 공간을 지정합니다.

• ** VerifyConversion:변환 후 PDF/A 준수에 대해 변환된 PDF/A 문서를 확인할지 여부를 지정합니다.

• 작업 로그 수준 :처리 로그에 사용할 로그 수준을 지정합니다.

• 메타데이터 확장 스키마 :PDF 문서의 메타데이터에서 XMP 속성에 사용할 메타데이터 확장 스키마의 경로를 지정합니다.

출력 문서

출력 문서 탭에서는 출력 문서의 대상을 지정할 수 있습니다

• PDFA 문서:변환된 PDF/A 문서가 저장되는 위치를 지정합니다. 페이로드 문서를 덮어쓰거나 페이로드 폴더 아래에 저장할 수 있습니다.
• 변환 로그:전환 로그가 저장되는 위치를 지정합니다. 페이로드 문서를 덮어쓰거나 페이로드 폴더 아래에 저장할 수 있습니다.

양식

PDF 양식 렌더링 워크플로우는 XDP 템플릿 및 데이터 xml을 사용하여 PDF 양식을 만들기 위한 renderPDFForm Forms 서비스 API의 래퍼입니다.

PDF 양식 렌더링 워크플로우

1. 사이드 킥의 Forms Workflow 탭 아래에서 PDF 양식 렌더링 워크플로우 단계를 드래그합니다.
2. 추가된 워크플로우 단계를 두 번 클릭하여 구성 요소를 편집합니다.
3. 구성 요소 편집 대화 상자에서 입력 문서, 출력 문서 및 추가 매개 변수를 구성하고 확인​을 클릭합니다.

입력 문서

• 템플릿 파일:XDP 템플릿의 위치를 지정합니다. 필수 필드입니다.

• 데이터 문서:템플릿에 병합해야 하는 데이터 xml의 위치를 지정합니다.

출력 문서

• 출력 문서:- 생성된 PDF 양식의 이름을 지정합니다.

추가 매개 변수

• 컨텐츠 루트:입력 XDP 템플릿에 사용된 조각이나 이미지가 저장되는 저장소의 폴더 경로를 지정합니다.
• 제출 Url:생성된 PDF 양식의 기본 제출 URL을 지정합니다.
• 로케일:생성된 PDF 양식의 기본 로케일을 지정합니다.
• Acrobat 버전:생성된 PDF 양식의 대상 Acrobat 버전을 지정합니다.
• 태그가 지정된 PDF:생성된 PDF를 액세스할 수 있도록 할지 여부를 지정합니다.
• XCI 문서:XCI 파일의 경로를 지정합니다.

출력

비대화형 PDF 생성 워크플로우는 generatePDFOutput 출력 서비스 API의 래퍼입니다. XDP 템플릿 및 데이터 xml에서 비대화형 PDF 문서를 생성하는 데 사용됩니다.

비대화형 PDF 출력 생성 워크플로우  

1. 사이드 킥의 Forms Workflow 탭 아래에서 비대화형 PDF 출력 생성 워크플로우를 드래그합니다.
2. 추가된 워크플로우 단계를 두 번 클릭하여 구성 요소를 편집합니다.
3. 구성 요소 편집 대화 상자에서 입력 문서, 출력 문서 및 추가 매개 변수를 구성하고 확인​을 클릭합니다.

입력 문서

• 템플릿 파일:XDP 템플릿의 위치를 지정합니다. 필수 필드입니다.

• 데이터 문서:템플릿에 병합해야 하는 데이터 xml의 위치를 지정합니다.

출력 문서

출력 문서:생성된 PDF 양식의 이름을 지정합니다.

추가 매개 변수

• 컨텐츠 루트:입력 XDP 템플릿에 사용된 조각이나 이미지가 저장되는 저장소의 폴더 경로를 지정합니다.
• 로케일:생성된 PDF 양식의 기본 로케일을 지정합니다.
• Acrobat 버전:생성된 PDF 양식의 대상 Acrobat 버전을 지정합니다.
• 선형화된 PDF:생성된 PDF를 웹 보기로 최적화할지 여부를 지정합니다.
• 태그가 지정된 PDF:생성된 PDF를 액세스할 수 있도록 할지 여부를 지정합니다.
• XCI 문서:XCI 파일의 경로를 지정합니다.