مطابقة جميع الخلايا غير الفارغة في ورقة عمل Excel باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud

نظرة عامة
يعمل إجراء مطابقة جميع الخلايا غير الفارغة على تطبيق فلتر تلقائي (AutoFilter) على ورقة عمل ويعيد فقط الصفوف التي تحتوي على بيانات في العمود المحدّد، مع تجاهل الخلايا الفارغة. ويُعد هذا الإجراء مفيدًا في تنظيف مجموعات البيانات، وإنشاء التقارير، أو إعداد البيانات للتحليل اللاحق.

المتطلبات المسبقة

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

تقوم واجهة برمجة التطبيقات هذه (REST API) بمطابقة جميع الخلايا غير الفارغة في قائمة AutoFilter في ورقة عمل Excel.

واجهة PostWorksheetMatchNonBlanks API

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

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

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

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

اسم المعلمة النوع الموقع الوصف
name string path اسم ملف Excel.
sheetName string path اسم ورقة العمل التي تحتوي على AutoFilter.
fieldIndex integer query الفهرس بصيغة صفرية-البداية للعمود الذي يُطبّق عليه الفلتر.
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 خطأ داخلي غير متوقع في الخادم.

مثال على استجابة خطأ (400)

{
  "Code": 400,
  "Message": "معلمة غير صالحة: يجب أن يكون fieldIndex عددًا صحيحًا غير سالب."
}

كيفية استخدام واجهة PostWorksheetMatchNonBlanks API باستخدام حزم التطوير (SDKs)

مواصفات واجهة PostWorksheetMatchNonBlanks API

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

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

استخدام حزم تطوير Aspose.Cells Cloud (SDKs)

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

تُظهر أمثلة الكود التالية كيفية إجراء مكالمات إلى خدمات الويب الخاصة بـ Aspose.Cells باستخدام حزم تطوير مختلفة: