إضافة كائن قائمة (جدول) إلى ورقة عمل Excel – وثائق Aspose.Cells Cloud
Contents
[
Hide
]
تضيف واجهة برمجة التطبيقات هذه كائن قائمة (جدول) إلى ورقة عمل 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 مختلفة: