Thêm chú thích trong Tài liệu Word bằng API REST trong Node.js

Chúng tôi có thể dễ dàng chú thích các tài liệu Word theo chương trình trên đám mây. Chúng tôi có thể thêm hình ảnh, nhận xét, ghi chú hoặc các loại nhận xét bên ngoài khác vào tài liệu dưới dạng chú thích. Trong bài viết này, chúng ta sẽ tìm hiểu cách thêm chú thích trong tài liệu Word bằng API REST trong Node.js.

Các chủ đề sau đây sẽ được đề cập trong bài viết này:

Chú thích tài liệu Word API REST và SDK Node.js

Để chú thích các tệp DOC hoặc DOCX, chúng tôi sẽ sử dụng API Node.js SDK của GroupDocs.Annotation Cloud. Vui lòng cài đặt nó bằng lệnh sau trong bảng điều khiển:

npm install groupdocs-annotation-cloud

Vui lòng lấy Client ID và Secret của bạn từ bảng điều khiển trước khi làm theo các bước được đề cập. Khi bạn có ID và bí mật của mình, hãy thêm mã như hình bên dưới:

global.clientId = "659fe7da-715b-4744-a0f7-cf469a392b73"; 
global.clientSecret = "b377c36cfa28fa69960ebac6b6e36421";
global.myStorage = "";

const configuration = new groupdocs_annotation_cloud.Configuration(clientId, clientSecret);
configuration.apiBaseUrl = "https://api.groupdocs.cloud";

Chú thích Tài liệu Word bằng API REST trong Node.js

Chúng tôi có thể thêm chú thích vào tệp DOCX bằng cách thực hiện theo các bước đơn giản được đề cập bên dưới:

Tải lên tài liệu

Đầu tiên, chúng tôi sẽ tải tệp DOCX lên Đám mây bằng ví dụ mã được cung cấp bên dưới:

// Khởi tạo API
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);
// Mở tệp trong IOStream từ cục bộ/đĩa.
var resourcesFolder = 'C:\\Files\\Annotation\\sample.docx';
fs.readFile(resourcesFolder, (err, fileStream) => {
  // Tạo yêu cầu tải lên
  var request = new groupdocs_annotation_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  // Cập nhật dử liệu
  fileApi.uploadFile(request);
});

Do đó, tệp DOCX đã tải lên sẽ có sẵn trong phần tệp của trang tổng quan trên đám mây.

Thêm nhiều chú thích vào tệp DOCX trong Node.js

Chúng tôi có thể thêm nhiều chú thích vào tài liệu Word theo chương trình bằng cách thực hiện theo các bước dưới đây:

  • Đầu tiên, tạo một phiên bản của AnnotateApi.
  • Tiếp theo, tạo phiên bản đầu tiên của AnnotationInfo.
  • Sau đó, đặt các thuộc tính chú thích cho trường hợp đầu tiên, ví dụ: vị trí, loại, văn bản, v.v.
  • Lặp lại các bước trên để thêm nhiều phiên bản của AnnotationInfo. Chúng tôi sẽ đặt các loại chú thích khác nhau và các thuộc tính khác cho từng phiên bản để thêm nhiều chú thích.
  • Tiếp theo, tạo một phiên bản của FileInfo và đặt đường dẫn tệp đầu vào.
  • Sau đó, tạo một phiên bản của AnnotateOptions.
  • Bây giờ, chỉ định FileInfo và các trường hợp chú thích đã xác định cho AnnotateOptions.
  • Ngoài ra, hãy đặt đường dẫn tệp đầu ra.
  • Sau đó, gọi phương thức AnnotateRequest bằng AnnotateOptions.
  • Cuối cùng, nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate() với AnnotateRequest.

Mẫu mã sau đây cho biết cách thêm nhiều chú thích vào tài liệu Word bằng API REST trong Node.js.

// Khởi tạo API
let annotateApi = groupdocs_annotation_cloud.chú thíchApi.fromKeys(clientId, clientSecret);

// Xác định chú thích khoảng cách
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 100
a1.pageNumber = 0
a1.penColor = 1201033
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 3
a1.opacity = 1
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Distance;
a1.text = "This is distance annotation";
a1.creatorName = "Anonym A.";

// Xác định chú thích khu vực
let a2 = new groupdocs_annotation_cloud.AnnotationInfo();
a2.annotationPosition = new groupdocs_annotation_cloud.Point();
a2.annotationPosition.x = 1;
a2.annotationPosition.y = 1;
a2.box = new groupdocs_annotation_cloud.Rectangle();
a2.box.x = 80
a2.box.y = 400
a2.box.width = 200
a2.box.height = 100
a2.penColor = 1201033;
a2.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a2.pageNumber = 0;
a2.penWidth = 3;
a2.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Area;
a2.text = "This is area annotation";
a2.creatorName = "Anonym A.";

// Xác định chú thích mũi tên
let a3 = new groupdocs_annotation_cloud.AnnotationInfo();
a3.annotationPosition = new groupdocs_annotation_cloud.Point();
a3.annotationPosition.x = 1;
a3.annotationPosition.y = 1;
a3.box = new groupdocs_annotation_cloud.Rectangle();
a3.box.x = 100;
a3.box.y = 100;
a3.box.width = 200;
a3.box.height = 100;
a3.pageNumber = 0;
a3.penColor = 1201033;
a3.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a3.penWidth = 1;
a3.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Arrow;
a3.text = "This is arrow annotation";
a3.creatorName = "Anonym A.";

// Xác định chú thích Ellipse
let a4 = new groupdocs_annotation_cloud.AnnotationInfo();
a4.annotationPosition = new groupdocs_annotation_cloud.Point();
a4.annotationPosition.x = 1;
a4.annotationPosition.y = 1;
a4.box = new groupdocs_annotation_cloud.Rectangle();
a4.box.x = 350;
a4.box.y = 350;
a4.box.width = 200;
a4.box.height = 100;
a4.pageNumber = 0;
a4.penColor = 1201033;
a4.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a4.penWidth = 4;
a4.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Ellipse;
a4.text = "This is ellipse annotation";
a4.creatorName = "Anonym A.";

// Đường dẫn tệp đầu vào
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Xác định các tùy chọn chú thích
let options = new groupdocs_annotation_cloud.chú thíchOptions();
options.fileInfo = fileInfo;
options.annotations = [a1, a2, a3, a4];
options.outputPath = "AddMultipleAnnotations.docx";

// Tạo yêu cầu chú thích
let request = new groupdocs_annotation_cloud.chú thíchRequest(options);

// chú thích
let result = await annotateApi.annotate(request);
Thêm nhiều chú thích vào tệp DOCX trong Node.js

Thêm nhiều chú thích vào tệp DOCX trong Node.js

Tải xuống tệp chú thích

Mẫu mã trên sẽ lưu tài liệu Word có chú thích (DOCX) trên đám mây. Nó có thể được tải xuống bằng cách sử dụng mẫu mã sau:

// Xây dựng tệpApi
var fileApi = new groupdocs_annotation_cloud.FileApi(configuration);

// Tạo yêu cầu tệp tải xuống
let request = new groupdocs_annotation_cloud.DownloadFileRequest("AddMultipleAnnotations.docx", myStorage);
// Tải tập tin
let response = await fileApi.downloadFile(request);

// Lưu tệp trong thư mục làm việc
fs.writeFile("C:\\Files\\Annotation\\AddMultipleAnnotations.docx", response, "binary", function (err) { });

Thêm chú thích hình ảnh trong Tài liệu Word bằng API REST trong Node.js

Chúng tôi có thể thêm chú thích hình ảnh trong tài liệu Word theo chương trình bằng cách thực hiện theo các bước dưới đây:

  • Đầu tiên, tạo một phiên bản của AnnotateApi.
  • Tiếp theo, tạo một phiên bản của AnnotationInfo.
  • Sau đó, xác định một hình chữ nhật và đặt vị trí, chiều cao và chiều rộng của nó.
  • Sau đó, đặt thuộc tính chú thích, ví dụ: vị trí, văn bản, chiều cao, chiều rộng, v.v.
  • Sau đó, đặt loại chú thích là Hình ảnh.
  • Tiếp theo, tạo một phiên bản của FileInfo và đặt đường dẫn tệp đầu vào.
  • Sau đó, tạo một phiên bản của AnnotateOptions.
  • Bây giờ, gán đối tượng FileInfo và chú thích cho AnnotateOptions.
  • Ngoài ra, hãy đặt đường dẫn tệp đầu ra.
  • Sau đó, tạo một yêu cầu bằng cách gọi phương thức AnnotateRequest với đối tượng AnnotateOptions làm đối số.
  • Cuối cùng, nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate() với đối tượng AnnotateRequest.

Mẫu mã sau đây cho biết cách thêm chú thích hình ảnh vào tài liệu Word bằng API REST trong Node.js. Vui lòng làm theo các bước được đề cập trước đó để tải lên và tải xuống tệp.

// Khởi tạo API
let annotateApi = groupdocs_annotation_cloud.chú thíchApi.fromKeys(clientId, clientSecret);

// Xác định chú thích hình ảnh
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 300;
a1.box.y = 320;
a1.box.width = 200;
a1.box.height = 40;
a1.pageNumber = 0;
a1.penColor = 1201033;
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 1;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Image;
a1.text = "This is image annotation";
a1.creatorName = "Anonym A.";
a1.imagePath = "JohnSmith.png";

// Đường dẫn tệp đầu vào
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Xác định tùy chọn Chú thích
let options = new groupdocs_annotation_cloud.chú thíchOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddImageAnnotation.docx";

// Tạo yêu cầu chú thích
let request = new groupdocs_annotation_cloud.chú thíchRequest(options);

// chú thích
let result = await annotateApi.annotate(request);
Thêm chú thích hình ảnh trong Tài liệu Word bằng API REST trong Node.js

Thêm chú thích hình ảnh trong Tài liệu Word bằng API REST trong Node.js

