حذف جميع جداول البيانات المحورية في ورقة عمل Excel
نظرة عامة
يقوم هذا الإجراء بإزالة جميع جداول البيانات المحورية من ورقة عمل محددة في ملف Excel. وهو مفيد عندما تحتاج إلى إعادة تعيين تحليلات ورقة العمل أو تنظيف جداول البيانات المحورية غير المستخدمة في استدعاء واحد.
المتطلبات المسبقة
قبل استدعاء واجهة برمجة التطبيقات (API)، تأكد من إكمال الخطوات التالية:
- حساب Aspose Cloud – سجّل حسابًا في Aspose Cloud إذا لم يكن لديك حساب بالفعل.
- رمز JWT – أنشئ رمز JWT (JSON Web Token) للمصادقة. راجع دليل المصادقة للحصول على التفاصيل.
- إعداد التخزين – قم برفع ملف Excel المستهدف إلى تخزين Aspose Cloud أو إلى تخزين خارجي متصل. لاحظ المجلد واسم التخزين (إن وُجد) حيث يوجد الملف.
المصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud مصادقة تعتمد على رمز JWT. أضف الرمز في رأس الطلب Authorization في كل طلب:
Authorization: Bearer <jwt token>
طلب HTTP
DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pivottables
معاملات المسار
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
name |
نص | نعم | اسم ملف Excel (مثال: Sample.xlsx). |
sheetName |
نص | نعم | اسم ورقة العمل التي سيتم إزالة جميع جداول البيانات المحورية منها (مثال: Sheet1). |
معاملات الاستعلام
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
folder |
نص | لا | المجلد الذي يحتوي على الملف. |
storageName |
نص | لا | اسم التخزين المراد استخدامه (إذا لم يكن الملف في التخزين الافتراضي). |
مثال على الطلب (cURL)
curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Pivot_Table_Example.xls/worksheets/Sheet2/pivottables?folder=SampleFolder&storageName=MyStorage" \
-X DELETE \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
الاستجابة الناجحة
يعيد الخدمة كائنًا قياسيًا CellsCloudResponse يُبيّن حالة العملية.
{
"Code": 200,
"Status": "OK"
}
معالجة الأخطاء
| حالة HTTP | المعنى | مثال على حمولة الطلب |
|---|---|---|
| 400 | طلب غير صالح – معاملات مفقودة أو غير صحيحة | { "Code": 400, "Message": "Missing required parameter 'name'." } |
| 401 | غير مصادق – رمز JWT غير صالح أو منتهٍ | { "Code": 401, "Message": "Invalid authentication token." } |
| 404 | غير موجود – الملف أو ورقة العمل غير موجودة | { "Code": 404, "Message": "Worksheet not found." } |
| 500 | خطأ داخلي في الخادم – فشل غير متوقع | { "Code": 500, "Message": "An unexpected error occurred." } |
أمثلة باستخدام SDKs
تُظهر مقاطع الكود التالية كيفية استدعاء العملية باستخدام العديد من SDKs الخاصة بـ Aspose.Cells Cloud.
C# (.NET)
using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;
// تهيئة عميل الواجهة البرمجية
var apiInstance = new CellsApi("<client-id>", "<client-secret>");
// تكوين معاملات الطلب
string name = "Sample_Pivot_Table_Example.xls";
string sheetName = "Sheet2";
string folder = "SampleFolder";
string storageName = "MyStorage";
try
{
var response = apiInstance.DeleteWorksheetPivotTables(name, sheetName, folder, storageName);
Console.WriteLine($"Response code: {response.Code}, status: {response.Status}");
}
catch (Exception e)
{
Console.WriteLine("Exception when calling CellsApi.DeleteWorksheetPivotTables: " + e.Message);
}
Java
import com.aspose.cells.cloud.api.CellsApi;
import com.aspose.cells.cloud.model.*;
public class DeletePivotTables {
public static void main(String[] args) {
CellsApi api = new CellsApi("<client-id>", "<client-secret>");
String name = "Sample_Pivot_Table_Example.xls";
String sheetName = "Sheet2";
String folder = "SampleFolder";
String storageName = "MyStorage";
try {
CellsCloudResponse result = api.deleteWorksheetPivotTables(name, sheetName, folder, storageName);
System.out.println("Code: " + result.getCode() + ", Status: " + result.getStatus());
} catch (Exception e) {
e.printStackTrace();
}
}
}
Python
import asposecellscloud_sdk
from asposecellscloud_sdk import CellsApi, ApiException
# تكوين عميل الواجهة البرمجية
configuration = asposecellscloud_sdk.Configuration()
configuration.api_key['client_id'] = '<client-id>'
configuration.api_key['client_secret'] = '<client-secret>'
api_instance = CellsApi(asposecellscloud_sdk.ApiClient(configuration))
name = 'Sample_Pivot_Table_Example.xls'
sheet_name = 'Sheet2'
folder = 'SampleFolder'
storage_name = 'MyStorage'
try:
response = api_instance.delete_worksheet_pivot_tables(name, sheet_name, folder, storage_name)
print(f'Code: {response.code}, Status: {response.status}')
except ApiException as e:
print("Exception when calling CellsApi->delete_worksheet_pivot_tables: %s\n" % e)
Node.js
const { CellsApi, Configuration } = require('asposecellscloud-sdk');
const config = new Configuration({
clientId: '<client-id>',
clientSecret: '<client-secret>'
});
const apiInstance = new CellsApi(config);
const name = 'Sample_Pivot_Table_Example.xls';
const sheetName = 'Sheet2';
const folder = 'SampleFolder';
const storageName = 'MyStorage';
apiInstance.deleteWorksheetPivotTables(name, sheetName, folder, storageName)
.then(result => {
console.log(`Code: ${result.code}, Status: ${result.status}`);
})
.catch(err => {
console.error('Error:', err);
});
SDKs إضافية (Go, PHP, Ruby, Swift, Perl, Android) متوفرة في مستودع Aspose.Cells Cloud SDK.
انظر أيضًا
- حذف جدول محوري محدد
- الحصول على جميع جداول البيانات المحورية في ورقة العمل
- نظرة عامة على المصادقة
- مواصفات OpenAPI لـ DeleteWorksheetPivotTables