office file processing on Document Processing REST APIs | GroupDocs Cloud

如何在 Java 中合併多個 Word 文檔

Mon, 14 Sep 2026 14:29:18 +0000

在構建以文件為中心的應用程式時，程式化合併 Word 檔案是一項常見需求，尤其在產生報告或整合合約時。 GroupDocs.Merger Cloud SDK for Java 提供一個簡單的雲端庫，讓您在不處理低階檔案操作的情況下合併 DOCX 檔案。在本指南中，您將學習如何在 Java 中合併多個 Word 文件，查看完整的程式碼範例，探索等效的 cURL 呼叫，並了解所需的設定。完成後，您將能將文件合併功能整合到自己的 Java 專案中。

完整的 Java 多個 Word 文檔合併示例

此示例演示了如何在 Java 中使用 Merger API 合併多個 Word 文檔。

import com.groupdocs.merger.cloud.client.ApiClient;
import com.groupdocs.merger.cloud.client.ApiException;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import java.util.ArrayList;
import java.util.List;

public class CombineWordDocuments {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

try {
            // List of Word documents to combine
            List<FileInfo> sourceFiles = new ArrayList<>();
            sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input2.docx"));
            sourceFiles.add(new FileInfo().setFilePath("input3.docx"));

// Configure merge options
            MergeOptions mergeOptions = new MergeOptions();
            mergeOptions.setOutputPath("merged_output.docx");
            mergeOptions.setFileInfos(sourceFiles);

// Execute the merge operation
            FileInfo result = mergerApi.merge(mergeOptions);

System.out.println("Merge completed successfully. Output file: " + result.getFilePath());
        } catch (ApiException e) {
            System.err.println("An error occurred while merging documents: " + e.getMessage());
        }
    }
}

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

使用 cURL 透過 REST API 合併 Word 檔案

如果您偏好純粹的 REST 方法，則可以使用 cURL 呼叫執行相同的合併操作。以下步驟說明如何取得存取權杖、上傳來源檔案、發出合併請求，並下載結果。

驗證並獲取訪問令牌：

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

將每個 DOCX 檔案上傳至您的雲端儲存 (將 YOUR_ACCESS_TOKEN 替換為前一步驟中的令牌)：

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input1.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
     --data-binary @input1.docx

對 input2.docx 和 input3.docx 重複執行上傳指令。

建立合併請求：

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "outputPath":"merged_output.docx",
           "fileInfos":[
               {"filePath":"input1.docx"},
               {"filePath":"input2.docx"},
               {"filePath":"input3.docx"}
           ]
         }'

下載合併的文件：

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

如需了解請求參數的更多詳細資訊，請參閱官方 API 文檔。

了解在 Java 中合併 Word 文檔的過程

以下是對前面顯示的代碼的逐步解析。

建立 ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") 用於建立與 GroupDocs 雲服務的連接。
```
ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
```
實例化 MergerApi - new MergerApi(apiClient) 可訪問合併相關的端點。
```
MergerApi mergerApi = new MergerApi(apiClient);
```
準備來源檔案清單 - 每個 FileInfo 物件指向雲端存儲的 DOCX 檔案。此清單會傳遞給 MergeOptions。
```
List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
```

配置 MergeOptions - 設定所需的輸出路徑並附加來源檔案清單。

MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setOutputPath("merged_output.docx");
mergeOptions.setFileInfos(sourceFiles);

執行合併 - mergerApi.merge(mergeOptions) 會發送請求，並返回合併後文件的 FileInfo。
```
FileInfo result = mergerApi.merge(mergeOptions);
```

如需完整的可用屬性清單，請參閱 API 參考。

GroupDocs.Merger Cloud SDK 的先決條件和設定

在執行程式碼之前，請將 Maven 依賴項添加到您的專案中，並確保您擁有有效的 GroupDocs 帳戶。

將 SDK 添加到您的 pom.xml：


    com.groupdocs
    groupdocs-merger-cloud
    25.11

從 download page 下載最新的 JAR 和原始碼。
您還需要 Java 8 或更高版本以及網際網路存取以進行雲端呼叫。
建立 GroupDocs 帳戶，取得您的 Client ID 和 Client Secret，並妥善保管。

結論

以程式方式合併 DOCX 檔案現在變得簡單，只需使用 GroupDocs.Merger Cloud SDK for Java。示例程式碼和 cURL 片段說明了兩種彈性的方式在 Java 中合併多個 Word 文件，無論您偏好原生函式庫還是直接的 REST 呼叫。請記得設定您的憑證，必要時以串流方式處理大型檔案，並使用具代表性的文件測試合併操作。對於正式上線的部署，您需要購買授權；授權價格資訊可在產品頁面上查閱，亦可從臨時授權頁面申請臨時授權以進行評估。

常見問題

如何在 Java 中合併多個 Word 文檔而無需編寫自訂檔案處理程式碼？
使用 GroupDocs.Merger Cloud SDK for Java。該 SDK 抽象了所有低層操作，讓您只需幾個 API 調用即可合併 DOCX 檔案。
是否可以合併存儲在不同雲端資料夾中的文件？
是的。請在 FileInfo 物件中提供完整的雲端文件路徑，合併操作將在合併前從各自的位置抓取每個文件。
如果合併因 ApiException 失敗，我該怎麼辦？
檢查例外訊息以獲取詳細資訊，例如缺少檔案或權限問題。確保檔案路徑正確，且您的帳戶對儲存具有讀寫存取權限。請參閱官方文件以了解錯誤代碼。
我是否需要為每個環境（開發、測試、正式）單獨購買授權？
單一授權可覆蓋所有環境，但您必須遵守授權協議中定義的使用限制。測試時您可以使用上面提供的臨時授權。

閱讀更多

在 C# 中編輯 Powerpoint 簡報

Wed, 09 Sep 2026 12:31:52 +0000

在 C# 中編輯 PowerPoint 簡報是開發動態投影片套件的開發人員常見的需求。 GroupDocs.Editor Cloud SDK for .NET 提供強大的 API，讓您可以直接從 .NET 應用程式修改 PPTX 檔案。在本指南中，您將學習如何設置 SDK、替換佔位符文字、執行編輯操作以及微調選項，並看到完整的程式碼範例和相應的 cURL REST 工作流程。

PowerPoint 自動化在 C# 中的需求

企業經常從模板生成投影片檔案，需自動更新標題、副標題或資料欄位。對於穩健解決方案的需求包括：

能夠在 PPTX 檔案中定位並取代特定文字字串。
支援雲端處理，使程式碼可在任何伺服器上執行，而無需安裝 Office。
清晰的錯誤處理以及簡易的輸入與輸出路徑設定。

手動編輯或使用通用檔案系統腳本無法保證在數十個簡報之間的一致性，尤其是當內容頻繁變更時。

方法：基於雲端的 PowerPoint 編輯

GroupDocs.Editor Cloud SDK for .NET 能夠滿足這些需求，提供一個完全在雲端運行的 REST‑驅動 API。主要功能包括：

EditDocument - 在不下載整個文件的情況下，替換 PPTX 文件中的文字、圖像或形狀。
FileInfo - 指定存儲在 GroupDocs Cloud 存儲中的源文件。
EditDocumentOptions - 定義輸出位置和文字替換列表。

SDK 處理身份驗證、檔案串流和保持格式的編輯，讓您專注於業務邏輯。詳細文件可在官方文件中取得。

在 C# 中使用 GroupDocs.Editor Cloud 实现编辑 PowerPoint 演示文稿

以下是逐步演练。每个步骤都包含直接取自完整示例的简短代码片段。

安裝 SDK 並新增 NuGet 套件

首先，將庫添加到您的專案中。

dotnet add package GroupDocs.editor-Cloud

您也可以從下載頁面下載最新版本。

配置 API 憑證

使用您的客戶端 ID 和密鑰建立 Configuration 物件。

var config = new Configuration
{
    ClientId = "YOUR_CLIENT_ID",
    ClientSecret = "YOUR_CLIENT_SECRET"
};

Configuration 類別在 API 參考中有說明。

初始化 Editor API

使用配置实例化 EditorApi。

var editorApi = new EditorApi(config);

此物件提供所有編輯操作。

定義編輯選項（取代佔位符文字）

設定來源檔案、輸出路徑以及您需要的文字取代。

var editOptions = new EditDocumentOptions
{
    FileInfo = new FileInfo { FilePath = "sample.pptx" },
    OutputPath = "sample_edited.pptx",
    EditTexts = new List
    {
        new EditText { Text = "OldTitle", NewText = "New Title" },
        new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
    }
};

EditTexts 集合讓您一次呼叫即可替換任意數量的佔位符。

執行編輯操作並處理回應

建立請求並呼叫 EditDocument。

var request = new EditDocumentRequest(editOptions);
var response = editorApi.EditDocument(request);
Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");

回應中包含雲端儲存中已編輯檔案的路徑。

完整程式碼範例：編輯 PowerPoint 簡報（C#）- 完整工作流程

以下程式碼示範了從頭到尾的完整流程。

using System;
using System.Collections.Generic;
using GroupDocs.Editor.Cloud.Sdk.Api;
using GroupDocs.Editor.Cloud.Sdk.Client;
using GroupDocs.Editor.Cloud.Sdk.Model;
using GroupDocs.Editor.Cloud.Sdk.Model.Requests;

namespace GroupDocsEditorDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configure API credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// Initialize the Editor API
            var editorApi = new EditorApi(config);

// Define input and output PowerPoint files
            string inputFilePath = "sample.pptx";
            string outputFilePath = "sample_edited.pptx";

// Set up editing options (replace placeholder texts)
            var editOptions = new EditDocumentOptions
            {
                FileInfo = new FileInfo { FilePath = inputFilePath },
                OutputPath = outputFilePath,
                EditTexts = new List
                {
                    new EditText { Text = "OldTitle", NewText = "New Title" },
                    new EditText { Text = "OldSubtitle", NewText = "Updated Subtitle" }
                }
            };

// Create the request
            var request = new EditDocumentRequest(editOptions);

try
            {
                // Perform the edit operation
                var response = editorApi.EditDocument(request);
                Console.WriteLine($"Edited PowerPoint saved to: {response.Path}");
            }
            catch (ApiException apiEx)
            {
                Console.WriteLine($"API error ({apiEx.ErrorCode}): {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Unexpected error: {ex.Message}");
            }
        }
    }
}

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

使用 cURL 和 REST API 進行 PowerPoint 編輯

如果您偏好語言無關的方法，您可以使用 cURL 調用執行相同的編輯操作。

驗證並取得存取權杖

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

上傳來源 PPTX 檔案

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

執行編輯操作

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": "sample.pptx" },
           "outputPath": "sample_edited.pptx",
           "editTexts": [
               { "text": "OldTitle", "newText": "New Title" },
               { "text": "OldSubtitle", "newText": "Updated Subtitle" }
           ]
         }'

下載已編輯的 PPTX 檔案

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download/sample_edited.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample_edited.pptx

如需了解請求有效負載的更多細節，請參閱 API 參考。

微調 PowerPoint 編輯選項

SDK 提供了可調整的其他參數:

OutputPath - 選擇不同的資料夾或檔案名稱作為編輯後簡報的輸出路徑。
EditTexts - 根據需要添加任意多個 EditText 物件，以取代多個佔位符。
FileInfo.StorageName - 如果使用多個雲端儲存，請指定自訂的儲存位置。

這些選項是 EditDocumentOptions 類別的一部分，該類別在 API 參考中被引用。

結論

在 C# 中編輯 PowerPoint 簡報變得簡單，使用 GroupDocs.Editor Cloud SDK for .NET。此函式庫負責驗證、檔案管理與文字取代，讓您專注於業務邏輯。請記得取得正式授權以供生產環境使用；您可以從臨時授權頁面取得臨時授權。透過提供的程式碼範例與 cURL 工作流程，您即可將動態投影片編輯整合至任何 .NET 應用程式。

常見問題

如何在 C# 中使用 GroupDocs.Editor Cloud 編輯 Powerpoint 簡報？
在配置了包含來源檔案、輸出路徑以及 EditText 替換清單的 EditDocumentOptions 後，使用 EditDocument 方法。完整範例已在本指南前面展示。

我可以在單個 PowerPoint 檔案中替換多個佔位符嗎？
是的。將 EditTexts 集合填充為所需數量的 EditText 物件；SDK 會在一次請求中處理所有替換。

如果編輯後的檔案未產生，我該怎麼辦？
檢查 OutputPath 是否正確設定，且 API 回應中是否包含有效的 Path。同時透過 GroupDocs 入口網站驗證您的憑證和儲存權限。

我在生產部署時需要許可證嗎？
在生產環境中需要有效的許可證。您可以在評估 SDK 時，從臨時許可證頁面獲取臨時許可證。

閱讀更多

如何在 Node.JS 中合併多個 Word 文檔

Wed, 19 Aug 2026 10:37:27 +0000

許多開發人員需要在 Node.JS 中合併多個 Word 文件，以生成綜合報告或套件。 GroupDocs.Merger Cloud SDK for Node.js 提供強大的 API，能在伺服器端處理 Word 合併，無需複雜的檔案處理程式碼。在本指南中，您將看到完整的實作範例、等效的 cURL 呼叫、安裝步驟以及最佳實踐技巧，快速完成文件合併。

在 Node.JS 中合併多個 Word 文檔 - 完整代碼示例

此範例示範如何使用 GroupDocs.Merger Cloud SDK for Node.js 將三個 DOCX 檔案合併為單一文件。

const GroupDocsMergerCloud = require("@groupdocs/merger-cloud");

// ==== Configuration ====
// Replace with your actual credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

// ==== Input / Output paths ====
const inputFiles = [
    "documents/input1.docx",
    "documents/input2.docx",
    "documents/input3.docx"
];
const outputFile = "documents/combined_output.docx";

// ==== Build request ====
const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({
            filePath: path
        })
    });
});

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

// ==== Execute merge ====
(async () => {
    try {
        const result = await mergeApi.mergeDocuments(mergeRequest);
        console.log(`Merge completed successfully. Output file: ${result.path}`);
    } catch (error) {
        console.error("Error during merging:", error);
    }
})();

注意： 此程式碼範例示範了核心功能。在將其用於您的專案之前，請確保更新檔案路徑（input1.docx、combined_output.docx 等）以符合實際檔案位置，驗證所有必要的相依性已正確安裝，並在開發環境中徹底測試。如果遇到任何問題，請參考官方文件或聯繫支援團隊尋求協助。

使用 cURL 的 REST API 合併 Word 文件

如果您更喜歡純粹的 REST 方法，則可以使用 cURL 命令執行相同的合併操作。以下是一個簡潔的工作流程，可驗證身份、上傳源文件、執行合併並下載結果。

1. 驗證並取得存取令牌

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/authenticate" \
-H "Content-Type: application/json" \
-d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

回應中包含一個在後續呼叫中使用的 access_token。

2. 上傳來源檔案

對每個您想要合併的 DOCX 檔案重複此步驟。

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=documents/input1.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@path/to/input1.docx"

3. 執行合併操作

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
    "documents": [
        {"fileInfo": {"filePath": "documents/input1.docx"}},
        {"fileInfo": {"filePath": "documents/input2.docx"}},
        {"fileInfo": {"filePath": "documents/input3.docx"}}
    ],
    "outputPath": "documents/combined_output.docx"
}'

API 返回合併檔案的路徑。

4. 下載合併文件

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=documents/combined_output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o combined_output.docx

欲了解有關請求有效負載和選項的更多詳細資訊，請參閱官方 API 文檔。

Node.JS 中合併多個 Word 文檔的工作原理

SDK 將合併過程抽象為幾個邏輯步驟：

配置建立 - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) 建立身份驗證上下文。請參閱類別參考於 API 參考。
```
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
```
API 實例 - new GroupDocsMergerCloud.MergeApi(config) 提供對合併操作的存取。

const mergeApi = new GroupDocsMergerCloud.MergeApi(config);

文件條目 - 每個來源檔案都會被包裝在 DocumentEntry 中，該物件包含具有檔案路徑的 FileInfo。

const documentEntries = inputFiles.map(path => {
    return new GroupDocsMergerCloud.Models.DocumentEntry({
        fileInfo: new GroupDocsMergerCloud.Models.FileInfo({ filePath: path })
    });
});

合併請求 - MergeDocumentsRequest 將條目與所需的輸出路徑打包。

const mergeRequest = new GroupDocsMergerCloud.Models.MergeDocumentsRequest({
    documents: documentEntries,
    outputPath: outputFile
});

執行 - mergeApi.mergeDocuments(mergeRequest) 會將請求發送到雲端服務。Promise 解析為包含輸出檔案路徑的結果物件。

const result = await mergeApi.mergeDocuments(mergeRequest);
console.log(`Merge completed successfully. Output file: ${result.path}`);

這些步驟結合起來，使您能夠高效地合併多個 Word 文檔，而無需處理低層級的文件流。

為 GroupDocs.Merger 準備環境

安裝 SDK

npm install groupdocs-merger-cloud

此套件可從官方下載頁面取得。

Node.js 版本 - 確保您正在運行 Node.js 12 或更高版本。
配置憑證 - 在程式碼中將 YOUR_CLIENT_ID 和 YOUR_CLIENT_SECRET 替換為您 GroupDocs Cloud 帳戶中的值。
建立專案資料夾 - 將來源 DOCX 檔案放置於 documents/ 子資料夾中，如範例所示。

完成這些步驟後，您已準備好執行合併腳本或呼叫 REST 端點。

結論

將多個 Word 文件在 Node.JS 中合併變得簡單，只需使用 GroupDocs.Merger Cloud SDK for Node.js。該 SDK 處理文件上傳、合併邏輯和輸出生成，讓您專注於業務邏輯，而不是低層次的文件操作。請確保為生產環境獲取適當的許可證；您可以先使用臨時許可證並隨需求增長升級為完整訂閱。立即開始合併，簡化您的文件工作流程。

常見問題

如何在 Node.JS 中使用 SDK 合併多個 Word 文件？
使用 MergeApi 類別建立 MergeDocumentsRequest，其中將每個 DOCX 文件列為 DocumentEntry。SDK 會按照提供的順序合併它們，並將結果保存到指定的輸出路徑。
是否可以使用相同的 SDK 合併 PDF？
是的，Merger SDK 支援 PDF、DOCX、ODT，以及其他多種格式。只需在 inputFiles 陣列中更改檔案副檔名，SDK 會自動處理轉換。請參閱官方文件以了解格式細節。
什麼是單次請求中我可以合併的文件數量限制？
雲服務施加的是大小限制，而非嚴格的文件數量限制。只要合併後的總大小在您的帳戶配額範圍內，您就可以合併數十個文件。對於非常大的批次，建議先將文件上傳至 GroupDocs 存儲，然後通過 ID 進行引用。
我需要擔心開發與生產環境的授權問題嗎？
開發和測試可以使用從臨時授權頁面獲得的臨時授權。對於生產部署，請購買完整授權以解鎖無限制合併和優先支援。