Anropa AEM Forms Communications API:er med OAuth Server-till-Server-autentisering

1. På sidan Programöversikt

2. Klicka på "Miljöer" på den vänstra menyn. Du kan se en lista över alla miljöer

3. Klicka på det specifika miljönamnet för att visa information

   

1. På sidan Programöversikt

2. Leta reda på avsnittet Miljöer

3. Klicka på "Visa alla" om du vill visa alla miljöer

4. Klicka på menyn ellips (…) bredvid miljön

5. Välj "Visa detaljer"

   

1. Klicka på Skapa nytt projekt i avsnittet Snabbstart

2. Ett nytt projekt skapas med ett standardnamn

   

3. Klicka på Redigera projekt längst upp till höger

   

4. Ange ett beskrivande namn (t.ex. "formsproject")

5. Klicka på Spara

   

1. Klicka på Alla projekt i Adobe Developer Console

   

2. Leta upp projektet och klicka för att öppna det.

   

Generera åtkomsttoken manuellt i Adobe Developer Console:

1. Klicka på knappen "Generera åtkomsttoken" i projektets API-avsnitt

2. Kopiera genererad åtkomsttoken

   

Generera tokens programmatiskt med Adobe IMS API:

Nödvändiga autentiseringsuppgifter:

• Klient-ID
• Klienthemlighet
• Omfång (vanligtvis: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Tokenslutpunkt:

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

Exempelbegäran (url):

    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'

Svar:

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

Swagger-gränssnittet innehåller ett interaktivt gränssnitt för att testa API:er utan att behöva skriva kod. Använd funktionen Prova för att anropa och testa generera Forms Communication API ​ för PDF.

1. Navigera till Forms Communication API Reference och öppna Forms Communication API -dokumentationen i webbläsaren.

2. Expandera avsnittet Dokumentgenerering och välj Skapar ett ifyllbart PDF-formulär från en XDP- eller PDF-mall, eventuellt med datasammanfogning.

3. Klicka på Testa i den högra rutan.

   

4. Ange följande värden:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Avsnitt	Parameter	Värde
   bucket	AEM, instans	AEM-instansnamn utan Adobe-domännamn (.adobeaemcloud.com) Använd till exempel pXXXXX-eYYYYY som bucket.
   Dokumentskydd	Bearer Token	Använd åtkomsttoken från autentiseringsuppgiften OAuth Server-to-Server för Adobe Developer Console Project
   Brödtext	mall	Överför en XDP för att generera PDF-formuläret. Du kan till exempel använda den här XDP för att generera en PDF.
   Brödtext	data	En valfri XML-fil som innehåller de data som ska sammanfogas med mallen för att generera ett förfyllt PDF-formulär. Du kan till exempel använda den här XML för att skapa en PDF.
   Parametrar	X-Adobe-Accept-Experimental	1

5. Klicka på Skicka för att anropa API:t

   

6. Kontrollera svaret på fliken Svar:

   • Om svarskoden är 200 innebär det att PDF har skapats.
   • Om svarskoden är 400 betyder det att parametrarna för begäran är ogiltiga eller har fel format.
   • Om svarskoden är 500 betyder det att det finns ett internt serverfel.
   • Om svarskoden är 403 betyder det att det finns ett auktoriseringsfel.

   I det här fallet är svarskoden 200, vilket betyder att PDF har skapats:

   

   Nu kan du hämta den skapade PDF med knappen Hämta och visa den i PDF Viewer:

   

   note note
   NOTE
   I testsyfte kan du även använda Postman, curl eller någon annan REST-klient för att anropa AEM API:er.

Utveckla ett Node.js-program för att generera ett ifyllbart PDF-formulär från en XDP-mall och en XML-datafil med Document Services API

Förutsättningar

• Node.js är installerat på datorn
• Aktiv AEM as a Cloud Service-instans
• Bearer-token för API-autentisering från Adobe Developer Console
• Exempel på XDP-fil: ClosingForm.xdp
• XML-exempelfil: ClosingForm.xml

Så här utvecklar du programmet Node.js:

Steg 1: Skapa ett nytt Node.js-projekt

Öppna cmd/terminal och kör nedanstående kommandon:

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

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

Steg 2: Installera nödvändiga beroenden

Installera biblioteken node-fetch, dotenv och form-data om du vill göra HTTP-begäranden, läsa miljövariabler respektive hantera formulärdata.

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

Steg 3: Uppdatera package.json

1. Öppna cmd/terminal och kör kommandot:

   code language-bash
   code .

   

   Det öppnar projektet i kodredigeraren.

2. Uppdatera filen package.json för att lägga till type i module.

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

   

Steg 4: Skapa en .env-fil

1. Skapa en .env-fil på rotnivån för ett projekt

2. Lägg till följande konfiguration och ersätt platshållarna med de faktiska värdena från ADC-projektets autentiseringsuppgifter för OAuth Server-till-server.

   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
   Du kan kopiera CLIENT_ID, CLIENT_SECRET och SCOPES från Adobe Developer Console-projektet.

Steg 5: Skapa src/index.js

1. Skapa filen index.js på projektets rotnivå
2. Lägg till följande kod och ersätt platshållarna med de faktiska värdena:

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

Steg 6: Kör programmet

node src/index.js

PDF skapas i mappen demo-nodejs-generate-pdf. Navigera till mappen för att hitta den genererade filen generatedForm.pdf.