Chú thích tệp Word bằng Python

Là nhà phát triển Python, bạn có thể chú thích bất kỳ tệp Word (.doc hoặc .docx) nào theo chương trình trên đám mây. Chú thích thường là siêu dữ liệu dưới dạng nhận xét, ghi chú, giải thích hoặc các loại nhận xét bên ngoài khác trong tài liệu cung cấp thông tin bổ sung về một phần dữ liệu hiện có. Bài viết này sẽ tập trung vào cách chú thích các tệp DOCX bằng API REST trong Python.

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

• Chú thích tài liệu API REST và Python SDK
• Chú thích các tệp DOCX bằng API REST
• Thêm nhiều chú thích bằng Python

Chú thích tài liệu API REST và Python SDK

Để chú thích tài liệu DOC hoặc DOCX, tôi sẽ sử dụng API Python SDK của GroupDocs.Annotation Cloud. Nó cho phép bạn xây dựng các công cụ chú thích hình ảnh và tài liệu trực tuyến theo chương trình. Những công cụ như vậy có thể được sử dụng để thêm chú thích, lớp phủ hình mờ, thay thế văn bản, biên tập, ghi chú dán và đánh dấu văn bản vào các tài liệu kinh doanh ở tất cả các định dạng phổ biến. Nó cũng cung cấp SDK .NET, Java, PHP, Ruby và Node.js dưới dạng các thành viên dòng chú thích tài liệu cho Cloud API.

Bạn có thể cài đặt GroupDocs.Annotation Cloud cho dự án Python của mình bằng lệnh sau trong bảng điều khiển:

pip install groupdocs_annotation_cloud

Vui lòng lấy ID khách hàng và Bí mật khách hàng của bạn từ bảng điều khiển trước khi bạn bắt đầu làm theo các bước và ví dụ về mã có sẵn. Thêm ID và bí mật của bạn vào mã như minh họa bên dưới:

client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
my_storage = ""

configurations = groupdocs_annotation_cloud.Configuration(client_id, client_secret)
configurations.api_base_url = "https://api.groupdocs.cloud"

Chú thích các tệp DOCX bằng API REST trong Python

Bạn có thể thêm chú thích vào tệp DOCX bằng cách làm theo các bước đơn giản dưới đây:

• Tải lên tệp DOCX lên Đám mây
• Thêm chú thích vào tệp DOCX trong Python
• Tải xuống tệp đã cập nhật

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

Trước hết, hãy tải tệp DOCX lên Đám mây bằng ví dụ mã được cung cấp bên dưới:

# Tạo phiên bản của API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configurations)

request = groupdocs_annotation_cloud.UploadFileRequest("one-page.docx", "C:\\Files\\one-page.docx", my_storage)
response = file_api.upload_file(request)

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

Thêm chú thích vào tệp DOCX bằng Python

Vui lòng làm theo các bước được đề cập bên dưới để chèn chú thích vào tài liệu Word theo chương trình.

• Tạo một phiên bản của AnnotationInfo
• Đặt các thuộc tính Chú thích khác nhau, ví dụ: vị trí, loại, văn bản, v.v.
• Tạo một phiên bản FileInfo
• Đặt đường dẫn tệp
• Tạo một phiên bản của AnnotateOptions
• Đặt thông tin tệp thành AnnotateOptions
• Đặt chú thích thành AnnotateOptions
• Tạo một yêu cầu bằng cách gọi phương thức AnnotateRequest
• Nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate()

Đoạn mã sau cho biết cách chèn chú thích vùng trong tài liệu Word bằng API REST.

api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)

a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.7

# Thêm chú thích khu vực
a1.type = "Area"
a1.text = "This is area annotation"
a1.creator_name = "Anonym A."

file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "one-page.docx"
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "Output\\output.docx"

request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)

Kết quả là các chú thích khu vực sẽ được chèn vào tài liệu như hình bên dưới.

Các loại chú thích được hỗ trợ

Vui lòng tìm bên dưới danh sách các loại chú thích được hỗ trợ, bạn có thể thêm vào tệp DOCX của mình bằng cách làm theo các bước được đề cập trước đó:

• Khu vực
• Khoảng cách
• liên kết
• Điểm
• đa tuyến
• Hình ảnh
• Chữ
• Chữ ký ảnh
• mũi tên

Tải xuống tệp cập nhật

Mẫu mã trên sẽ lưu tệp DOCX có chú thích trên đám mây. Bạn có thể tải xuống bằng mẫu mã sau:

# Tạo phiên bản của API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configurations)

request = groupdocs_annotation_cloud.DownloadFileRequest("Output\\output.docx", my_storage)
response = file_api.download_file(request)

# Di chuyển tệp đã tải xuống vào thư mục làm việc của bạn
shutil.move(response, "C:\\Files\\")

Thêm nhiều chú thích bằng Python

Vui lòng làm theo các bước được đề cập bên dưới để thêm nhiều chú thích vào tệp DOCX của bạn theo chương trình.

• Tạo phiên bản đầu tiên của AnnotationInfo
• Đặt các thuộc tính Chú thích khác nhau cho trường hợp đầu tiên, ví dụ: vị trí, loại, văn bản, v.v.
• Tạo phiên bản thứ hai của AnnotationInfo
• Đặt các thuộc tính chú thích khác nhau cho trường hợp thứ hai, ví dụ: vị trí, loại, văn bản, v.v.
• Tạo một phiên bản FileInfo
• Đặt đường dẫn tệp
• Tạo một phiên bản của AnnotateOptions
• Đặt thông tin tệp thành AnnotateOptions
• Đặt chú thích thứ nhất và thứ hai thành AnnotateOptions
• Tạo một yêu cầu bằng cách gọi phương thức AnnotateRequest
• Nhận kết quả bằng cách gọi phương thức AnnotateApi.annotate()

Đoạn mã sau cho biết cách thêm nhiều chú thích vào tệp DOCX bằng API REST. 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.

api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)
  
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 200
a1.box.y = 200
a1.box.width = 300
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.2
a1.type = "Watermark"
a1.text = "This is watermark annotation"
a1.creator_name = "Anonym A."
    
a2 = groupdocs_annotation_cloud.AnnotationInfo()
a2.annotation_position = groupdocs_annotation_cloud.Point()
a2.annotation_position.x = 852
a2.annotation_position.y = 59.38
a2.box = groupdocs_annotation_cloud.Rectangle()
a2.box.x = 375.8
a2.box.y = 59.38
a2.box.width = 88
a2.box.height = 37
a2.page_number = 2
a2.pen_color = 1201033
a2.pen_style = "Solid"
a2.pen_width = 1
a2.opacity = 0.9
a2.type = "Image"
a2.text = "This is Image annotation"
a2.creator_name = "Anonym A."
a2.image_path = "JohnSmith.png"
    
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "ten-pages.docx"
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2]
options.output_path = "Output\\output.docx"

request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)

Kết quả là chú thích hình ảnh và hình mờ sẽ được chèn vào tài liệu như hình bên dưới.

Phần kết luận

Trong bài viết này, bạn đã học cách thêm nhiều loại chú thích khác nhau vào tài liệu Word trên đám mây bằng API REST chú thích tài liệu bằng Python. Bạn cũng đã học cách lập trình tải lên tệp DOCX trên đám mây và sau đó tải xuống tệp có chú thích từ đám mây. 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 khảo 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.