Chamar APIs do AEM Forms Communications usando a autenticação de servidor para servidor do OAuth

1. Na página Visão geral do programa

2. Clique em "Ambientes" no menu do lado esquerdo. É possível ver uma lista de todos os ambientes

3. Clique no nome do ambiente específico para exibir os detalhes

   

1. Na página Visão geral do programa

2. Localize a seção Ambientes

3. Clique em "Mostrar tudo" para exibir todos os ambientes

4. Clique no menu de reticências (…) ao lado do ambiente

5. Selecione "Exibir Detalhes"

   

1. Na seção Início rápido, clique em Criar novo projeto

2. Um novo projeto é criado com um nome padrão

   

3. Clique em Editar projeto no canto superior direito

   

4. Forneça um nome significativo (por exemplo, "formsproject")

5. Clique em Salvar

   

1. Clique em Todos os projetos da Adobe Developer Console

   

2. Localize o projeto e clique em para abri-lo.

   

Gerar tokens de acesso manualmente no Adobe Developer Console:

1. Clique no botão "Gerar token de acesso" na seção API do projeto

2. Copiar o token de acesso gerado

   

Gerar tokens de forma programática usando a API do Adobe IMS:

Credenciais necessárias:

• ID do cliente
• Segredo do cliente
• Escopos (normalmente: openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Ponto de Extremidade do Token:

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

Solicitação de Exemplo (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'

Resposta:

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

A interface do Swagger fornece uma interface interativa para APIs de teste sem gravar código. Use o recurso Experimentar para invocar e testar a API de Comunicação do Forms gerar PDF.

1. Navegue até Referência da API de Comunicação da Forms e abra a documentação da API de Comunicação da Forms em seu navegador.

2. Expanda a seção Geração de Documento e selecione Gera um formulário do PDF preenchível a partir de um modelo XDP ou PDF, opcionalmente com a mesclagem de dados.

3. No painel direito, clique em Experimente.

   

4. Insira os seguintes valores:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Seção	Parâmetro	Valor
   balde	Instância do AEM	Nome da instância do AEM sem o nome de domínio do Adobe (.adobeaemcloud.com) Por exemplo, use pXXXXX-eYYYYY como bucket.
   Segurança	Token de portador	Usar o token de acesso da credencial de servidor para servidor OAuth do projeto do Adobe Developer Console
   Corpo	modelo	Carregue um XDP para gerar o formulário do PDF. Por exemplo, você pode usar este XDP para gerar um PDF.
   Corpo	dados	Um arquivo XML opcional que contém os dados a serem mesclados com o modelo para gerar um formulário PDF pré-preenchido. Por exemplo, você pode usar este XML para gerar um PDF.
   Parâmetros	X-Adobe-Accept-Experimental	1

5. Clique em Enviar para invocar a API

   

6. Verifique a resposta na guia Resposta:

   • Se o código de resposta for 200, significa que o PDF foi criado com êxito.
   • Se o código de resposta for 400, significa que os parâmetros da solicitação são inválidos ou malformados.
   • Se o código de resposta for 500, significa que há um erro interno do servidor.
   • Se o código de resposta for 403, significa que há um erro de autorização.

   Nesse caso, o código de resposta é 200, isso significa que o PDF foi gerado com êxito:

   

   Agora você pode baixar o PDF criado usando o botão Baixar e exibi-lo no visualizador do PDF:

   

   note note
   NOTE
   Para fins de teste, você também pode usar o Postman, curl ou qualquer outro cliente REST para invocar as APIs do AEM.

Desenvolva um aplicativo Node.js para gerar um formulário do PDF preenchível a partir de um modelo XDP e um arquivo de dados XML usando a API de Serviços de Documento

Pré-requisitos

• Node.js instalado em seu sistema
• Instância ativa do AEM as a Cloud Service
• Token de portador para autenticação de API do Adobe Developer Console
• Arquivo XDP de Exemplo: ClosingForm.xdp
• Arquivo XML de Exemplo: ClosingForm.xml

Para desenvolver o aplicativo Node.js, siga o passo a passo do desenvolvimento:

Etapa 1: Criar um novo projeto Node.js

Abra o cmd/terminal e execute os comandos abaixo:

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

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

Etapa 2: Instalar Dependências Necessárias

Instale as bibliotecas node-fetch, dotenv e form-data para fazer solicitações HTTP, ler variáveis de ambiente e manipular dados de formulário, respectivamente.

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

Etapa 3: atualizar package.json

1. Abra o cmd/terminal e execute o comando:

   code language-bash
   code .

   

   Ele abre o projeto no editor de código.

2. Atualize o arquivo package.json para adicionar type a module.

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

   

Etapa 4: Criar um Arquivo .env

1. Criar arquivo .env no nível raiz de um projeto

2. Adicione a configuração a seguir e substitua os espaços reservados pelos valores reais da credencial servidor a servidor OAuth do projeto 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
   Você pode copiar o CLIENT_ID, CLIENT_SECRET e SCOPES do projeto do Adobe Developer Console.

Etapa 5: Criar src/index.js

1. Criar arquivo index.js no nível raiz do projeto
2. Adicione o código a seguir e substitua os espaços reservados pelos valores reais:

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

Etapa 6: Executar o Aplicativo

node src/index.js

O PDF é criado na pasta demo-nodejs-generate-pdf. Navegue até a pasta para localizar o arquivo gerado chamado generatedForm.pdf.