Invocar las API de comunicaciones de AEM Forms mediante la autenticación de servidor a servidor OAuth

1. En la página Resumen del programa

2. Haga clic en "Entornos" en el menú del lado izquierdo. Puede ver una lista de todos los entornos

3. Haga clic en el nombre de entorno específico para ver los detalles

   

1. En la página Resumen del programa

2. Busque la sección Entornos

3. Haga clic en "Mostrar todo" para ver todos los entornos

4. Haga clic en el menú de puntos suspensivos (…) que está junto al entorno

5. Seleccionar "Ver detalles"

   

1. En la sección Inicio rápido, haga clic en Crear nuevo proyecto

2. Se crea un nuevo proyecto con un nombre predeterminado

   

3. Haga clic en Editar proyecto en la esquina superior derecha

   

4. Proporcione un nombre significativo (por ejemplo, "formsproject")

5. Haga clic en Guardar.

   

1. Haga clic en Todos los proyectos desde Adobe Developer Console

   

2. Busque el proyecto y haga clic en para abrirlo.

   

Genere los tokens de acceso manualmente en Adobe Developer Console:

1. Haga clic en el botón "Generar token de acceso" en la sección de API del proyecto

2. Copiar el token de acceso generado

   

Generar tokens mediante programación usando la API Adobe IMS:

Credenciales requeridas:

• ID del cliente
• Secreto de cliente
• Ámbitos (normalmente: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Extremo de token:

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

Solicitud de ejemplo (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'

Respuesta:

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

La interfaz de usuario de Swagger proporciona una interfaz interactiva para probar las API sin escribir código. Use la característica Probarla para invocar y probar la API de comunicación de Forms generate PDF.

1. Vaya a Referencia de la API de comunicación de Forms y abra la documentación de la API de comunicación de Forms en su explorador.

2. Expanda la sección Generación de documentos y seleccione Genera un formulario PDF que se puede rellenar a partir de una plantilla XDP o PDF, opcionalmente con la combinación de datos.

3. En el panel derecho, haga clic en Probar.

   

4. Introduzca los siguientes valores:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Sección	Parámetro	Valor
   cubo	Instancia de AEM	Nombre de instancia de AEM sin el nombre de dominio de Adobe (.adobeaemcloud.com). Por ejemplo, use pXXXXX-eYYYYY como contenedor.
   Seguridad	Token de portador	Utilice el token de acceso de la credencial de servidor a servidor OAuth del proyecto de Adobe Developer Console
   Cuerpo	plantilla	Cargue un XDP para generar el formulario de PDF. Por ejemplo, puede usar este XDP para generar un PDF.
   Cuerpo	data	Un archivo XML opcional que contiene los datos que se van a combinar con la plantilla para generar un formulario PDF rellenado previamente. Por ejemplo, puede usar este XML para generar un PDF.
   Parámetros	X-Adobe-Accept-Experimental	1

5. Haga clic en Enviar para invocar la API

   

6. Compruebe la respuesta en la ficha Respuesta:

   • Si el código de respuesta es 200, significa que PDF se ha creado correctamente.
   • Si el código de respuesta es 400, significa que los parámetros de la solicitud no son válidos o tienen un formato incorrecto.
   • Si el código de respuesta es 500, significa que hay un error interno del servidor.
   • Si el código de respuesta es 403, significa que hay un error de autorización.

   En este caso, el código de respuesta es 200, lo que significa que PDF se ha generado correctamente:

   

   Ahora puedes descargar el PDF creado con el botón Descargar y verlo en el visor de PDF:

   

   note note
   NOTE
   Para hacer pruebas, también puede usar Postman, curl o cualquier otro cliente REST para invocar las API de AEM.

Desarrolle una aplicación Node.js para generar un formulario PDF que se pueda rellenar a partir de una plantilla XDP y un archivo de datos XML mediante la API de servicios de documentos

Requisitos previos

• Node.js instalado en el sistema
• Instancia de AEM as a Cloud Service activa
• Token de portador para la autenticación de API desde Adobe Developer Console
• Archivo XDP de muestra: ClosingForm.xdp
• Archivo XML de ejemplo: ClosingForm.xml

Para desarrollar la aplicación Node.js, siga el desarrollo paso a paso:

Paso 1: Crear un nuevo proyecto de Node.js

Abra cmd/terminal y ejecute los siguientes comandos:

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

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

Paso 2: Instalar Dependencias Necesarias

Instale las bibliotecas node-fetch, dotenv y form-data para realizar solicitudes HTTP, leer variables de entorno y administrar datos de formulario respectivamente.

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

Paso 3: actualizar package.json

1. Abra cmd/terminal y ejecute el comando:

   code language-bash
   code .

   

   Se abre el proyecto en el editor de código.

2. Actualice el archivo package.json para agregar type a module.

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

   

Paso 4: Crear un archivo .env

1. Crear archivo .env en el nivel raíz de un proyecto

2. Agregue la siguiente configuración y reemplace los marcadores de posición con los valores reales de la credencial de servidor a servidor OAuth del proyecto 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
   Puede copiar CLIENT_ID, CLIENT_SECRET y SCOPES del proyecto de Adobe Developer Console.

Paso 5: Crear src/index.js

1. Crear index.js archivo en el nivel raíz del proyecto
2. Agregue el siguiente código y reemplace los marcadores de posición por los valores reales:

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

Paso 6: Ejecute la aplicación

node src/index.js

El PDF se crea en la carpeta demo-nodejs-generate-pdf. Vaya a la carpeta para buscar el archivo generado denominado generatedForm.pdf.