إضافة كائن قائمة (جدول) إلى ورقة عمل Excel – وثائق Aspose.Cells Cloud

تضيف واجهة برمجة التطبيقات هذه كائن قائمة (جدول) إلى ورقة عمل Excel.

قبل استخدام هذه الـ endpoint، تأكّد من امتلاك رمز JWT صالح، واحتفاظ الملف المصنف بتخزين سحابي مدعوم، ووجود ورقة العمل.

واجهة برمجة التطبيقات REST

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

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

اسم المعلمة النوع الموقع الوصف
name string path اسم ملف المصنف.
sheetName string path اسم ورقة العمل.
startRow integer query المؤشر المُعدّ من الصفر لصف أول نطاق الجدول.
startColumn integer query المؤشر المُعدّ من الصفر لعمود أول نطاق الجدول.
endRow integer query المؤشر المُعدّ من الصفر لصف آخر نطاق الجدول.
endColumn integer query المؤشر المُعدّ من الصفر لعمود آخر نطاق الجدول.
hasHeaders boolean query true إذا كان الصف الأول يحتوي على رؤوس أعمدة؛ وإلا false.
listObject object body تعريف كائن القائمة (انظر مخطط جسم الطلب).
folder string query المجلد الذي يحتوي على المصنف.
storageName string query اسم التخزين.

مخطط جسم الطلب

يصف كائن listObject الجدول الذي سيتم إنشاؤه. تُعرض فقط الخصائص الأكثر شيوعًا؛ وللحصول على القائمة الكاملة، راجع مواصفات OpenAPI.

{
  "displayName": "MyTable",
  "showTotals": false,
  "style": "TableStyleMedium2"
}

مثال على الطلب (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/listobjects?startRow=1&startColumn=1&endRow=10&endColumn=12&hasHeaders=true" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "displayName": "MyTable",
        "showTotals": false,
        "style": "TableStyleMedium2"
      }'

مثال على الاستجابة

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

رموز الأخطاء

الحالة HTTP السبب الوصف
400 Bad Request (طلب غير صالح) مَعلمات النطاق غير صالحة أو جسم JSON غير مُنسّق بشكل صحيح.
401 Unauthorized (غير مُصادَق) رمز JWT مفقود أو منتهٍ.
404 Not Found (غير موجود) المصنف أو ورقة العمل المحدّدة غير موجودين.
500 Internal Server Error (خطأ داخلي في الخادم) فشل غير متوقّع من جانب الخادم.

مثال على استجابة 400

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Invalid range parameters."
}

مثال على استجابة 401

{
  "Code": 401,
  "Status": "Unauthorized",
  "Message": "Authentication token is missing or expired."
}

توفر مواصفات OpenAPI العقد الكاملة لهذه العملية.

مجموعة أدوات Cloud SDK

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

توضح أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب الخاصة بـ Aspose.Cells باستخدام SDKs مختلفة: