تحديث محور الفئة في المخطط – واجهة Aspose.Cells Cloud API
تقوم هذه الواجهة بتحديث محور الفئة في مخطط.
واجهة PostChartCategoryAxis API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/categoryaxis
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف Excel. |
| sheetName | string | path | اسم ورقة العمل التي يحتوي المخطط عليها. |
| chartIndex | integer | path | الفهرس (من الصفر) للمخطط المراد تحديثه. |
| axis | object | body | كائن JSON يُعرّف خصائص محور الفئة. |
| folder | string | query | المجلد في التخزين السحابي حيث يقع الملف (اختياري). |
| storageName | string | query | اسم التخزين (اختياري). |
مخطط جسم الطلب – كائن axis
| الخاصية | النوع | الوصف |
|---|---|---|
| IsAutomaticMajorUnit | boolean | تحديد ما إذا كان يتم احتساب الوحدة الرئيسية تلقائيًا. |
| MajorUnit | number | قيمة الوحدة الرئيسية عندما تكون IsAutomaticMajorUnit تساوي false. |
| IsAutomaticMinorUnit | boolean | تحديد ما إذا كان يتم احتساب الوحدة الثانوية تلقائيًا. |
| MinorUnit | number | قيمة الوحدة الثانوية عندما تكون IsAutomaticMinorUnit تساوي false. |
| Title | object | إعدادات العنوان للمحور (مثل Text، Font، Visible). |
| TickLabelPosition | string | موقع تسميات العلامات (مثل Low، High، NextToAxis). |
| … | … | خصائص المحور الإضافية كما هو مُعرّف في وثيقة API. |
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (تم بنجاح) | تمت تطبيق الفلتر بنجاح؛ يحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب خاطئ) | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مُصرّح) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | حدث خطأ غير متوقع في الخادم. |
المتطلبات المسبقة / المصادقة
لاستدعاء هذه النقطة النهائية، يجب عليك الحصول على رمز وصول JWT من خدمة مصادقة Aspose.Cells Cloud (/connect/token)، ثم تضمين الرمز في رأس Authorization كما هو موضح في المثال أدناه.
تُعرّف 仕様 OpenAPI واجهة برمجة تطبيقات عامة قابلة للاستخدام، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
ملاحظات
- النقطة النهائية تتطلب استخدام HTTPS؛ استخدام HTTP قد يؤدي إلى ظهور تحذيرات محتوى مختلط في المتصفحات.
- يجب استبدال جميع القيم العينية (placeholders) (
{name}،{sheetName}،{chartIndex}،{folder}،{storageName}) بمعرفات فعلية. - أنواع المخططات المدعومة لتحديث محور الفئة مذكورة في مرجع API.
عائلة SDK السحابية
استخدام SDK يُعدّ أفضل طريقة لتسريع عملية التطوير، إذ يتولى SDK إدارة التفاصيل منخفضة المستوى ويسمح لك بالتركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs لـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات الويب Aspose.Cells باستخدام SDKs مختلفة: