ในฐานะนักพัฒนา Python คุณสามารถใส่คำอธิบายประกอบไฟล์ Word (.doc หรือ .docx) ใดๆ บนระบบคลาวด์โดยทางโปรแกรม คำอธิบายประกอบมักเป็นข้อมูลเมตาในรูปแบบของความคิดเห็น บันทึก คำอธิบาย หรือข้อสังเกตภายนอกประเภทอื่นๆ ในเอกสารที่ให้ข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลที่มีอยู่ บทความนี้จะมุ่งเน้นไปที่วิธีการใส่คำอธิบายประกอบไฟล์ DOCX โดยใช้ REST API ใน Python
หัวข้อต่อไปนี้จะครอบคลุมในบทความนี้:
- คำอธิบายประกอบเอกสาร REST API และ Python SDK
- ใส่คำอธิบายประกอบไฟล์ DOCX โดยใช้ REST API
- เพิ่มคำอธิบายประกอบหลายรายการโดยใช้ Python
คำอธิบายประกอบเอกสาร REST API และ Python SDK
สำหรับการเพิ่มคำอธิบายประกอบในเอกสาร DOC หรือ DOCX ฉันจะใช้ API ของ Python SDK of GroupDocs.Annotation Cloud ช่วยให้คุณสร้างเครื่องมือทำหมายเหตุประกอบเอกสารและรูปภาพแบบออนไลน์ได้ เครื่องมือดังกล่าวสามารถใช้เพื่อเพิ่มคำอธิบายประกอบ การซ้อนทับลายน้ำ การแทนที่ข้อความ การแก้ไข โน้ตแปะ และมาร์กอัปข้อความในเอกสารทางธุรกิจในรูปแบบยอดนิยมทั้งหมด นอกจากนี้ยังมี .NET, Java, PHP, Ruby และ Node.js SDK เป็น document annotation family members สำหรับ Cloud API
คุณสามารถติดตั้ง GroupDocs.Annotation Cloud ในโครงการ Python ของคุณโดยใช้คำสั่งต่อไปนี้ในคอนโซล:
pip install groupdocs_annotation_cloud
โปรดรับรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ของคุณจาก แดชบอร์ด ก่อนที่คุณจะเริ่มทำตามขั้นตอนและตัวอย่างโค้ดที่มีอยู่ เพิ่ม ID และความลับของคุณในรหัสที่แสดงด้านล่าง:
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"
ใส่คำอธิบายประกอบไฟล์ DOCX โดยใช้ REST API ใน Python
คุณสามารถเพิ่มคำอธิบายประกอบลงในไฟล์ DOCX โดยทำตามขั้นตอนง่าย ๆ ที่กล่าวถึงด้านล่าง:
- อัปโหลด ไฟล์ DOCX ไปยังคลาวด์
- เพิ่มคำอธิบายประกอบให้กับไฟล์ DOCX ใน Python
- ดาวน์โหลด ไฟล์ที่อัปเดต
อัปโหลดเอกสาร
ก่อนอื่น อัปโหลดไฟล์ DOCX ไปยัง Cloud โดยใช้ตัวอย่างโค้ดด้านล่าง:
# สร้างอินสแตนซ์ของ 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)
ด้วยเหตุนี้ ไฟล์ DOCX ที่อัปโหลดจะอยู่ใน ส่วนไฟล์ ของแดชบอร์ดของคุณบนระบบคลาวด์
เพิ่มคำอธิบายประกอบให้กับไฟล์ DOCX ใน Python
โปรดทำตามขั้นตอนด้านล่างเพื่อแทรกคำอธิบายประกอบในเอกสาร Word โดยทางโปรแกรม
- สร้างอินสแตนซ์ของ AnnotationInfo
- กำหนดคุณสมบัติ Annotation ได้หลากหลาย เช่น ตำแหน่ง ประเภท ข้อความ ฯลฯ
- สร้างอินสแตนซ์ FileInfo
- กำหนดเส้นทางของไฟล์
- สร้างอินสแตนซ์ของ AnnotateOptions
- ตั้งค่าข้อมูลไฟล์เป็น AnnotateOptions
- ตั้งค่าคำอธิบายประกอบเป็น AnnotateOptions
- สร้างคำขอโดยเรียกเมธอด AnnotateRequest
- รับผลลัพธ์โดยเรียกเมธอด AnnotateApi.annotate()
ข้อมูลโค้ดต่อไปนี้แสดงวิธีแทรกคำอธิบายประกอบพื้นที่ในเอกสาร Word โดยใช้ REST API
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
# เพิ่มคำอธิบายประกอบพื้นที่
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)
ดังนั้นคำอธิบายประกอบพื้นที่จะถูกแทรกในเอกสารดังที่แสดงด้านล่าง
ประเภทคำอธิบายประกอบที่รองรับ
โปรดดูรายการประเภทคำอธิบายประกอบที่รองรับด้านล่าง คุณสามารถเพิ่มลงในไฟล์ DOCX ของคุณโดยทำตามขั้นตอนที่กล่าวถึงก่อนหน้านี้:
- พื้นที่
- ระยะทาง
- ลิงค์
- จุด
- โพลีไลน์
- ภาพ
- ข้อความ
- ลายน้ำ
- ลูกศร
ดาวน์โหลดไฟล์ที่อัปเดตแล้ว
ตัวอย่างโค้ดด้านบนจะบันทึกไฟล์ DOCX ที่มีคำอธิบายประกอบไว้บนคลาวด์ คุณสามารถดาวน์โหลดได้โดยใช้ตัวอย่างโค้ดต่อไปนี้:
# สร้างอินสแตนซ์ของ 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)
# ย้ายไฟล์ที่ดาวน์โหลดไปยังไดเร็กทอรีการทำงานของคุณ
shutil.move(response, "C:\\Files\\")
เพิ่มคำอธิบายประกอบหลายรายการโดยใช้ Python
โปรดทำตามขั้นตอนด้านล่างเพื่อเพิ่มคำอธิบายประกอบหลายรายการในไฟล์ DOCX ของคุณโดยทางโปรแกรม
- สร้างอินสแตนซ์แรกของ AnnotationInfo
- ตั้งค่าคุณสมบัติ Annotation ต่างๆ สำหรับตัวอย่างแรก เช่น ตำแหน่ง ประเภท ข้อความ ฯลฯ
- สร้างอินสแตนซ์ที่สองของ AnnotationInfo
- ตั้งค่าคุณสมบัติคำอธิบายประกอบต่างๆ สำหรับตัวอย่างที่สอง เช่น ตำแหน่ง ประเภท ข้อความ ฯลฯ
- สร้างอินสแตนซ์ FileInfo
- กำหนดเส้นทางของไฟล์
- สร้างอินสแตนซ์ของ AnnotateOptions
- ตั้งค่าข้อมูลไฟล์เป็น AnnotateOptions
- ตั้งค่าคำอธิบายประกอบที่หนึ่งและสองเป็น AnnotateOptions
- สร้างคำขอโดยเรียกเมธอด AnnotateRequest
- รับผลลัพธ์โดยเรียกเมธอด AnnotateApi.annotate()
ข้อมูลโค้ดต่อไปนี้แสดงวิธีเพิ่มคำอธิบายประกอบหลายรายการในไฟล์ DOCX โดยใช้ REST API โปรดทำตามขั้นตอนที่กล่าวถึงก่อนหน้านี้เพื่ออัปโหลดและดาวน์โหลดไฟล์
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)
ดังนั้นคำอธิบายประกอบรูปภาพและลายน้ำจะถูกแทรกในเอกสารดังที่แสดงด้านล่าง
บทสรุป
ในบทความนี้ คุณได้เรียนรู้วิธีเพิ่มคำอธิบายประกอบประเภทต่างๆ ลงในเอกสาร Word บนคลาวด์ด้วย Document Annotation REST API โดยใช้ Python คุณยังได้เรียนรู้วิธีอัปโหลดไฟล์ DOCX ทางโปรแกรมบนคลาวด์ จากนั้นดาวน์โหลดไฟล์ที่มีคำอธิบายประกอบจากคลาวด์ คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับ GroupDocs.Annotation Cloud API โดยใช้ เอกสารประกอบ นอกจากนี้ เรายังมีส่วน การอ้างอิง API ที่ช่วยให้คุณแสดงภาพและโต้ตอบกับ API ของเราได้โดยตรงผ่านเบราว์เซอร์ ในกรณีที่มีความคลุมเครือ โปรดติดต่อเราได้ที่ ฟอรัม