تقوم هذه الواجهة REST بتصفية أعلى 10 عناصر في قائمة.

المتطلبات الأساسية
• احصل على رمز JWT صالح باستخدام مصادقة Aspose.Cells Cloud.
• رفع ملف مصنف إكسل إلى مساحة التخزين الخاصة بك في Aspose Cloud (أو حدد مساحة التخزين/المجلد الذي يوجد فيه الملف).
• اعرف اسم ورقة العمل ونطاق الخلية الذي تريد تطبيق التصفية عليه.

PutWorksheetFilterTop10 API

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

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

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

مُعطَلات الطلب

اسم المُعطَل النوع الموقع إجباري القيمة الافتراضية الوصف
name string path نعم — اسم ملف إكسل.
sheetName string path نعم — اسم ورقة العمل التي تحتوي على البيانات.
range string query نعم — نطاق الخلايا الذي سيتم تطبيق التصفية عليه (مثال: A1:B10).
fieldIndex integer query نعم — المؤشر المبني على الصفر لعمود تطبيق التصفية عليه.
isTop boolean query نعم true true لتصفية العناصر العلوية؛ false للعناصر السفلية.
isPercent boolean query لا false true لاعتبار itemCount نسبة مئوية؛ false للعدد المطلق.
itemCount integer query لا 10 عدد العناصر التي يجب تضمينها في عامل التصفية.
matchBlanks boolean query لا false true لتضمين الخلايا الفارغة في نتائج عامل التصفية.
refresh boolean query لا false true لتحديث عامل التصفية بعد تطبيقه.
folder string query لا — المجلد في التخزين حيث يوجد ملف إكسل.
storageName string query لا — اسم مساحة تخزين Aspose Cloud.

الاستجابة

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

استجابات الخطأ النموذجية

{
    "Code":400,
    "Message":"طلب غير صحيح – مُعطَلات مفقودة أو غير صالحة."
}

{
    "Code":401,
    "Message":"غير مصرّح – رمز JWT غير صالح أو مفقود."
}

{
    "Code":413,
    "Message":"حمولة كبيرة جدًا – حجم الملف المرفوع يتجاوز الحد المسموح به."
}

{
    "Code":500,
    "Message":"خطأ داخلي في الخادم – حالة غير متوقعة في الخادم."
}

رموز حالة HTTP

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

كيفية استخدام PutWorksheetFilterTop10 API باستخدام مكتبات SDK

مواصفات PutWorksheetFilterTop10 API

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

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

استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام مكتبات SDK المختلفة: