إضافة مرشح تواريخ إلى ورقة عمل Excel | واجهة Aspose.Cells Cloud API
تقوم هذه الواجهة REST بإضافة مرشح تواريخ إلى ورقة عمل Excel.
المتطلبات المسبقة: يجب أن يكون لديك رمز JWT صالح، وأن يكون الملف المطلوب موجودًا مسبقًا في موقع التخزين المحدّد. لا تتطلب الطلب إرسال جسم JSON.
واجهة PutWorksheetDateFilter API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/dateFilter
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب المصادقة باستخدام رمز JWT.
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | Path | اسم ملف العمل. |
| sheetName | string | Path | اسم ورقة العمل. |
| range | string | Query | نطاق Excel الذي سيُطبّق عليه المرشح (مثل A1:B1). |
| fieldIndex | integer | Query | المؤشر الصفري-الأساسي للعمود المراد ترشيحه. |
| dateTimeGroupingType | string | Query | نوع التجميع لمرشح التاريخ/الوقت. القيم المسموح بها هي Day و Hour و Minute و Month و Second و Year. القيم حساسة لحالة الأحرف؛ والقيمة الافتراضية هي Day. |
| year | integer | Query | مكوّن السنة في قيمة المرشح. |
| month | integer | Query | مكوّن الشهر في قيمة المرشح. |
| day | integer | Query | مكوّن اليوم في قيمة المرشح. |
| hour | integer | Query | مكوّن الساعة في قيمة المرشح. |
| minute | integer | Query | مكوّن الدقيقة في قيمة المرشح. |
| second | integer | Query | مكوّن الثانية في قيمة المرشح. |
| matchBlanks | boolean | Query | تضمين الخلايا الفارغة (true أو false). |
| refresh | boolean | Query | تحديث المرشح بعد التطبيق (true أو false). |
| folder | string | Query | مسار المجلد الذي يوجد فيه ملف العمل الأصلي. |
| storageName | string | Query | اسم خدمة التخزين. |
لا يتطلب طلب PUT وجود جسم طلب؛ يتم تزويد جميع المعلمات عبر سلسلة الاستعلام.
الاستجابة
{
"Status":"OK",
"Code":200
}
كود حالات HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تم تطبيق المرشح بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صحيح | معلمات ناقصة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصرّح به | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | حجم الملف المرفّع يتجاوز الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PutWorksheetDateFilter API باستخدام SDKs
مواصفات واجهة PutWorksheetDateFilter API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء الاتصال بواجهة Cloud API باستخدام cURL.
استخدام Aspose.Cells Cloud SDKs
استخدام SDK هو أسرع طريقة للتطوير. تُHANDLE SDK التفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells باستخدام SDKs مختلفة: