Show Menu
화제×

거래 보고서 청구 가능한 API

AEM Forms에서는 양식을 제출하거나 문서를 처리하고 문서를 렌더링하는 데 필요한 여러 API를 제공합니다. 일부 API는 트랜잭션으로 계산되며 다른 API는 무료로 사용할 수 있습니다. 이 문서에서는 트랜잭션 보고서에서 트랜잭션으로 간주되는 모든 API의 목록을 제공합니다. 다음은 청구 가능한 API가 사용되는 몇 가지 일반적인 시나리오입니다.
  • 적응형 양식, HTML5 양식 및 양식 세트 제출
  • 인터랙티브한 커뮤니케이션의 인쇄 또는 웹 버전 렌더링
  • 문서 변환
  • 동적 PDF 문서 병합
  • 기록 문서 생성
  • 인터랙티브한 PDF 문서를 다른 PDF 문서와 병합
  • AEM 워크플로우의 할당 작업 단계 및 문서 서비스 단계 사용
  • 적응형 양식 내에서 적응형 양식 사용
청구 API는 렌더링된 문서의 페이지 수, 문서 또는 양식의 길이 또는 최종 형식을 고려하지 않습니다. 거래 보고서는 트랜잭션을 두 가지 범주로 나눕니다.제출된 문서 및 양식
  • ​제출된 양식:AEM Forms로 만든 모든 유형의 양식에서 데이터를 전송하면 데이터가 데이터 저장소 또는 데이터베이스에 제출되거나 양식 제출으로 간주됩니다. 예를 들어 적응형 양식, HTML5 양식, PDF 양식 및 양식 세트를 제출하는 것은 양식을 제출한 것으로 간주합니다. 양식 세트의 각 양식은 제출물로 간주됩니다. 예를 들어, 양식 세트에 5개의 양식이 있는 경우, 양식 세트가 제출되면 거래 보고 서비스는 이를 5개의 제출물로 계산합니다.
  • ​렌더링된 문서:템플릿 및 데이터를 결합하거나, 문서에 디지털 서명 또는 인증을 하거나, 문서 서비스에 대해 청구 가능한 문서 서비스 API를 사용하거나, 한 형식에서 다른 형식으로 문서를 변환하여 문서를 생성하는 것은 문서가 렌더링된 것으로 간주됩니다.
거래 보고서 UI에는 다음 세 가지 카테고리가 표시됩니다.양식 제출, 문서 렌더링 및 처리된 문서. 렌더링된 문서와 처리된 문서 모두 렌더링된 문서로 간주됩니다.

청구 가능한 Document Services API

PDF 서비스 생성

API
설명 거래 보고서 범주 추가 정보
createPDF 지원되는 파일 형식에서 Adobe PDF를 만듭니다. 처리된 문서
createPDF2 지원되는 파일 형식에서 Adobe PDF를 만듭니다. 처리된 문서
exportPDF Adobe PDF를 지원되는 파일 유형으로 변환합니다. 처리된 문서
exportPDF2 Adobe PDF를 지원되는 파일 유형으로 변환합니다. 처리된 문서
exportPDF3 Adobe PDF를 지원되는 파일 유형으로 변환합니다. 처리된 문서
htmlFileToPdf
HTML 페이지에서 PDF를 만듭니다.
처리된 문서
htmlToPdf HTML 페이지를 가리키는 URL에서 PDF를 만듭니다. 처리된 문서
htmlToPdf2 HTML 페이지를 가리키는 URL에서 PDF를 만듭니다. 처리된 문서
optimizePDF 품질에 영향을 주지 않고 불필요한 메타데이터를 제거함으로써 파일 크기를 줄이기 위해 PDF를 최적화합니다. 처리된 문서

Distiller Service

API
설명 거래 보고서 범주 추가 정보
createPDF 지원되는 파일 형식에서 Adobe PDF를 만듭니다. 처리된 문서
createPDF2 지원되는 파일 형식에서 Adobe PDF를 만듭니다. 처리된 문서

기록 서비스 문서(DoR 서비스)

API
설명 거래 보고서 범주 추가 정보
render 지정된 렌더링 방법을 호출하여 제공된 매개 변수를 사용하여 레코드 문서를 생성합니다. 처리된 문서

출력 서비스