Thêm chú thích trường văn bản trong Tài liệu Word bằng API REST trong Node.js

Chúng tôi có thể thêm chú thích trường văn bản trong tài liệu Word theo chương trình bằng cách làm theo các bước được đề cập trước đó. Tuy nhiên, chúng ta cần đặt loại chú thích là TextField.

Mẫu mã sau đây cho biết cách thêm chú thích trường văn bản vào tài liệu Word bằng API REST trong Node.js. Vui lòng làm theo các bước được đề cập trước đó để tải lên và tải xuống tệp.

// Khởi tạo API
let annotateApi = groupdocs_annotation_cloud.chú thíchApi.fromKeys(clientId, clientSecret);

// Xác định chú thích trường văn bản
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 300;
a1.box.y = 310;
a1.box.width = 200;
a1.box.height = 50;
a1.pageNumber = 0;
a1.fontColor = 3093151;
a1.fontSize = 12;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.TextField;
a1.text = "Text field text";
a1.creatorName = "Anonym A.";

// Đường dẫn tệp đầu vào
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Xác định tùy chọn chú thích
let options = new groupdocs_annotation_cloud.chú thíchOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddTextFieldAnnotation.docx";

// Tạo yêu cầu chú thích
let request = new groupdocs_annotation_cloud.chú thíchRequest(options);

// chú thích
let result = await annotateApi.annotate(request);
Thêm chú thích trong Tài liệu Word bằng API REST trong Node.js

Thêm chú thích trường văn bản trong Tài liệu Word bằng API REST trong Node.js

Chú thích hình mờ trong Tài liệu Word bằng API REST trong Node.js

Chúng tôi có thể thêm chú thích hình mờ trong tài liệu Word theo chương trình bằng cách làm theo các bước được đề cập trước đó. Tuy nhiên, chúng ta cần đặt loại chú thích là Hình chìm mờ.

Mẫu mã sau đây cho biết cách thêm chú thích hình mờ vào tài liệu Word bằng API REST trong Node.js. Vui lòng làm theo các bước được đề cập trước đó để tải lên và tải xuống tệp.

// Khởi tạo API
let annotateApi = groupdocs_annotation_cloud.chú thíchApi.fromKeys(clientId, clientSecret);

// Xác định chú thích hình mờ
let a1 = new groupdocs_annotation_cloud.AnnotationInfo();
a1.annotationPosition = new groupdocs_annotation_cloud.Point();
a1.annotationPosition.x = 1;
a1.annotationPosition.y = 1;
a1.box = new groupdocs_annotation_cloud.Rectangle();
a1.box.x = 100;
a1.box.y = 700;
a1.box.width = 500;
a1.box.height = 100;
a1.pageNumber = 0;
a1.penColor = 1201033;
a1.penStyle = groupdocs_annotation_cloud.AnnotationInfo.PenStyleEnum.Solid;
a1.penWidth = 2;
a1.fontSize = 24;
a1.angle = 75;
a1.type = groupdocs_annotation_cloud.AnnotationInfo.TypeEnum.Watermark;
a1.text = "This is a watermark annotation";
a1.creatorName = "Anonym A.";

// Đường dẫn tệp đầu vào
let fileInfo = new groupdocs_annotation_cloud.FileInfo();
fileInfo.filePath = "sample.docx";

// Xác định tùy chọn Chú thích
let options = new groupdocs_annotation_cloud.chú thíchOptions();
options.fileInfo = fileInfo;
options.annotations = [a1];
options.outputPath = "AddWatermarkAnnotation.docx";

// Tạo yêu cầu chú thích
let request = new groupdocs_annotation_cloud.chú thíchRequest(options);

// chú thích
let result = await annotateApi.annotate(request);
Chú thích hình mờ trong Tài liệu Word bằng API REST trong Node.js

Chú thích hình mờ trong Tài liệu Word bằng API REST trong Node.js

Thử trực tuyến

Vui lòng dùng thử công cụ chú thích DOCX trực tuyến miễn phí sau đây, được phát triển bằng cách sử dụng API ở trên. https://products.groupdocs.app/annotation/docx

Phần kết luận

Trong bài viết này, chúng ta đã học cách thêm chú thích vào tài liệu Word trên đám mây. Chúng ta cũng đã thấy cách thêm chú thích trường hình ảnh và văn bản vào tệp DOCX bằng API REST trong Node.js. Bài viết này cũng giải thích cách lập trình tải tệp DOCX lên đám mây rồi tải xuống tệp đã chỉnh sửa từ Đám mây. Ngoài ra, bạn có thể tìm hiểu thêm về GroupDocs.Annotation Cloud API bằng cách sử dụng tài liệu. Chúng tôi cũng cung cấp phần Tham chiếu API cho phép bạn hình dung và tương tác trực tiếp với các API của chúng tôi thông qua trình duyệt. Trong trường hợp có bất kỳ sự mơ hồ nào, vui lòng liên hệ với chúng tôi trên diễn đàn.

Xem thêm