كيفية تحويل بيانات جدول جداول البيانات المحلية إلى ملف صورة: دليل خطوة بخطوة
تصدير بيانات الجدول من ملف Excel المحلي إلى ملف صورة باستخدام واجهة برمجة تطبيقات السحابة.
تنسيقات الصور المدعومة:
واجهة برمجة تطبيقات تحويل الجدول إلى صورة
قبل استخدام هذه النقطة النهائية، تأكد من توفر المتطلبات الأساسية التالية:
- رمز وصول JWT صالح تم الحصول عليه من خلال مصادقة Aspose.Cells Cloud.
- حساب تخزين قابل للوصول إذا كنت تنوي استخدام معاملات
outPathأوoutStorageName. - يجب أن يكون ملف المصنف المصدر (ملف Excel المحلي) قابلًا للقراءة، وإذا كان مشفرًا، يجب توفير كلمة المرور الصحيحة.
واجهة برمجة تطبيقات الويب
PUT https://api.aspose.cloud/v4.0/cells/convert/table/image
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب:
| اسم المعامل | النوع | المسار / سلسلة الاستعلام / جسم الـ HTTP | الوصف |
|---|---|---|---|
| Spreadsheet | ملف | FormData | تحميل ملف جدول البيانات. |
| worksheet | نص | استعلام | اسم ورقة العمل الخاصة بجدول البيانات أو Excel. |
| tableName | نص | استعلام | اسم الجدول المراد تحويله. |
| format | نص | استعلام | تنسيق ملف الصورة المرغوب (مثل: png, svg). |
| outPath | نص | استعلام | (اختياري) مسار المجلد حيث سيتم حفظ الصورة المحولة. القيمة الافتراضية هي null. |
| outStorageName | نص | استعلام | تحديد اسم تخزين ملف الإخراج. |
| fontsLocation | نص | استعلام | استخدام خطوط مخصصة عند الحاجة. |
| region | نص | استعلام | إعداد منطقة/لغة جدول البيانات (مثل: en-US, fr-FR). يؤثر على تنسيق الأرقام، وتفسير التواريخ، والسلوك الخاص باللغة المحلية. |
| password | نص | استعلام | كلمة المرور المطلوبة للوصول إلى ملف جدول البيانات. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معاملات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مصرح به | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمل كبير جدًا | حجم الملف المرفوع يتجاوز الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
أين يجب عليك استخدام واجهة برمجة تطبيقات تحويل الجدول إلى صورة؟
- لقطات ثابتة للتقارير: حوّل جداول مالية أو نتائج الحسابات أو أي بيانات منسقة إلى صور لتضمينها في تقارير 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 المختلفة: