تحديد قيمة النطاق في ورقة عمل Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud
استخدم هذه الواجهة البرمجية لتحديد قيمة في النطاق المحدّد. وعند الاقتضاء، يتم تحويل القيمة إلى نوع بيانات آخر وإعادة تعيين تنسيق رقم الخلية.
المتطلبات المسبقة
- حساب Aspose Cloud ساري المفعول.
- رمز JWT يشمل النطاق
Cells.ReadWrite. - يجب أن يكون ملف جدول العمل مرفوعًا مسبقًا إلى موقع التخزين المستهدف.
PostWorksheetCellsRangeValue API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value
مُعلّمات الطلب هي:
| اسم المُعلّمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف جدول العمل |
| sheetName | string | path | اسم ورقة العمل |
| value | string | query | القيمة المُدخلة |
| range | object | body | كائن النطاق داخل ورقة العمل |
| isConverted | boolean | query | يشير إلى ما إذا كان يجب تحويل القيمة المُدخلة |
| setStyle | boolean | query | يشير إلى ما إذا كان يجب تطبيق التنسيق على الخلايا المستهدفة |
| folder | string | query | مجلد ملف جدول العمل |
| storageName | string | query | اسم وحدة التخزين |
مثال لكائن range الذي يمكن إرساله في جسم الطلب:
{
"range": {
"FirstRow": 0,
"FirstColumn": 0,
"RowCount": 1,
"ColumnCount": 1
}
}
يعرّف مواصفة OpenAPI واجهة برمجة تطبيقات متاحة علنًا، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL. قم بتضمين رمز JWT ساري المفعول في رأس Authorization.
مخطط الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
| Code | integer | رمز حالة HTTP للاستدعاء. |
| Status | string | وصف موجز للنتيجة (مثل “OK”). |
| Message | string | رسالة خطأ تفصيلية عند فشل الطلب (اختياري). |
| Result | object | بيانات إضافية تُعاد في حالة النجاح (اختياري). |
رموز حالة HTTP المحتملة
- 200 OK – تم تحديد قيمة النطاق بنجاح.
- 400 Bad Request – مُعلمات غير صالحة أو جسم طلب غير مهيّأ بشكل صحيح.
- 401 Unauthorized – رمز JWT مفقود أو غير صالح.
- 403 Forbidden – صلاحيات غير كافية للعمليّة المطلوبة.
- 404 Not Found – ملف جدول العمل أو ورقة العمل أو النطاق المحدّد غير موجود.
- 500 Internal Server Error – خطأ غير متوقع في الخادم.
مثال على استجابة خطأ لحالة 400 Bad Request:
{
"Code": 400,
"Status": "Bad Request",
"Message": "كائن 'range' يفتقر إلى الحقول المطلوبة."
}
عائلة حزم تطوير البرامج السحابية
استخدام حزمة تطوير البرامج (SDK) هو أفضل طريقة لتسريع عملية التطوير. وتتولّى SDK تفاصيل المستوى المنخفض تلقائيًا، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرامج السحابية لـ Aspose.Cells.
تُظهر أمثلة الرمز التالية كيفية إجراء استدعاءات لخدمات ويب Aspose.Cells باستخدام مختلف SDKs: