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 をテストするためのインタラクティブなインターフェイスが用意されています。試す 機能を使用して、Forms通信 API の PDFを生成 ​ を呼び出してテストします。

1. Forms Communication API Reference に移動し ​ ブラウザーで 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 インスタンス	AEM インスタンス名（Adobe ドメイン名（.adobeaemcloud.com）を除いたもの。例えば、pXXXXX-eYYYYY をバケットとして使用します。
   セキュリティ	ベアラートークン	Adobe Developer Console プロジェクトの OAuth サーバー間資格情報からのアクセストークン ​ を使用します。
   本文	テンプレート	XDP をアップロードしてPDF フォームを生成します。 例えば、​ この XDP を使用してPDFを生成できます。
   本文	data	事前入力されたPDF フォームを生成するためにテンプレートと結合されるデータを含む、オプションの XML ファイル。 例えば、​ この XML を使用してPDFを生成できます。
   パラメーター	X-Adobe-Accept-Experimental	1

5. 「送信」をクリックして、API を呼び出します

   

6. 「応答 タブで応答を確認します。

   • 応答コードが 200 の場合は、PDFが正常に作成されたことを意味します。
   • 応答コードが 400 の場合は、リクエストパラメーターが無効か、形式が正しくないことを意味します。
   • 応答コードが 500 の場合は、内部サーバーエラーがあることを意味します。
   • 応答コードが 403 の場合は、認証エラーがあることを意味します。

   この場合、応答コードは 200 です。これは、PDFが正常に生成されたことを意味します。

   

   これで、「​ ダウンロード ​ ボタンを使用して 作成したPDF をダウンロードし、PDF ビューアで表示できます。

   

   note
   NOTE
   テストの目的で、Postman、curl またはその他の REST クライアントを使用して、AEM API を呼び出すこともできます。

Document Services 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
   CLIENT_ID、CLIENT_SECRET および SCOPES をAdobe Developer Console プロジェクトからコピーできます。

手順 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 という名前の生成されたファイルを見つけます。