使用OAuth服务器到服务器身份验证调用AEM Forms通信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. 展开​ Document Generation ​部分并选择从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实例	AEM实例名称不带Adobe域名(.adobeaemcloud.com)。例如，使用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。

开发Node.js应用程序以使用​ Document Services API ​从​ XDP ​模板和​ XML ​数据文件生成可填写的PDF表单

先决条件

• 系统上安装的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：更新包.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的生成文件。