كيفية تحويل ورقة عمل جدول بيانات محلي إلى ملف PDF: دليل خطوة بخطوة
قم بتحويل مخطط موجود في ملف عمل مخزن في مساحة التخزين الخاصة بـ Aspose Cloud إلى تنسيق ملف مختلف (PDF أو PNG أو SVG أو غيرها) دون تنزيل الملف المصدر.
واجهة برمجة تطبيقات ExportChartAsFormat
GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/charts/{chartIndex}
الأمان والمصادقة
تُعد واجهات برمجة التطبيقات الخاصة بـ Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
📦 معاملات الطلب
| الاسم | النوع | الموقع | إجباري | الوصف |
|---|---|---|---|---|
| name | نص | المسار | نعم | اسم ملف العمل. |
| worksheet | نص | المسار | نعم | اسم ورقة العمل التي يحتويها المخطط. |
| chartIndex | عدد صحيح | المسار | نعم | الفهرس بصفر كبداية للمخطط المراد تصديره. |
| format | نص | الاستعلام | نعم | تنسيق الإخراج المرغوب (مثل: png، pdf، svg). |
| folder | نص | الاستعلام | لا | مسار المجلد الذي يخزن فيه ملف العمل (الافتراضي: الجذر). |
| storageName | نص | الاستعلام | لا | اسم التخزين المخصص؛ تجاهل هذا الخيار لاستخدام التخزين الافتراضي. |
| outPath | نص | الاستعلام | لا | مسار المجلد الذي سيتم حفظ الملف المحول فيه. |
| outStorageName | نص | الاستعلام | لا | اسم التخزين لملف الإخراج. |
| fontsLocation | نص | الاستعلام | لا | مسار مجلد يحتوي على الخطوط المخصصة. |
| region | نص | الاستعلام | لا | إعدادات الإقليم (مثل: en-US، fr-FR). |
| password | نص | الاستعلام | لا | كلمة المرور لفتح ملف عمل محمي. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | نجاح | تمت عملية التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصادق عليه | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جداً | حجم الملف المرفوع يتجاوز الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
كيف تستخدم واجهة برمجة تطبيقات Export Chart as Format باستخدام مكتبات SDK؟
مواصفات واجهة برمجة تطبيقات Export Chart as Format
توفر مواصفات واجهة برمجة تطبيقات Export Chart as Format واجهة برمجة تطبيقات متاحة للعامة وتتيح التفاعل عبر REST مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يوضح المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
يعتبر استخدام مكتبة SDK الطريقة الأسرع للتطوير، لأنها تُجريد التفاصيل من المستوى المنخفض، مما يسمح لك بتحويل بيانات جدول البيانات إلى ملف PDF باستخدام كود محدود جداً. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام مكتبات SDK مختلفة: