使用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 Reference，然後在瀏覽器中開啟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網域名稱(.adobeaemcloud.com)的Adobe執行個體名稱例如，使用pXXXXX-eYYYYY做為貯體。
   安全性	持有人權杖	使用Adobe Developer Console專案之OAuth伺服器對伺服器認證的存取權杖
   內文	範本	上傳XDP以產生PDF表單。 例如，您可以使用此XDP來產生PDF。
   內文	資料	選用的XML檔案，其中包含要與範本合併的資料，以產生預先填入的PDF表單。 例如，您可以使用此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/終端機並執行以下命令：

# 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/終端機並執行命令：

   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

PDF是在demo-nodejs-generate-pdf資料夾中建立。 瀏覽至資料夾以尋找名為generatedForm.pdf的產生檔案。