إضافة معيار مخصص في ورقة عمل إكسل – واجهة برمجة تطبيقات Aspose.Cells Cloud
تُطبّق هذه واجهة برمجة تطبيقات REST تصفيةً لقائمة باستخدام معيار مخصص.
PutWorksheetCustomFilter API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/custom
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب:
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | سلسلة نصية | المسار | اسم ملف إكسل. |
| sheetName | سلسلة نصية | المسار | اسم ورقة العمل التي تحتوي على البيانات المراد تصفيتها. |
| range | سلسلة نصية | الاستعلام | النطاق الخلوي الذي سيتم تطبيق التصفية عليه (مثال: A1:B1). |
| fieldIndex | عدد صحيح | الاستعلام | المؤشر الصفر-based للعمود الذي تُطبّق عليه التصفية. |
| operatorType1 | سلسلة نصية | الاستعلام | عامل المقارنة الأول (مثال: LessOrEqual، Equal). |
| criteria1 | سلسلة نصية | الاستعلام | القيمة أو التعبير الأول للتصفية. |
| isAnd | منطقي | الاستعلام | إذا كانت القيمة true، تُدمج المعياران باستخدام AND؛ وإلا باستخدام OR. |
| operatorType2 | سلسلة نصية | الاستعلام | عامل المقارنة الثاني (اختياري). |
| criteria2 | سلسلة نصية | الاستعلام | القيمة أو التعبير الثاني للتصفية (اختياري). |
| matchBlanks | منطقي | الاستعلام | عند القيمة true، تُضمّن الخلايا الفارغة في نتائج التصفية. |
| refresh | منطقي | الاستعلام | إذا كانت القيمة true، تُجبر ورقة العمل على التحديث بعد تطبيق التصفية. |
| folder | سلسلة نصية | الاستعلام | مسار المجلد في التخزين حيث يقع الملف. |
| storageName | سلسلة نصية | الاستعلام | اسم خدمة التخزين. |
الاستجابة
{
"Status":"OK",
"Code":200
}
كود حالات HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | OK (نجاح) | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب غير صالح) | معاملات مفقودة أو غير صحيحة (مثال: نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مصادق) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PutWorksheetCustomFilter API باستخدام SDKs
مواصفات واجهة PutWorksheetCustomFilter API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للاستدعاء، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء استدعاء إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDKs هو أسرع طريقة للتطوير. تُعالج SDKs التفاصيل منخفضة المستوى، مما يتيح لك التركيز على منطق مشروعك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة:
لعمليات التصفية التلقائية الأخرى، مثل إضافة تصفية قياسية أو تصفية تاريخ، راجع صفحات الوثائق ذات الصلة ضمن قسم التصفية التلقائية.