به عنوان یک توسعه دهنده پایتون، ممکن است نیاز داشته باشید که اسناد Word یا Excel را به صورت برنامه نویسی ویرایش کنید. شما می توانید چنین اسنادی را بدون نصب هیچ برنامه خارجی به روز کنید. این مقاله بر نحوه ویرایش اسناد Word یا Excel با استفاده از REST API تمرکز خواهد کرد.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- ویرایشگر سند REST API و Python SDK
- سند Word را با استفاده از REST API ویرایش کنید
- برگه اکسل را با استفاده از REST API ویرایش کنید
ویرایشگر سند REST API و Python SDK
برای ویرایش اسناد Word یا برگه‌های اکسل، از Python SDK of GroupDocs.Editor Cloud API استفاده خواهم کرد. این به شما امکان می دهد اسناد پردازش ورد، برگه های اکسل یا اسناد دیگر فرمت های پشتیبانی شده را به صورت برنامه نویسی ویرایش کنید. همچنین SDKهای دات نت، جاوا، PHP، روبی، اندروید و Node.js را به عنوان [اعضای خانواده ویرایشگر سند2 برای Cloud API ارائه می دهد.
می توانید GroupDocs.Editor-Cloud را با استفاده از دستور زیر در کنسول در پروژه پایتون خود نصب کنید:
pip install groupdocs_editor_cloud
لطفاً قبل از شروع به دنبال کردن مراحل و نمونه کدهای موجود، شناسه مشتری و راز مشتری خود را از داشبورد دریافت کنید. شناسه و راز خود را به شکل زیر در کد اضافه کنید:
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
configuration = groupdocs_editor_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
سند Word را با استفاده از REST API ویرایش کنید
شما می توانید سند Word را با انجام مراحل ساده زیر ویرایش کنید:
سند را آپلود کنید
اول از همه، سند Word را با استفاده از مثال کد زیر در Cloud آپلود کنید:
storage_api = groupdocs_editor_cloud.StorageApi.from_config(config_info)
file_api = groupdocs_editor_cloud.FileApi.from_config(config_info)
# فایل نمونه را آپلود کنید
files = glob.glob("C:\\Files\\sample_word_document.docx", recursive=False)
destination_file = files[0].replace("C:\\Files\\", "", 1)
file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(destination_file, files[0]))
در نتیجه، فایل Word در فضای ذخیره‌سازی ابری آپلود می‌شود و در بخش فایل‌ها داشبورد شما در دسترس خواهد بود.
ویرایش سند ورد در پایتون
لطفاً مراحل ذکر شده در زیر را دنبال کنید تا سند Word را به صورت برنامه ای ویرایش کنید.
- نمونه های File API و Edit API را ایجاد کنید
- WordProcessingLoadOptions را ارائه دهید
- یک فایل را با روش Load ویرایش API بارگیری کنید
- سند HTML را با استفاده از روش Download File File API دانلود کنید
- ویرایش سند HTML
- با استفاده از روش Upload File File API، HTML را دوباره آپلود کنید
- WordProcessingSaveOptions را برای ذخیره در DOCX ارائه دهید
- با استفاده از روش Save Edit API، HTML را به DOCX برگردانید
قطعه کد زیر نحوه به روز رسانی یک سند Word را با استفاده از REST API نشان می دهد.
# نمونه های API لازم را ایجاد کنید
edit_api = groupdocs_editor_cloud.EditApi.from_config(configurations)
file_api = groupdocs_editor_cloud.FileApi.from_config(configuration)
# سند قبلاً در حافظه بارگذاری شده است.
# آن را در حالت قابل ویرایش بارگذاری کنید
file_info = groupdocs_editor_cloud.FileInfo("sample_word_document.docx", None, None, None)
load_options = groupdocs_editor_cloud.WordProcessingLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))
# دانلود سند html
html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
html = ""
with open(html_file, 'r') as file:
html = file.read()
# چیزی را ویرایش کنید...
html = html.replace("Sample test text", "Hello world")
# html را دوباره به فضای ذخیره سازی آپلود کنید
with open(html_file, 'w') as file:
file.write(html)
file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))
# html را به docx ذخیره کنید
save_options = groupdocs_editor_cloud.WordProcessingSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.docx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))
# انجام شده
print("Document edited: " + save_result.path)
فایل به روز شده را دانلود کنید
نمونه کد بالا فایل ورد ویرایش شده را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر می توانید آن را دانلود کنید:
request = groupdocs_editor_cloud.DownloadFileRequest("output\\edited.docx", my_storage)
response = file_api.download_file(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\")
برگه اکسل را با استفاده از REST API ویرایش کنید
لطفا مراحل ذکر شده در زیر را برای ویرایش برنامه نویسی برگه اکسل دنبال کنید.
- نمونه های File API و Edit API را ایجاد کنید
- SpreadsheetLoadOptions را ارائه دهید
- یک فایل را با روش Load Edit API بارگیری کنید
- سند HTML را با استفاده از روش Download File File API دانلود کنید
- ویرایش سند HTML
- با استفاده از روش Upload File File API، HTML را دوباره آپلود کنید
- گزینه های SpreadsheetSave را برای ذخیره در XLSX ارائه دهید
- HTML را با استفاده از روش Save Edit API به XLSX ذخیره کنید
مثال کد ساده ارائه شده در زیر نشان می دهد که چگونه یک برگه اکسل را با استفاده از REST API به روز کنید. لطفاً برای آپلود و دانلود یک فایل مراحل ذکر شده را دنبال کنید.
# نمونه های API لازم را ایجاد کنید
edit_api = groupdocs_editor_cloud.EditApi.from_config(configurations)
file_api = groupdocs_editor_cloud.FileApi.from_config(configurations)
# سند قبلاً در حافظه بارگذاری شده است.
# آن را در حالت قابل ویرایش بارگذاری کنید
file_info = groupdocs_editor_cloud.FileInfo("sample_four_sheets.xlsx")
load_options = groupdocs_editor_cloud.SpreadsheetLoadOptions()
load_options.file_info = file_info
load_options.output_path = "output"
load_options.worksheet_index = 0
load_result = edit_api.load(groupdocs_editor_cloud.LoadRequest(load_options))
# دانلود سند html
html_file = file_api.download_file(groupdocs_editor_cloud.DownloadFileRequest(load_result.html_path))
html = ""
with open(html_file, 'r') as file:
html = file.read()
# چیزی را ویرایش کنید...
html = html.replace("This is sample sheet", "This is sample sheep")
# html را دوباره به فضای ذخیره سازی آپلود کنید
with open(html_file, 'w') as file:
file.write(html)
file_api.upload_file(groupdocs_editor_cloud.UploadFileRequest(load_result.html_path, html_file))
# html را به xlsx ذخیره کنید
save_options = groupdocs_editor_cloud.SpreadsheetSaveOptions()
save_options.file_info = file_info
save_options.output_path = "output/edited.xlsx"
save_options.html_path = load_result.html_path
save_options.resources_path = load_result.resources_path
save_result = edit_api.save(groupdocs_editor_cloud.SaveRequest(save_options))
# انجام شده
print("Excel sheet edited: " + save_result.path)
نتیجه
در این مقاله، نحوه ویرایش اسناد Word یا برگه های اکسل را در فضای ابری با Document Editor REST API با استفاده از Python یاد گرفتید. همچنین یاد گرفتید که چگونه به صورت برنامه‌نویسی فایل‌ها را در فضای ابری آپلود کنید و سپس فایل‌های به‌روزشده را از ابر دانلود کنید. می‌توانید با استفاده از مستندات درباره GroupDocs.Editor Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می کنیم که به شما امکان می دهد API های ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهامی، لطفاً با ما در تالار گفتمان تماس بگیرید.