Konfigurieren des OAuth-Server-zu-Server-Zugriffs für AEM Forms Communications-APIs

1. Auf der Seite Programmübersicht

2. Klicken Sie Menü links„Umgebungen“. Es wird eine Liste aller Umgebungen angezeigt

3. Klicken Sie auf den spezifischen Umgebungsnamen, um die Details anzuzeigen

   

1. Auf der Seite Programmübersicht

2. Suchen Sie den Abschnitt Umgebungen.

3. Klicken Sie auf „Alle anzeigen, um alle Umgebungen anzuzeigen

4. Klicken Sie auf Menü mit den Auslassungspunkten (…) neben der Umgebung

5. Wählen Sie Details anzeigen“

   

1. Klicken Sie Abschnitt „Schnellstart auf Neues Projekt erstellen

2. Ein neues Projekt wird mit einem Standardnamen erstellt

   

3. Klicken oben auf „Projekt bearbeiten“

   

4. Geben Sie einen aussagekräftigen Namen an (z. B. „FormsProject„)

5. Klicken Sie auf Speichern.

   

1. Klicken Sie Adobe Developer Console auf Alle Projekte“

   

2. Suchen Sie Ihr Projekt und klicken Sie darauf, um es zu öffnen.

   

Manuelles Generieren von Zugriffs-Token in Adobe Developer Console:

1. Klicken Sie im API-Abschnitt Ihres Projekts auf Schaltfläche Zugriffs-Token generieren“.

2. Kopieren des generierten Zugriffstokens

   

Programmgesteuerte Generierung von Token mithilfe Adobe IMS-API:

Erforderliche Anmeldedaten:

• Client-ID
• Client-Geheimnis
• Bereiche (typischerweise: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Token-Endpunkt:

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

Beispielanfrage (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'

Antwort:

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

Die Swagger-Benutzeroberfläche bietet eine interaktive Oberfläche zum Testen von APIs, ohne Code zu schreiben. Verwenden Sie die Funktion "ausprobieren zum Aufrufen und Testen der Kommunikations-API Generate PDF von Forms.

1. Navigieren Sie zur Forms-Kommunikations-APIReferenz und öffnen Sie die FormsKommunikations-API}-Dokumentation in Ihrem Browser.

2. Erweitern Sie den Abschnitt Dokumenterstellung und wählen Sie Generiert ein ausfüllbares PDF-Formular aus einer XDP- oder PDF-Vorlage, optional mit Datenzusammenführung.

3. Klicken Sie im rechten Bereich auf "ausprobieren.

   

4. Geben Sie die folgenden Werte ein:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Abschnitt	Parameter	Wert
   bucket	AEM-Instanz	AEM-Instanzname ohne den Adobe-Domänennamen (.adobeaemcloud.com) Verwenden Sie beispielsweise pXXXXX-eYYYYY als Bucket.
   Sicherheit	Bearer Token	Verwenden Sie das Zugriffstoken aus den OAuth-Server-zu-Server-Anmeldeinformationen des Adobe Developer Console-Projekts
   Hauptteil	template	Laden Sie eine XDP-Datei hoch, um das PDF-Formular zu generieren. Sie können beispielsweise "​ XDP“ verwenden um eine PDF zu generieren.
   Hauptteil	data	Eine optionale XML-Datei mit den Daten, die mit der Vorlage zusammengeführt werden sollen, um ein vorausgefülltes PDF-Formular zu generieren. Sie können beispielsweise "​ XML“ verwenden um eine PDF zu generieren.
   Parameter	X-Adobe-Accept-Experimental	1

5. Klicken Sie auf Senden, um die API aufzurufen

   

6. Überprüfen Sie die Antwort auf der Registerkarte Antwort:

   • Wenn der Antwort-Code 200 ist, bedeutet dies, dass die PDF erfolgreich erstellt wurde.
   • Wenn der Antwort-Code 400 ist, bedeutet dies, dass die Anfrageparameter ungültig oder fehlerhaft sind.
   • Wenn der Antwort-Code 500 ist, bedeutet dies, dass ein interner Server-Fehler vorliegt.
   • Wenn der Antwort-Code 403 ist, bedeutet dies, dass ein Autorisierungsfehler vorliegt.

   In diesem Fall lautet der Antwort-Code 200. Das bedeutet, dass die PDF erfolgreich generiert wurde:

   

   Jetzt können Sie die erstellte PDF über die Schaltfläche Herunterladen herunterladen und in PDF Viewer anzeigen:

   

   note note
   NOTE
   Zu Testzwecken können Sie auch den Postman, curl oder einen anderen REST-Client verwenden, um die AEM-APIs aufzurufen.

Entwickeln Sie eine Node.js-Anwendung, um ein ausfüllbares PDF-Formular aus einer XDP-Vorlage und einer XML-Datendatei mithilfe der Document Services-API

Voraussetzungen

• Auf Ihrem System installierte Node.js
• Aktive AEM as a Cloud Service Instanz
• Bearer-Token für die API-Authentifizierung von Adobe Developer Console
• XDP-Beispieldatei: closingForm.xdp
• XML-Beispieldatei: closingForm.xml

Um die Node.js-Anwendung zu entwickeln, folgen Sie der schrittweisen Entwicklung:

Schritt 1: Erstellen Sie ein neues Node.js-Projekt

Öffnen Sie den Befehl/das Terminal und führen Sie die folgenden Befehle aus:

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

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

Schritt 2: Installieren Sie die erforderlichen Abhängigkeiten

Installieren Sie die node-fetch, dotenv und form-data-Bibliotheken, um HTTP-Anfragen zu stellen, Umgebungsvariablen zu lesen und Formulardaten zu verarbeiten.

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

Schritt 3: Aktualisieren Sie package.json

1. Öffnen Sie den Befehl cmd/Terminal und führen Sie den Befehl aus:

   code language-bash
   code .

   

   Das Projekt wird im Code-Editor geöffnet.

2. Aktualisieren Sie die package.json Datei , um die type zu module hinzuzufügen.

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

   

Schritt 4: Erstellen Sie eine .env-Datei

1. Erstellen der .env-Datei auf der Stammebene eines Projekts

2. Fügen Sie die folgende Konfiguration hinzu und ersetzen Sie die Platzhalter durch die tatsächlichen Werte aus den OAuth Server-zu-Server-Anmeldeinformationen des ADC-Projekts.

   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
   Sie können die CLIENT_ID, CLIENT_SECRET und SCOPES aus dem Adobe Developer Console-Projekt kopieren.

Schritt 5: Erstellen Sie src/index.js

1. Erstellen index.js Datei auf der Stammebene des Projekts
2. Fügen Sie den folgenden Code hinzu und ersetzen Sie die Platzhalter durch die tatsächlichen Werte:

// 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();

Schritt 6: Führen Sie die Anwendung aus

node src/index.js

Die PDF wird im demo-nodejs-generate-pdf erstellt. Navigieren Sie zum Ordner , um die generierte Datei mit dem Namen generatedForm.pdf zu finden.