Richiama le API di comunicazione di AEM Forms tramite autenticazione server-to-server OAuth

1. Nella pagina Panoramica del programma

2. Fare clic su "Ambienti" nel menu a sinistra. Puoi visualizzare un elenco di tutti gli ambienti

3. Fai clic sul nome dell’ambiente specifico per visualizzare i dettagli

   

1. Nella pagina Panoramica del programma

2. Individua la sezione Ambienti

3. Fai clic su "Mostra tutto" per visualizzare tutti gli ambienti

4. Fai clic sul menu puntini di sospensione (…) accanto all'ambiente

5. Selezionare "Visualizza dettagli"

   

1. Dalla sezione Guida rapida, fai clic su Crea nuovo progetto

2. Viene creato un nuovo progetto con un nome predefinito

   

3. Fai clic su Modifica progetto nell'angolo superiore destro

   

4. Fornisci un nome significativo (ad esempio, "formsproject")

5. Fai clic su Salva

   

1. Fai clic su Tutti i progetti da Adobe Developer Console

   

2. Individua il progetto e fai clic su per aprirlo.

   

Generare manualmente i token di accesso in Adobe Developer Console:

1. Fai clic sul pulsante "Genera token di accesso" nella sezione API del progetto

2. Copia il token di accesso generato

   

Genera i token a livello di programmazione utilizzando l'API Adobe IMS:

Credenziali richieste:

• ID client
• Segreto client
• Ambiti (in genere: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Endpoint token:

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

Richiesta di esempio (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'

Risposta:

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

L'interfaccia utente Swagger fornisce un'interfaccia interattiva per testare le API senza scrivere codice.Utilizzare la funzionalità Prova per richiamare e testare l'API di comunicazione Forms genera PDF.

1. Passa a Riferimento API di comunicazione Forms e apri la documentazione API di comunicazione Forms nel browser.

2. Espandere la sezione Generazione documento e selezionare Genera un modulo PDF compilabile da un modello XDP o PDF, facoltativamente con unione dati.

3. Nel riquadro destro fare clic su Prova.

   

4. Immetti i seguenti valori:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Sezione	Parametro	Valore
   bucket	istanza AEM	Nome dell'istanza di AEM senza il nome di dominio di Adobe (.adobeaemcloud.com). Utilizzare ad esempio pXXXXX-eYYYYY come bucket.
   Protezione	Token Bearer	Utilizza il token di accesso dalle credenziali server-to-server OAuth di Adobe Developer Console Project
   Corpo testo	Modello	Carica un XDP per generare il modulo PDF. Ad esempio, puoi utilizzare questo XDP per generare un PDF.
   Corpo testo	dati	File XML facoltativo contenente i dati da unire al modello per generare un modulo PDF precompilato. È ad esempio possibile utilizzare questo XML per generare un PDF.
   Parametri	X-Adobe-Accept-Experimental	1

5. Fai clic su Invia per richiamare l'API

   

6. Controlla la risposta nella scheda Risposta:

   • Se il codice di risposta è 200, significa che il PDF è stato creato correttamente.
   • Se il codice di risposta è 400, significa che i parametri di richiesta non sono validi o non sono corretti.
   • Se il codice di risposta è 500, significa che si è verificato un errore interno del server.
   • Se il codice di risposta è 403, significa che si è verificato un errore di autorizzazione.

   In questo caso, il codice di risposta è 200, significa che il PDF è stato generato correttamente:

   

   Ora puoi scaricare il PDF creato utilizzando il pulsante Scarica e visualizzarlo nel visualizzatore PDF:

   

   note note
   NOTE
   A scopo di test, puoi anche utilizzare Postman, curl o qualsiasi altro client REST per richiamare le API di AEM.

Sviluppa un'applicazione Node.js per generare un modulo PDF compilabile da un modello XDP e un file di dati XML utilizzando l'API Document Services

Prerequisiti

• Node.js installato nel sistema
• Istanza AEM as a Cloud Service attiva
• Token Bearer per l’autenticazione API da Adobe Developer Console
• File XDP di esempio: ClosingForm.xdp
• File XML di esempio: ClosingForm.xml

Per sviluppare l’applicazione Node.js, segui lo sviluppo passo passo:

Passaggio 1: creare un nuovo progetto Node.js

Apri il comando/terminale ed esegui i seguenti comandi:

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

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

Passaggio 2: Installare Le Dipendenze Richieste

Installa le librerie node-fetch, dotenv e form-data per effettuare richieste HTTP, leggere le variabili di ambiente e gestire rispettivamente i dati del modulo.

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

Passaggio 3: aggiornare package.json

1. Apri il comando/terminale ed esegui il comando:

   code language-bash
   code .

   

   Apre il progetto nell’editor di codice.

2. Aggiornare il file package.json per aggiungere type a module.

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

   

Passaggio 4: creare un file .env

1. Creare un file .env a livello di directory principale di un progetto

2. Aggiungi la seguente configurazione e sostituisci i segnaposto con i valori effettivi delle credenziali server-to-server OAuth del progetto ADC.

   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
   È possibile copiare CLIENT_ID, CLIENT_SECRET e SCOPES dal progetto Adobe Developer Console.

Passaggio 5: creare src/index.js

1. Crea il file index.js a livello di directory principale del progetto
2. Aggiungi il seguente codice e sostituisci i segnaposto con i valori effettivi:

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

Passaggio 6: eseguire l'applicazione

node src/index.js

PDF creato nella cartella demo-nodejs-generate-pdf. Passare alla cartella per trovare il file generato denominato generatedForm.pdf.