كيفية تحويل مخطط جدول البيانات إلى صورة: دليل خطوة بخطوة
Contents
[
Hide
]
مخططات Excel هي تمثيلات مرئية للبيانات يمكن تضمينها داخل أوراق العمل. يُمكّن تحويل هذه المخططات إلى تنسيقات الصور من إعادة استخدامها بسهولة عبر المستندات وصفحات الويب والتقارير دون الحاجة إلى Excel.
قم بتحويل مخطط من ملف جدول بيانات محلي أو ملف Excel إلى ملف صورة. تنسيقات الصور المدعومة: PNG، SVG، TIFF، JPEG، BMP
واجهة API لتحويل المخطط إلى صورة
واجهة API عبر الويب
PUT https://api.aspose.cloud/v4.0/cells/convert/chart/image
curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/chart/image?format=png&chartIndex=0" \
-H "Authorization: Bearer {access_token}" \
-F "Spreadsheet=@MyWorkbook.xlsx" \
-o chart.png
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معلمات الطلب:
| اسم المعلمة | النوع | المسار/سلسلة الاستعلام/جسم HTTP | الوصف | الإلزام |
|---|---|---|---|---|
| Spreadsheet | ملف | FormData | تحميل ملف جدول البيانات الذي يحتوي على المخطط. | نعم |
| worksheet | سلسلة نصية | استعلام | تحديد اسم ورقة العمل إن وُجد. | لا |
| chartIndex | عدد صحيح | استعلام | فهرس المخطط المراد تحويله. | نعم |
| format | سلسلة نصية | استعلام | (إلزامي) نوع الصورة المطلوب (مثل: svg، png، jpg). | نعم |
| outPath | سلسلة نصية | استعلام | (اختياري) مسار المجلد الذي سيتم تخزين ملف الإخراج فيه؛ الافتراضي هو null. | لا |
| outStorageName | سلسلة نصية | استعلام | اسم وحدة التخزين الخاصة بملف الإخراج. | لا |
| fontsLocation | سلسلة نصية | استعلام | تحديد الخطوط المخصصة عند الحاجة. | لا |
| region | سلسلة نصية | استعلام | ضبط منطقة جدول البيانات. | لا |
| password | سلسلة نصية | استعلام | كلمة المرور لفتح ملف جدول البيانات. | لا |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معلمات مفقودة أو غير صحيحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه | رمز JWT غير صالح أو مفقود. |
| 413 | حملة البيانات كبيرة جدًا | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة API لتحويل المخطط إلى صورة؟
- توليد التقارير واللوحات التفاعلية (Dashboards): تحويل المخططات تلقائيًا من بيانات Excel إلى صور (PNG وJPEG وما إلى ذلك) لتضمينها في تقارير PDF أو لوحات تفاعلية على الويب أو عروض PowerPoint.
- تطبيقات الويب/البريد الإلكتروني: عرض صور المخططات مباشرةً في صفحات الويب أو رسائل البريد الإلكتروني دون الحاجة إلى تنزيل أو فتح ملفات Excel. مفيد في أدوات التقارير الديناميكية أو النشرات الإخبارية أو الإشعارات الآلية.
- سير عمل معالجة المستندات: دمجها في خطوط أنابيب آلية (مثل: الفوترة أو التحليلات) حيث تكون الحاجة إلى إدراج مخططات من Excel في تنسيقات أخرى (Word أو PDF أو HTML) ضرورية.
- تطبيقات الجوال/سطح المكتب: عرض مخططات Excel في التطبيقات التي لا تتطلب عرض جدول البيانات بالكامل أو يكون ذلك غير عملي.
- الأرشفة والتصور: حفظ المخططات كصور منفصلة لتخزينها على المدى الطويل أو كصور مصغرة أو معاينات سريعة دون اعتماد على Excel.
لماذا يجب استخدام واجهة API لتحويل المخطط إلى صورة؟
- الحفاظ على الدقة البصرية: تحافظ على تنسيق المخطط بالضبط (الألوان والتصنيفات والم масحات) كما تظهر في Excel، مما يضمن إخراجًا بجودة احترافية.
- مستقلة عن المنصة: لا حاجة لتثبيت Excel. تعمل عبر أنظمة التشغيل (Windows وLinux وmacOS) عبر واجهة API REST، مما يجعلها مناسبة للتطبيقات السحابية أو الخوادم.
- الأتمتة والقابلية للتوسع: تحويل جماعي لمخططات أو ملفات متعددة برمجيًا، مما يوفر الوقت مقارنةً بالتصدير اليدوي. معالجة كميات كبيرة بكفاءة في السحابة.
- تنسيقات إخراج مرنة: تدعم تنسيقات الصور الشائعة (PNG وJPG وBMP وSVG وما إلى ذلك)، مما يسمح بالتكامل مع أنظمة ووسائط متنوعة.
- آمنة وموثوقة: معالجة الملفات في بيئة سحابية تابعة لـ Aspose دون تعريض البيانات الحساسة لاستخدام أدوات من جانب العميل. توفر متانة عالية وأداءً ثابتًا.
- سهلة للمطورين: توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، ما يُسهّل التطوير بسرعة، وتُرفق بتوثيق شامل. مقارنةً ببناء حلول تصور مخصصة للمخططات، فإن هذا يقلل بشكل كبير من جهد التطوير.
- موفرة من حيث التكلفة: يمكنك تحويل المخططات دون رفع كتاب العمل أولاً، مما يوفر مساحة التخزين ويقلل التكاليف.
كيفية استخدام واجهة API لتحويل المخطط إلى صورة مع مكتبات SDK؟
مواصفات واجهة API لتحويل المخطط إلى صورة
مواصفات واجهة API لتحويل المخطط إلى صورة تُعرّف واجهة برمجة تطبيقات متاحة علنًا وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
استخدام مكتبات SDK لـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، حيث تُجرّدك من التفاصيل منخفضة المستوى، مما يسمح لك بتحويل المخطط إلى صورة باستخدام كود قصير.
يرجى الاطلاع على مستودع GitHub للاطلاع على قائمة كاملة بمكتبات SDK لـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام مكتبات SDK المختلفة: