إضافة مرشّح في ورقة عمل Excel باستخدام Aspose.Cells Cloud

المتطلبات المسبقة: قبل استدعاء هذه الواجهة، يجب عليك الحصول على رمز JWT صالح، والتأكّد من أن مصنف العمل المستهدف مُحمّل في التخزين المحدّد، وامتلاك الصلاحيات اللازمة للوصول إلى الملف. يُوصى باستخدام إصدار حديث من cURL (7.68 أو أحدث) لتشغيل الأمثلة المبنية على سطر الأوامر.

تضيف هذه الواجهة البرمجية للخدمات REST مرشّحًا لعمود معيّن في ورقة عمل Excel.

واجهة PutWorksheetFilter البرمجية

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

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

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

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

اسم المعامل النوع الموقع الوصف
name string Path اسم مصنف العمل.
sheetName string Path اسم ورقة العمل.
range string Query النطاق الخلوي الذي يحتوي على المرشّح (مثل A1:B1).
fieldIndex integer Query الفهرس الصفري (zero-based) للعمود الذي يُطبّق عليه المرشّح.
criteria string Query معايير المرشّح (مثل قيمة أو تعبير).
matchBlanks boolean Query اضبطها على true لتضمين الخلايا الفارغة في المرشّح، وإلا فاضبطها على false.
refresh boolean Query اضبطها على true لتحديث المرشّح بعد تطبيقه، وإلا فاضبطها على false.
folder string Query المجلد الذي يخزّن فيه مصنف العمل الأصلي.
storageName string Query اسم خدمة التخزين.

الاستجابة

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

رموز حالة HTTP

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

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

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

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

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

استخدام مكتبات Aspose.Cells Cloud SDKs

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

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

إضافة معيار مخصص في ورقة عمل إكسل