إضافة مخطط إلى ورقة عمل – دليل واجهة برمجة تطبيقات Aspose.Cells Cloud
تقوم هذه الواجهة REST بإضافة مخطط جديد إلى ورقة عمل.
المتطلبات المسبقة
قبل استدعاء هذه العملية، احصل على رمز وصول JWT صالح، وتأكد من أن ملف المصنف المستهدف مخزن في المجلد المحدد أو موقع التخزين.
PutWorksheetAddChart API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مَعلمات الطلب
| اسم المعلمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | نص | المسار | اسم ملف المصنف. |
| sheetName | نص | المسار | اسم ورقة العمل. |
| chartType | نص | الاستعلام | نوع المخطط (انظر خاصية Type في مورد المخطط). تشمل أنواع المخططات المدعومة: Bar (عمودي)، Column (عمود)، Line (خط)، Pie (دائري)، Scatter (نقطي)، Area (منطقة)، Doughnut (حلقي)، Radar (رادار)، إلخ. |
| upperLeftRow | عدد صحيح | الاستعلام | فهرس الصف الأيسر العلوي لمنطقة المخطط (العد يبدأ من الصفر). |
| upperLeftColumn | عدد صحيح | الاستعلام | فهرس العمود الأيسر العلوي لمنطقة المخطط (العد يبدأ من الصفر). |
| lowerRightRow | عدد صحيح | الاستعلام | فهرس الصف الأيمن السفلي لمنطقة المخطط (العد يبدأ من الصفر). |
| lowerRightColumn | عدد صحيح | الاستعلام | فهرس العمود الأيمن السفلي لمنطقة المخطط (العد يبدأ من الصفر). |
| area | نص | الاستعلام | النطاق الذي يوفّر القيم المراد تمثيلها (مثلًا: A1:B5). |
| isVertical | منطقي | الاستعلام | يُشير إلى ما إذا كانت توجيه المخطط عموديًا. |
| categoryData | نص | الاستعلام | نطاق قيم محور الفئات (مثلًا: D1:E10). |
| isAutoGetSerialName | منطقي | الاستعلام | إذا كانت القيمة true، تُولّد أسماء المتسلسلات تلقائيًا. |
| title | نص | الاستعلام | عنوان المخطط. |
| folder | نص | الاستعلام | المجلد الذي يحتوي على ملف المصنف. |
| storageName | نص | الاستعلام | اسم موقع التخزين. |
| dataLabels | منطقي | الاستعلام | إظهار تسميات البيانات عند القيمة true. |
| dataLabelsPosition | نص | الاستعلام | موقع تسميات البيانات (مثلًا: Above). |
| pivotTableSheet | نص | الاستعلام | اسم ورقة العمل التي تحتوي على الجدول المحوري. |
| pivotTableName | نص | الاستعلام | اسم الجدول المحوري. |
الاستجابة
{
"Status":"OK",
"Code":200
}
رموز حالات HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | مَعلمات مفقودة أو غير صالحة (مثلًا: نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم البيانات كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
كيفية استخدام PutWorksheetAddChart API باستخدام SDKs
مواصفات PutWorksheetAddChart API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول بشكل عام وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يُظهر المثال التالي كيفية إجراء مكالمة إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فالـ SDK يُجرّد التفاصيل من المستوى المنخفض ويسمح لك بالتركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات SDK مختلفة: