كيفية تحويل ورقة عمل جدول بيانات إلى JSON باستخدام واجهة Aspose.Cells Cloud API
يقوم_endpoint_ **ConvertWorksheetToJson** بقراءة ملف جدول البيانات من نظام الملفات المحلي، واستخراج ورقة العمل المحددة، وإرجاع محتواها كملف JSON. ويتم التحويل بالكامل على خوادم Aspose.Cells Cloud، لذا لا يتطلب رفعًا مبدئيًا أو تخزينًا وسيطًا. وتدعم هذه الميزة أوراق العمل المحمية بكلمة مرور، ومواقع الخطوط المخصصة، والإعدادات الإقليمية، مما يقدّم حلاً سريعًا ومُصممًا للسحابة لتصدير بيانات ورقة العمل إلى JSON لمعالجتها في خطوط أنابيب لاحقة.
واجهة API لتحويل ورقة العمل إلى JSON
واجهة API على الويب
PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/json
الأمان والمصادقة
تُعتبر واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معلمات الطلب:
| اسم المعلمة | النوع | الموقع | إلزامي/اختياري | الوصف |
|---|---|---|---|---|
| Spreadsheet | ملف | FormData | إلزامي | ملف مصنف Excel المراد معالجته. يجب أن يكون بصيغة مدعومة (مثل xls، xlsx، csv، إلخ). يُرسَل كـ multipart/form-data. مثال: Spreadsheet=@C:\Docs\Sample.xlsx. |
| worksheet | نص | Query | إلزامي | الاسم الدقيق لورقة العمل المراد تحويلها (مع مراعاة حالة الأحرف). إذا حُذفت أو لم يُعثر عليها، تُعيد الواجهة خطأً. مثال: worksheet=Sheet1. |
| outPath | نص | Query | اختياري | المجلد الوجهة على مساحة التخزين السحابية المُعدة لحفظ ملف JSON الناتج. إن لم يُحدَّد، يُعاد محتوى JSON مباشرةً في تدفق الاستجابة. مثال: outPath=/converted/. |
| outStorageName | نص | Query | اختياري | اسم مساحة التخزين المستهدفة (مثل “MyStorage”) التي تحتوي على outPath. ويُستخدم مساحة التخزين الافتراضية عند حذف هذه المعلمة. |
| fontsLocation | نص | Query | اختياري | مجلد على الخادم يحتوي على خطوط مخصصة مطلوبة لعرض النصوص في ورقة العمل بدقة. مثال: fontsLocation=/fonts/custom/. |
| region | نص | Query | اختياري | معرّف ثقافة/منطقة يؤثّر على تنسيق الأرقام والتاريخ والعملات في ملف JSON الناتج (مثل en-US، fr-FR). |
| password | نص | Query | اختياري | كلمة المرور لفتح مصنف مشفر. إن لم يكن المصنف محميًا بكلمة مرور، يمكن حذف هذه المعلمة. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
أكواد حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | نجاح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معلمات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح به | رمز JWT غير صحيح أو مفقود. |
| 413 | حجم البيانات كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
أين نستخدم واجهة API لتحويل ورقة العمل إلى JSON؟
- الوحة القيادية على الويب (Web dashboards) – تصدير بيانات ورقة العمل إلى JSON لاستخدامها مع مكتبات الرسم البياني من جانب العميل (مثل Chart.js، D3.js).
- الهجرة البياناتية – نقل بيانات Excel القديمة إلى قواعد بيانات NoSQL أو خدمات REST التي تستهلك بيانات JSON.
- تطبيقات الجوال أو غير المتصلة بالإنترنت – تحويل محتوى ورقة العمل إلى JSON على الخادم، ثم مزامنة البيانات الخفيفة مع أجهزة الجوال.
- خطوط أنابيب التقرير – تغذية بيانات ورقة العمل مباشرةً إلى محركات التحليلات التي تقبل إدخال JSON دون الحاجة لخطوات وسيطة بملفات CSV.
لماذا يجب استخدام واجهة API لتحويل ورقة العمل إلى JSON؟
- سير عمل بدون رفع مبدئي – معالجة الملفات المحلية في السحابة دون رفعها أولًا إلى مساحة تخزين، مما يوفر النطاق الترددي وتكاليف التخزين.
- تحويل شامل الميزات – يدعم أوراق العمل المحمية بكلمة مرور، والخطوط المخصصة، والتنسيق الإقليمي لتمثيل دقيق للبيانات.
- تنفيذ سريع وقابل للتوسع – يستفيد من محرك Aspose.Cells عالي الأداء على البنية التحتية السحابية، ليتعامل بكفاءة مع أوراق العمل الكبيرة.
- تكامل مبسّط – استدعاء PUT واحد يُعيد ملف JSON جاهز للاستخدام، أو يحفظه مباشرةً، مما يقلل تعقيد الكود في تطبيقات العميل.
كيفية استخدام واجهة API لتحويل ورقة العمل إلى JSON باستخدام SDKs
مواصفات واجهة API لتحويل ورقة العمل إلى JSON
توفّر مواصفات واجهة API لتحويل ورقة العمل إلى JSON واجهة برمجة تطبيقات عامة قابلة للوصول تنفيذ تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات لواجهة API السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDKs هو أسرع طريقة للتطوير، لأنها تُجرّدك من التفاصيل منخفضة المستوى وتمكّنك من العمل مع جداول البيانات عبر كود موجز. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية التفاعل مع خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة: