동기 처리 사용 sync-processing-introduction
Forms as a Cloud Service - 커뮤니케이션 API를 통해 비즈니스 서신, 문서, 청구서 처리 편지, 청구서 처리 편지, 월별 청구서 및 환영 키트와 같은 브랜드 지향적이고 개인화된 커뮤니케이션을 만들고, 조합하고, 제공할 수 있습니다. 커뮤니케이션 API를 사용하여 템플릿(XFA 또는 PDF)을 고객 데이터와 결합하여 PDF, PS, PCL, DPL, IPL 및 ZPL 형식의 문서를 생성할 수 있습니다.
하나 이상의 템플릿과 각 템플릿에 대한 여러 XML 데이터 레코드가 있는 시나리오를 고려하십시오. 커뮤니케이션 API를 사용하여 각 레코드에 대한 인쇄 문서를 생성할 수 있습니다. 결과가 비대화형 PDF 문서입니다. 비대화형 PDF 문서에서는 사용자가 해당 필드에 데이터를 입력할 수 없습니다.
Forms as a Cloud Service - 및 Communications는 예약된 문서 생성을 위해 주문형 일괄 처리 API 제공:
-
동기 API는 온디맨드, 짧은 대기 시간 및 단일 레코드 문서 생성 사용 사례에 적합합니다. 해당 API는 사용자 액션 기반 사용 사례에 보다 적합합니다. 예를 들어 사용자가 양식을 작성한 후 문서를 생성하는 방법이 있습니다.
-
배치 API(비동기 API)는 예약된 높은 처리량의 여러 문서 생성 사용 사례에 적합합니다. 해당 API는 배치 문서를 생성합니다. 예: 매월 생성되는 전화요금 청구서, 신용카드 명세서와 혜택 명세서.
동기 작업 사용 batch-operations
동기 작업은 선형 방식으로 문서를 생성하는 프로세스입니다. 이러한 API는 단일 테넌트 API 및 다중 테넌트 API로 분류됩니다.
단일 테넌트 API
- 문서 생성 API
- 문서 조작 API
단일 테넌트 API 인증
단일 테넌트 API 작업은 두 가지 유형의 인증을 지원합니다.
-
기본 인증: 기본 인증은 HTTP 프로토콜에 내장된 간단한 인증 구성표입니다. 클라이언트는 Basic이라는 단어 뒤에 공백과 base64로 인코딩된 문자열 username:password가 있는 Authorization 헤더를 사용하여 HTTP 요청을 보냅니다. 예를 들어, 클라이언트가 관리자/관리자로 권한을 부여하려면 기본 [base64로 인코딩된 문자열 사용자 이름]: [base64로 인코딩된 문자열 암호]를 보냅니다.
-
토큰 기반 인증: 토큰 기반 인증은 액세스 토큰(전달자 인증 토큰)을 사용하여 Experience Manageras a Cloud Service 에 요청합니다. AEM Formsas a Cloud Service 에서 액세스 토큰을 검색할 수 있는 API 보안 제공 토큰을 검색하고 사용하여 요청을 인증하려면 다음을 수행하십시오.
- Developer Console에서 Experience Manager as a Cloud Service 자격 증명을 검색합니다.
- Experience Manager as a Cloud Service 자격 증명을 환경에 설치. (Application Server, 웹 서버 또는 기타 비AEM 서버)가 클라우드 서비스에 요청을 전송(호출)하도록 구성되어 있습니다.
- JWT 토큰을 생성하고 액세스 토큰용 Adobe IMS API와 교환했습니다.
- 액세스 토큰을 전달자 인증 토큰으로 사용하여 Experience Manager API를 실행합니다.
- Experience Manager 환경에서 기술 계정 사용자에 대한 적절한 사용 권한을 설정합니다.
note note NOTE Adobe은 프로덕션 환경에서 토큰 기반 인증을 사용할 것을 권장합니다.
(Document Generation API만 해당) 자산 및 권한 구성
동기 API를 사용하려면 다음 조건을 충족해야 합니다.
- Experience Manager 관리자 권한이 있는 사용자
- Experience Manager Forms Cloud Service 인스턴스에 템플릿 및 기타 에셋 업로드
(Document Generation API에만 해당) 템플릿 및 기타 에셋을 Experience Manager 인스턴스에 업로드합니다
조직에는 일반적으로 여러 템플릿이 있습니다. 예를 들어 신용 카드 명세서, 복리후생 명세서 및 청구 신청에 대해 각각 하나의 템플리트가 있습니다. 이러한 모든 XDP 및 PDF 템플릿을 Experience Manager 인스턴스에 업로드합니다. 템플릿을 업로드하려면 다음 작업을 수행하십시오.
- Experience Manager 인스턴스를 엽니다.
- Forms > Forms 및 문서로 이동합니다.
- 만들기 > 폴더 를 클릭하고 폴더를 만듭니다. 폴더를 엽니다.
- 만들기 > 파일 업로드 를 클릭하고 템플릿을 업로드합니다.
API 호출
API 참조 설명서에서는 API에서 제공하는 모든 매개 변수, 인증 방법 및 다양한 서비스에 대한 자세한 정보를 제공합니다. API 참조 설명서는 API 정의 파일도 .yaml 형식으로 제공합니다. .yaml 파일을 다운로드하고 Postman에 업로드하여 API의 기능을 확인할 수 있습니다.