الحصول على جدول محوري في ورقة عمل إكسل
تُعيد هذه الواجهة البرمجية معلومات الجدول المحوري في ورقة العمل بناءً على مؤشره.
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
واجهة برمجة تطبيقات REST
GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivottableIndex}
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص (string) | مسار | اسم ملف إكسل. |
| sheetName | نص (string) | مسار | اسم ورقة العمل التي تحتوي على الجدول المحوري. |
| pivottableIndex | عدد صحيح (integer) | مسار | المؤشر الصفري (zero-based) للجدول المحوري في ورقة العمل. |
| folder | نص (string) | استعلام | المجلد الذي يُخزَّن فيه المستند. |
| storageName | نص (string) | استعلام | اسم تخزين Aspose Cloud. |
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية استدعاء الواجهة البرمجية باستخدام cURL.
معالجة الأخطاء
تتّبع الواجهة البرمجية رموز حالة HTTP القياسية. تشمل الاستجابات الشائعة ما يلي:
| رمز الحالة | المعنى | مثال JSON (خطأ) |
|---|---|---|
| 200 | نجاح – تم إرجاع الجدول المحوري | — |
| 401 | غير مصادَق – رمز غير صالح أو مفقود | {"code":401,"message":"Invalid access token."} |
| 404 | غير موجود – الملف أو ورقة العمل أو مؤشر الجدول المحوري غير موجود | {"code":404,"message":"Pivot table not found."} |
| 500 | خطأ في الخادم – حالة غير متوقّعة | {"code":500,"message":"Internal server error."} |
ملاحظات: تدعم الواجهة البرمجية ملفات إكسل حتى 150 ميغابايت، وتعمل مع صيغ إكسل من 2007 إلى 2021. تأكّد من أن اسم ورقة العمل حسّاس لحالة الأحرف.
عائلة حزم تطوير البرمجيات (SDK) السحابية
استخدام حزمة تطوير برمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير. فحزمة SDK تُدار بالتفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات لـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الويب باستخدام حزم تطوير برمجيات مختلفة: