OAuth 서버 간 인증을 사용하여 AEM Forms Communications API 호출

1. 프로그램 개요 페이지에서

2. 왼쪽 메뉴에서 "환경"​을(를) 클릭합니다. 모든 환경 목록을 볼 수 있습니다

3. 세부 정보를 보려면 특정 환경 이름을 클릭하십시오.

   

1. 프로그램 개요 페이지에서

2. 환경 섹션을 찾습니다.

3. 모든 환경을 보려면 "모두 표시"​를 클릭하십시오.

4. 환경 옆에 있는 줄임표 메뉴(…)​를 클릭합니다

5. "세부 정보 보기" 선택

   

1. 빠른 시작 섹션에서 새 프로젝트 만들기​를 클릭하세요.

2. 기본 이름으로 새 프로젝트가 만들어집니다.

   

3. 오른쪽 상단 모서리에서 프로젝트 편집​을 클릭합니다.

   

4. 의미 있는 이름(예: "formsproject") 제공

5. 저장 클릭

   

1. Adobe Developer Console에서 모든 프로젝트 클릭

   

2. 프로젝트를 찾은 다음 를 클릭하여 엽니다.

   

Adobe Developer Console에서 액세스 토큰을 수동으로 생성합니다.

1. 프로젝트의 API 섹션에서 "액세스 토큰 생성" 단추를 클릭합니다.

2. 생성된 액세스 토큰 복사

   

Adobe IMS API를 사용하여 프로그래밍 방식으로 토큰 생성:

필요한 자격 증명:

• 클라이언트 ID
• 클라이언트 비밀
• 범위(일반적으로 openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

토큰 끝점:

    https://ims-na1.adobelogin.com/ims/token/v3

샘플 요청(curl):

    curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'grant_type=client_credentials' \
    -d 'client_id=<YOUR_CLIENT_ID>' \
    -d 'client_secret=<YOUR_CLIENT_SECRET>' \
    -d 'scope=AdobeID,openid,read_organizations'

응답:

        {
        "access_token": "eyJhbGciOiJSUz...",
        "token_type": "bearer",
        "expires_in": 86399
        }

Swagger UI는 코드를 작성하지 않고 API를 테스트하기 위한 대화형 인터페이스를 제공합니다. 사용해 보기 기능을 사용하여 PDF 생성 Forms 통신 API를 호출하고 테스트하십시오.

1. Forms Communication API 참조​(으)로 이동하여 브라우저에서 Forms Communication API 설명서를 엽니다.

2. 문서 생성 섹션을 확장하고 XDP 또는 PDF 템플릿에서 입력 가능한 PDF 양식을 생성합니다(선택적으로 데이터 병합 포함)을(를) 선택합니다.

3. 오른쪽 창에서 시도​를 클릭합니다.

   

4. 다음 값을 입력합니다.

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   섹션	매개 변수	값
   버킷	AEM 인스턴스	Adobe 도메인 이름(.adobeaemcloud.com)이 없는 AEM 인스턴스 이름. 예를 들어 pXXXXX-eYYYYY을(를) 버킷으로 사용합니다.
   보안	전달자 토큰	Adobe Developer Console 프로젝트의 OAuth 서버 간 자격 증명에서 액세스 토큰 사용
   본문	템플릿	XDP를 업로드하여 PDF 양식을 생성합니다. 예를 들어 이 XDP를 사용하여 PDF을 생성할 수 있습니다.
   본문	데이터	템플릿과 병합하여 미리 채워진 PDF 양식을 생성할 데이터가 포함된 선택적 XML 파일입니다. 예를 들어 이 XML을 사용하여 PDF을 생성할 수 있습니다.
   매개변수	X-Adobe-Accept-Experimental	1

5. API를 호출하려면 보내기​를 클릭하십시오.

   

6. 응답 탭에서 응답을 확인하십시오.

   • 응답 코드가 200이면 PDF이 성공적으로 만들어졌습니다.
   • 응답 코드가 400이면 요청 매개 변수가 잘못되었거나 형식이 잘못되었음을 의미합니다.
   • 응답 코드가 500이면 내부 서버 오류가 있음을 의미합니다.
   • 응답 코드가 403이면 인증 오류가 있음을 의미합니다.

   이 경우 응답 코드는 200입니다. 이는 PDF이 성공적으로 생성되었음을 의미합니다.

   

   이제 다운로드 단추를 사용하여 만든 PDF​을(를) 다운로드하고 PDF 뷰어에서 볼 수 있습니다.

   

   note note
   NOTE
   테스트 목적으로 Postman, curl 또는 기타 REST 클라이언트를 사용하여 AEM API를 호출할 수도 있습니다.

문서 서비스 API​를 사용하여 XDP 템플릿과 XML 데이터 파일에서 입력 가능한 PDF 양식을 생성하도록 Node.js 응용 프로그램을 개발하십시오.

사전 요구 사항

• 시스템에 설치된 Node.js
• 활성 AEM as a Cloud Service 인스턴스
• Adobe Developer Console의 API 인증을 위한 전달자 토큰
• 샘플 XDP 파일: ClosingForm.xdp
• 샘플 XML 파일: ClosingForm.xml

Node.js 애플리케이션을 개발하려면 단계별 개발을 따르십시오.

1단계: 새 Node.js 프로젝트 만들기

cmd/terminal을 열고 다음 명령을 실행합니다.

# Create a new directory
mkdir demo-nodejs-generate-pdf
cd demo-nodejs-generate-pdf

##### Initialize Node.js project
npm init -y

2단계: 필요한 종속성 설치

node-fetch, dotenv 및 form-data 라이브러리를 설치하여 HTTP 요청을 하고, 환경 변수를 읽고, 양식 데이터를 각각 처리합니다.

npm install node-fetch
npm install dotenv
npm install form-data

3단계: package.json 업데이트

1. cmd/terminal을 열고 다음 명령을 실행합니다.

   code language-bash
   code .

   

   코드 편집기에서 프로젝트가 열립니다.

2. package.json 파일을 업데이트하여 type을(를) module에 추가합니다.

   code language-bash
   { "name": "demo-nodejs-generate-pdf", "version": "1.0.0", "type": "module", "main": "index.js", }

   

4단계: .env 파일 만들기

1. 프로젝트의 루트 수준에서 .env 파일 만들기

2. 다음 구성을 추가하고 자리 표시자를 ADC 프로젝트의 OAuth 서버 간 자격 증명의 실제 값으로 바꿉니다.

   code language-bash
   CLIENT_ID=<ADC Project OAuth Server-to-Server credential ClientID> CLIENT_SECRET=<ADC Project OAuth Server-to-Server credential Client Secret> SCOPES=<ADC Project OAuth Server-to-Server credential Scopes>

   

   note note
   NOTE
   Adobe Developer Console 프로젝트에서 CLIENT_ID, CLIENT_SECRET 및 SCOPES을(를) 복사할 수 있습니다.

5단계: src/index.js 만들기

1. 프로젝트의 루트 수준에서 index.js 파일 만들기
2. 다음 코드를 추가하고 자리 표시자를 실제 값으로 바꿉니다.

// Import the dotenv configuration to load environment variables from the .env file
import "dotenv/config";

// Import fetch for making HTTP requests
import fetch from "node-fetch";
import fs from "fs";
import FormData from "form-data";

// REPLACE THE FOLLOWING VALUE WITH YOUR OWN
const bucket = <bucket-value>; // Your AEM Cloud Service Bucket name
const xdpFilePath = <xdp-file>;
const xmlFilePath = <xml-file>;

// Load environment variables
const clientId = process.env.CLIENT_ID;
const clientSecret = process.env.CLIENT_SECRET;
const scopes = process.env.SCOPES;

// Adobe IMS endpoint for obtaining an access token
const adobeIMSV3TokenEndpointURL = "https://ims-na1.adobelogin.com/ims/token/v3";

// Function to get an access token
const getAccessToken = async () => {
    console.log("Getting access token from IMS...");

    const options = {
        method: "POST",
        headers: {
            "Content-Type": "application/x-www-form-urlencoded",
        },
        body: `grant_type=client_credentials&client_id=${clientId}&client_secret=${clientSecret}&scope=${scopes}`,
    };

    const response = await fetch(adobeIMSV3TokenEndpointURL, options);
    const responseJSON = await response.json();

    console.log("Access token received.");
    return responseJSON.access_token;
};

// Function to generate PDF form from XDP and XML
const generatePDF = async () => {
    const accessToken = await getAccessToken();

    console.log("Generating PDF form from XDP and XML...");

    // Read XDP and XML files
    const xdpFile = fs.readFileSync(xdpFilePath);
    const xmlFile = fs.readFileSync(xmlFilePath);

    const url = `https://${bucket}.adobeaemcloud.com/adobe/document/generate/pdfform`;

    const formData = new FormData();
    formData.append("template", xdpFile, {
        filename: "form.xdp",
        contentType: "application/vnd.adobe.xdp+xml"
    });
    formData.append("data", xmlFile, {
        filename: "data.xml",
        contentType: "application/xml"
    });

    const response = await fetch(url, {
        method: "POST",
        headers: {
            Authorization: `Bearer ${accessToken}`,
            "X-Api-Key": clientId,
            "X-Adobe-Accept-Experimental": "1",
            ...formData.getHeaders()
        },
        body: formData,
    });

    if (response.ok) {
        const arrayBuffer = await response.arrayBuffer();
        fs.writeFileSync("generatedForm.pdf", Buffer.from(arrayBuffer));
        console.log("✅ PDF form generated successfully (saved as generatedForm.pdf)");
    } else {
        console.error("❌ Failed to generate PDF. Status:", response.status);
        console.error(await response.text());
    }
};

// Run the PDF generation function
generatePDF();

6단계: 응용 프로그램 실행

node src/index.js

demo-nodejs-generate-pdf 폴더에 PDF이 만들어집니다. 생성된 파일 generatedForm.pdf을(를) 찾으려면 폴더로 이동합니다.