بصفتك مطور Python ، يمكنك إضافة تعليق توضيحي لأي ملف Word (.doc أو .docx) برمجيًا على السحابة. عادةً ما تكون التعليقات التوضيحية عبارة عن بيانات وصفية في شكل تعليقات أو ملاحظات أو تفسيرات أو أنواع أخرى من الملاحظات الخارجية في المستند توفر معلومات إضافية حول جزء موجود من البيانات. ستركز هذه المقالة على كيفية إضافة تعليق توضيحي لملفات DOCX باستخدام واجهة برمجة تطبيقات REST في Python.
سيتم تناول الموضوعات التالية في هذه المقالة:
- الوثيقة التوضيحية REST API و Python SDK
- علق ملفات DOCX باستخدام واجهة برمجة تطبيقات REST
- أضف العديد من التعليقات التوضيحية باستخدام Python
الوثيقة التوضيحية REST API و Python SDK
للتعليق على مستندات DOC أو DOCX ، سأستخدم Python SDK من GroupDocs.Annotation Cloud API. يسمح لك بإنشاء أدوات شرح للمستندات والصور عبر الإنترنت برمجيًا. يمكن استخدام هذه الأدوات لإضافة التعليقات التوضيحية ، وتراكبات العلامات المائية ، واستبدال النصوص ، والتنقيحات ، والملاحظات اللاصقة ، وعلامات النص إلى مستندات الأعمال بجميع التنسيقات الشائعة. كما أنها توفر حزم SDK لـ .NET و Java و PHP و Ruby و Node.js باعتبارها أعضاء عائلة التعليقات التوضيحية للمستندات لواجهة برمجة التطبيقات السحابية.
يمكنك تثبيت GroupDocs.Annotation Cloud على مشروع Python الخاص بك باستخدام الأمر التالي في وحدة التحكم:
pip install groupdocs_annotation_cloud
يرجى الحصول على معرّف العميل وسر العميل من لوحة القيادة قبل البدء في اتباع الخطوات وأمثلة الكود المتاحة. أضف المعرف الخاص بك والسر في الكود كما هو موضح أدناه:
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 في Python
يمكنك إضافة تعليقات توضيحية إلى ملف DOCX باتباع الخطوات البسيطة المذكورة أدناه:
- تحميل ملف DOCX إلى السحابة
- إضافة التعليقات التوضيحية إلى ملفات DOCX في Python
- تنزيل الملف المحدث
قم بتحميل المستند
بادئ ذي بدء ، قم بتحميل ملف DOCX إلى السحابة باستخدام مثال الرمز الموضح أدناه:
# إنشاء مثيل من 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
- قم بتعيين خصائص مختلفة للتعليقات التوضيحية ، مثل الموضع والنوع والنص وما إلى ذلك.
- قم بإنشاء مثيل FileInfo
- حدد مسار الملف
- إنشاء مثيل AnnotateOptions
- قم بتعيين معلومات الملف إلى AnnotateOptions
- قم بتعيين التعليق التوضيحي على AnnotateOptions
- قم بإنشاء طلب عن طريق استدعاء أسلوب AnnotateRequest
- احصل على النتائج عن طريق استدعاء طريقة AnnotateApi .annotate()
يوضح مقتطف التعليمات البرمجية التالي كيفية إدراج التعليقات التوضيحية للمنطقة في مستند Word باستخدام واجهة برمجة تطبيقات 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
# إضافة تعليق توضيحي للمنطقة
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
- قم بتعيين العديد من خصائص التعليق التوضيحي للمثال الأول ، مثل الموضع والنوع والنص وما إلى ذلك.
- إنشاء مثيل AnnotationInfo الثاني
- قم بتعيين العديد من خصائص التعليق التوضيحي للمثال الثاني ، مثل الموضع والنوع والنص وما إلى ذلك.
- قم بإنشاء مثيل FileInfo
- حدد مسار الملف
- إنشاء مثيل AnnotateOptions
- قم بتعيين معلومات الملف إلى AnnotateOptions
- قم بتعيين التعليقات التوضيحية الأولى والثانية على AnnotateOptions
- قم بإنشاء طلب عن طريق استدعاء أسلوب AnnotateRequest
- احصل على النتائج عن طريق استدعاء طريقة AnnotateApi .annotate()
يوضح مقتطف الشفرة التالي كيفية إضافة تعليقات توضيحية متعددة إلى ملف DOCX باستخدام واجهة برمجة تطبيقات 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 = 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 على السحابة باستخدام واجهة برمجة تطبيقات REST للتعليق التوضيحي للمستند باستخدام Python. لقد تعلمت أيضًا كيفية تحميل ملف DOCX برمجيًا على السحابة ثم تنزيل الملف المشروح من السحابة. يمكنك معرفة المزيد حول GroupDocs.Annotation Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.