كيفية إضافة جدول محوري في ورقة عمل Excel باستخدام Aspose.Cells Cloud
تضيف هذه الواجهة البرمجية (REST API) جدولًا محوريًا في ورقة عمل.
المتطلبات المسبقة:
- حساب Aspose.Cells Cloud مع رمز وصول JWT صالح.
- يجب تخزين ملف العمل المستهدف في موقع تخزين مدعوم (التخزين الافتراضي أو تخزين مُحدّد من قِبل المستخدم).
- يجب أن توجد الورقة المحددة عبر
sheetNameفي ملف العمل.
PutWorksheetPivotTable API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables
الأمان والمصادقة
تُطبّق واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud سياسة أمان صارمة وتتطلب مصادقة قائمة على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel. |
| sheetName | string | path | اسم ورقة العمل التي سيتم إنشاء الجدول المحوري فيها. |
| request | object | body | كائن CreatePivotTableRequest DTO الذي يحتوي على تعريف الجدول المحوري. |
| folder | string | query | المجلد الذي يحتوي على المستند. |
| storageName | string | query | اسم مكان التخزين الذي يوجد فيه المستند. |
| sourceData | string | query | النطاق الذي يزوّد البيانات المصدرية لذاكرة التخزين المؤقتة الجديدة للجدول المحوري (مثل A5:E10). |
| destCellName | string | query | عنوان الخلية العلوية اليسرى للنطاق الوجهة لتقرير الجدول المحوري. |
| tableName | string | query | الاسم المُسنَد إلى الجدول المحوري الجديد. |
| useSameSource | boolean | query | عندما تكون القيمة true، فإن الجدول المحوري الجديد يُعيد استخدام مصدر بيانات موجود، مما يوفّر الذاكرة إذا كان هناك جدول محوري آخر قد استخدم هذا المصدر مسبقًا. |
يمكنك الاطّلاع على مواصفات OpenAPI التي تُعرّف واجهة برمجة تطبيقات عامة قابلة للاستعمال، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يُظهر المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL.
ملاحظة أمنية: تأكد دائمًا من استخدام https:// عند استدعاء الواجهة البرمجية، واحتفظ بسرية رمز JWT الخاص بك؛ إذ أن إرساله عبر بروتوكول HTTP غير المشفر يعرّضه للاختطاف.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصرّح (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
عائلة SDK السحابية
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى SDK التعامل مع التفاصيل من المستوى المنخفض، مما يمكّنك من التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطّلاع على القائمة الكاملة لـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs المختلفة:
لمزيد من العمليات، راجع صفحات الواجهة البرمجية ذات الصلة: الحصول على جدول محوري، حذف جدول محوري، و تحديث جدول محوري.