Ví dụ Hoạt động đầy đủ để Xóa các Đối tượng Ghi chú khỏi PDF bằng REST trong Node.JS

Ví dụ này minh họa cách tải lên một tệp PDF, xóa tất cả các chú thích của nó và tải xuống tệp đã được làm sạch bằng GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

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.

Xóa chú thích PDF qua REST API bằng cURL

Dưới đây là các lệnh cURL thực hiện cùng quy trình xóa chú thích thông qua các endpoint REST của GroupDocs.Annotation Cloud.

# 1. Obtain an access token
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. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Để xem danh sách đầy đủ các endpoint và tham số, hãy xem tài liệu API chính thức.

Cách Xóa Đối Tượng Ghi Chú trong PDF bằng REST trong Node.JS Hoạt Động

1. Cấu hình xác thực - Lớp Configuration được khởi tạo với clientId và clientSecret của bạn, tạo ra một ngữ cảnh đã xác thực cho tất cả các cuộc gọi API tiếp theo.

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

2. Tải lên tệp - UploadFileRequest gửi các byte PDF cục bộ tới lưu trữ GroupDocs Cloud. Phương thức storageApi.uploadFile xử lý việc truyền tải.

const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);

3. Lấy chú thích - GetAnnotationsRequest tạo một đối tượng yêu cầu với tham chiếu FileInfo. Lệnh annotationsApi.getAnnotations trả về một bộ sưu tập các đối tượng chú thích, từ đó trích xuất các ID.

const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);

4. Xóa chú thích - Nếu có bất kỳ ID nào, DeleteAnnotationsRequest được điền và truyền cho annotationsApi.deleteAnnotations, lệnh này sẽ xóa vĩnh viễn các chú thích khỏi PDF đã lưu.

const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);

5. Tải xuống PDF sạch - Cuối cùng, DownloadFileRequest lấy tệp đã cập nhật, và fs.writeFileSync ghi nó vào hệ thống tệp cục bộ.

const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

Để xem chi tiết các định nghĩa lớp và phương thức, hãy tham khảo Tham khảo API.

Cài đặt và cấu hình GroupDocs.Annotation Cloud SDK for Node.js

SDK được phân phối dưới dạng gói npm. Cài đặt nó bằng lệnh dưới đây và sau đó yêu cầu nó trong dự án của bạn.

npm install groupdocs-annotation-cloud

Bạn cũng có thể tải xuống gói mới nhất trực tiếp từ trang phát hành trên GitHub hoặc từ URL tải xuống chính thức.

Sau khi cài đặt, nhập thư viện và tạo một đối tượng cấu hình như được hiển thị trong ví dụ mã sau:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Đảm bảo môi trường chạy của bạn đáp ứng các yêu cầu về phiên bản Node.js và bạn có tài khoản GroupDocs hợp lệ để lấy thông tin xác thực client.

Tùy chọn và Cài đặt Loại bỏ chú thích

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

• clientId / clientSecret - Thông tin xác thực cho OAuth. Đặt chúng trong hàm khởi tạo Configuration.
• fileInfo.filePath - Đường dẫn tới tệp PDF trong lưu trữ GroupDocs Cloud. Điều chỉnh nếu bạn lưu tệp trong thư mục khác.
• annotationIds - Một mảng các ID được trả về bởi GetAnnotations. Cung cấp một phần con cho phép xóa có chọn lọc.

Các cài đặt bổ sung như thời gian chờ yêu cầu và cấu hình proxy có sẵn trong tài liệu SDK; xem tài liệu chính thức để biết danh sách đầy đủ.

Các thực tiễn tốt nhất cho việc xóa chú thích PDF qua REST

• Xác thực ID chú thích - Luôn kiểm tra xem các ID bạn dự định xóa có tồn tại hay không; việc cố gắng xóa các ID không tồn tại có thể gây ra lỗi 404.
• Sử dụng HTTPS - Tất cả các cuộc gọi API phải được thực hiện qua HTTPS để bảo vệ thông tin đăng nhập và dữ liệu tài liệu của bạn.
• Xử lý tệp lớn với tải lên dạng khối - Đối với các tệp PDF lớn hơn 100 MB, nên sử dụng endpoint tải lên đa phần để tránh thời gian chờ.
• Ghi lại phản hồi API - Lưu trữ ID yêu cầu và phản hồi để tạo nhật ký kiểm toán và dễ dàng khắc phục sự cố.
• Tái sử dụng token truy cập - Lưu token OAuth trong bộ nhớ đệm cho đến khi hết hạn để giảm tải xác thực.

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

• How do I authenticate with GroupDocs.Annotation Cloud API?
  Lấy client ID và secret từ tài khoản GroupDocs của bạn, sau đó yêu cầu một access token thông qua endpoint OAuth. Xem tài liệu chính thức để biết chi tiết.

• Tôi có thể xóa các chú thích cụ thể thay vì tất cả không?
  Có, hãy cung cấp các ID của các chú thích bạn muốn xóa trong DeleteAnnotationsRequest. SDK trả về danh sách các ID chú thích sau một cuộc gọi GetAnnotations.

• Làm thế nào để tôi xóa các đối tượng Annotation khỏi PDF bằng REST trong Node.JS?
  Sử dụng GroupDocs.Annotation Cloud SDK for Node.js để gọi endpoint DeleteAnnotations sau khi lấy các ID của annotation. Quy trình đầy đủ được trình bày trong ví dụ mã và phần cURL của hướng dẫn này.

• Cần giấy phép gì cho việc sử dụng trong môi trường sản xuất?
  Cần một giấy phép trả phí cho môi trường sản xuất. Bạn có thể nhận giấy phép tạm thời từ trang giấy phép tạm thời trong quá trình đánh giá.

Đọc thêm

• Trích xuất hoặc Xóa chú thích khỏi PDF bằng REST API trong Node.js
• Gạch ngang văn bản trong PDF với Node.js và REST API
• Xóa chú thích khỏi PDF bằng REST API trong Python

Chỉnh sửa tệp Excel trong Node.js qua REST - Hướng dẫn 5 bước

1. Cài đặt SDK và cấu hình thông tin xác thực: Đặt CLIENT_ID và CLIENT_SECRET của bạn để thư viện có thể xác thực với 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. Tải workbook Excel để chỉnh sửa: Sử dụng EditDocumentRequest để mở tệp được lưu trữ trong bộ nhớ đám mây của bạn.

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

3. Lấy worksheet đầu tiên và xác định ô mục tiêu: SDK trả về một đối tượng document chứa các worksheet và ô.

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

4. Cập nhật hoặc tạo giá trị ô: Thay đổi nội dung của ô A1 (hoặc thêm nếu chưa tồn tại).

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. Lưu workbook đã chỉnh sửa trở lại bộ nhớ lưu trữ: Cung cấp một outputPath và gọi 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);

Để xem danh sách đầy đủ các lớp và phương thức, hãy xem tài liệu API.

Chỉnh sửa tệp Excel trong Node.js qua REST - Ví dụ mã hoàn chỉnh

Ví dụ sau đây minh họa cách chỉnh sửa tệp Excel trong Node.js thông qua REST bằng cách sử dụng 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);
});

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.

Cập nhật Sheet XLSX bằng REST API trong Node.js qua cURL

Dưới đây là hướng dẫn nhanh về cùng một thao tác sử dụng các cuộc gọi HTTP thô. Thay thế các giá trị placeholder bằng thông tin xác thực và tên tệp thực tế của bạn.

1. Nhận token truy cập

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"

Phản hồi chứa access_token.

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

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

3. Chỉnh sửa sổ làm việc (sửa ô 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. Tải xuống tệp đã chỉnh sửa

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

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

Yêu cầu trước và Cài đặt cho GroupDocs.Editor Cloud SDK for Node.js

Để bắt đầu sử dụng SDK, bạn cần Node.js 14 hoặc phiên bản mới hơn và một tài khoản GroupDocs Cloud.

npm install groupdocs-editor-cloud

Bạn cũng có thể tải xuống gói mới nhất từ trang phát hành. Sau khi cài đặt, tạo một client_id và client_secret trong bảng điều khiển GroupDocs Cloud của bạn và giữ chúng an toàn.

Điều gì khiến GroupDocs.Editor Cloud SDK for Node.js trở nên lý tưởng cho việc chỉnh sửa các bảng tính Excel

• Full XLSX support - Tải, chỉnh sửa và lưu các workbook trong khi giữ nguyên công thức, kiểu dáng và xác thực dữ liệu.
• Cell‑level editing - Truy cập các ô, hàng hoặc cột riêng lẻ một cách lập trình, rất phù hợp để cập nhật báo cáo hoặc bảng điều khiển.
• Cloud storage integration - Làm việc trực tiếp với các tệp được lưu trữ trong GroupDocs Cloud mà không cần tải xuống cục bộ.
• Secure REST communication - Tất cả các thao tác diễn ra qua HTTPS, và SDK xử lý việc quản lý token cho bạn.

Để tìm hiểu sâu hơn, hãy tham khảo tài liệu.

Tinh chỉnh các tùy chọn chỉnh sửa Excel trong GroupDocs.Editor Cloud

SDK cung cấp một số tùy chọn cho phép bạn kiểm soát cách lưu workbook đã chỉnh sửa.

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

• outputPath - Đường dẫn đích trong lưu trữ đám mây.
• compressionLevel - Giảm kích thước tệp cho các workbook lớn (có sẵn trong tài liệu tham chiếu API).
• password - Bảo vệ tệp kết quả bằng mật khẩu nếu cần.

Điều chỉnh các cài đặt này để phù hợp với nhu cầu bảo mật và hiệu suất của dự án của bạn.

Các yếu tố cân nhắc về hiệu năng khi chỉnh sửa sổ làm việc XLSX qua REST

1. Tái sử dụng đối tượng cấu hình - Việc tạo một Configuration mới cho mỗi yêu cầu sẽ gây tốn tài nguyên. Giữ một thể hiện duy nhất trong suốt vòng đời của ứng dụng.
2. Cập nhật ô theo lô - Nếu bạn cần sửa đổi nhiều ô, hãy thu thập chúng vào một mảng và gửi một yêu cầu chỉnh sửa duy nhất thay vì nhiều lần gọi.
3. Giới hạn kích thước bảng tính - Bảng tính rất lớn sẽ tăng mức tiêu thụ bộ nhớ. Hãy cân nhắc chia dữ liệu thành nhiều sheet khi có thể.
4. Tránh lưu không cần thiết - Chỉ gọi saveDocument sau khi tất cả các thay đổi cần thiết đã được áp dụng để giảm các thao tác I/O.

Kết luận

Việc chỉnh sửa tệp Excel trong Node.js qua REST trở nên đơn giản với GroupDocs.Editor Cloud SDK for Node.js. Bạn có thể tải một workbook một cách lập trình, sửa đổi các ô và lưu kết quả chỉ bằng một vài lời gọi API hoặc các lệnh cURL đơn giản. Kiến trúc dựa trên đám mây của SDK loại bỏ nhu cầu cài đặt Office cục bộ và mở rộng phù hợp với tải công việc của ứng dụng của bạn. Đối với triển khai sản xuất, mua giấy phép phù hợp với mô hình sử dụng của bạn, và bạn cũng có thể lấy giấy phép tạm thời để thử nghiệm từ trang giấy phép tạm thời. Bắt đầu tích hợp chỉnh sửa Excel ngay hôm nay và tối ưu hoá quy trình xử lý dữ liệu của bạn.

FAQs

Làm thế nào để chỉnh sửa tệp Excel trong Node.js qua REST mà không cần viết mã HTTP tùy chỉnh?
Sử dụng GroupDocs.Editor Cloud SDK for Node.js, nó trừu tượng hóa các cuộc gọi REST và cho phép bạn chỉnh sửa tệp Excel trong Node.js qua REST bằng các lời gọi phương thức đơn giản.

Có thể cập nhật một sheet XLSX bằng REST api Node.js cho các tệp lớn không?
Có. SDK truyền dữ liệu theo luồng và hỗ trợ cập nhật theo lô, giúp phù hợp với các workbook lớn. Điều chỉnh compressionLevel và các thay đổi ô theo lô để cải thiện hiệu năng.

Cách tốt nhất để chỉnh sửa worksheet Excel một cách lập trình trong Node.js là gì?
Làm việc với các đối tượng worksheet và cell được trả về bởi editDocument. Điều này cho phép bạn kiểm soát hoàn toàn các hàng, cột và giá trị ô mà không rời khỏi môi trường Node.js.

Tôi có thể tìm thông tin về giá và giấy phép ở đâu?
Tất cả chi tiết về giấy phép, bao gồm các mức giá và giấy phép tạm thời để đánh giá, có sẵn trên trang giấy phép tạm thời.

Đọc thêm

• Chỉnh sửa bảng Excel qua REST trong Java
• Chỉnh sửa bảng Excel bằng REST API trong Python
• Các thực tiễn tốt nhất cho phát triển trình chỉnh sửa CSV trong Java