Exemple complet fonctionnel pour supprimer les objets d’annotation d’un PDF avec REST en Node.JS

Cet exemple montre comment téléverser un PDF, supprimer toutes ses annotations et télécharger le fichier nettoyé en utilisant le GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Note : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Supprimer les annotations PDF via l’API REST en utilisant cURL

Ci-dessous se trouvent les commandes cURL qui exécutent le même flux de travail de suppression d’annotation via les points de terminaison REST de GroupDocs.Annotation Cloud.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Pour une liste complète des points de terminaison et des paramètres, consultez la documentation officielle de l’API.

Comment supprimer les objets d’annotation d’un PDF avec REST en Node.JS fonctionne

1. Configuration de l’authentification - La classe Configuration est instanciée avec votre clientId et clientSecret, créant un contexte authentifié pour tous les appels d’API ultérieurs.

   const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
   

2. Téléchargement de fichier - UploadFileRequest envoie les octets PDF locaux vers le stockage GroupDocs Cloud. La méthode storageApi.uploadFile gère le transfert.

   const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
       path: remoteFilePath,
       file: fileBytes
   });
   await storageApi.uploadFile(uploadRequest);
   

3. Récupération des annotations - GetAnnotationsRequest crée un objet de requête avec une référence FileInfo. L’appel annotationsApi.getAnnotations renvoie une collection d’objets d’annotation, dont les ID sont extraits.

   const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
       fileInfo: fileInfo
   });
   const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
   

4. Suppression des annotations - Si des ID existent, DeleteAnnotationsRequest est rempli et transmis à annotationsApi.deleteAnnotations, qui supprime définitivement les annotations du PDF stocké.

   const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
       fileInfo: fileInfo,
       annotationIds: annotationIds
   });
   await annotationsApi.deleteAnnotations(deleteRequest);
   

5. Téléchargement du PDF nettoyé - Enfin, DownloadFileRequest récupère le fichier mis à jour, et fs.writeFileSync l’écrit sur le système de fichiers local.

   const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
       path: remoteFilePath
   });
   const fileStream = await storageApi.downloadFile(downloadRequest);
   fs.writeFileSync(localOutputPath, fileStream);
   

Pour des définitions détaillées des classes et des méthodes, consultez la référence API.

Installation et configuration GroupDocs.Annotation Cloud SDK for Node.js

Le SDK est distribué sous forme de package npm. Installez‑le avec la commande ci‑dessous, puis requérez‑le dans votre projet.

npm install groupdocs-annotation-cloud

Vous pouvez également télécharger le dernier package directement depuis la page des releases GitHub ou depuis l’URL de téléchargement officielle.

Après l’installation, importez la bibliothèque et créez un objet de configuration comme indiqué dans l’exemple de code :

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Assurez-vous que votre environnement d’exécution répond aux exigences de version de Node.js et que vous disposez d’un compte GroupDocs valide pour obtenir les informations d’identification du client.

Options et paramètres de suppression d’annotation

Le SDK expose plusieurs paramètres que vous pouvez ajuster :

• clientId / clientSecret - Identifiants pour l’authentification OAuth. Définissez‑les dans le constructeur Configuration.
• fileInfo.filePath - Le chemin du PDF dans le stockage GroupDocs Cloud. Modifiez‑le si vous stockez les fichiers dans un autre dossier.
• annotationIds - Un tableau d’ID renvoyés par GetAnnotations. Fournir un sous‑ensemble permet une suppression sélective.

Des paramètres supplémentaires tels que les délais d’attente des requêtes et la configuration du proxy sont disponibles dans la documentation du SDK ; consultez la documentation officielle pour la liste complète.

Meilleures pratiques pour la suppression des annotations PDF via REST

• Valider les ID d’annotation - Vérifiez toujours que les ID que vous prévoyez de supprimer existent ; tenter de supprimer des ID inexistants peut entraîner une erreur 404.
• Utiliser HTTPS - Toutes les appels d’API doivent être effectués via HTTPS afin de protéger vos identifiants et les données du document.
• Gérer les gros fichiers avec des téléchargements fractionnés - Pour les PDF de plus de 100 Mo, privilégiez le point de terminaison de téléchargement multipart pour éviter les dépassements de délai.
• Consigner les réponses de l’API - Enregistrez les ID de requête et les réponses pour les pistes d’audit et faciliter le dépannage.
• Réutiliser les jetons d’accès - Mettez en cache le jeton OAuth jusqu’à son expiration afin de réduire la charge d’authentification.

Questions fréquentes

• Comment m’authentifier avec GroupDocs.Annotation Cloud API ?
  Obtenez un ID client et un secret depuis votre compte GroupDocs, puis demandez un jeton d’accès via le point de terminaison OAuth. Voir la documentation officielle pour plus de détails.

• Puis-je supprimer des annotations spécifiques au lieu de toutes ?
  Oui, fournissez les ID des annotations que vous souhaitez supprimer dans le DeleteAnnotationsRequest. Le SDK renvoie la liste des ID d’annotation après un appel GetAnnotations.

• How can I remove Annotation objects from PDF with REST in Node.JS?
  Utilisez le GroupDocs.Annotation Cloud SDK for Node.js pour appeler le point de terminaison DeleteAnnotations après avoir récupéré les ID des annotations. Le flux complet est présenté dans l’exemple de code et la section cURL de ce guide.

• Quel type de licence est requis pour une utilisation en production ?
  Une licence payante est nécessaire pour la production. Vous pouvez obtenir une licence temporaire depuis la page de licence temporaire lors de l’évaluation.

Lectures complémentaires

• Extraire ou supprimer des annotations d’un PDF à l’aide de l’API REST en Node.js
• Texte barré dans un PDF avec Node.js et l’API REST
• Supprimer les annotations d’un PDF à l’aide de l’API REST en Python

Modifier un fichier Excel dans Node.js via REST - Guide en 5 étapes

1. Installez le SDK et configurez les informations d’identification : Définissez votre CLIENT_ID et CLIENT_SECRET afin que la bibliothèque puisse s’authentifier auprès de GroupDocs Cloud.

const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
const editApi = new GroupDocsEditorCloud.EditApi(config);

2. Charger le classeur Excel pour l’édition : Utilisez EditDocumentRequest pour ouvrir le fichier stocké dans votre stockage cloud.

const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
    fileInfo: new GroupDocsEditorCloud.FileInfo({ filePath: "input.xlsx" })
});
const editResult = await editApi.editDocument(editRequest);

3. Récupérer la première feuille de calcul et localiser la cellule cible : Le SDK renvoie un objet document qui contient des feuilles de calcul et des cellules.

const worksheet = editResult.document.worksheets[0];
let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);

4. Mettre à jour ou créer la valeur de la cellule : Modifiez le contenu de la cellule A1 (ou ajoutez‑le s’il n’existe pas).

if (!targetCell) {
    targetCell = new GroupDocsEditorCloud.Cell({
        rowIndex: 0,
        columnIndex: 0,
        value: "Edited via GroupDocs Editor Cloud"
    });
    worksheet.cells.push(targetCell);
} else {
    targetCell.value = "Edited via GroupDocs Editor Cloud";
}

5. Enregistrez le classeur modifié dans le stockage : Fournissez un outputPath et appelez saveDocument.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({ outputPath: "output.xlsx" });
const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
    documentId: editResult.documentId,
    document: editResult.document,
    saveOptions: saveOptions
});
await editApi.saveDocument(saveRequest);

Pour une liste complète des classes et des méthodes, consultez la référence API.

Modifier un fichier Excel dans Node.js via REST - Exemple de code complet

L’exemple suivant montre comment modifier un fichier Excel dans Node.js via REST en utilisant GroupDocs.Editor Cloud SDK.

const GroupDocsEditorCloud = require("@groupdocs/editor-cloud");

// Replace with your actual GroupDocs Cloud credentials
const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

// Paths for the source Excel file and the edited result
const INPUT_FILE_PATH = "input.xlsx";
const OUTPUT_FILE_PATH = "output.xlsx";

async function editExcel() {
    // Configure the SDK
    const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
    const editApi = new GroupDocsEditorCloud.EditApi(config);

// 1. Load the Excel workbook for editing
    const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
        fileInfo: new GroupDocsEditorCloud.FileInfo({
            filePath: INPUT_FILE_PATH
        })
    });

const editResult = await editApi.editDocument(editRequest);
    const documentId = editResult.documentId;
    const document = editResult.document;

// 2. Retrieve the first worksheet
    const worksheet = document.worksheets[0];

// 3. Update cell A1 (rowIndex = 0, columnIndex = 0) with a new value
    let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);
    if (!targetCell) {
        targetCell = new GroupDocsEditorCloud.Cell({
            rowIndex: 0,
            columnIndex: 0,
            value: "Edited via GroupDocs Editor Cloud"
        });
        worksheet.cells.push(targetCell);
    } else {
        targetCell.value = "Edited via GroupDocs Editor Cloud";
    }

// 4. Save the edited workbook back to storage
    const saveOptions = new GroupDocsEditorCloud.SaveOptions({
        outputPath: OUTPUT_FILE_PATH
    });

const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
        documentId: documentId,
        document: document,
        saveOptions: saveOptions
    });

const saveResult = await editApi.saveDocument(saveRequest);
    console.log(`Edited file saved to: ${saveResult.path}`);
}

// Execute the edit operation
editExcel().catch(error => {
    console.error("Error during Excel editing:", error);
});

Note : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Mettre à jour une feuille XLSX en utilisant l’API REST dans Node.js via cURL

Voici un guide rapide de la même opération en utilisant des appels HTTP bruts. Remplacez les valeurs de substitution par vos informations d’identification et noms de fichiers réels.

1. Obtenir un jeton d’accès

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

La réponse contient access_token.

2. Téléverser le fichier XLSX source

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@input.xlsx"

3. Modifier le classeur (modifier la cellule A1)

   curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{
              "fileInfo": { "filePath": "input.xlsx" },
              "options": {
                  "cells": [
                      { "rowIndex": 0, "columnIndex": 0, "value": "Edited via GroupDocs Editor Cloud" }
                  ]
              }
            }'
   

4. Télécharger le fichier modifié

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.xlsx

Pour plus de détails sur les charges utiles de la requête, consultez la documentation officielle de l’API.

Prérequis et configuration pour GroupDocs.Editor Cloud SDK for Node.js

Pour commencer à utiliser le SDK, vous avez besoin de Node.js 14 ou une version ultérieure et d’un compte GroupDocs Cloud.

npm install groupdocs-editor-cloud

Vous pouvez également télécharger le dernier package depuis la page de publication. Après l’installation, créez un client_id et un client_secret dans votre tableau de bord GroupDocs Cloud et conservez‑les en sécurité.

Ce qui rend GroupDocs.Editor Cloud SDK for Node.js idéal pour modifier les feuilles de calcul Excel

• Full XLSX support - Chargez, modifiez et enregistrez les classeurs tout en préservant les formules, les styles et la validation des données.
• Cell‑level editing - Accédez aux cellules, lignes ou colonnes individuelles de manière programmatique, ce qui est idéal pour mettre à jour les rapports ou les tableaux de bord.
• Cloud storage integration - Travaillez directement avec les fichiers stockés dans GroupDocs Cloud sans les télécharger localement.
• Secure REST communication - Toutes les opérations se déroulent via HTTPS, et le SDK gère la gestion des jetons pour vous.

Pour approfondir, consultez la documentation.

Affiner les options d’édition Excel dans GroupDocs.Editor Cloud

Le SDK expose plusieurs options qui vous permettent de contrôler la façon dont le classeur modifié est enregistré.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({
    outputPath: "output.xlsx",
    // You can also set compression level, password protection, etc.
});

• outputPath - Chemin de destination dans le stockage cloud.
• compressionLevel - Réduire la taille du fichier pour les grands classeurs (disponible dans la référence API).
• password - Protéger le fichier résultant avec un mot de passe si nécessaire.

Ajustez ces paramètres pour correspondre aux exigences de sécurité et de performance de votre projet.

Considérations de performance pour la modification de classeurs XLSX via REST

1. Réutiliser l’objet de configuration - Créer une nouvelle Configuration pour chaque requête ajoute une surcharge. Conservez une instance unique pendant la durée de vie de votre application.
2. Mise à jour groupée des cellules - Si vous devez modifier de nombreuses cellules, regroupez‑les dans un tableau et envoyez une seule requête de modification au lieu de plusieurs appels.
3. Limiter la taille de la feuille de calcul - Les feuilles de calcul très volumineuses augmentent la consommation de mémoire. Envisagez de répartir les données sur plusieurs feuilles lorsque cela est possible.
4. Éviter les sauvegardes inutiles - N’appelez saveDocument qu’après que toutes les modifications requises ont été appliquées afin de réduire les opérations d’E/S.

Conclusion

Editing an Excel file in Node.js via REST becomes straightforward with the GroupDocs.Editor Cloud SDK for Node.js. Vous pouvez charger programmétiquement un classeur, modifier des cellules et enregistrer le résultat en utilisant seulement quelques appels d’API ou de simples commandes cURL. L’architecture cloud du SDK élimine le besoin d’installations locales d’Office et s’adapte à la charge de travail de votre application. Pour les déploiements en production, achetez une licence adaptée à votre modèle d’utilisation, et vous pouvez également obtenir une licence temporaire pour les tests depuis la temporary license page. Commencez à intégrer l’édition Excel dès aujourd’hui et rationalisez vos pipelines de traitement de données.

FAQ

Comment modifier un fichier Excel dans Node.js via REST sans écrire de code HTTP personnalisé ?
Utilisez le GroupDocs.Editor Cloud SDK for Node.js, qui abstrait les appels REST et vous permet de modifier un fichier Excel dans Node.js via REST avec de simples invocations de méthodes.

Puis-je mettre à jour une feuille XLSX en utilisant l’API REST Node.js pour les gros fichiers ?
Oui. Le SDK diffuse les données et prend en charge les mises à jour par lots, ce qui le rend adapté aux classeurs volumineux. Ajustez compressionLevel et les modifications de cellules par lots pour améliorer les performances.

Quelle est la meilleure façon de modifier une feuille de calcul Excel de manière programmatique avec Node.js ?
Travaillez avec les objets worksheet et cell renvoyés par editDocument. Cela vous donne un contrôle complet sur les lignes, les colonnes et les valeurs des cellules sans quitter l’environnement Node.js.

Où puis-je trouver les informations de tarification et de licence ?
Tous les détails de licence, y compris les niveaux de tarification et une licence temporaire pour l’évaluation, sont disponibles sur la page de licence temporaire.

En savoir plus

• Modifier une feuille Excel via REST en Java
• Modifier une feuille Excel en utilisant l’API REST en Python
• Meilleures pratiques pour le développement d’un éditeur CSV en Java