پذیرش یا رد تغییرات

Microsoft Word یک ویژگی فوق‌العاده برای ردیابی تغییرات و حفظ ویرایش‌ها برای اسناد Word ارائه می‌کند. به‌عنوان یک توسعه‌دهنده پایتون، می‌توانید تغییرات ردیابی شده اسناد Word (.docx) را به‌صورت برنامه‌نویسی در فضای ابری بپذیرید یا رد کنید. این مقاله بر نحوه پذیرش یا رد تغییرات ردیابی شده یک سند Word با استفاده از REST API در پایتون تمرکز دارد.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

API REST مقایسه اسناد و Python SDK

برای کار با ویرایش‌ها، از Python SDK of GroupDocs.Comparison Cloud API استفاده خواهم کرد. این دو سند از فرمت‌های فایل پشتیبانی شده را با هم مقایسه می‌کند و تفاوت‌هایی را بین آنها پیدا می‌کند. در نتیجه، یک فایل حاصل حاوی تفاوت ها ایجاد می کند. همچنین شما را قادر می سازد تا تغییرات بازیابی شده را بپذیرید یا رد کنید. شما به راحتی می توانید SDK را در برنامه های پایتون موجود خود ادغام کنید. این به شما امکان می دهد اسناد، صفحات گسترده، ارائه ها، نمودارهای Microsoft Visio، ایمیل ها و فایل های بسیاری از فرمت های دیگر را با هم مقایسه کنید. همچنین .NET، جاوا، PHP، Node.js و Ruby SDK را به عنوان [اعضای خانواده مقایسه اسناد2 خود برای Cloud API فراهم می کند.

می توانید GroupDocs.Comparison Cloud را در پروژه پایتون خود با استفاده از دستور زیر در کنسول نصب کنید:

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 API در پایتون

شما می توانید با دنبال کردن مراحل ساده ذکر شده در زیر، ویرایش های خاص اسناد Word را بپذیرید یا رد کنید:

  1. فایل‌های DOCX را در Cloud [آپلود] کنید
  2. پذیرش یا رد تغییرات با استفاده از پایتون
  3. دانلود فایل حاصل

سند را آپلود کنید

ابتدا با استفاده از نمونه کد زیر، سند Word را با بازبینی‌ها در Cloud آپلود کنید:

# یک نمونه از API ایجاد کنید
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 نشان می دهد.

# یک نمونه از API ایجاد کنید
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 را روی “درست” قرار دهید
  • یا برای رد کردن همه تغییرات، reject\all را روی “True” تنظیم کنید
  • سپس نسخه های به روز شده را به ApplyRevisionsOptions اختصاص دهید
  • ApplyRevisionsRequest را ایجاد کنید
  • با فراخوانی روش ReviewApi.apply\revisions() نتیجه بگیرید

مثال کد زیر نحوه پذیرش تمام تغییرات را با استفاده از REST API نشان می دهد. لطفاً برای آپلود و دانلود فایل مراحل ذکر شده قبلی را دنبال کنید.

# یک نمونه از API ایجاد کنید
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

آنلاین را امتحان کنید

لطفاً ابزار مقایسه آنلاین رایگان Word زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/comparison/docx

نتیجه

در این مقاله نحوه پذیرش یا رد تغییرات ردیابی شده اسناد مایکروسافت ورد در فضای ابری با استفاده از پایتون را یاد گرفتید. همچنین یاد گرفتید که چگونه فایل DOCX را به صورت برنامه‌نویسی در فضای ابری آپلود کنید و سپس فایل حاصل را از ابر دانلود کنید. می‌توانید با استفاده از مستندات درباره GroupDocs.Comparison Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [فروم 13 تماس بگیرید.

همچنین ببینید