بصفتك مطور Python ، قد تحتاج إلى تحرير مستندات Word أو Excel برمجيًا. يمكنك تحديث هذه المستندات دون تثبيت أي تطبيق خارجي. ستركز هذه المقالة على كيفية تحرير مستندات Word أو Excel باستخدام واجهة برمجة تطبيقات REST.
سيتم تناول الموضوعات التالية في هذه المقالة:
- محرر المستندات REST API و Python SDK
- قم بتحرير مستند Word باستخدام واجهة برمجة تطبيقات REST
- قم بتحرير ورقة Excel باستخدام واجهة برمجة تطبيقات REST
محرر المستندات REST API و Python SDK
لتحرير مستندات Word أو أوراق Excel ، سأستخدم Python SDK of GroupDocs.Editor Cloud API. يسمح لك بتحرير مستندات معالجة الكلمات أو أوراق Excel أو المستندات ذات التنسيقات المدعومة الأخرى برمجيًا. كما أنها توفر حزم SDK لـ NET و Java و PHP و Ruby و Android و Node.js باعتبارها أعضاء عائلة محرر المستندات لواجهة برمجة التطبيقات السحابية.
يمكنك تثبيت GroupDocs.Editor-Cloud لمشروع Python الخاص بك باستخدام الأمر التالي في وحدة التحكم:
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
يمكنك تحرير مستند 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 إلى Cloud Storage وسيكون متاحًا في قسم الملفات من لوحة المعلومات الخاصة بك.
تحرير مستند Word في Python
يرجى اتباع الخطوات المذكورة أدناه لتحرير مستند Word برمجيًا.
- قم بتكوين مثيلات File API و Edit API
- توفير WordProcessingLoadOptions
- قم بتحميل ملف باستخدام طريقة تحميل لتحرير API
- قم بتنزيل مستند HTML باستخدام طريقة Download File من File API
- تحرير مستند HTML
- قم بتحميل HTML مرة أخرى باستخدام طريقة تحميل ملف من File API
- قم بتوفير خيارات WordProcessingSaveOptions للحفظ في DOCX
- احفظ HTML مرة أخرى إلى DOCX باستخدام طريقة حفظ لتحرير API
يوضح مقتطف الشفرة التالي كيفية تحديث مستند 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)
قم بتنزيل الملف المحدث
نموذج الكود أعلاه سيحفظ ملف Word المحرر على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية التالي:
request = groupdocs_editor_cloud.DownloadFileRequest("output\\edited.docx", my_storage)
response = file_api.download_file(request)
# انقل الملف الذي تم تنزيله إلى دليل العمل الخاص بك
shutil.move(response, "C:\\Files\\")
قم بتحرير ورقة Excel باستخدام واجهة برمجة تطبيقات REST
يرجى اتباع الخطوات المذكورة أدناه لتحرير ورقة Excel برمجيًا.
- إنشاء ملف API و تحرير API مثيلات
- توفير SpreadsheetLoadOptions
- قم بتحميل ملف بطريقة تحميل لتحرير API
- قم بتنزيل مستند HTML باستخدام طريقة Download File من File API
- تحرير مستند HTML
- قم بتحميل HTML مرة أخرى باستخدام طريقة تحميل ملف من File API
- قم بتوفير SpreadsheetSaveOptions للحفظ في XLSX
- احفظ HTML مرة أخرى إلى XLSX باستخدام طريقة حفظ لتحرير API
يوضح مثال الكود البسيط الوارد أدناه كيفية تحديث ورقة Excel باستخدام واجهة برمجة تطبيقات REST. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل ملف.
# إنشاء مثيلات 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 أو أوراق Excel على السحابة باستخدام واجهة برمجة تطبيقات Document Editor REST باستخدام Python. لقد تعلمت أيضًا كيفية تحميل الملفات برمجيًا على السحابة ثم تنزيل الملفات المحدثة من السحابة. يمكنك معرفة المزيد حول GroupDocs.Editor Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.