تحديث كائن قائمة في ورقة عمل Excel – وثائق واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم واجهات برمجة تطبيقات Aspose.Cells Cloud بتحديث خصائص كائن القائمة (الجدول) في ورقة عمل Excel.
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مخطط جسم الطلب
يحتوي كائن البيانات listObject (DTO) على الحقول التالية. الحقول المطلوبة في جسم الطلب هي فقط تلك التي تحتاج إلى تغييرها.
| الحقل | النوع | الإلزام | الوصف |
|---|---|---|---|
| DisplayName | string | اختياري | الاسم المعروض للجدول. |
| StartRow / StartColumn | integer | اختياري | الفهرس الصفر-based للصف/العمود الأول في الجدول. |
| EndRow / EndColumn | integer | اختياري | الفهرس الصفر-based للصف/العمود الأخير في الجدول. |
| Range | string | اختياري | عنوان بنمط A-1 يُعرّف نطاق الجدول (مثل A1:D10). |
| ShowHeaderRow | boolean | اختياري | true لعرض صف العنوان. |
| ShowTotals | boolean | اختياري | true لعرض صف المجموعات. |
| TableStyleName | string | اختياري | اسم نمط الجدول الجاهز المراد تطبيقه. |
| TableStyleType | string | اختياري | نوع النمط (TableStyleLight، TableStyleMedium، إلخ). |
| ListColumns | array of objects | اختياري | مجموعة تعريفات الأعمدة (Name، TotalsCalculation). |
| Sorter، AutoFilter، ShowTableStyle… | object | اختياري | خيارات متقدمة للتنسيق والتصفية (انظر مُعرّف البيانات الكامل في مواصفات OpenAPI). |
مثال الحد الأدنى من حمولة الطلب
{
"DisplayName": "SalesData",
"Range": "A1:E20",
"ShowHeaderRow": true,
"ShowTotals": false
}
واجهة برمجة تطبيقات REST
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}
معلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم المستند. |
| sheetName | string | path | اسم ورقة العمل. |
| listObjectIndex | integer | path | فهرس كائن القائمة المراد تحديثه. |
| listObject | object | body | كائن البيانات ListObject في جسم الطلب. |
| folder | string | query | المجلد الذي يحتوي على المستند. |
| storageName | string | query | اسم وحدة التخزين. |
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول بشكل عام وتتيح لك تنفيذ تفاعلات REST مباشرة من متصفح ويب.
الطلب
استجابات الأخطاء
| رمز HTTP | الوصف | مثال حمولة الطلب |
|---|---|---|
| 400 | طلب غير صالح – حقول مفقودة أو JSON غير صحيح. | { "Code": 400, "Message": "Invalid request body." } |
| 401 | غير مُصادق عليه – رمز JWT مفقود أو غير صالح. | { "Code": 401, "Message": "Authentication failed." } |
| 404 | غير موجود – المستند أو ورقة العمل أو كائن القائمة المحدد غير موجود. | { "Code": 404, "Message": "Resource not found." } |
| 500 | خطأ داخلي في الخادم – شرط غير متوقع من جانب الخادم. | { "Code": 500, "Message": "Server error." } |
الأسئلة الشائعة
كيف أُحدّث كائن قائمة باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud؟
استخدم النقطة الطرفية POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}. تضمن جسم JSON يحتوي على الخصائص التي ترغب في تعديلها (مثل DisplayName، ShowHeaderRow). قم بالمصادقة باستخدام رمز JWT في رأس Authorization.
ما هي الاستجابة التي أتلقاها بعد التحديث الناجح؟
يُعاد كائن JSON يحتوي على Code: 200 و Status: "OK". في حالة حدوث خطأ، تحتوي الاستجابة على رمز حالة HTTP المناسب وكائن Error يصف المشكلة.
هل يمكنني تحديث مجموعة فرعية فقط من خصائص كائن القائمة؟
نعم. قم بتضمين الحقول التي ترغب في تعديلها فقط في جسم الطلب؛ ستظل جميع الحقول المُهمَلة دون تغيير.
الوثائق ذات الصلة
عائلة حزم SDK السحابية
استخدام حزمة SDK هي أفضل طريقة لتسريع عملية التطوير. فحزمة SDK تتعامل مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطلاع على قائمة كاملة بحزم SDK الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام حزم SDK المختلفة: