قبول التغييرات أو رفضها

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

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

مقارنة المستندات REST API و Python SDK

للعمل مع المراجعات ، سأستخدم Python SDK of GroupDocs.Comparison Cloud API. يقارن بين مستندين من تنسيقات الملفات المدعومة ويجد الاختلافات بينهما. نتيجة لذلك ، يقوم بإنشاء ملف ناتج يحتوي على اختلافات. كما يتيح لك قبول التغييرات المسترجعة أو رفضها. يمكنك بسهولة دمج SDK في تطبيقات Python الموجودة لديك. يمكّنك من مقارنة المستندات وجداول البيانات والعروض التقديمية ومخططات Microsoft Visio ورسائل البريد الإلكتروني وملفات من العديد من التنسيقات الأخرى. كما يوفر NET و Java و PHP و Node.js و Ruby SDKs باعتبارها أعضاء عائلة مقارنة المستندات لواجهة برمجة التطبيقات السحابية.

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

pip install groupdocs_comparison_cloud

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

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

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

قبول أو رفض التغييرات المتعقبة باستخدام واجهة برمجة تطبيقات REST في Python

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

  1. تحميل ملفات DOCX إلى السحابة
  2. قبول أو رفض التغييرات باستخدام بايثون
  3. تحميل الملف الناتج

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

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

# إنشاء مثيل لواجهة برمجة التطبيقات
file_api = groupdocs_comparison_cloud.FileApi.from_config(configuration)

request = groupdocs_comparison_cloud.UploadFileRequest("source_with_revs.docx", "C:\\Files\\source_with_revs.docx", "")
response = file_api.upload_file(request)

نتيجة لذلك ، سيكون ملف DOCX الذي تم تحميله متاحًا في قسم الملفات من لوحة المعلومات على السحابة.

قبول التغييرات أو رفضها باستخدام بايثون

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

  • قم بإنشاء مثيل ReviewApi
  • قم بتعيين ملف .docx المصدر
  • حدد ApplyRevisionsOptions
  • قم بتعيين المصدر وتعيين ملف الإخراج
  • قم بإنشاء GetRevisionsRequest
  • احصل على المراجعات عن طريق استدعاء طريقة ReviewApi.get \ revisions()
  • قم بتعيين إجراء المراجعة على “قبول” أو “رفض” لكل مراجعة
  • تعيين المراجعات المحدثة إلى ApplyRevisionsOptions
  • إنشاء ApplyRevisionsRequest
  • احصل على النتائج عن طريق استدعاء طريقة ReviewApi.apply \ revisions()

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

# إنشاء مثيل لواجهة برمجة التطبيقات
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)

# تعيين ملف المصدر
source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_with_revs.docx"

options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

request = groupdocs_comparison_cloud.GetRevisionsRequest(options)
revisions = api_instance.get_revisions(request)

# الحصول على عدد المراجعات
print("Revisions count: " + str(len(revisions)))

# قبول المراجعات
for revision in revisions:
    revision.action = "Accept"

options.revisions = revisions

request = groupdocs_comparison_cloud.ApplyRevisionsRequest(options)
response = api_instance.apply_revisions(request)
اقبل التغييرات باستخدام بايثون

اقبل التغييرات باستخدام بايثون

في حالة رفض أي تغييرات ، يمكنك استخدام مثال الكود التالي:

for revision in revisions:
        revision.action = "Reject"

قم بتنزيل الملف الناتج

نتيجة لذلك ، سيحفظ مثال الكود أعلاه ملف DOCX تم إنشاؤه حديثًا مع التغييرات على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية التالي:

# تهيئة API
file_api = groupdocs_comparison_cloud.FileApi.from_config(configuration)

request = groupdocs_comparison_cloud.DownloadFileRequest("output\\result.docx", my_storage)
response = file_api.download_file(request)

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

اقبل أو ارفض كل التغييرات باستخدام بايثون

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

  • قم بإنشاء مثيل ReviewApi
  • قم بتعيين ملف .docx المصدر
  • حدد ApplyRevisionsOptions
  • ثم قم بتعيين المصدر وقم بتعيين ملف الإخراج
  • اضبط Accept \ all على “True” لقبول جميع التغييرات
  • أو اضبط رفض \ الكل على “صحيح” لرفض جميع التغييرات
  • ثم قم بتعيين المراجعات المحدثة إلى ApplyRevisionsOptions
  • إنشاء ApplyRevisionsRequest
  • احصل على النتائج عن طريق استدعاء طريقة ReviewApi.apply \ revisions()

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

# إنشاء مثيل لواجهة برمجة التطبيقات
api_instance = groupdocs_comparison_cloud.ReviewApi.from_keys(client_id, client_secret)

# تعيين ملف المصدر
source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_with_revs.docx"

options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

# قبول جميع المراجعات
options.accept_all = True   

request = groupdocs_comparison_cloud.ApplyRevisionsRequest(options)
response = api_instance.apply_revisions(request)

يمكنك رفض جميع المراجعات باستخدام مثال الكود التالي:

options.reject_all = True

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

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

خاتمة

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

أنظر أيضا