استيراد مصفوفة صحيحة ثنائية الأبعاد إلى ورقة عمل Excel
تقوم هذه الواجهة البرمجية باستيراد مصفوفة صحيحة ثنائية الأبعاد إلى ورقة عمل Excel.
الطلب هو طلب HTTP يحتوي على محتوى متعدد الأجزاء (انظر RFC 2046 أو RFC 1341). الجزء الأول من المحتوى المتعدد الأجزاء يحتوي على بيانات Import2DimensionIntegerArrayOption والجزء الثاني يحتوي على ملف البيانات.
البارامترات الأساسية موضحة في الجدول التالي:
واجهة برمجة التطبيقات REST
POST https://api.aspose.cloud/v3.0/cells/import
POST https://api.aspose.cloud/v3.0/cells/{name}/importdata
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
Import2DimensionIntegerArrayOption
| اسم البارامتر | النوع | الوصف |
|---|---|---|
| FirstRow | int | المؤشر (1-الأساس) للصف الأول الذي سيتم وضع البيانات فيه. |
| FirstColumn | int | المؤشر (1-الأساس) للعمود الأول الذي سيتم وضع البيانات فيه. |
| Data | Integer[,] | مصفوفة صحيحة ثنائية الأبعاد تحتوي على القيم المراد استيرادها. |
| DestinationWorksheet | string | اسم ورقة العمل الوجهة. |
| IsInsert | string | "true" لإدراج البيانات (بتحريك الخلايا الموجودة)، "false" لكتابة البيانات فوق الخلايا الموجودة. |
| ImportDataType | string | يُحدد تنسيق البيانات. القيم المدعومة: IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData. |
| Source | FileSource | يُشير إلى موقع ملف البيانات عندما تكون قيمة البارامتر BatchData null. |
مثال
{
"Data": [
[1, 2],
[3, 4]
],
"DestinationWorksheet": "Sheet2",
"FirstRow": 4,
"FirstColumn": 1,
"ImportDataType": "TwoDimensionIntArray"
}
الاستجابة
{
"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 واجهة برمجة تطبيقات متاحة للعامة تسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
يعتبر استخدام SDK أفضل طريقة لتسريع عملية التطوير. تتعامل SDKs مع التفاصيل منخفضة المستوى وتركّز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة: