Edit Lembar Excel melalui REST di Node.JS

Mengotomatisasi pembaruan spreadsheet adalah kebutuhan umum saat membangun layanan web berbasis data atau pipeline pelaporan. The GroupDocs.Editor Cloud SDK for Node.js memungkinkan Anda mengedit file Excel di Node.js melalui REST dengan hanya beberapa baris kode. Dalam tutorial ini Anda akan melihat cara mengkonfigurasi SDK, memuat workbook XLSX, memodifikasi sebuah sel, menyimpan perubahan, dan mencapai hasil yang sama menggunakan panggilan cURL mentah. Kami juga membahas fitur utama, opsi konfigurasi, dan pertimbangan kinerja untuk membantu Anda mengintegrasikan penyuntingan Excel secara efisien.

Mengedit File Excel di Node.js melalui REST - Panduan 5 Langkah

Instal SDK dan konfigurasikan kredensial: Tetapkan CLIENT_ID dan CLIENT_SECRET Anda sehingga perpustakaan dapat mengautentikasi dengan 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);

Muat buku kerja Excel untuk diedit: Gunakan EditDocumentRequest untuk membuka file yang disimpan di penyimpanan cloud Anda.

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

Ambil lembar kerja pertama dan temukan sel target: SDK mengembalikan objek document yang berisi lembar kerja dan sel.

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

Perbarui atau buat nilai sel: Ubah konten sel A1 (atau tambahkan jika tidak ada).

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";
}

Simpan buku kerja yang telah diedit kembali ke penyimpanan: Berikan outputPath dan panggil 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);

Untuk daftar lengkap kelas dan metode, lihat referensi API.

Edit File Excel di Node.js via REST - Contoh Kode Lengkap

Contoh berikut menunjukkan cara mengedit file Excel di Node.js melalui REST menggunakan 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);
});

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Perbarui Lembar XLSX Menggunakan REST API di Node.js via cURL

Berikut adalah panduan singkat tentang operasi yang sama menggunakan panggilan HTTP mentah. Ganti nilai placeholder dengan kredensial dan nama file Anda yang sebenarnya.

Dapatkan token akses

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"

Respons berisi access_token.

Unggah file XLSX sumber

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

Edit buku kerja (ubah sel 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" }
               ]
           }
         }'

Unduh file yang telah diedit

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

Untuk detail lebih lanjut tentang payload permintaan, lihat dokumentasi API resmi.

Prasyarat dan Penyiapan untuk GroupDocs.Editor Cloud SDK for Node.js

Untuk mulai menggunakan SDK, Anda memerlukan Node.js 14 atau yang lebih baru dan akun GroupDocs Cloud.

npm install groupdocs-editor-cloud

Anda juga dapat mengunduh paket terbaru dari halaman rilis. Setelah instalasi, buat client_id dan client_secret di dasbor GroupDocs Cloud Anda dan simpan dengan aman.

Apa yang Membuat GroupDocs.Editor Cloud SDK for Node.js Ideal untuk Memodifikasi Lembar Kerja Excel

Full XLSX support - Muat, edit, dan simpan workbook sambil mempertahankan formula, gaya, dan validasi data.
Cell‑level editing - Akses sel, baris, atau kolom secara individual secara programatik, yang sangat cocok untuk memperbarui laporan atau dasbor.
Cloud storage integration - Bekerja langsung dengan file yang disimpan di GroupDocs Cloud tanpa mengunduhnya secara lokal.
Secure REST communication - Semua operasi terjadi melalui HTTPS, dan SDK menangani manajemen token untuk Anda.

Untuk penjelasan lebih mendalam, lihat dokumentasi.

Menyempurnakan Opsi Penyuntingan Excel di GroupDocs.Editor Cloud

SDK menyediakan beberapa opsi yang memungkinkan Anda mengontrol bagaimana workbook yang diedit disimpan.

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

outputPath - Jalur tujuan di penyimpanan cloud.
compressionLevel - Kurangi ukuran file untuk buku kerja besar (tersedia di referensi API).
password - Lindungi file yang dihasilkan dengan kata sandi jika diperlukan.

Sesuaikan pengaturan ini agar sesuai dengan kebutuhan keamanan dan kinerja proyek Anda.

Pertimbangan Kinerja untuk Mengedit Buku Kerja XLSX melalui REST

Reuse the configuration object - Membuat Configuration baru untuk setiap permintaan menambah overhead. Simpan satu instance untuk masa hidup aplikasi Anda.
Batch cell updates - Jika Anda perlu memodifikasi banyak sel, kumpulkan mereka dalam array dan kirim satu permintaan edit alih-alih beberapa panggilan.
Limit worksheet size - Worksheet yang sangat besar meningkatkan konsumsi memori. Pertimbangkan membagi data ke beberapa sheet bila memungkinkan.
Avoid unnecessary saves - Hanya panggil saveDocument setelah semua perubahan yang diperlukan diterapkan untuk mengurangi operasi I/O.

Kesimpulan

Mengedit file Excel di Node.js via REST menjadi mudah dengan GroupDocs.Editor Cloud SDK for Node.js. Anda dapat memuat workbook secara programatik, memodifikasi sel, dan menyimpan hasilnya hanya dengan beberapa panggilan API atau perintah cURL sederhana. Arsitektur berbasis cloud SDK menghilangkan kebutuhan akan instalasi Office lokal dan dapat diskalakan sesuai beban kerja aplikasi Anda. Untuk penyebaran produksi, beli lisensi yang sesuai dengan pola penggunaan Anda, dan Anda juga dapat memperoleh lisensi sementara untuk pengujian dari halaman lisensi sementara. Mulailah mengintegrasikan pengeditan Excel hari ini dan sederhanakan pipeline pemrosesan data Anda.

FAQs

Bagaimana cara mengedit file Excel di Node.js melalui REST tanpa menulis kode HTTP khusus?
Gunakan GroupDocs.Editor Cloud SDK for Node.js, yang mengabstraksi panggilan REST dan memungkinkan Anda mengedit file Excel di Node.js melalui REST dengan pemanggilan metode yang sederhana.

Bisakah saya memperbarui lembar XLSX menggunakan REST api Node.js untuk file besar?
Ya. SDK mem‑stream data dan mendukung pembaruan batch, menjadikannya cocok untuk buku kerja besar. Sesuaikan compressionLevel dan perubahan sel batch untuk meningkatkan kinerja.

Apa cara terbaik untuk memodifikasi lembar kerja Excel secara programatis di Node.js?
Gunakan objek worksheet dan cell yang dikembalikan oleh editDocument. Ini memberi Anda kontrol penuh atas baris, kolom, dan nilai sel tanpa meninggalkan lingkungan Node.js.

Di mana saya dapat menemukan informasi harga dan lisensi?
Semua detail lisensi, termasuk tingkatan harga dan lisensi sementara untuk evaluasi, tersedia di halaman lisensi sementara.

Mengedit File Excel di Node.js melalui REST - Panduan 5 Langkah#

Edit File Excel di Node.js via REST - Contoh Kode Lengkap#

Perbarui Lembar XLSX Menggunakan REST API di Node.js via cURL#

Prasyarat dan Penyiapan untuk GroupDocs.Editor Cloud SDK for Node.js#

Apa yang Membuat GroupDocs.Editor Cloud SDK for Node.js Ideal untuk Memodifikasi Lembar Kerja Excel#

Menyempurnakan Opsi Penyuntingan Excel di GroupDocs.Editor Cloud#

Pertimbangan Kinerja untuk Mengedit Buku Kerja XLSX melalui REST#

Kesimpulan#

FAQs#

Baca Selengkapnya#