API
설명 거래 보고서 범주 추가 정보
generatePDFOutput 데이터와 템플릿을 결합하여 PDF 문서를 만듭니다. 처리된 문서
generatePDFOutput 데이터와 템플릿을 결합하여 PDF 문서를 만듭니다. 처리된 문서
generatePDFOutputBatch 데이터와 템플릿을 결합하여 PDF 문서 세트를 만듭니다. 처리된 문서 generatePDFOutputBatch API는 양식 템플릿을 레코드와 결합하고 PDF를 생성합니다. 일괄 레코드를 처리할 때 트랜잭션 보고 서비스는 각 레코드를 별도의 PDF 변환으로 계산합니다. getGenerateManyFiles 플래그를 사용하여 여러 변환을 단일 PDF 파일로 결합할 수 있습니다. 플래그 상태와 관계없이 서비스는 각 레코드를 별도의 PDF 변환으로 계산합니다.
generatePrintedOutput XDP 및 PDF 문서를 PS(PostScript), PCL(프린터 명령 언어) 및 ZPL 파일 포맷으로 변환합니다. 처리된 문서
generatePrintedOutput XDP 및 PDF 문서를 PS(PostScript), PCL(프린터 명령 언어) 및 ZPL 파일 포맷으로 변환합니다. 처리된 문서
generatePrintedOutputBatch XDP 및 PDF 문서 집합을 PS(PostScript), PCL(프린터 명령 언어) 및 ZPL 파일 형식 세트로 변환합니다. 처리된 문서 generatePDFOutputBatch API는 양식 템플릿을 레코드와 결합하고 PDF를 생성합니다. 일괄 레코드를 처리할 때 트랜잭션 보고 서비스는 각 레코드를 별도의 PDF 변환으로 계산합니다. getGenerateManyFiles 플래그를 사용하여 여러 변환을 단일 PDF 파일로 결합할 수 있습니다. 플래그 상태와 관계없이 서비스는 각 레코드를 별도의 PDF 변환으로 계산합니다.

양식 서비스

API
설명 거래 보고서 범주 추가 정보
renderPDForm XDP 템플릿에서 PDF 양식을 렌더링합니다. XP 템플릿은 Forms Designer에서 만듭니다. 처리된 문서
exportData PDF 양식 또는 XDP 템플릿에서 데이터 추출 처리된 문서

PDF 서비스 변환

API
설명 거래 보고서 범주 추가 정보
toImage PDF 문서를 이미지 문서 목록으로 변환합니다. 지원되는 이미지 형식은 JPEG, JPEG2K, PNG 및 TIFF입니다. 처리된 문서
toPS 옵션 사양에 지정된 옵션을 사용하여 플랫 PDF 파일을 PostScript 포맷으로 변환합니다. 처리된 문서

Barcoded Forms Service

API
설명 거래 보고서 범주 추가 정보
decode Document 개체의 모든 바코드를 디코딩하고 바코드에서 검색한 데이터를 포함하는 org.w3c.dom.Document 개체를 반환합니다. 처리된 문서

어셈블러 서비스

API
설명 거래 보고서 범주 추가 정보
voke 지정된 DCX 문서를 실행하고 결과 문서를 포함하는 AssemblerResult 개체를 반환합니다. 처리된 문서 다음 작업은 트랜잭션으로 계산되지 않습니다.
  • 패키지 또는 포트폴리오 만들기
  • 여러 XDP 연결
voke 지정된 DCX 문서를 실행하고 결과 문서를 포함하는 AssemblerResult 개체를 반환합니다. 처리된 문서 PDF Generator, Forms 및 Output Services에서 지원하는 모든 입력 파일 포맷인 Assembler 서비스는 이러한 모든 포맷을 출력 파일 포맷으로 지원합니다.
toPDFA 지정된 옵션을 사용하여 지정된 문서를 PDF/A로 변환합니다. 처리된 문서
  • 어셈블러 서비스의 호출 API는 입력에 따라 다른 서비스의 청구 가능한 API를 내부적으로 호출할 수 있습니다. 따라서 호출 API는 없음, 단일 또는 여러 트랜잭션으로 설명할 수 있습니다. 카운트된 트랜잭션 수는 호출된 내부 API와 입력에 따라 달라집니다.
  • 어셈블러 서비스를 사용하여 생성된 단일 PDF 문서는 없음, 단일 또는 여러 트랜잭션으로 설명할 수 있습니다. 계산된 트랜잭션 수는 제공된 DCX 코드에 따라 달라집니다.

PDF 유틸리티 서비스

API
설명 거래 보고서 범주 추가 정보
convertPDFtoXDP PDF 문서를 XDP 파일로 변환합니다. PDF 문서를 XDP 파일로 성공적으로 변환하려면 PDF 문서에 AcroForm 사전의 XFA 스트림이 포함되어야 합니다. 처리된 문서

청구 가능한 데이터 캡처 API

적응형 양식, HTML5 양식 및 양식 세트의 모든 제출 이벤트는 트랜잭션으로 간주됩니다. 기본적으로 PDF 양식 제출은 트랜잭션으로 간주되지 않습니다. 제공된 트랜잭션 레코더 API를 사용하여 PDF 양식 제출을 거래로 기록합니다.

응용 양식

사용 사례
설명 거래 보고서 범주 추가 정보
적응형 양식 제출 구성된 제출 작업에 적응형 양식을 제출합니다. 제출된 양식
  • 성공적으로 제출하면 한 개 또는 두 개의 거래가 고려됩니다. 계산된 트랜잭션 수는 실행에 사용되는 실행 작업의 유형에 따라 달라집니다. 예를 들어 전자 메일 제출 작업을 통해 PDF를 전송하는 경우 두 가지 트랜잭션 카운트가 계산됩니다. DOR(Document of Record) 서비스를 사용하여 생성된 PDF에 대한 한 트랜잭션(양식 제출) 및 다른 트랜잭션.
  • 적응형 양식(적응형 양식 형식 세트) 내에서 적응형 양식을 사용하면 단일 거래만 가능합니다. 적응형 양식 내에 원하는 수의 적응형 양식을 포함할 수 있습니다.

HTML5 양식

사용 사례
설명 거래 보고서 범주 추가 정보
HTML5 양식 제출 양식에 구성된 URL을 제출하기 위해 HTML5 양식을 제출합니다. 제출된 양식

양식 집합

API
설명 거래 보고서 범주 추가 정보
양식 세트 제출 양식 세트에 구성된 제출 URL에 양식 세트를 제출합니다. 제출된 양식
  • 적응형 양식(적응형 양식 형식 세트) 내에서 적응형 양식을 사용하면 단일 거래만 가능합니다. 적응형 양식 내에 원하는 수의 적응형 양식을 포함할 수 있습니다.
  • HTML5 양식 양식의 모든 양식은 계정을 별도의 트랜잭션으로 설정합니다.

OSGi API에서 청구 가능한 대화형 커뮤니케이션 및 양식 중심의 AEM 워크플로우

OSGi에서 양식 중심의 AEM 워크플로우의 작업 및 문서 서비스 단계와 모든 대화형 커뮤니케이션의 변환을 할당하고 트랜잭션으로 간주합니다. 에이전트 UI를 사용하여 작성 인스턴스에서 대화형 통신을 미리 보고 게시 인스턴스에서 미리 보는 것은 트랜잭션으로 계산되지 않습니다. 워크플로우 단계가 트랜잭션을 계산하고 워크플로우가 완료되지 않으면 트랜잭션 수가 취소되지 않습니다.

대화형 통신 - 웹 채널

API
설명 거래 보고서 범주 추가 정보
웹 채널 렌더링 대화형 통신의 웹 버전을 엽니다. 렌더링된 문서

Interactive Communication - Print Channel

API
설명 거래 보고서 범주 추가 정보
렌더링 (PDF로 변환) 인터랙티브한 커뮤니케이션의 PDF 버전을 생성합니다. 렌더링된 문서

OSGi에서 양식 중심의 AEM 워크플로우

사용 사례
거래 보고서 범주 추가 정보
작업 지정 단계 제출 제출된 양식
워크플로우 애플리케이션 시작 지점 제출 제출된 양식
에이전트 UI에서 워크플로우로 대화형 통신(인쇄 채널) 제출 렌더링된 문서

청구 가능한 API를 사용자 지정 코드에 대한 트랜잭션으로 기록

PDF 양식 제출, 에이전트 UI를 사용하여 대화형 통신 미리 보기, 비표준 양식 제출 사용 및 사용자 지정 구현과 같은 작업은 트랜잭션으로 간주되지 않습니다. AEM Forms에서는 트랜잭션과 같은 작업을 기록할 API를 제공합니다. 사용자 지정 구현에서 API를 호출하여 트랜잭션을 기록할 수 있습니다 .