OAuth サーバー間認証を使用したAEM Forms Communications APIの呼び出し

1. プログラムの概要 ページ

2. 左側のメニューで「“環境”」をクリックします。 Adobe Experience Manager Sitesに登録されている

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をテストするためのインタラクティブなインターフェイスを提供します。Try it​機能を使用して、generate PDF Forms Communication APIを呼び出してテストします。

1. Forms Communication API Referenceに移動し、ブラウザーでForms Communication API ドキュメントを開きます。

2. 「Document Generation」セクションを展開し、「入力可能なPDF フォームをXDPまたは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を生成できます。
   本文	data	事前入力されたPDF フォームを生成するために、テンプレートと結合するデータを含むオプションのXML ファイル。 例えば、このXMLを使用してPDFを生成できます。
   パラメーター	X-Adobe-Accept-Experimental	1

5. Send​をクリックして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
   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という名前の生成ファイルを見つけます。