AEM Forms Communications API's aanroepen met OAuth Server-to-Server-verificatie

1. Op de pagina van het Overzicht van het Programma

2. Klik "Milieu's" in het linkerzijmenu. U ziet een lijst met alle omgevingen

3. Klik op de naam van de specifieke omgeving om details weer te geven

   

1. Op de pagina van het Overzicht van het Programma

2. Bepaal de plaats van de sectie van Milieu's

3. Klik "tonen allen" om alle milieu's te bekijken

4. Klik het weglatingsmenu (…) naast het milieu

5. Selecteer "Details van de Mening"

   

1. Van de Snelle sectie van het Begin, klik creeer nieuw project

2. Een nieuw project wordt gecreeerd met een standaardnaam

   

3. Klik uitgeven project in de hoogste juiste hoek

   uit

4. Geef een betekenisvolle naam op (bijvoorbeeld "formsproject")

5. Klik sparen

   

1. Klik Alle Projecten van Adobe Developer Console

   

2. Zoek uw project en klik om het te openen.

   

Handmatig toegangstokens genereren in Adobe Developer Console:

1. Klik "produceer toegangstoken" knoop in de API van uw project sectie

2. Het gegenereerde toegangstoken kopiëren

   

Genereer programmatically tokens gebruikend ​ IMS van Adobe ​ API:

Vereiste Referenties:

• Client-id
• Clientgeheim
• Bereiken (doorgaans: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Symbolische Eindpunt:

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

Verzoek van de Steekproef (krulling):

    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'

Reactie:

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

De wagger UI verstrekt een interactieve interface voor het testen APIs zonder code te schrijven.Gebruik probeert het eigenschap om ​ te roepen en te testen produceert de Communicatie API van PDF ​ Forms.

1. Navigeer aan ​ Communicatie API Verwijzing van Forms ​ en open de ​ Communicatie API van Forms ​ documentatie in uw browser.

2. Breid de sectie van de Generatie van het 0} Document uit en selecteer produceert een invulbare vorm van PDF van een malplaatje XDP of van PDF, naar keuze met gegevens die ​ samenvoegen.

3. In de juiste ruit, klik probeert het.

   

4. Voer de volgende waarden in:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Sectie	Parameter	Waarde
   emmer	AEM-exemplaar	AEM-instantienaam zonder de Adobe-domeinnaam (.adobeaemcloud.com). Gebruik bijvoorbeeld pXXXXX-eYYYYY als emmertje.
   Beveiliging	Dragertoken	Gebruik het ​ toegangstoken van de Server-aan-Server referentie van het Project van Adobe Developer Console ​
   Lichaam	template	Upload een XDP om het PDF-formulier te genereren. Bijvoorbeeld, kunt u ​ dit XDP ​ gebruiken om een PDF te produceren.
   Lichaam	data	Een optioneel XML-bestand met de gegevens die met de sjabloon moeten worden samengevoegd om een voorgevuld PDF-formulier te genereren. Bijvoorbeeld, kunt u ​ dit XML ​ gebruiken om een PDF te produceren.
   Parameters	X-Adobe-Accept-Experimental	1

5. Klik verzenden om API aan te halen

   

6. Controleer de reactie in het lusje van de Reactie:

   • Als de antwoordcode 200 is, betekent dit dat de PDF is gemaakt.
   • Als de antwoordcode 400 is, betekent dit dat de aanvraagparameters ongeldig of onjuist zijn geformuleerd.
   • Als de antwoordcode 500 is, betekent dit dat er een interne serverfout is.
   • Als de antwoordcode 403 is, betekent dit dat er een machtigingsfout is.

   In dit geval is de antwoordcode 200 , hetgeen betekent dat de PDF is gegenereerd:

   

   Nu, kunt u ​ gecreeerde PDF ​ downloaden gebruikend de 3} knoop van de Download {en het bekijken in de kijker van PDF:

   

   note note
   NOTE
   Voor testende doeleinden, kunt u ​ Postman ​, ​ krullen ​, of een andere cliënt van de WEERSTING ook gebruiken om AEM APIs aan te halen.

Ontwikkel een toepassing Node.js om een invulbare vorm van PDF van een XDP malplaatje en een dossier van XML te produceren dat het Document Services API gebruikt

Eerste vereisten

• Knooppunt.js geïnstalleerd op uw systeem
• Active AEM as a Cloud Service-exemplaar
• Dragertoken voor API-verificatie van Adobe Developer Console
• Voorbeeld-XDP-bestand: ​ ClosingForm.xdp ​
• Het Dossier van XML van de steekproef: ​ ClosingForm.xml ​

Als u de toepassing Node.js wilt ontwikkelen, volgt u de stapsgewijze ontwikkeling:

Stap 1: Creeer een Nieuw Project Node.js

Open de cmd/terminal en voer de volgende bevelen uit:

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

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

Stap 2: Installeer Vereiste Afhankelijkheden

Installeer de knoop-haal, dotenv, en vorm-gegevens bibliotheken om HTTP- verzoeken te maken, milieu variabelen te lezen, en vormgegevens respectievelijk te behandelen.

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

Stap 3: Update package.json

1. Open cmd/terminal en stel het bevel in werking:

   code language-bash
   code .

   

   Het opent het project in de coderedacteur.

2. Werk het package.json -bestand bij om het type to module -bestand toe te voegen.

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

   

Stap 4: Creeer een .env- Dossier

1. .env dossier op het wortelniveau van een project tot stand brengen

2. Voeg de volgende configuratie toe en vervang placeholders met de daadwerkelijke waarden van OAuth van het Project van ADC Server-aan-Server referentie.

   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
   U kunt de CLIENT_ID , CLIENT_SECRET en SCOPES van het Adobe Developer Console-project kopiëren.

Stap 5: Creeer src/index.js

1. index.js -bestand maken op het hoofdniveau van het project
2. Voeg de volgende code toe en vervang de plaatsaanduidingen door de werkelijke waarden:

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

Stap 6: Looppas de Toepassing

node src/index.js

De PDF wordt gemaakt in de map demo-nodejs-generate-pdf . Navigeer naar de map om het gegenereerde bestand met de naam generatedForm.pdf te zoeken.