在 Node.JS 中通過 REST 編輯 Excel 工作表

自動化試算表更新是在構建資料驅動的 Web 服務或報告管道時的常見需求。 GroupDocs.Editor Cloud SDK for Node.js 讓您只需幾行程式碼即可在 Node.js 中透過 REST 編輯 Excel 檔案。在本教學中，您將看到如何設定 SDK、載入 XLSX 工作簿、修改儲存格、儲存變更，並使用原始 cURL 呼叫達成相同結果。我們還將討論關鍵功能、設定選項和效能考量，協助您有效整合 Excel 編輯功能。

編輯 Excel 檔案於 Node.js 透過 REST - 5 步驟指南

安裝 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);

載入 Excel 工作簿以進行編輯：使用 EditDocumentRequest 開啟儲存在雲端儲存中的檔案。

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

檢索第一個工作表並定位目標儲存格：SDK 會返回一個包含工作表和儲存格的 document 物件。

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

更新或建立儲存格值：變更儲存格 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";
}

將編輯過的工作簿儲存回儲存空間：提供 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 參考。

在 Node.js 中透過 REST 編輯 Excel 檔案 - 完整程式碼範例

以下範例示範如何在 Node.js 中透過 REST 使用 GroupDocs.Editor Cloud SDK 編輯 Excel 檔案。

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

注意： 此代碼示例演示了核心功能。在將其用於您的項目之前，請確保更新所有文件路徑和配置值以匹配實際環境，驗證所有必需的依賴項已正確安裝，並在開發環境中徹底測試。如果遇到任何問題，請參閱官方文檔或聯繫支援團隊尋求協助。

使用 REST API 在 Node.js 中透過 cURL 更新 XLSX 工作表

以下是一個使用原始 HTTP 呼叫執行相同操作的快速步驟說明。請將佔位符值替換為您的實際憑證和檔案名稱。

取得存取權杖

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。

上傳來源 XLSX 檔案

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

編輯工作簿（修改 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" }
               ]
           }
         }'

下載已編輯的檔案

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 for Node.js 的先決條件與設定

要開始使用 SDK，您需要 Node.js 14 或更高版本，以及一個 GroupDocs Cloud 帳戶。

npm install groupdocs-editor-cloud

您也可以從發行頁面下載最新的套件。安裝完成後，請在您的 GroupDocs Cloud 儀表板中建立 client_id 和 client_secret，並妥善保存它們。

什麼使 GroupDocs.Editor Cloud SDK for Node.js 成為修改 Excel 工作表的理想選擇

完整的 XLSX 支援 - 載入、編輯並儲存活頁簿，同時保留公式、樣式和資料驗證。
儲存格層級編輯 - 以程式方式存取單一儲存格、列或欄，這對於更新報告或儀表板非常適合。
雲端儲存整合 - 直接操作存放於 GroupDocs Cloud 的檔案，無需下載到本機。
安全的 REST 通訊 - 所有操作皆透過 HTTPS 進行，SDK 會為您處理令牌管理。

如需更深入了解，請參閱文檔。

微調 GroupDocs.Editor Cloud 中的 Excel 編輯選項

SDK 提供了多種選項，讓您可以控制已編輯工作簿的保存方式。

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

outputPath - 雲端儲存中的目標路徑。
compressionLevel - 減少大型工作簿的檔案大小（可在 API 參考中找到）。
password - 如有需要，使用密碼保護產生的檔案。

調整這些設定以符合您專案的安全性和效能需求。

透過 REST 編輯 XLSX 工作簿的效能考量

重用配置物件 - 為每個請求建立新的 Configuration 會增加額外負擔。請在應用程式的整個生命週期內保持單一實例。
批次儲存格更新 - 如果需要修改大量儲存格，請將它們收集到陣列中，並發送單一的編輯請求，而非多次呼叫。
限制工作表大小 - 非常大的工作表會增加記憶體消耗。盡可能將資料分割到多個工作表中。
避免不必要的儲存 - 僅在所有必要變更完成後才呼叫 saveDocument，以減少 I/O 操作。

結論

在 Node.js 中透過 REST 編輯 Excel 檔案變得簡單，只需使用 GroupDocs.Editor Cloud SDK for Node.js。您可以以程式方式載入工作簿、修改儲存格，並僅透過少量 API 呼叫或簡單的 cURL 指令即可儲存結果。SDK 的雲端架構消除對本機 Office 安裝的需求，並能隨您的應用程式工作負載擴展。對於正式環境部署，請購買符合使用模式的授權，您亦可從臨時授權頁面取得測試用的臨時授權。立即開始整合 Excel 編輯，簡化您的資料處理流程。

常見問題

如何在 Node.js 中透過 REST 編輯 Excel 檔案而不撰寫自訂 HTTP 程式碼？
使用 GroupDocs.Editor Cloud SDK for Node.js，它抽象化了 REST 呼叫，讓您只需簡單的方法呼叫即可在 Node.js 中透過 REST 編輯 Excel 檔案。

我可以使用 REST api Node.js 更新大型 XLSX 工作表嗎？
是的。SDK 會串流資料並支援批次更新，使其適用於大型活頁簿。調整 compressionLevel 和批次儲存格變更以提升效能。

什麼是以 Node.js 程式方式修改 Excel 工作表的最佳方法？
使用 editDocument 回傳的 worksheet 和 cell 物件。這讓您在不離開 Node.js 環境的情況下，完整控制列、欄和儲存格值。

我可以在哪裡找到價格和授權資訊？
所有授權細節，包括價格層級和用於評估的臨時授權，都可在臨時授權頁面上取得。

編輯 Excel 檔案於 Node.js 透過 REST - 5 步驟指南#

在 Node.js 中透過 REST 編輯 Excel 檔案 - 完整程式碼範例#

使用 REST API 在 Node.js 中透過 cURL 更新 XLSX 工作表#

GroupDocs.Editor Cloud SDK for Node.js 的先決條件與設定#

什麼使 GroupDocs.Editor Cloud SDK for Node.js 成為修改 Excel 工作表的理想選擇#

微調 GroupDocs.Editor Cloud 中的 Excel 編輯選項#

透過 REST 編輯 XLSX 工作簿的效能考量#

結論#

常見問題#

閱讀更多#