Редагування файлу Excel у Node.js через REST - 5‑кроковий посібник

1. Встановіть SDK та налаштуйте облікові дані: Вкажіть ваш CLIENT_ID і CLIENT_SECRET, щоб бібліотека могла автентифікуватися в 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. Завантажте Excel‑книгу для редагування: Використайте EditDocumentRequest для відкриття файлу, що зберігається у вашому хмарному сховищі.

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

3. Отримайте перший лист і знайдіть цільову клітинку: SDK повертає об’єкт document, який містить листи та клітинки.

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

4. Оновити або створити значення комірки: Змініть вміст комірки A1 (або додайте її, якщо вона не існує).

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. Збережіть відредаговану книгу назад у сховище: Вкажіть outputPath і викличте 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);

Для повного списку класів і методів перегляньте довідку API.

Редагування файлу Excel у Node.js через REST - Повний приклад коду

У наведеному прикладі демонструється, як редагувати файл Excel у Node.js через REST, використовуючи 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);
});

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили всі шляхи до файлів та значення конфігурації відповідно до вашого реального середовища, перевірте, що всі необхідні залежності правильно встановлені, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Оновлення листа XLSX за допомогою REST API у Node.js через cURL

Нижче наведено швидкий покроковий огляд тієї ж операції за допомогою чистих HTTP‑викликів. Замініть заповнювачі фактичними обліковими даними та іменами файлів.

1. Отримайте токен доступу

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"

Відповідь містить access_token.

2. Завантажте вихідний файл XLSX

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

3. Редагувати робочу книгу (змінити клітинку 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. Завантажте відредагований файл

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

Для отримання докладнішої інформації про корисне навантаження запитів, перегляньте офіційну документацію API.

Вимоги та налаштування для GroupDocs.Editor Cloud SDK для Node.js

Щоб почати використовувати SDK, вам потрібен Node.js 14 або новіший і обліковий запис GroupDocs Cloud.

npm install groupdocs-editor-cloud

Ви також можете завантажити останній пакет зі сторінки випуску. Після встановлення створіть client_id і client_secret у вашій панелі управління GroupDocs Cloud і збережіть їх у безпеці.

Що робить GroupDocs.Editor Cloud SDK for Node.js ідеальним для модифікації листків Excel

• Повна підтримка XLSX - Завантажуйте, редагуйте та зберігайте книги, зберігаючи формули, стилі та перевірку даних.
• Редагування на рівні клітинки - Програмно отримуйте доступ до окремих клітинок, рядків або стовпців, що ідеально підходить для оновлення звітів або панелей інструментів.
• Інтеграція з хмарним сховищем - Працюйте безпосередньо з файлами, збереженими в GroupDocs Cloud, без їхнього завантаження локально.
• Безпечне REST‑з’єднання - Всі операції виконуються через HTTPS, а SDK самостійно керує токенами.

Для більш глибокого занурення зверніться до документації.

Тонке налаштування параметрів редагування Excel у GroupDocs.Editor Cloud

SDK надає кілька параметрів, які дозволяють вам контролювати, як зберігається відредагована робоча книга.

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

• outputPath - Шлях призначення у хмарному сховищі.
• compressionLevel - Зменшити розмір файлу для великих робочих книг (доступно в довідці API).
• password - Захистити отриманий файл паролем, якщо це потрібно.

Налаштуйте ці параметри, щоб відповідати вимогам безпеки та продуктивності вашого проєкту.

Питання продуктивності при редагуванні робочих книг XLSX через REST

1. Повторне використання об’єкта конфігурації - Створення нового Configuration для кожного запиту створює накладні витрати. Тримайте один екземпляр протягом усього часу роботи вашого застосунку.
2. Пакетне оновлення клітинок - Якщо потрібно змінити багато клітинок, зберіть їх у масив і надішліть один запит на редагування замість кількох викликів.
3. Обмежте розмір листа - Дуже великі листи збільшують споживання пам’яті. За можливості розділіть дані на кілька листів.
4. Уникайте зайвих збережень - Викликайте saveDocument лише після застосування всіх необхідних змін, щоб зменшити операції вводу/виводу.

Висновок

Редагування файлу Excel у Node.js через REST стає простим завдяки GroupDocs.Editor Cloud SDK for Node.js. Ви можете програмно завантажити робочу книгу, змінити клітинки та зберегти результат, використовуючи лише кілька викликів API або прості команди cURL. Хмарна архітектура SDK усуває необхідність локальних встановлень Office і масштабується разом із навантаженням вашого застосунку. Для продакшн‑розгортань придбайте ліцензію, що відповідає вашому патерну використання, а також ви можете отримати тимчасову ліцензію для тестування зі сторінки тимчасової ліцензії. Почніть інтегрувати редагування Excel вже сьогодні та оптимізуйте ваші конвеєри обробки даних.

Питання та відповіді

Як відредагувати файл Excel у Node.js через REST без написання власного HTTP коду?
Використовуйте GroupDocs.Editor Cloud SDK for Node.js, який абстрагує REST‑виклики і дозволяє редагувати файл Excel у Node.js через REST за допомогою простих викликів методів.

Чи можу я оновити лист XLSX за допомогою REST api Node.js для великих файлів?
Так. SDK передає дані потоково та підтримує пакетні оновлення, що робить його придатним для великих робочих книг. Налаштуйте compressionLevel та пакетні зміни клітинок для підвищення продуктивності.

Який найкращий спосіб програмно змінювати лист Excel у Node.js?
Працюйте з об’єктами worksheet та cell, які повертає editDocument. Це дає вам повний контроль над рядками, стовпцями та значеннями клітинок, не виходячи зі середовища Node.js.

Де я можу знайти інформацію про ціни та ліцензування?
Всі деталі ліцензування, включаючи рівні цін та тимчасову ліцензію для оцінки, доступні на сторінці тимчасової ліцензії.

Читати далі

• Редагування Excel‑таблиці через REST у Java
• Редагування Excel‑таблиці за допомогою REST API у Python
• Кращі практики розробки CSV‑редактора у Java