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