تصدير مخطط Excel – مستند
تصدير كائنات المخططات من ملفات Excel إلى تنسيقات مختلفة للصور والمستندات هو متطلب شائع في إعداد التقارير والنشر. توفر Aspose.Cells Cloud نقطة نهاية REST بسيطة تحول المخططات مباشرةً إلى تنسيقات شائعة مثل PNG و JPEG و PDF و SVG و TIFF و EMF و WMF والمزيد.
يمكنك تصدير المخططات إلى التنسيقات التالية: PNG, GIF, JPEG, BMP, SVG, TIFF, EMF, WMF, و PDF.
متطلبات مسبقة:
- حساب Aspose.Cells Cloud ساري المفعول مع اشتراك نشط.
- رمز مميز OAuth 2.0 Bearer (JWT) تم الحصول عليه عبر عملية المصادقة.
- ملف المصنف المراد تحميله (أقصى حجم < 50 ميجابايت).
واجهة REST API
POST https://api.aspose.cloud/v3.0/cells/export
الأمان والمصادقة
تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب
| اسم المعامل | النوع | المسار / سلسلة الاستعلام / جسم HTTP | مطلوب | الوصف |
|---|---|---|---|---|
| file | ملف | formData | نعم | الملف المراد تحميله |
| objectType | نص | استعلام | نعم | نوع الكائن المراد تصديره. لتصدير المخطط استخدم chart. القيم المحتملة الأخرى تشمل worksheet و picture وما إلى ذلك. |
| format | نص | استعلام | نعم | التنسيق المطلوب للإخراج. القيم المدعومة: png و jpeg و gif و bmp و svg و tiff و emf و wmf و pdf. |
الاستجابة
{
"Files": [
{
"Filename": "Book1_xlsx_Sheet4_Charts_0.tif",
"FileSize": 10040,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_1.tif",
"FileSize": 12978,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_2.tif",
"FileSize": 7002,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_3.tif",
"FileSize": 11532,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet6_Charts_0.tif",
"FileSize": 8270,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_0.tif",
"FileSize": 42570,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_1.tif",
"FileSize": 12102,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_2.tif",
"FileSize": 8290,
"FileContent": "-----Base64String--------"
}
]
}
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مخوّل | رمز JWT غير صالح أو مفقود. |
| 413 | حملة البيانات كبيرة جدًا | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيفية استخدام واجهة PostExport API باستخدام SDKs
مواصفات واجهة PostExport API
تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يجب أن تتضمن جميع الطلبات رمز مميز OAuth 2.0 Bearer صالح في رأس Authorization. يُظهر المثال التالي كيفية استدعاء الواجهة باستخدام cURL وتحميل مصنف باستخدام multipart/form-data.
curl -X POST "https://api.aspose.cloud/v3.0/cells/export?objectType=chart&format=tiff" \
-H "Authorization: Bearer {access_token}" \
-H "Accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-F "File=@/path/to/your/workbook.xlsx"
استخدام SDKs الخاصة بـ Aspose.Cells Cloud
استخدام SDKs هو أفضل طريقة لتسريع عملية التطوير. تقوم SDKs بالتعامل مع التفاصيل منخفضة المستوى وتسمح لك بالتركيز على مهام مشروعك. يُرجى مراجعة مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام SDKs متنوعة: