إضافة مرشح أيقونات إلى ورقة عمل إكسل – وثائق Aspose.Cells Cloud
واجهة برمجة التطبيقات REST
تُضيف هذه الواجهة مرشح أيقونات إلى ورقة عمل إكسل باستخدام واجهة Aspose.Cells Cloud REST API.
الخلفية: يطبّق مرشح الأيقونات مجموعة مرئية من الأيقونات على الخلايا بناءً على قيمها، مما يسمح بتحليل بصري سريع لاتجاهات البيانات. تشمل حالات الاستخدام الشائعة تسليط الضوء على مقاييس الأداء أو مؤشرات الحالة أو تصنيف القيم باستخدام أيقونات على شكل إشارات مرورية (مثل الإشارة الضوئية) مباشرةً داخل ورقات عمل إكسل.
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/iconFilter
الأمان والمصادقة
تتطلب واجهات برمجة تطبيقات Aspose.Cells Cloud مصادقة قائمة على رمز JWT token، وهي آمنة.
معاملات الطلب:
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | Path | اسم ملف العمل (workbook). |
| sheetName | string | Path | اسم ورقة العمل. |
| range | string | Query | النطاق الخلوي (مثل A1:B1) الذي سيتم تطبيق المرشح عليه. |
| fieldIndex | integer | Query | الفهرس الصفر-based للعمود الذي يستهدفه المرشح. |
| iconSetType | string | Query | مجموعة الأيقونات المراد استخدامها. القيم المسموح بها: Arrows3, ArrowsGray3, Flags3, Signs3, Symbols3, Symbols32, TrafficLights31, TrafficLights32, Arrows4, ArrowsGray4, Rating4, RedToBlack4, TrafficLights4, Arrows5, ArrowsGray5, Quarters5, Rating5, Stars3, Boxes5, Triangles3, None, CustomSet, Smilies3, ColorSmilies3. |
| iconId | integer | 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 | خطأ داخلي في الخادم غير متوقع. |
كيفية استخدام PutWorksheetIconFilter API باستخدام SDKs
مواصفات PutWorksheetIconFilter API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات مفتوحة للوصول العام، وتتيح لك إجراء تفاعلات REST مباشرةً من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء استدعاء إلى واجهة Cloud API باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. تتعامل الـ SDK مع التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة:
لمزيد من إمكانات المرشح التلقائي، راجع الوثائق حول إضافة مرشح لون، إضافة مرشح تواريخ، و مسح المرشح التلقائي.