منصة دمج البيانات من مصادر متعددة – واجهة برمجة تطبيقات Aspose.Cells Cloud للاستيراد والتحويل التلقائي للبيانات.
الميزات الأساسية
دعم تنسيقات البيانات المتعددة
- CSV استيراد البيانات: يدعم فواصل متعددة ويكتشف الترميز تلقائيًا.
- JSON معالجة البيانات: يُسطّح الهياكل المعقدة لملفات JSON في جداول Excel.
- XML تحويل الملفات: يُعيّن بيانات العقد إلى هيكل الصفوف والأعمدة في Excel.
وصف واجهة برمجة تطبيقات استيراد البيانات إلى ورقة العمل
واجهة برمجة التطبيقات عبر الويب
PUT https://api.aspose.cloud/v4.0/cells/import/data
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
متغيرات الطلب
| اسم المتغير | النوع | الموقع | الوصف |
|---|---|---|---|
| datafile | ملف | FormData | ملف البيانات (CSV أو JSON أو XML) المراد استيراده. |
| spreadsheet | ملف | FormData | المصنف المستهدف الذي سيتلقّى البيانات المستوردة. |
| worksheet | نص | Query | اسم ورقة العمل التي ستُوضع فيها البيانات. |
| startCell | نص | Query | الخلية العلوية اليسرى (مثل A1) التي تُحدّد نقطة البداية للاستيراد. |
| insert | منطقي | Query | true لإدراج صفوف؛ false لكتابة البيانات فوق البيانات الموجودة. |
| convertNumericData | منطقي | Query | true لتحويل النصوص الرقمية إلى أرقام أثناء الاستيراد. |
| splitter | نص | Query | فاصل CSV مكوّن من حرف واحد (الافتراضي هو ,). |
| outPath | نص | Query (اختياري) | مسار المجلد الذي سيتم فيه حفظ المصنف المحدّث. |
| outStorageName | نص | Query (اختياري) | اسم موقع التخزين لملف الإخراج. |
| fontsLocation | نص | Query (اختياري) | مسار مجلد خطوط مخصّص، إن لزم الأمر. |
| region | نص | Query (اختياري) | إعدادات إقليم ورقة العمل (مثل en-US). |
| password | نص | Query (اختياري) | كلمة المرور لفتح مصنف محمي. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تمت تطبيق المرشّح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | مفقود أو غير صالح المتغيرات (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق عليه | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقّع في الخادم. |
أسباب استخدام هذه الواجهة
- تحميل بيانات فعّال – يتيح الاستيراد الجُملي لمجموعات بيانات كبيرة مباشرةً إلى مصنف دون إنشاء ملفات وسيطة.
- دعم واسع لـ SDKs – يوفّر مكتبات عميل لـ .NET وJava وPHP وRuby وNode.js وPython وGo وPerl، ما يبسّط التكامل.
- معالجة في الذاكرة – يُجري التحويلات في الذاكرة، ما يقلّل متطلبات التخزين المؤقت.
كيفية استخدام واجهة برمجة تطبيقات استيراد البيانات إلى ورقة العمل باستخدام SDKs
ملاحظات / قيود: تدعم الواجهة ما يصل إلى 1,000,000 صف في كل استيراد. الفاصل الافتراضي لملفات CSV هو الفاصلة فقط؛ ويمكن تحديد فواصل حرفية أخرى عبر المتغير splitter. قد تزيد ملفات XML الكبيرة من وقت المعالجة.
لعمليات مرتبطة مثل تصدير البيانات أو تحويل تنسيقات المصنفات، راجع مستندات تصدير البيانات وتحويل المصنف.
مواصفات واجهة برمجة تطبيقات استيراد البيانات إلى ورقة العمل
توفّر مواصفات واجهة برمجة تطبيقات استيراد البيانات إلى ورقة العمل واجهة برمجة برمجية متاحة علنًا، ما يسمح بالتفاعل مع REST مباشرةً من متصفح الويب الخاص بك. يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
يُعد استخدام SDKs الطريقة الأسرع لتطوير التطبيقات، إذ يُجرّدك من التفاصيل منخفضة المستوى، مما يتيح لك استيراد البيانات إلى ورقة عمل باستخدام كود قصير. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.