كيف تحول بيانات النطاق في ملف جدول بيانات محلي إلى ملف JSON: دليل خطوة بخطوة
صدِّر بيانات النطاق من ملف Excel محلي إلى ملف JSON باستخدام واجهة Cloud API.
واجهة تحويل النطاق إلى JSON
PUT https://api.aspose.cloud/v4.0/cells/convert/range/json
الأمان والمصادقة
تُعدّ واجهات Aspose.Cells Cloud API آمنة وتتطلب مصادقة قائمة على رمز JWT.
معلمات الطلب:
| اسم المعلمة | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | رفع ملف جدول البيانات. |
| worksheet | نص | استعلام | اسم ورقة العمل داخل جدول البيانات. |
| range | نص | استعلام | منطقة الخلايا المراد تحويلها، مثل A1:C10. |
| outPath | نص | استعلام | (اختياري) مسار المجلد حيث يُخزَّن ملف العمل؛ القيمة الافتراضية هي null. |
| outStorageName | نص | استعلام | اسم مخزن ملفات الإخراج. |
| fontsLocation | نص | استعلام | موقع تخزين الخطوط المخصّصة للاستخدام الشخصي. |
| region | نص | استعلام | إعداد منطقة جدول البيانات. |
| password | نص | استعلام | كلمة المرور لفتح ملف جدول البيانات. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة تحويل النطاق إلى JSON؟
- لوحات التحكم في الوقت الفعلي: حوّل بيانات Excel الحية إلى JSON لاستخدامها مع مكتبات الرسم البياني مثل Chart.js أو D3.js.
- جداول البيانات كخدمة (Spreadsheet-as-a-Service): قدّم نطاقات Excel كنقاط نهاية JSON لخدمات أخرى.
- حمولات Webhook: حوّل بيانات جداول البيانات إلى JSON لإرسال إشعارات Webhook.
- نماذج أولية سريعة للبيانات: حوّل بيانات Excel النظيفة بسرعة إلى JSON لتحليلها باستخدام Python أو R.
- سير عمل التعلّم الآلي: أجرِ معالجة أولية لبيانات التدريب من جداول البيانات المُدارة من قِبل الأعمال.
- عمليات التجارة الإلكترونية: زامن كتالوجات المنتجات أو أوراق أسعارها مع المواقع الإلكترونية عبر JSON.
- أتمتة التقارير: أنشئ تدفقات بيانات JSON من نماذج مالية لأغراض إنشاء تقارير تلقائية.
- تكوين التطبيقات: أدر علامات الميزات والإعدادات أو معلمات اختبارات A/B في Excel → JSON.
- الدعم متعدد اللغات: حوّل جداول البيانات الخاصة بالتعريب إلى JSON لاستخدامها مع مكتبات i18n.
- القوائم/التنقل الديناميكي: اخزن هياكل التنقل في الموقع الإلكتروني في Excel ونفّذها كـ JSON.
لعرض خيارات التحويل الأخرى، راجع دليل تحويل النطاق إلى CSV.
لماذا يجب استخدام واجهة تحويل النطاق إلى JSON؟
- دعم SDK: توفر Aspose.Cells Cloud مكتبات بلغات برمجة متعددة، مما يقلل من الحاجة إلى كتابة كود مخصص.
- خفض تكاليف التخزين: يمكن تحويل النطاق دون رفع ملف العمل بالكامل أولاً، مما يوفر مساحة تخزين.
- التوافق مع تطبيقات الويب والجوّال: JSON هو تنسيق البيانات الأصلي لإطارات عمل JavaScript الحديثة مثل React وVue وAngular.
- دعم واسع للغات البرمجة: يمكن لمعظم لغات البرمجة وقواعد البيانات قراءة JSON.
- الحفاظ على هيكلية البيانات
- الكشف الذكي عن الهيكل: تحويل تلقائي لبيانات الجداول إلى مصفوفات أو كائنات JSON صحيحة.
- ربط الرؤوس: استخدام الصف الأول كمفاتيح JSON لبناء كائنات واضحة.
- الحفاظ على أنواع البيانات: الاحتفاظ بأنواع البيانات (أرقام، تواريخ، قيم منطقية) بدلاً من نصوص بسيطة.
كيف تستخدم واجهة تحويل النطاق إلى JSON باستخدام SDKs؟
معيار واجهة تحويل النطاق إلى JSON
يُعرّف معيار واجهة تحويل النطاق إلى JSON واجهة برمجة تطبيقات متاحة للعامة وتسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء المكالمات إلى Cloud API باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
يُعد استخدام SDK الطريقة الأسرع للتطوير، إذ تُجرّدك من التفاصيل المنخفضة المستوى، مما يسمح لك بتحويل نطاق من البيانات إلى ملف JSON بكود موجز.
يرجى زيارة مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات الويب Aspose.Cells باستخدام SDKs مختلفة: