قم بتحرير ورقة Excel باستخدام REST API في Python.

يعد Excel أحد أكثر تطبيقات جداول البيانات شيوعًا والأكثر استخدامًا. تمكننا من تنظيم وتحليل وتخزين البيانات في شكل جدول. يمكننا بسهولة إضافة محتوى ملفات Excel أو تعديله أو حذفه باستخدام Python. في هذه المقالة ، سوف نتعلم كيفية تحرير ورقة Excel باستخدام واجهة برمجة تطبيقات REST في Python.

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

محرر جداول بيانات Excel REST API و Python SDK

لتعديل ملفات XLSX ، سنستخدم Python SDK of GroupDocs.Editor Cloud API. يسمح بتحرير المستندات من التنسيقات المدعومة. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:

pip install groupdocs_editor_cloud

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

# يوضح مثال الرمز هذا كيفية إضافة معرّف العميل والسرية في الرمز.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
my_storage = ""

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

قم بتحرير ملف Excel باستخدام واجهة برمجة تطبيقات REST في Python

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

  1. تحميل ملف XLSX إلى السحابة
  2. تحرير بيانات جدول بيانات Excel
  3. [تحميل](# تحميل الملف) الملف المحدث

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

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

# يوضح مثال الرمز هذا كيفية تحميل ملف Excel إلى السحابة.
# إنشاء مثيل من API
file_api = groupdocs_editor_cloud.FileApi.from_config(configuration)

# تحميل ملف عينة
request = groupdocs_editor_cloud.UploadFileRequest("sample.xlsx", "C:\\Files\\\Editor\\sample.xlsx", my_storage)
response = file_api.upload_file(request)

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

قم بتحرير بيانات جدول بيانات Excel في Python

يمكننا تحرير محتوى ورقة Excel باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيلات من FileApi و EditApi.
  • بعد ذلك ، قم بتوفير مسار ملف XLSX الذي تم تحميله.
  • بعد ذلك ، قم بتنزيل الملف كمستند HTML.
  • بعد ذلك ، اقرأ ملف HTML الذي تم تنزيله كسلسلة.
  • بعد ذلك ، قم بتحرير HTML وحفظ مستند HTML المحدث.
  • بعد ذلك ، قم بتحميل ملف HTML المحدث.
  • أخيرًا ، احفظ HTML مرة أخرى إلى XLSX باستخدام طريقة EditApi.save().

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

# يوضح مثال التعليمات البرمجية هذا كيفية تحرير محتوى ورقة Excel.
# تهيئة API
editApi = groupdocs_editor_cloud.EditApi.from_keys(client_id, client_secret)
fileApi = groupdocs_editor_cloud.FileApi.from_keys(client_id, client_secret)

# قم بتحميل المستند الذي تم تحميله إلى حالة قابلة للتحرير
fileInfo = groupdocs_editor_cloud.FileInfo("sample.xlsx")

# تحديد خيارات تحميل جدول البيانات
loadOptions = groupdocs_editor_cloud.SpreadsheetLoadOptions()
loadOptions.file_info = fileInfo

# توفير مسار مجلد الإخراج 
loadOptions.output_path = "output"
# قم بتوفير فهرس ورقة العمل لتحريرها
loadOptions.worksheet_index = 0
# قم بتحميل الورقة
loadResult = editApi.load(groupdocs_editor_cloud.LoadRequest(loadOptions))        

# قم بتنزيل مستند html
htmlFile = fileApi.download_file(groupdocs_editor_cloud.DownloadFileRequest(loadResult.html_path))
html = ""       

with open(htmlFile, 'r') as file:
    html = file.read()

# تحرير شيء ما ...    
html = html.replace("Welcome", "This is a sample sheet!")

# تحميل html مرة أخرى إلى التخزين
with open(htmlFile, 'w') as file:
    file.write(html)

fileApi.upload_file(groupdocs_editor_cloud.UploadFileRequest(loadResult.html_path, htmlFile))

# احفظ html مرة أخرى إلى xlsx
saveOptions = groupdocs_editor_cloud.SpreadsheetSaveOptions()
saveOptions.file_info = fileInfo
saveOptions.output_path = "edited.xlsx"
saveOptions.html_path = loadResult.html_path
saveOptions.resources_path = loadResult.resources_path
saveResult = editApi.save(groupdocs_editor_cloud.SaveRequest(saveOptions))

# منتهي
print("Document edited: " + saveResult.path)
قم بتحرير ملف Excel باستخدام واجهة برمجة تطبيقات REST في Python.

قم بتحرير ملف Excel باستخدام واجهة برمجة تطبيقات REST في Python.

قم بتنزيل الملف المحدث

نموذج الكود أعلاه سيحفظ ملف Excel المحرر (XLSX) على السحابة. يمكن تنزيله باستخدام نموذج التعليمات البرمجية التالي:

# يوضح مثال الرمز هذا كيفية تنزيل ملف Excel المحدث.
# تهيئة API
file_api = groupdocs_editor_cloud.FileApi.from_config(configuration)

# تحميل الملف
request = groupdocs_editor_cloud.DownloadFileRequest("edited.xlsx", my_storage)
response = file_api.download_file(request)

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

أضف جدولًا في ورقة Excel باستخدام Python

يمكننا إضافة جدول في ورقة Excel باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج إلى تحديث HTML لإضافة جدول في المستند كما هو موضح أدناه:

html = html.replace("</TABLE>", """</TABLE> <br/><table style="width: 100%;background-color: #dddddd;border: 1px solid black;">
<caption style=\"font-weight:bold;\"> Persons List</caption>
<tr><th style="background-color: #04AA6D; color: white;">First Name</th><th style="background-color: #04AA6D; color: white;">Last Name</th><th style="background-color: #04AA6D; color: white;">Age</th></tr>
<tr><td>Jill</td><td>Smith</td><td>50</td></tr>
<tr><td>Eve</td><td>Jackson</td><td>94</td></tr>
</table>""")

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

# يوضح مثال الرمز هذا كيفية تحرير ورقة Excel وإدراج جدول جديد.
# تهيئة API
editApi = groupdocs_editor_cloud.EditApi.from_keys(client_id, client_secret)
fileApi = groupdocs_editor_cloud.FileApi.from_keys(client_id, client_secret)

# قم بتحميل المستند الذي تم تحميله إلى حالة قابلة للتحرير
fileInfo = groupdocs_editor_cloud.FileInfo("sample.xlsx")

# تحديد خيارات تحميل جدول البيانات
loadOptions = groupdocs_editor_cloud.SpreadsheetLoadOptions()
loadOptions.file_info = fileInfo

# توفير مسار مجلد الإخراج 
loadOptions.output_path = "output"
# قم بتوفير فهرس ورقة العمل لتحريرها
loadOptions.worksheet_index = 0
# قم بتحميل الورقة
loadResult = editApi.load(groupdocs_editor_cloud.LoadRequest(loadOptions))        

# قم بتنزيل مستند html
htmlFile = fileApi.download_file(groupdocs_editor_cloud.DownloadFileRequest(loadResult.html_path))
html = ""       

with open(htmlFile, 'r') as file:
    html = file.read()

# إدراج الجدول  
html = html.replace("</TABLE>", """</TABLE> <br/><table style="width: 100%;background-color: #dddddd;border: 1px solid black;">
<caption style=\"font-weight:bold;\"> Persons List</caption>
<tr><th style="background-color: #04AA6D; color: white;">First Name</th><th style="background-color: #04AA6D; color: white;">Last Name</th><th style="background-color: #04AA6D; color: white;">Age</th></tr>
<tr><td>Jill</td><td>Smith</td><td>50</td></tr>
<tr><td>Eve</td><td>Jackson</td><td>94</td></tr>
</table>""")

# تحميل html مرة أخرى إلى التخزين
with open(htmlFile, 'w') as file:
    file.write(html)

fileApi.upload_file(groupdocs_editor_cloud.UploadFileRequest(loadResult.html_path, htmlFile))

# احفظ html مرة أخرى إلى xlsx
saveOptions = groupdocs_editor_cloud.SpreadsheetSaveOptions()
saveOptions.file_info = fileInfo
saveOptions.output_path = "edited.xlsx"
saveOptions.html_path = loadResult.html_path
saveOptions.resources_path = loadResult.resources_path
saveResult = editApi.save(groupdocs_editor_cloud.SaveRequest(saveOptions))

# منتهي
print("Document edited: " + saveResult.path)
أضف جدولًا في ورقة Excel باستخدام Python.

أضف جدولًا في ورقة Excel باستخدام Python.

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

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

خاتمة

في هذا المقال ، تعلمنا:

  • كيفية تحرير بيانات أوراق Excel على السحابة ؛
  • كيفية إضافة جدول في ورقة Excel باستخدام Python ؛
  • تحميل ملف Excel إلى السحابة ؛
  • كيفية تنزيل ملف Excel المحدث من السحابة.

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

أنظر أيضا