تقوم بايثون باستخراج أو إزالة التعليقات التوضيحية من ملفات Word.

بصفتك مطور Python ، يمكنك إضافة تعليق توضيحي لأي ملف Word (.doc أو .docx) برمجيًا على السحابة. يمكنك أيضًا استخراج أو إزالة جميع التعليقات التوضيحية من ملفات Word باستخدام Python. تتضمن التعليقات التوضيحية التعليقات والنوافذ المنبثقة والعديد من الكائنات الرسومية الأخرى في المستند التي توفر معلومات إضافية. ستركز هذه المقالة على كيفية استخراج التعليقات التوضيحية أو إزالتها من ملفات DOCX باستخدام واجهة برمجة تطبيقات REST في Python.

سيتم تناول الموضوعات التالية في هذه المقالة:

الوثيقة التوضيحية REST API و Python SDK

لاستخراج التعليقات التوضيحية أو إزالتها من ملفات DOC أو DOCX ، سأستخدم Python SDK of GroupDocs.Annotation Cloud API. يسمح لك بإنشاء أدوات شرح للمستندات والصور عبر الإنترنت برمجيًا. يمكن استخدام هذه الأدوات لإضافة التعليقات التوضيحية ، وتراكبات العلامات المائية ، واستبدال النصوص ، والتنقيحات ، والملاحظات اللاصقة ، وعلامات النص إلى مستندات الأعمال بجميع التنسيقات الشائعة. كما أنها توفر حزم SDK لـ .NET و Java و PHP و Ruby و Node.js باعتبارها أعضاء عائلة التعليقات التوضيحية للمستندات لواجهة برمجة التطبيقات السحابية.

يمكنك تثبيت GroupDocs.Annotation Cloud على مشروع Python الخاص بك باستخدام الأمر التالي في وحدة التحكم:

pip install groupdocs_annotation_cloud

يرجى الحصول على معرّف العميل وسر العميل من لوحة القيادة قبل البدء في اتباع الخطوات وأمثلة الكود المتاحة. بمجرد حصولك على المعرف والسر الخاص بك ، قم بإضافة الرمز كما هو موضح أدناه:

client_id = "da0c487d-c1c0-45ae-b7bf-43eaf53c5ad5"
client_secret = "479db2b01dcb93a3d4d20efb16dea971"

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

استخراج أو إزالة التعليقات التوضيحية من ملفات DOCX باستخدام واجهة برمجة تطبيقات REST في Python

يمكنك استخراج أو حذف جميع التعليقات التوضيحية من ملفات DOCX باتباع الخطوات البسيطة المذكورة أدناه:

قم بتحميل المستند

أولاً ، قم بتحميل ملف DOCX إلى السحابة باستخدام مثال الرمز الموضح أدناه:

# مثيل API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)

# رفع ملف
request = groupdocs_annotation_cloud.UploadFileRequest("input.docx", "C:\\Files\\input.docx", my_storage)
response = file_api.upload_file(request)

نتيجة لذلك ، سيكون ملف DOCX الذي تم تحميله (input.docx) متاحًا في قسم الملفات من لوحة المعلومات الخاصة بك على السحابة.

استخراج التعليقات التوضيحية من ملفات DOCX في Python

يرجى اتباع الخطوات المذكورة أدناه لاستخراج التعليقات التوضيحية من مستند Word برمجيًا.

  • قم بإنشاء مثيل لـ AnnotateApi
  • قم بإنشاء مثيل FileInfo
  • عيّن مسار الملف
  • قم بإنشاء طلب عن طريق استدعاء طريقة ExtractRequest
  • احصل على النتائج عن طريق استدعاء طريقة AnnotateApi.extract()

يوضح مقتطف الشفرة التالي كيفية استخراج التعليقات التوضيحية من مستند Word باستخدام واجهة برمجة تطبيقات REST.

# مثيل API
api = groupdocs_annotation_cloud.AnnotateApi.from_config(configuration)

# تفاصيل ملف الإدخال
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "input.docx"

# طلب استخراج شرح توضيحي
request = groupdocs_annotation_cloud.ExtractRequest(file_info)
result = api.extract(request)        

print("ExtractAnnotations: annotations count: " + str(len(result)))

سيعرض نموذج الكود أعلاه مصفوفة من جميع التعليقات التوضيحية بتنسيق JSON كما هو موضح أدناه:

استخراج التعليقات التوضيحية من ملف DOCX باستخدام Python

استخراج التعليقات التوضيحية من ملف DOCX باستخدام Python

إزالة التعليقات التوضيحية من ملفات DOCX في Python

يرجى اتباع الخطوات المذكورة أدناه لحذف التعليقات التوضيحية من مستند Word برمجيًا.

  • قم بإنشاء مثيل لـ AnnotateApi
  • قم بإنشاء مثيل FileInfo
  • عيّن مسار الملف
  • حدد RemoveOptions
  • قم بتعيين معلومات الملف إلى AnnotateOptions
  • قدِّم معرّفات التعليقات التوضيحية لإزالتها
  • تعيين مسار ملف الإخراج
  • قم بإنشاء طلب عن طريق استدعاء الأسلوب RemoveAnnotationsRequest
  • احصل على النتائج عن طريق استدعاء طريقة AnnotateApi.remove \ annotations()

يوضح مقتطف الشفرة التالي كيفية إزالة التعليقات التوضيحية من مستند Word باستخدام واجهة برمجة تطبيقات REST. تحتاج إلى ذكر معرّفات التعليقات التوضيحية التي يجب إزالتها من المستند.

# مثيل API
api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)

# تفاصيل ملف الإدخال
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "input.docx"

# خيارات الإزالة
options = groupdocs_annotation_cloud.RemoveOptions()
options.file_info = file_info
options.annotation_ids = [0,1,2,3,4,5,6,7,8,9,10,11]

# ملف إلاخراج
options.output_path = "output.docx"

# طلب إزالة
request = groupdocs_annotation_cloud.RemoveAnnotationsRequest(options)
result = api.remove_annotations(request)

print("RemoveAnnotations: Annotations removed: " + result['href'])
إزالة التعليقات التوضيحية من ملف DOCX باستخدام Python

إزالة التعليقات التوضيحية من ملف DOCX باستخدام Python

قم بتنزيل ملف الإخراج

سيحفظ نموذج الكود أعلاه ملف DOCX الناتج (output.docx) بعد إزالة التعليقات التوضيحية على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية التالي:

# مثيل API
file_api = groupdocs_annotation_cloud.FileApi.from_config(configuration)

# طلب تحميل الملف
request = groupdocs_annotation_cloud.DownloadFileRequest("output.docx", my_storage)
response = file_api.download_file(request)

# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(response, "C:\\Files\\")

جرب عبر الإنترنت

يرجى تجربة أداة التعليق التوضيحي DOCX المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/annotation/docx

خاتمة

في هذه المقالة ، تعلمت كيفية استخراج التعليقات التوضيحية أو إزالتها من مستندات Word على السحابة باستخدام Python. لقد تعلمت أيضًا كيفية تحميل ملف DOCX برمجيًا على السحابة وتنزيل الملف من السحابة. يمكنك معرفة المزيد حول GroupDocs.Annotation Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، لا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا