تحديث فلتر تلقائي في ورقة عمل إكسل
ماذا يفعل التحديث؟
استدعاء نقطة النهاية هذا يُطبّق معايير التصفية الحالية مجددًا بعد تغيّر بيانات الورقة (مثل إضافة أو حذف صفوف). لا يغيّر هذا الإجراء تعريف الفلتر؛ بل يقوم بتحديث العرض فقط ويُعيد استجابة توضّح الحالة.
واجهة REST API
تقوم هذه واجهة REST API بتحديث الفلتر التلقائي في ورقة عمل إكسل (إصدار API v3.0).
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/refresh
الأمان والمصادقة
تُعدّ واجهات Aspose.Cells Cloud API آمنة وتتطلب مصادقة تعتمد على رمز JWT.
الاستجابة
{
"Status":"OK",
"Code":200
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معطيات ناقصة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أمثلة على استجابات الأخطاء
// 400 Bad Request
{
"Code": 400,
"Message": "معطى غير صالح: لم يتم العثور على اسم الورقة (sheetName)."
}
// 401 Unauthorized
{
"Code": 401,
"Message": "فشلت المصادقة. رمز JWT مفقود أو غير صالح."
}
// 413 Payload Too Large
{
"Code": 413,
"Message": "تجاوز حجم الملف المرفوع الحد الأقصى المسموح به."
}
// 500 Internal Server Error
{
"Code": 500,
"Message": "حدث خطأ غير متوقع في الخادم."
}
كيفية استخدام واجهة PostWorksheetAutoFilterRefresh مع SDKs
###仕様 واجهة PostWorksheetAutoFilterRefresh
يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة للعامة وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL.
استخدام SDKات Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. تُدار التفاصيل منخفضة المستوى بواسطة الـ SDK، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKات Aspose.Cells Cloud.