دالة UnpivotRange في خدمات الويب Aspose.Cells Cloud
تبديل الصفوف والأعمدة في جدول البيانات.
نقطة نهاية واجهة برمجة التطبيقات عبر الويب
PUT https://api.aspose.cloud/v4.0/cells/unpivot/range
الأمان والمصادقة
تُعد واجهات برمجة التطبيقات Aspose.Cells Cloud آمنة وتحتاج إلى مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | المسار/سلسلة الاستعلام/جسم HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | رفع ملف جدول البيانات. |
| worksheet | سلسلة نصية | استعلام | اسم ورقة العمل. |
| cellArea | سلسلة نصية | استعلام | نطاق بيانات محدّد. |
| skipEmptyValue | منطقي (boolean) | استعلام | إذا كانت القيمة true، فتجاهل القيم الفارغة. القيمة الافتراضية: true. |
| outPath | سلسلة نصية | استعلام | (اختياري) مسار المجلد الذي يُخزَّن فيه ملف جدول العمل. القيمة الافتراضية: null. |
| outStorageName | سلسلة نصية | استعلام | اسم وحدة التخزين للملف الناتج. |
| region | سلسلة نصية | استعلام | إعدادات منطقة/لغة جدول البيانات (مثل en-US، fr-FR). تؤثر على تنسيق الأرقام، وتفسير التواريخ، والسلوك المرتبط باللغة المحلية. |
| password | سلسلة نصية | استعلام | كلمة المرور لفتح ملف جدول البيانات. |
معامل جسم الطلب
| اسم المعامل | النوع | الوصف |
|---|---|---|
| — | — | — |
الاستجابة
{
"File": "تدفق ثنائي"
}
كود حالات الاستجابة
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | إرجاع ملف جدول البيانات بعد إلغاء التحويل الدائري (Unpivot). |
| 400 | طلب غير صالح (Bad Request) | معاملات طلب غير صالحة. |
| 401 | غير مصرّح (Unauthorized) | فشلت المصادقة. |
| 413 | حجم البيانات كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | واجه الخادم حالة غير متوقعة. |
كيفية استخدام UnpivotRange باستخدام حزم تطوير البرمجيات (SDKs)
مواصفات UnpivotRange
تُعرِّف مواصفات واجهة برمجة التطبيقات UnpivotRange واجهة برمجة تفاعلية عامة مُتاحة، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب Aspose.Cells Cloud. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
{< tabs tabTotal=“2” tabID=“1” tabName1=“Request” tabName2=“Response” >}
{< tab tabNum=“1” >}
# استخدام HTTPS للاتصال الآمن
curl -v "https://api.aspose.cloud/v4.0/cells/unpivot/range?worksheet=Sheet1&cellArea=A1:C10&skipEmptyValue=true&outPath=output%2Ffolder&outStorageName=MyStorage®ion=en-US&password=yourPassword" -X PUT -H "Content-Type: multipart/form-data" -H "Accept: application/octet-stream" -H "Authorization: Bearer <jwt token>" -F 'Spreadsheet=@sample.xlsx'
{< /tab >}
{< tab tabNum=“2” >}
{
"FileUrl": "https://example.com/output/unpivoted.xlsx"
}
{< /tab >}
{< /tabs >}
استخدام حزم تطوير البرمجيات Aspose Cells Cloud
استخدام SDK هو أسرع طريقة لتسريع عملية التطوير. فتقوم SDK بإخفاء التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات Aspose.Cells Cloud.