Developer-Guide: حذف أوراق عمل متعددة في Excel

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة REST بحذف أوراق عمل متعددة من ملف عمل.

الأمان والمصادقة

واجهات Aspose.Cells Cloud آمنة وتطالب بالمصادقة باستخدام رمز JWT.

واجهة REST

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف Excel.
matchCondition	object	body	كائن `MatchConditionRequest` يحدد أوراق العمل التي سيتم حذفها.
folder	string	query	مسار المجلد في التخزين حيث يقع الملف.
storageName	string	query	اسم خدمة التخزين.

خصائص MatchConditionRequest

الاسم	النوع	الوصف	الملاحظات
RegexPattern	string	تعبير نمطي لمطابقة أسماء أوراق العمل.	اختياري
FullMatchConditions	string[]	أسماء أوراق العمل الدقيقة المراد حذفها.	اختياري

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة للعامة وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات ويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL. يلزم وجود رمز JWT صالح في رأس Authorization.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets?folder=Temp" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt_token>" \
  -d '{"FullMatchConditions":["Sheet1","Sheet2","Sheet3"]}'

Response

{
  "Code": 200,
  "Status": "OK"
}

يمكن أن يُعدّ الطلب أيضًا بإجابات أخطاء شائعة، مثل:

حالة HTTP	المعنى	محتوى الاستجابة النموذجي
400	طلب غير صالح – JSON أو معاملات غير صحيحة	`{"Code":400,"Message":"Invalid request payload."}`
401	غير مُصادَق – رمز JWT مفقود أو غير صالح	`{"Code":401,"Message":"Authentication failed."}`
403	ممنوع – صلاحيات غير كافية	`{"Code":403,"Message":"Access denied."}`
404	غير موجود – الملف أو ورقة العمل غير موجودة	`{"Code":404,"Message":"Resource not found."}`
500	خطأ داخلي في الخادم	`{"Code":500,"Message":"An unexpected error occurred."}`

عائلة SDK للسحابة

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى SDK إدارة التفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs متنوعة:

انظر أيضًا:

Developer-Guide: حذف ورقة عمل

Mon, 01 Jan 0001 00:00:00 +0000

تقوم هذه الواجهة البرمجية لـ REST بحذف ورقة عمل.
المتطلبات الأساسية: لاستدعاء هذه الواجهة، يجب أن تقدّم رمز مصادقة JWT صالحًا في رأس Authorization، ولديك صلاحيات الوصول إلى موقع التخزين الذي يوجد فيه ملف العمل.

واجهة برمجة التطبيقات (REST API)

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}

ملاحظة: تستخدم الواجهة الإصدار v3.0، وهو الإصدار المستقر الحالي. سيتم الإعلان عن أي تغييرات في الإصدارات مستقبلًا في ملاحظات الإصدار.

مُعلمات الطلب

اسم المُعلمة	النوع	الموقع	الوصف
name	string	path	اسم المستند.
sheetName	string	path	اسم ورقة العمل.
folder	string	query	مجلد المستند.
storageName	string	query	اسم التخزين.

ردود HTTP المحتملة:

رمز الحالة	الوصف
200 OK	تم حذف ورقة العمل بنجاح.
400 Bad Request	مُعلمات طلب غير صالحة.
401 Unauthorized	فشلت المصادقة أو نقص الرمز المميز.
404 Not Found	ملف العمل أو ورقة العمل المحددة غير موجودة.
500 Internal Server Error	خطأ غير متوقع في الخادم.

يُعرّف مواصفات OpenAPI واجهة برمجة قابلة للوصول بشكل عام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/myWorkbook.xlsx/worksheets/Sheet3" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

يجب إجراء جميع الطلبات عبر بروتوكول HTTPS؛ الواجهة لا تدعم الاتصالات غير المشفرة (TLS).

الرد

{
  "Code": 200,
  "Status": "OK"
}

عائلة SDK للخدمات السحابية

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. يتعامل SDK مع التفاصيل من المستوى المنخفض، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

توضح أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات ويب Aspose.Cells باستخدام SDKs مختلفة:

Documentation –