Ví dụ Hoạt động Đầy đủ để Kết hợp Nhiều Tài liệu Word trong Java

Ví dụ này trình bày cách kết hợp nhiều tài liệu Word trong Java bằng cách sử dụng Merger API.

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

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Hợp nhất các tệp Word qua REST API bằng cURL

Nếu bạn muốn sử dụng phương pháp REST thuần túy, cùng một thao tác hợp nhất có thể được thực hiện bằng các lệnh cURL. Các bước dưới đây cho thấy cách lấy token truy cập, tải lên các tệp nguồn, yêu cầu hợp nhất và tải xuống kết quả.

Xác thực và nhận token truy cập:

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

Tải lên mỗi tệp DOCX lên bộ nhớ đám mây của bạn (thay thế YOUR_ACCESS_TOKEN bằng token từ bước trước):

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

Lặp lại lệnh tải lên cho input2.docx và input3.docx.

Tạo yêu cầu hợp nhất:

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

Tải xuống tài liệu đã hợp nhất:

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

Để biết thêm chi tiết về các tham số yêu cầu, xem tài liệu API chính thức.

Hiểu quy trình kết hợp tài liệu Word trong Java

Dưới đây là phân tích từng bước của mã đã được trình bày ở trên.

1. Create an ApiClient - new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") thiết lập kết nối tới dịch vụ đám mây GroupDocs.

   ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
   

2. Instantiate MergerApi - new MergerApi(apiClient) cung cấp quyền truy cập vào các endpoint liên quan đến hợp nhất.

   MergerApi mergerApi = new MergerApi(apiClient);
   

3. Prepare source file list - Mỗi đối tượng FileInfo chỉ tới một tệp DOCX được lưu trữ trên đám mây. Danh sách này được truyền vào MergeOptions.

   List<FileInfo> sourceFiles = new ArrayList<>();
   sourceFiles.add(new FileInfo().setFilePath("input1.docx"));
   

4. Configure MergeOptions - Đặt đường dẫn đầu ra mong muốn và gắn danh sách các tệp nguồn.

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

5. Execute merge - mergerApi.merge(mergeOptions) gửi yêu cầu và trả về một FileInfo cho tài liệu đã hợp nhất.

   FileInfo result = mergerApi.merge(mergeOptions);
   

Để xem danh sách đầy đủ các thuộc tính có sẵn, hãy tham khảo tài liệu API.

Các yêu cầu trước và thiết lập cho GroupDocs.Merger Cloud SDK

Trước khi bạn có thể chạy mã, hãy thêm phụ thuộc Maven vào dự án của bạn và đảm bảo bạn có một tài khoản GroupDocs hợp lệ.

Thêm SDK vào pom.xml của bạn:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Tải xuống các tệp JAR và mã nguồn mới nhất từ trang tải xuống.
Bạn cũng sẽ cần Java 8 hoặc cao hơn và kết nối internet để thực hiện các cuộc gọi đám mây.
Tạo một tài khoản GroupDocs, lấy Client ID và Client Secret của bạn, và giữ chúng an toàn.

Kết luận

Việc hợp nhất các tệp DOCX một cách lập trình hiện đã trở nên đơn giản với GroupDocs.Merger Cloud SDK for Java. Mã mẫu và các đoạn cURL minh họa hai cách linh hoạt để kết hợp nhiều tài liệu Word trong Java, cho dù bạn thích sử dụng thư viện gốc hay gọi trực tiếp REST. Hãy nhớ cấu hình thông tin xác thực của bạn, xử lý các tệp lớn bằng cách streaming nếu cần, và kiểm tra hoạt động hợp nhất với các tài liệu đại diện. Đối với triển khai trong môi trường sản xuất, bạn sẽ cần một giấy phép trả phí; chi tiết giá cả có sẵn trên trang sản phẩm và bạn có thể yêu cầu giấy phép tạm thời để đánh giá từ trang giấy phép tạm thời.

Câu hỏi thường gặp

• Làm thế nào để kết hợp nhiều tài liệu Word trong Java mà không cần viết mã xử lý tệp tùy chỉnh?
  Sử dụng GroupDocs.Merger Cloud SDK for Java. SDK trừu tượng hoá tất cả các thao tác cấp thấp và cho phép bạn hợp nhất các tệp DOCX chỉ với một vài lời gọi API.

• Có thể hợp nhất các tài liệu được lưu trong các thư mục đám mây khác nhau không?
  Có. Cung cấp đường dẫn tệp đầy đủ trên đám mây trong các đối tượng FileInfo, và thao tác hợp nhất sẽ lấy mỗi tệp từ vị trí của chúng trước khi kết hợp lại.

• Tôi nên làm gì nếu quá trình hợp nhất thất bại với ApiException?
  Kiểm tra thông báo ngoại lệ để biết chi tiết như thiếu tệp hoặc vấn đề quyền truy cập. Đảm bảo các đường dẫn tệp đúng và tài khoản của bạn có quyền đọc/ghi đối với bộ nhớ. Tham khảo tài liệu chính thức để biết mã lỗi.

• Tôi có cần giấy phép riêng cho mỗi môi trường (phát triển, thử nghiệm, sản xuất) không?
  Một giấy phép duy nhất bao phủ tất cả các môi trường, nhưng bạn phải tuân thủ các giới hạn sử dụng được định nghĩa trong thỏa thuận giấy phép của mình. Đối với việc thử nghiệm, bạn có thể sử dụng giấy phép tạm thời được liên kết ở trên.

Đọc thêm

• Bảo vệ tệp ZIP bằng mật khẩu sử dụng phần mềm bảo vệ mật khẩu
• Bảo vệ Excel bằng mật khẩu sử dụng dịch vụ bảo vệ mật khẩu
• Kết hợp tài liệu Word trong C#

Những Yêu Cầu Của Tự Động Hóa PowerPoint trong C#

Các doanh nghiệp thường tạo các bộ slide từ mẫu, trong đó tiêu đề, phụ đề hoặc các trường dữ liệu cần được cập nhật tự động. Các yêu cầu cho một giải pháp mạnh mẽ bao gồm:

• Khả năng xác định và thay thế các chuỗi văn bản cụ thể trong tệp PPTX.
• Hỗ trợ xử lý dựa trên đám mây để mã chạy trên bất kỳ máy chủ nào mà không cần cài đặt Office.
• Xử lý lỗi rõ ràng và cấu hình dễ dàng cho các đường dẫn đầu vào và đầu ra.

Việc chỉnh sửa thủ công hoặc sử dụng các script hệ thống tệp chung không thể đảm bảo tính nhất quán trên hàng chục bản trình bày, đặc biệt khi nội dung thay đổi thường xuyên.

Cách Tiếp Cận: Chỉnh sửa PowerPoint dựa trên đám mây

GroupDocs.Editor Cloud SDK for .NET đáp ứng những nhu cầu này bằng một API dựa trên REST hoạt động hoàn toàn trên đám mây. Các khả năng chính bao gồm:

• EditDocument - Thay thế văn bản, hình ảnh hoặc hình dạng trong các tệp PPTX mà không cần tải xuống toàn bộ tài liệu.
• FileInfo - Chỉ định các tệp nguồn được lưu trữ trong lưu trữ GroupDocs Cloud.
• EditDocumentOptions - Xác định vị trí đầu ra và danh sách các thay thế văn bản.

SDK xử lý xác thực, truyền luồng tệp và các chỉnh sửa bảo toàn định dạng, cho phép bạn tập trung vào logic kinh doanh. Tài liệu chi tiết có sẵn tại tài liệu chính thức.

Thực hiện chỉnh sửa bản trình bày PowerPoint trong C# với GroupDocs.Editor Cloud

Dưới đây là hướng dẫn chi tiết từng bước. Mỗi bước bao gồm một đoạn mã ngắn được lấy trực tiếp từ ví dụ đầy đủ.

Cài đặt SDK và Thêm Gói NuGet

Đầu tiên, thêm thư viện vào dự án của bạn.

dotnet add package GroupDocs.editor-Cloud

Bạn cũng có thể tải phiên bản mới nhất từ trang tải xuống.

Cấu hình thông tin xác thực API

Tạo một đối tượng Configuration với client ID và secret của bạn.

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

Lớp Configuration được mô tả trong tham chiếu API.

Khởi tạo API Trình chỉnh sửa

Tạo một thể hiện của EditorApi bằng cách sử dụng cấu hình.

var editorApi = new EditorApi(config);

Đối tượng này cung cấp tất cả các thao tác chỉnh sửa.

Xác định tùy chọn chỉnh sửa (Thay thế văn bản giữ chỗ)

Đặt tệp nguồn, đường dẫn đầu ra và các thay thế văn bản bạn cần.

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

Bộ sưu tập EditTexts cho phép bạn thay thế bất kỳ số lượng placeholder nào trong một lần gọi.

Thực hiện thao tác chỉnh sửa và xử lý phản hồi

Tạo yêu cầu và gọi EditDocument.

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

Phản hồi chứa đường dẫn tới tệp đã chỉnh sửa trong lưu trữ đám mây.

Ví dụ mã đầy đủ: chỉnh sửa bản trình bày PowerPoint trong C# - Quy trình đầy đủ

Mã sau đây minh họa toàn bộ quy trình từ đầu đến cuối.

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<EditText>
                {
                    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}");
            }
        }
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Chỉnh sửa PowerPoint bằng cURL và REST API

Nếu bạn muốn một cách tiếp cận không phụ thuộc vào ngôn ngữ, bạn có thể thực hiện cùng một thao tác chỉnh sửa bằng các lệnh cURL.

1. Xác thực và nhận token truy cập

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

2. Tải lên tệp PPTX nguồn

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

3. Thực hiện thao tác chỉnh sửa

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

4. Tải xuống tệp PPTX đã chỉnh sửa

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

Để biết thêm chi tiết về payload yêu cầu, xem tài liệu API.

Tinh chỉnh các tùy chọn chỉnh sửa PowerPoint

SDK cung cấp các tham số bổ sung mà bạn có thể điều chỉnh:

• OutputPath - Chọn một thư mục hoặc tên tệp khác cho bản trình chiếu đã chỉnh sửa.
• EditTexts - Thêm bao nhiêu đối tượng EditText tùy ý để thay thế nhiều chỗ giữ chỗ.
• FileInfo.StorageName - Chỉ định vị trí lưu trữ tùy chỉnh nếu bạn sử dụng nhiều lưu trữ đám mây.

Các tùy chọn này là một phần của lớp EditDocumentOptions được tham chiếu trong tài liệu API.

Kết luận

Việc chỉnh sửa các bản trình bày PowerPoint trong C# trở nên đơn giản với GroupDocs.Editor Cloud SDK for .NET. Thư viện xử lý xác thực, quản lý tệp và thay thế văn bản, cho phép bạn tập trung vào logic nghiệp vụ. Hãy nhớ lấy giấy phép phù hợp cho môi trường sản xuất; bạn có thể bắt đầu với giấy phép tạm thời từ trang giấy phép tạm thời. Với mẫu mã và quy trình cURL được cung cấp, bạn đã sẵn sàng tích hợp việc chỉnh sửa slide động vào bất kỳ ứng dụng .NET nào.

Câu hỏi thường gặp

Làm thế nào để chỉnh sửa bản trình bày Powerpoint trong C# bằng GroupDocs.Editor Cloud?
Sử dụng phương thức EditDocument sau khi cấu hình EditDocumentOptions với tệp nguồn của bạn, đường dẫn đầu ra và danh sách các thay thế EditText. Ví dụ đầy đủ đã được trình bày ở phần trước của hướng dẫn này.

Có thể thay thế nhiều placeholder trong một tệp PowerPoint duy nhất không?
Có. Điền bộ sưu tập EditTexts với số lượng đối tượng EditText cần thiết; SDK sẽ xử lý tất cả các thay thế trong một yêu cầu.

Nếu tệp đã chỉnh sửa không được tạo ra, tôi nên làm gì?
Kiểm tra xem OutputPath đã được đặt đúng chưa và phản hồi API có chứa một Path hợp lệ không. Ngoài ra, hãy xác minh thông tin đăng nhập và quyền truy cập lưu trữ của bạn qua cổng GroupDocs.

Tôi có cần giấy phép cho việc triển khai trong môi trường sản xuất không?
Cần có giấy phép hợp lệ cho môi trường sản xuất. Bạn có thể lấy giấy phép tạm thời từ trang giấy phép tạm thời trong quá trình đánh giá SDK.

Đọc Thêm

• Chỉnh sửa bản trình bày PowerPoint bằng Python
• Chỉnh sửa tệp PowerPoint bằng thư viện Java
• Các thực tiễn tốt nhất cho việc phát triển trình chỉnh sửa CSV bằng Java

Kết hợp nhiều tài liệu Word trong Node.JS - Ví dụ mã hoàn chỉnh

Ví dụ này minh họa cách hợp nhất ba tệp DOCX thành một tài liệu duy nhất bằng cách sử dụng GroupDocs.Merger Cloud SDK for Node.js.

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

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy đảm bảo cập nhật các đường dẫn tệp (input1.docx, combined_output.docx, v.v.) cho phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Kết hợp tài liệu Word qua REST API bằng cURL

Nếu bạn ưu tiên cách tiếp cận REST thuần túy, cùng một thao tác hợp nhất có thể được thực hiện bằng các lệnh cURL. Dưới đây là quy trình ngắn gọn xác thực, tải lên các tệp nguồn, thực hiện hợp nhất và tải xuống kết quả.

1. Xác thực và Lấy Mã Truy cập

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

Phản hồi chứa một access_token được sử dụng trong các cuộc gọi tiếp theo.

2. Tải lên các tệp nguồn

Lặp lại bước này cho mỗi tệp DOCX mà bạn muốn hợp nhất.

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. Thực hiện thao tác hợp nhất

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 trả về đường dẫn của tệp đã hợp nhất.

4. Tải xuống tài liệu đã hợp nhất

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

Để biết thêm chi tiết về payload yêu cầu và các tùy chọn, xem tài liệu API chính thức.

