استيراد مصفوفة سلاسل ثنائية الأبعاد إلى ورقة عمل Excel
تقوم هذه الواجهة REST API باستيراد مصفوفة سلاسل ثنائية الأبعاد إلى ورقة عمل Excel.
يُشكّل الطلب طلب HTTP يحتوي على محتوى متعدد الأجزاء (انظر RFC 2046 أو RFC 1341). يحتوي الجزء الأول من المحتوى متعدد الأجزاء على بيانات Import2DimensionStringArrayOption، ويحتوي الجزء الثاني على ملف البيانات.
واجهة REST API
POST https://api.aspose.cloud/v3.0/cells/import
POST https://api.aspose.cloud/v3.0/cells/{name}/importdata
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
يُوضّح الجدول التالي المعاملات المهمة:
Import2DimensionStringArrayOption
| اسم المعاملة | النوع | الوصف |
|---|---|---|
| FirstRow | int | الفهرس الصفري للصف الذي يبدأ منه الاستيراد. |
| FirstColumn | int | الفهرس الصفري للعمود الذي يبدأ منه الاستيراد. |
| Data | String[,] | مصفوفة ثنائية الأبعاد تحتوي على قيم السلاسل المراد استيرادها. |
| DestinationWorksheet | string | اسم ورقة العمل التي ستتلقّى البيانات المستوردة. |
| IsInsert | string (true/false) | إذا كانت القيمة true، تُدرج البيانات وتُزاحَم الخلايا الموجودة وفقًا لذلك. |
| ImportDataType | string | يحدّد نوع البيانات؛ لاستخدام هذه العملية، اضبط القيمة على TwoDimensionStringArray. |
| Source | FileSource | يشير إلى موقع ملف البيانات عند كون المعاملة BatchData تساوي null. |
مثال على جسم الطلب
{
"Data": [
["1.0", "2.9"],
["2.0", "2.1"]
],
"DestinationWorksheet": "Sheet2",
"FirstRow": 1,
"FirstColumn": 1,
"ImportDataType": "TwoDimensionStringArray"
}
الاستجابة
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (تمت العملية بنجاح) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مصادَق) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقّع في الخادم. |
كيفية استخدام PostImportData API باستخدام SDKs
مواصفات PostImportData API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للاستدعاء مباشرةً من متصفح الويب.
استخدام SDKs لـ Aspose.Cells Cloud
يُعدّ استخدام SDK أسرع طريقة لدمج هذه الوظيفة. فتُجَسّد SDKs التفاصيل من المستوى المنخفض، مما يتيح لك التركيز على منطق أعمالك. يمكنك الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهِر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: