كيفية تحويل بيانات جدول بيانات ورقة عمل محلية إلى ملف صورة: دليل خطوة بخطوة
تصدير البيانات من ورقة عمل في ملف Excel محلي إلى ملف صورة باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud. تدعم هذه العملية تنسيقات الصور المتعددة، وهي مثالية لإنشاء لقطات بصرية لبيانات جداول البيانات.
تنسيقات الصور المدعومة
واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة
واجهة برمجة التطبيقات عبر الويب
PUT http://api.aspose.cloud/v4.0/cells/convert/worksheet/image
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معلمات الطلب
| اسم المعلمة | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | رفع ملف جدول البيانات. |
| worksheet | سلسلة نصية | استعلام | اسم ورقة العمل المراد تحويلها. |
| format | سلسلة نصية | استعلام | تنسيق الصورة المطلوب (svg، png، tiff، jpeg، bmp، إلخ). |
| outPath | سلسلة نصية | استعلام | (اختياري) مسار المجلد الذي سيتم حفظ صورة الإخراج فيه؛ القيمة الافتراضية هي null. |
| outStorageName | سلسلة نصية | استعلام | اسم موقع التخزين لملف الإخراج. |
| fontsLocation | سلسلة نصية | استعلام | مسار مجلد خطوط مخصصة، إن احتجت لاستخدام خطوط غير متوفرة على الخادم. |
| region | سلسلة نصية | استعلام | إعداد منطقة جدول البيانات (مثل en-US). |
| password | سلسلة نصية | استعلام | كلمة المرور المطلوبة لفتح ملف جدول البيانات المحمي. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معلمات ناقصة أو غير صحيحة (مثل نوع الملف غير المدعوم). |
| 401 | غير مصرح (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة؟
- لقطات ثابتة للتقارير – تحويل الجداول المالية أو الحسابات أو غيرها من البيانات إلى صور لاستخدامها في تقارير PDF أو شرائح PowerPoint أو المستندات المطبوعة حيث لا يُطلب تعديلها.
- تمثيل بصري للبيانات في العروض التقديمية – تحويل جداول البيانات المعقدة (بما في ذلك التنسيق الشرطي أو المخططات البسيطة) إلى صور يمكن تضمينها في العروض التقديمية (PPTX، Google Slides).
- المستندات ومواد التدريب – التقاط أمثلة جداول البيانات أو القوالب أو نماذج إدخال البيانات كصور لاستخدامها في الكتيبات أو الدلائل أو المقالات في قواعد المعرفة.
- معاينات مصغرة – إنشاء معاينات صور صغيرة لأقسام جداول البيانات الأساسية لمستعرضات الملفات أو مكتبات المستندات أو نتائج البحث.
لماذا يجب استخدام واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة؟
- سهلة الاستخدام للمطورين – توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يمكّن من تطوير سريع ويأتي مع وثائق شاملة. مقارنةً بإنشاء حل مخصص لعرض الرسوم البيانية، فإن هذا يقلل بشكل كبير من حجم العمل التطويري.
- فعالة من حيث التكلفة – يمكنك تحويل بيانات الجداول دون الحاجة لتخزين ملفات المصنف بشكل دائم، مما يوفر مساحة تخزين ويقلل التكاليف.
- الحفاظ على دقة البكسل – إعادة إنتاج مظهر Excel بدقة، بما في ذلك تنسيق الخلايا والصيغ (كقيم معروضة)، والحدود والألوان والتنسيق الشرطي، في صورة الإخراج.
- توافق عالمي – تنسيقات الصور (PNG، JPEG، TIFF، BMP، SVG، وما إلى ذلك) قابلة للعرض على أي جهاز أو منصة دون برامج متخصصة، مما يضمن أقصى قدر من إمكانية الوصول.
كيفية استخدام واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة مع مكتبات SDK؟
مواصفات واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة
تعرّف مواصفات واجهة برمجة تطبيقات تحويل ورقة العمل إلى صورة واجهة برمجة تطبيقات قابلة للوصول بشكل عام وتسمح بالتفاعل مع REST مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يُظهر المثال التالي كيفية إجراء مكالمات لواجهة برمجة تطبيقات السحابة باستخدام cURL.
استخدام مكتبات SDK لـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، حيث يُجرّد التفاصيل من المستوى المنخفض ويجعلك قادرًا على تحويل بيانات ورقة العمل إلى صورة باستخدام كود محدود. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK لـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات الويب Aspose.Cells باستخدام مكتبات SDK المختلفة: