كيف تحذف جدولًا محوريًا في ورقة عمل Excel باستخدام Aspose.Cells Cloud
يقوم هذا الـ REST API بحذف جدول محوري من ورقة عمل باستخدام فهرسه.
المتطلبات المسبقة – يجب أن يكون لديك رمز وصول JWT صالح لـ Aspose.Cells Cloud، وأن يكون ملف Excel المستهدف مخزنًا في موقع مدعوم للتخزين. تأكد من تحديد اسم الملف، واسم الورقة، وتفاصيل التخزين بشكل صحيح قبل استدعاء الـ API.
تعتبر الجداول المحورية وسيلة قوية لتلخيص البيانات في ورقة عمل Excel. باستخدام Aspose.Cells Cloud، يمكنك حذف جدول محوري غير مرغوب فيه برمجيًا باستخدام طلب HTTP DELETE واحد. وتُعد هذه العملية مثالية عند الحاجة إلى تنظيف ورقات العمل، أو أتمتة توليد التقارير، أو دمج تعديل ملفات Excel في تطبيقاتك.
API DeleteWorksheetPivotTable
DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables/{pivotTableIndex}
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مُعلمات الطلب
| اسم المُعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم مستند Excel. |
| sheetName | string | path | اسم ورقة العمل التي تحتوي على الجدول المحوري. |
| pivotTableIndex | integer | path | الفهرس الصفري (zero-based) للجدول المحوري المراد حذفه. |
| folder | string | query | المسار إلى المجلد الذي يحتوي على المستند. |
| storageName | string | query | اسم خدمة التخزين. |
يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة عمومًا، مما يسمح لك بإجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات إلى الـ API السحابي باستخدام cURL.
معالجة الأخطاء
تُدرج أدناه رموز حالة الاستجابة الشائعة:
| حالة HTTP | الوصف |
|---|---|
| 400 | طلب غير صالح – مُعلمات مفقودة أو غير صالحة. |
| 401 | غير مصرح به – رمز JWT غير صالح أو مفقود. |
| 404 | غير موجود – الملف أو الورقة أو الجدول المحوري غير موجود. |
| 500 | خطأ داخلي في الخادم – حدثت حالة غير متوقعة على الخادم. |
عائلة SDK السحابية
يُعد استخدام SDK أفضل طريقة لتسريع عملية التطوير. فتتولى SDK معالجة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة: