حذف مرشح من ورقة عمل إكسل – واجهة Aspose.Cells Cloud API

واجهة REST API

تحذف هذه الواجهة من نوع REST المرشح التلقائي (AutoFilter) من ورقة عمل إكسل.

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

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	مطلوب؟	الوصف
name	سلسلة	المسار	نعم	اسم ملف المصنف.
sheetName	سلسلة	المسار	نعم	اسم ورقة العمل.
range	سلسلة	الاستعلام	لا	النطاق الخلايا الذي يطبّق عليه المرشح (مثال: `A1:C10`).
fieldIndex	عدد صحيح	الاستعلام	نعم	المؤشر المبدئي (صفر) للعمود الذي يطبّق عليه المرشح.
dateTimeGroupingType	سلسلة	الاستعلام	لا	طريقة تجميع قيم التاريخ/الوقت: `Day`، `Hour`، `Minute`، `Month`، `Second`، أو `Year`.
year	عدد صحيح	الاستعلام	لا	مكوّن السنة للتجميع حسب السنة.
month	عدد صحيح	الاستعلام	لا	مكوّن الشهر للتجميع حسب الشهر.
day	عدد صحيح	الاستعلام	لا	مكوّن اليوم للتجميع حسب اليوم.
hour	عدد صحيح	الاستعلام	لا	مكوّن الساعة للتجميع حسب الساعة.
minute	عدد صحيح	الاستعلام	لا	مكوّن الدقيقة للتجميع حسب الدقيقة.
second	عدد صحيح	الاستعلام	لا	مكوّن الثانية للتجميع حسب الثانية.
matchBlanks	منطقي	الاستعلام	لا	`true` / `false` – ما إذا كانت الخلايا الفارغة تُضمَّن في المرشح أم لا.
refresh	منطقي	الاستعلام	لا	`true` / `false` – ما إذا كان سيتم تحديث ورقة العمل بعد الحذف أم لا.
folder	سلسلة	الاستعلام	لا	مجلد المصنف الأصلي.
storageName	سلسلة	الاستعلام	لا	اسم وحدة التخزين.

الاستجابة

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

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK (تم بنجاح)	تم تطبيق المرشح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request (طلب خاطئ)	معلمات ناقصة أو غير صالحة (مثل: نوع ملف غير مدعوم).
401	Unauthorized (غير مصرّح)	رمز JWT غير صالح أو مفقود.
413	Payload Too Large (الحمولة كبيرة جدًا)	ملف المرفوع يتجاوز الحد الأقصى للحجم.
500	Internal Server Error (خطأ داخلي في الخادم)	خطأ غير متوقع في الخادم.

كيفية استخدام واجهة DeleteWorksheetFilter باستخدام حزم التطوير (SDKs)

مواصفات واجهة DeleteWorksheetFilter

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

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

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/autoFilter/filter?fieldIndex=0&dateTimeGroupingType=Year" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

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

استخدام حزم التطوير (SDKs) الخاصة بـ Aspose.Cells Cloud

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

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