설명서AEM 6.5사용 안내서

AEM Workflow에서 문서 서비스 API 시작 initiate-document-services-apis-from-aem-workflow

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 적용 대상:
  • Experience Manager 6.5
  • 주제:

작성 대상:

  • 사용자
  • 개발자

어셈블러 assembler

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

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

DDX 워크플로우 호출 invoke-ddx-workflow

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

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

입력 문서 input-documents

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

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

    • 페이로드 관련: DDX 입력 파일은 워크플로 항목의 페이로드 폴더에 관련됩니다.
    • 페이로드 사용: 워크플로 항목에 대한 페이로드가 입력 DDX 문서로 사용됩니다.
    • 절대 경로: CRX 저장소의 DDX 문서에 대한 절대 경로입니다.

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

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

환경 옵션 environment-options

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

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

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

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

출력 문서 output-documents

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

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

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

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

PDF/A 워크플로우로 전환 convert-to-pdf-a-workflow

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

  1. Sidekick의 Forms Workflow 탭 아래에 있는 ConvertToPDFA 워크플로 단계를 드래그합니다.

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

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

입력 문서 input-documents-1

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

  • 페이로드 관련: 입력 문서는 워크플로 항목의 페이로드 폴더에 관련됩니다.
  • 페이로드 사용: 워크플로 항목에 대한 페이로드가 입력 문서로 사용됩니다.
  • 절대 경로: CRX 저장소에 있는 입력 문서의 절대 경로입니다.

전환 옵션 conversion-options

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

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

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

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

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

  • 확인 변환: 변환 후 변환된 PDF/A 문서의 PDF/A 준수 여부를 확인합니다.

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

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

출력 문서 output-documents-1

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

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

Forms forms

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

렌더링 PDF 양식 워크플로 render-pdf-form-workflow

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

입력 문서 input-documents-2

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

  • 데이터 문서: 서식 파일과 병합해야 하는 데이터 xml의 위치를 지정합니다.

출력 문서 output-documents-2

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

추가 매개 변수 additional-parameters

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

출력 output

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

비대화형 PDF 출력 워크플로우 생성   generate-non-interactive-pdf-output-workflow-nbsp

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

입력 문서 input-documents-3

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

  • 데이터 문서: 서식 파일과 병합해야 하는 데이터 xml의 위치를 지정합니다.

출력 문서 output-document

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

추가 매개 변수 additional-parameters-1

  • 콘텐츠 루트: 입력 XDP 템플릿에서 사용된 조각이나 이미지가 저장되는 저장소의 폴더에 대한 경로를 지정합니다.
  • 로케일: 생성된 PDF 양식에 대한 기본 로케일을 지정합니다.
  • Acrobat 버전: 생성된 PDF 양식에 대해 타깃팅된 Acrobat 버전을 지정합니다.
  • 선형화된 PDF: 웹 보기를 위해 생성된 PDF을 최적화할지 여부를 지정합니다.
  • 태그가 지정된 PDF: 생성된 PDF에 액세스할 수 있게 할지 여부를 지정합니다.
  • XCI 문서: XCI 파일의 경로를 지정합니다.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2