كيفية تحويل بيانات جدول جدول البيانات المحلي إلى ملف JSON: دليل خطوة بخطوة
قم بتحويل جدول جدول البيانات/إكسل المحلي إلى ملف JSON باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud عبر الويب.
واجهة برمجة تطبيقات تحويل الجدول إلى JSON
واجهة برمجة تطبيقات الويب
PUT https://api.aspose.cloud/v4.0/cells/convert/table/json
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مُعطَلات الطلب
| اسم المُعطَل | النوع | الموقع | الوصف |
|---|---|---|---|
| جدول البيانات | ملف | FormData | ملف إكسل المراد تحميله. |
| worksheet | سلسلة نصية | استعلام | اسم ورقة العمل التي تحتوي على الجدول. |
| tableName | سلسلة نصية | استعلام | اسم الجدول المراد تحويله. |
| outPath | سلسلة نصية | استعلام | (اختياري) مسار المجلد الذي سيتم فيه تخزين ملف JSON الناتج؛ القيمة الافتراضية هي null. |
| outStorageName | سلسلة نصية | استعلام | (اختياري) اسم وحدة التخزين التي سيتم وضع ملف الإخراج فيها. |
| fontsLocation | سلسلة نصية | استعلام | (اختياري) مسار الخطوط المخصصة المستخدمة أثناء التحويل. |
| region | سلسلة نصية | استعلام | (اختياري) الإعدادات الإقليمية لكتاب العمل. |
| password | سلسلة نصية | استعلام | (اختياري) كلمة المرور لفتح كتاب عمل محمي. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | مُعطَلات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حملة الطلب كبيرة جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات تحويل الجدول إلى JSON؟
- لوحات التحكم في الوقت الفعلي – حوّل بيانات إكسل الحية إلى JSON لاستخدامها في مكتبات الرسم البياني مثل Chart.js أو D3.js.
- جدول البيانات كخدمة (Spreadsheet-as-a-Service) – عرّض جداول إكسل كنقاط نهاية JSON لخدمات ميكرو-خدمات أخرى.
- أحمال Webhook – حوّل بيانات جدول البيانات إلى JSON لإشعارات Webhook.
- نماذج البيانات السريعة (Rapid Data Prototyping) – حوّل بيانات إكسل المنظمة بسرعة إلى JSON لتحليلها باستخدام Python أو R.
- أنابيب التعلم الآلي (Machine-Learning Pipelines) – قم بمعالجة مسبق لبيانات التدريب المخزّنة في جداول بيانات الأعمال.
- عمليات التجارة الإلكترونية (E-commerce Operations) – زامن قوائم المنتجات أو أوراق الأسعار مع المواقع عبر JSON.
- أتمتة التقارير (Reporting Automation) –ولّد تغذّيات JSON من نماذج مالية لتقارير آلية.
- تكوين التطبيقات (App Configuration) – أدر أعلام الميزات والإعدادات أو معلمات اختبارات A/B في إكسل → JSON.
- الدعم متعدد اللغات (Multi-language Support) – حوّل جداول البيانات الخاصة بالترجمة إلى JSON لمكتبات التدويل (i18n).
- قوائم/تنقل ديناميكي (Dynamic Menus/Navigation) – خزّن هياكل التنقل في الموقع في إكسل ونفّذها كملفات JSON.
لماذا يجب استخدام واجهة برمجة تطبيقات تحويل الجدول إلى JSON؟
- سهلة المطورين (Developer-Friendly) – توفر Aspose.Cells Cloud SDKs للعديد من اللغات، مما يقلل من جهود التطوير ويقدم توثيقًا شاملاً.
- فعالة من حيث التكلفة (Cost-Effective) – حوّل بيانات الجدول دون الحاجة أولاً لتحميل كتاب العمل، مما يوفر مساحة تخزين ويقلل التكاليف.
- متوافقة مع الويب والجوّال الحديثة (Modern Web & Mobile Compatibility) – JSON هي لغة البيانات الأصلية للويب؛ تتيح لك واجهة البرمجة هذه تغذية بيانات جدول البيانات الحية مباشرةً في React أو Vue أو Angular أو تطبيقات الجوال أو تطبيقات الصفحة الواحدة دون تحليل معقد.
- دعم واسع للغات (Broad Language Support) – يعمل JSON مع تقريب جميع لغات البرمجة وقواعد البيانات وخدمات الويب.
- الحفاظ على هيكلية البيانات (Structured Data Preservation)
- كشف تلقائي للهيكل (Intelligent Structure Detection) – يحول بيانات الجدول تلقائيًا إلى مصفوفات/كائنات JSON صحيحة.
- ربط الرؤوس (Header Mapping) – يستخدم الصف الأول كمفاتيح JSON لهياكل الكائنات النظيفة.
- الحفاظ على أنواع البيانات (Data Type Retention) – يحافظ على الأرقام والتاريخ والقيم المنطقية (وليس فقط النصوص).
سجل الإصدارات: تم إدخال نقطة نهاية تحويل الجدول إلى JSON مع إصدار واجهة برمجة التطبيقات v4.0 (2024)، ويبقى هو الإصدار المستقر الحالي. نقاط نهاية الإصدارات الأقدم v3.x لم تعد مستخدمة (مُهمَلة).
كيف تستخدم واجهة برمجة تطبيقات تحويل الجدول إلى JSON مع SDKs؟
مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى JSON
توفر مواصفات واجهة برمجة تطبيقات تحويل الجدول إلى JSON{:target="_blank" rel=“noopener noreferrer”} واجهة برمجة تطبيقات قابلة للوصول للعامة، مما يمكّن من إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs لـ Aspose.Cells Cloud
استخدام SDK يُجرّد التفاصيل من المستوى المنخفض، مما يسمح لك بتحويل جدول جدول البيانات إلى ملف JSON بحد أدنى من الكود. راجع مستودع GitHub الرسمي للحصول على قائمة كاملة بـ SDKs لـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية التفاعل مع خدمات ويب Aspose.Cells باستخدام مختلف SDKs: