إضافة مُفلّت (Slicer) إلى كائن قائمة في Excel – واجهة Aspose.Cells Cloud API

تُضيف هذه الواجهة البرمجية REST مُفلّت (Slicer) لكائن قائمة في ورقة عمل Excel.

واجهة REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/InsertSlicer

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

اسم المُعلَمة	النوع	الموقع	الوصف
name	نص (String)	المسار	اسم ملف Excel.
sheetName	نص (String)	المسار	اسم ورقة العمل التي تحتوي على كائن القائمة.
listObjectIndex	عدد صحيح (Integer)	المسار	الفهرس الصفري لكائن القائمة الذي سيتم إضافة المُفلّت إليه.
columnIndex	عدد صحيح (Integer)	الاستعلام	الفهرس الصفري للعمود الذي يستند إليه المُفلّت.
destCellName	نص (String)	الاستعلام	مرجع الخلية (مثل A1) حيث سيتم وضع المُفلّت.
folder	نص (String)	الاستعلام	المجلد في التخزين الذي يحتوي على ملف Excel.
storageName	نص (String)	الاستعلام	اسم خدمة تخزين Aspose Cloud.

يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء الواجهة:

Request

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/InsertSlicer" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

ملاحظة: يتطلب الطلب رمز bearer JWT صالحًا يُحصل عليه من خدمة مصادقة Aspose Cloud. لا تتطلب هذه النقطة النهائية جسم طلب؛ أرسل كائن JSON فارغ {} إذا كان مكتبة العميل الخاصة بك تفرض وجود حمولة (payload).

Response

{
  "Code": 200,
  "Status": "OK",
  "Slicer": {
    "Name": "Slicer1",
    "ColumnIndex": 2,
    "Position": "A1"
  }
}

رأس الاستجابة: Content-Type: application/json

رموز حالة HTTP

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

معالجة الأخطاء

عند حدوث خطأ، تُعيد الواجهة كائن JSON يحتوي على حقل ErrorMessage يصف المشكلة. راجع رمز حالة HTTP وحقل ErrorMessage لتحديد الإجراء التصحيحي.

عائلة حزم SDK السحابية

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

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

تحويل كائن القائمة إلى نطاق – واجهة Aspose.Cells Cloud API