Configuration de l’accès serveur à serveur OAuth pour les API de communication AEM Forms

1. Sur la page Aperçu du programme

2. Cliquez sur « Environnements » dans le menu de gauche. Vous pouvez voir une liste de tous les environnements

3. Cliquez sur le nom de l’environnement pour en afficher les détails

   

1. Sur la page Aperçu du programme

2. Recherchez la section Environnements

3. Cliquez sur « Tout afficher » pour afficher tous les environnements

4. Cliquez sur le menu points de suspension (…) en regard de l’environnement

5. Sélectionnez « Afficher les détails »

   

1. Dans la section Démarrage rapide, cliquez sur Créer un projet

2. Un nouveau projet est créé avec un nom par défaut

   

3. Cliquez sur Modifier le projet dans le coin supérieur droit

   

4. Fournissez un nom significatif (par exemple, « projet de formulaire »).

5. Cliquer sur Enregistrer

   

1. Cliquez sur Tous les projets dans le Adobe Developer Console

   

2. Recherchez votre projet et cliquez pour l’ouvrir.

   

Générez manuellement les jetons d’accès dans Adobe Developer Console :

1. Cliquez sur le bouton Générer un jeton d’accès » dans la section API de votre projet

2. Copier le jeton d’accès généré

   

Générez des jetons par programmation à l’aide de l’API Adobe IMS :

Informations d’identification requises :

• ID client
• Secret client
• Portées (généralement : openid, AdobeID, read_organizations, additional_info.projectedProductContext, read_pc.dma_aem_cloud, aem.document)

Point d’entrée du jeton :

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

Exemple de requête (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'

Réponse:

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

L’interface utilisateur Swagger fournit une interface interactive pour tester les API sans écrire de code. Utilisez la fonctionnalité Essayer pour appeler et tester l’API de communication Forms générer PDF.

1. Accédez à Référence de l’API de communication Forms puis ouvrez la documentation de l’API de communication Forms dans votre navigateur.

2. Développez la section Génération de documents et sélectionnez ​ Génère un formulaire PDF à remplir à partir d’un modèle XDP ou PDF, éventuellement avec fusion des données.

3. Dans le volet de droite, cliquez sur Essayer.

   

4. Saisissez les valeurs suivantes :

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Section	Paramètre	Valeur.
   compartiment	Instance AEM	Nom de l’instance AEM sans le nom de domaine Adobe (.adobeaemcloud.com) Par exemple, utilisez pXXXXX-eYYYYY comme compartiment.
   Sécurité	Jeton porteur	Utilisez le jeton d’accès ​ à partir des informations d’identification OAuth de serveur à serveur du projet Adobe Developer Console
   Corps	template	Chargez un fichier XDP pour générer le formulaire PDF. Par exemple, vous pouvez utiliser ce XDP pour générer un PDF.
   Corps	data	Fichier XML facultatif contenant les données à fusionner avec le modèle pour générer un formulaire PDF prérempli. Par exemple, vous pouvez utiliser ce XML pour générer un PDF.
   Paramètres	X-Adobe-Accept-Experimental	1

5. Cliquez sur Envoyer pour appeler l’API

   

6. Vérifiez la réponse dans l’onglet Réponse :

   • Si le code de réponse est 200, cela signifie que le PDF a été créé avec succès.
   • Si le code de réponse est 400, cela signifie que les paramètres de requête sont non valides ou incorrects.
   • Si le code de réponse est 500, cela signifie qu’il existe une erreur de serveur interne.
   • Si le code de réponse est 403, cela signifie qu’il existe une erreur d’autorisation.

   Dans ce cas, le code de réponse est 200, ce qui signifie que le PDF a bien été généré :

   

   Vous pouvez désormais télécharger le PDF créé à l’aide du bouton Télécharger et l’afficher dans la visionneuse PDF :

   

   note note
   NOTE
   À des fins de test, vous pouvez également utiliser Postman, curl ou tout autre client REST pour appeler les API AEM.

Développez une application Node.js pour générer un formulaire PDF à remplir à partir d’un modèle XDP et d’un fichier de données XML à l’aide de l’API Document Services

Conditions préalables

• Node.js installé sur votre système
• Instance AEM as a Cloud Service active
• Jeton porteur pour l’authentification de l’API à partir de Adobe Developer Console
• Exemple de fichier XDP : ClosingForm.xdp
• Exemple de fichier XML : ClosingForm.xml

Pour développer l’application Node.js, procédez comme suit :

Étape 1 : créer un projet Node.js

Ouvrez le cmd/terminal et exécutez les commandes ci-dessous :

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

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

Étape 2 : Installer les dépendances requises

Installez les bibliothèques node-fetch, dotenv et form-data pour effectuer des requêtes HTTP, lire des variables d’environnement et gérer les données de formulaire, respectivement.

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

Étape 3 : mettre à jour package.json

1. Ouvrez le cmd/terminal et exécutez la commande :

   code language-bash
   code .

   

   Le projet s’ouvre alors dans l’éditeur de code.

2. Mettez à jour le fichier package.json pour ajouter le type à module.

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

   

Étape 4 : créer un fichier .env

1. Créer un fichier .env au niveau racine d’un projet

2. Ajoutez la configuration suivante et remplacez les espaces réservés par les valeurs réelles des informations d’identification OAuth de serveur à serveur du projet 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
   Vous pouvez copier les CLIENT_ID, CLIENT_SECRET et SCOPES à partir du projet Adobe Developer Console.

Étape 5 : Créer src/index.js

1. Créer index.js fichier au niveau racine du projet
2. Ajoutez le code suivant et remplacez les espaces réservés par les valeurs réelles :

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

Étape 6 : exécuter l’application

node src/index.js

Le PDF est créé dans le dossier demo-nodejs-generate-pdf . Accédez au dossier pour trouver le fichier généré nommé generatedForm.pdf.