Cách hoạt động của việc hợp nhất nhiều tài liệu Word trong Node.JS

SDK trừu tượng hóa quá trình hợp nhất thành một vài bước logic:

1. Tạo cấu hình - new GroupDocsMergerCloud.Configuration(clientId, clientSecret) tạo ngữ cảnh xác thực. Xem tham chiếu lớp trong API Reference.

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

2. API Instance - new GroupDocsMergerCloud.MergeApi(config) cung cấp quyền truy cập vào các thao tác hợp nhất.

   const mergeApi = new GroupDocsMergerCloud.MergeApi(config);
   

3. Các mục tài liệu - Mỗi tệp nguồn được bao bọc trong một DocumentEntry chứa một FileInfo với đường dẫn tệp.

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

4. Yêu cầu hợp nhất - MergeDocumentsRequest gói các mục và đường dẫn đầu ra mong muốn.

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

5. Thực thi - mergeApi.mergeDocuments(mergeRequest) gửi yêu cầu tới dịch vụ đám mây. Promise trả về một đối tượng kết quả chứa đường dẫn tệp đầu ra.

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

Các bước này cùng nhau cho phép bạn kết hợp nhiều tài liệu Word một cách hiệu quả mà không cần xử lý các luồng tệp cấp thấp.

Chuẩn bị môi trường cho GroupDocs.Merger

1. Cài đặt SDK

npm install groupdocs-merger-cloud

Gói có sẵn từ trang tải xuống chính thức.

2. Node.js Version - Đảm bảo bạn đang chạy Node.js 12 hoặc mới hơn.

3. Cấu hình thông tin xác thực - Thay thế YOUR_CLIENT_ID và YOUR_CLIENT_SECRET trong mã bằng các giá trị từ tài khoản GroupDocs Cloud của bạn.

4. Tạo Thư Mục Dự Án - Đặt các tệp DOCX nguồn vào thư mục con documents/ như được minh họa trong ví dụ.

Với các bước này đã hoàn thành, bạn đã sẵn sàng để chạy script hợp nhất hoặc gọi các endpoint REST.

Kết luận

Kết hợp nhiều tài liệu Word trong Node.JS trở nên đơn giản với GroupDocs.Merger Cloud SDK for Node.js. SDK xử lý việc tải lên tệp, logic hợp nhất và tạo đầu ra, cho phép bạn tập trung vào logic nghiệp vụ thay vì thao tác tệp cấp thấp. Hãy nhớ đảm bảo có giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; bạn có thể bắt đầu với một giấy phép tạm thời và nâng cấp lên đăng ký đầy đủ khi nhu cầu của bạn tăng lên. Bắt đầu hợp nhất ngay hôm nay và tối ưu hoá quy trình công việc tài liệu của bạn.

Câu hỏi thường gặp

• Làm thế nào để kết hợp nhiều tài liệu Word trong Node.JS bằng SDK?
  Sử dụng lớp MergeApi để tạo một MergeDocumentsRequest liệt kê mỗi tệp DOCX dưới dạng DocumentEntry. SDK sẽ hợp nhất chúng theo thứ tự đã cung cấp và lưu kết quả vào đường dẫn đầu ra đã chỉ định.

• Liệu có thể hợp nhất các tệp PDF lại với cùng một SDK không?
  Có, Merger SDK hỗ trợ PDF, DOCX, ODT, và một số định dạng khác. Chỉ cần thay đổi phần mở rộng tệp trong mảng inputFiles và SDK sẽ tự động xử lý việc chuyển đổi. Xem tài liệu chính thức để biết chi tiết về các định dạng.

• Giới hạn về số lượng tài liệu tôi có thể hợp nhất trong một yêu cầu là bao nhiêu?
  Dịch vụ đám mây áp dụng giới hạn kích thước thay vì số lượng cố định. Miễn là tổng kích thước vẫn nằm trong hạn mức tài khoản của bạn, bạn có thể hợp nhất hàng chục tệp. Đối với các lô rất lớn, hãy cân nhắc tải các tệp lên lưu trữ GroupDocs trước và tham chiếu chúng bằng ID.

• Tôi có cần lo lắng về giấy phép cho phát triển so với sản xuất không?
  Phát triển và kiểm thử có thể sử dụng giấy phép tạm thời được lấy từ trang giấy phép tạm thời. Đối với triển khai sản xuất, mua giấy phép đầy đủ để mở khóa số lần hợp nhất không giới hạn và hỗ trợ ưu tiên.

Đọc thêm

• Bảo vệ tệp ZIP bằng phần mềm bảo vệ mật khẩu
• Bảo vệ Excel bằng dịch vụ bảo vệ mật khẩu
• Kết hợp tài liệu Word trong C#