Automatiser les mises à jour de feuilles de calcul est un besoin courant lors de la création de services web axés sur les données ou de pipelines de reporting. Le GroupDocs.Editor Cloud SDK for Node.js vous permet de modifier un fichier Excel dans Node.js via REST avec seulement quelques lignes de code. Dans ce tutoriel, vous verrez comment configurer le SDK, charger un classeur XLSX, modifier une cellule, enregistrer les modifications et obtenir le même résultat en utilisant des appels cURL bruts. Nous abordons également les fonctionnalités clés, les options de configuration et les considérations de performance pour vous aider à intégrer l’édition d’Excel de manière efficace.

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);
  1. 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);
  1. 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);
  1. 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";
}
  1. 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.

  1. 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"

  1. 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" }
               ]
           }
         }'

  2. 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