تصدير منطقة ورقة العمل إلى PNG و PDF و CSV باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud – دليل شامل
يتيح لك GET /cells/{name}/worksheets/{sheetName} API تحويل منطقة محددة من ورقة العمل إلى تنسيقات ملفات متعددة. التنسيقات المدعومة: XLS، XLSX، XLSB، CSV، TSV، XLSM، ODS، TXT، PDF، OTS، XPS، DIF، PNG، JPEG، GIF، BMP، WMF، TIFF، EMF، NUMBERS، FODS.
يُظهر هذا الدليل كيفية تصدير نطاق خلايا محدّد من ورقة عمل Excel إلى تنسيقات PNG و PDF و CSV وأكثر من 20 تنسيق إضافي باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud. وللمهام ذات الصلة مثل تصدير ورقة العمل بالكامل أو تحويل ملف книга، راجع صفحات تصدير ورقة العمل بالكامل و تحويل ملف книга إلى PDF.
واجهة برمجة تطبيقات REST
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول العام وتتيح لك إجراء تفاعلات REST مباشرة من متصفّح ويب.
معاملات الطلب
| المعامل | النوع | الإلزام | الوصف |
|---|---|---|---|
name |
نص | نعم | اسم ملف книга. |
sheetName |
نص | نعم | اسم ورقة العمل المستهدفة. |
format |
نص | نعم | تنسيق الإخراج المطلوب (png أو pdf أو csv…). |
area |
نص | لا | نطاق الخلايا المراد تصديره (مثال: B3:K8). |
verticalResolution |
عدد صحيح | لا | الدقة الرأسية للتنسيقات النقطية. |
horizontalResolution |
عدد صحيح | لا | الدقة الأفقية للتنسيقات النقطية. |
folder |
نص | لا | مجلد تخزين السحابة الذي يحتوي على الملف. |
storage |
نص | لا | اسم خدمة التخزين. |
الاستجابة الناجحة
- 200 OK – يُعيد الملف المطلوب بصيغته الثنائية (PNG أو PDF أو CSV… إلخ).
استجابات الأخطاء
| رمز الحالة | الوصف |
|---|---|
| 400 | طلب خاطئ – معاملات مفقودة أو غير صالحة. |
| 401 | غير مُصادَق – رمز المصادقة مفقود أو غير صالح. |
| 404 | غير موجود – لم يُعثر على книга أو ورقة العمل المحدّدة. |
| 500 | خطأ داخلي في الخادم – حالة غير متوقعة في الخادم. |
مثال على حمولة خطأ
{
"error": {
"code": "InvalidParameter",
"message": "المعامل 'area' بصيغة غير صحيحة. الصيغة المتوقعة: B3:K8."
}
}
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء استدعاء لواجهة برمجة التطبيقات السحابية باستخدام cURL.
عائلة مكتبات SDK السحابية
يُعد استخدام مكتبات SDK الطريقة الأسرع للتطوير. فتُجرّد مكتبات SDK التفاصيل من المستوى المنخفض، مما يسمح لك بالتركيز على منطق مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
توضح الأمثلة التالية كيفية استدعاء خدمات Aspose.Cells عبر مكتبات SDK مختلفة: