AEM Forms API를 사용하여 AFP 출력 생성

Last update: Tue Nov 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

적용 대상:
Experience Manager as a Cloud Service

작성 대상:

관리자
사용자

이는 프리릴리스 기능이고 프리릴리스 채널을 통해 액세스할 수 있습니다.

AFP(Advanced Function Presentation)는 주로 인쇄용으로 설계된 고성능 문서 형식입니다.
이 안내서에서는 AEM Forms을 사용하여 AFP 출력을 생성하는 데 필요한 모든 단계 및 구성을 간략하게 설명합니다.

AFP 생성 API

XDP 템플릿과 입력 데이터를 사용하여 AFP(Advanced Function Presentation) 파일을 생성합니다.

승인

로컬 환경에 대해 BasicAuth(관리자 자격 증명)를 사용하거나 AEM Cloud 인스턴스에 대해 OAuth 서버 간 인증을 사용할 수 있습니다.

요청

끝점:
https://[publish-url].adobeaemcloud.com/adobe/forms/doc/v1/adobe/forms/doc/v1/generate/afp

헤더

키

값

Content-Type

application/pdf

Authorization

(Bearer Access token)

요청 본문

콘텐츠 형식: multipart/form-data

키

유형

필수

설명

template

파일/텍스트

예

AFP 생성용 템플릿으로 사용되는 XDP 파일(예: demo.xdp)

data

파일/텍스트

아니요

템플릿에 병합할 데이터 파일(XML 또는 JSON)(예: data.xml)

options

텍스트

아니요

AFP 출력을 제어하는 옵션이 포함된 JSON 문자열(예: 해상도, 로케일)

예 options JSON(텍스트 필드):

{
  "pdfVersion": "1.7",
  "resolution": 300,
  "locale": "en-US",
  "embedFonts": true,
  "contentRoot": "/usr/tmp"
}

응답

코드

설명

200

작업이 완료되었습니다. AFP 문서 스트림을 반환합니다.

400

잘못된 요청. 요청 페이로드의 형식이 잘못되었거나 필수 필드가 누락되었습니다.

500

내부 서버 오류. 잠시 후 다시 시도하십시오.

Curl 명령

curl --location 'http://<server>:<port>/adobe/forms/document/generate/afp' \
--header 'Authorization: Bearertoken <base64-encoded-credentials>' \
--form 'template=@"<path-to-template>.xdp"' \
--form 'data=@"<path-to-data-file>.xml"' \
--form 'options=<JSON-options-string>'

API 테스트

.yaml 파일을 다운로드하고 Postman에 업로드하여 API의 기능을 확인할 수 있습니다.

AFP Postman 이미지

응답을 저장하고 저장된 파일을 AFP 판독기에서 열어 볼 수 있습니다.

IC 문서 찾기

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab