إضافة شرط التنسيق – مستندات واجهة برمجة تطبيقات Aspose.Cells Cloud
Contents
[
Hide
]
تقوم هذه الواجهة البرمجية REST بإضافة شرط تنسيق إلى ورقة عمل.
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
واجهة برمجة تطبيقات REST
PUT http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/conditionalFormattings/{index}
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف جدول العمل Excel. |
| sheetName | string | path | اسم ورقة العمل التي تحتوي على النطاق المراد تنسيقه. |
| index | integer | path | الفهرس الصفر-based لشرط التنسيق المراد إضافته أو استبداله. |
| cellArea | string | query | نطاق الخلايا (مثل A1:C3) الذي يطبّق عليه الشرط. |
| type | string | query | نوع الشرط (مثل Expression, CellValue). |
| operatorType | string | query | العامل المستخدم في الشرط (مثل Between, Equal). |
| formula1 | string | query | الصيغة أو القيمة الأولى المستخدمة في الشرط. |
| formula2 | string | query | الصيغة أو القيمة الثانية (مطلوبة لبعض العوامل مثل Between). |
| folder | string | query | المجلد في التخزين حيث يوجد ملف جدول العمل. |
| storageName | string | query | اسم خدمة التخزين (مثل Default). |
استجابات الأخطاء
| رمز HTTP | السبب | محتوى الاستجابة المثال |
|---|---|---|
| 400 | طلب غير صالح – معاملات مفقودة أو غير صالحة. | { "Code":"400", "Message":"Invalid parameter value." } |
| 401 | غير مصرّح – رمز JWT مفقود أو غير صالح. | { "Code":"401", "Message":"Access token is missing or invalid." } |
| 404 | غير موجود – ملف جدول العمل أو ورقة العمل غير موجود. | { "Code":"404", "Message":"File not found." } |
| 500 | خطأ داخلي في الخادم – فشل غير متوقع في الخادم. | { "Code":"500", "Message":"An unexpected error occurred." } |
استجابة ناجحة
| رمز HTTP | السبب | محتوى الاستجابة المثال |
|---|---|---|
| 200 | ناجح – تم إضافة الشرط أو تحديثه بنجاح. | { "Code": "200", "Status": "OK" } |
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة للعامة وتسمح لك بإجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام cURL لاستدعاء واجهة برمجة تطبيقات Aspose.Cells. يوضح المثال التالي طلبًا كاملًا، بما في ذلك جسم JSON فارغ.
مثال باستخدام cURL
عائلة SDK للسحابة
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. يتعامل SDK مع التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للاطلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة: