كيفية تصدير ورقة عمل جدول بيانات عن بُعد إلى تنسيق آخر: دليل خطوة بخطوة
تصدير ورقة عمل من جدول بيانات/Excel مخزّن في السحابة إلى ملف بتنسيق آخر باستخدام واجهة Aspose.Cells Cloud Web API.
واجهة تصدير ورقة العمل كتنسيق
واجهة برمجة التطبيقات عبر الويب
GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
-H "Authorization: Bearer {access_token}"
معلمات الطلب
| اسم المعلمة | النوع | المسار / سلسلة الاستعلام / جسم الطلب HTTP | الوصف |
|---|---|---|---|
| name | String | Path | (مطلوبة) اسم ملف المصنف المراد استرجاعه. |
| worksheet | String | Path | (مطلوبة) ورقة العمل المحددة المراد تحويلها. |
| format | String | Query | (مطلوبة) التنسيق المطلوب للملف الناتج (مثل png أو pdf أو svg). |
| folder | String | Query | (اختياري) مسار المجلد الذي يخزّن فيه المصنف. القيمة الافتراضية هي null. |
| storageName | String | Query | (اختياري) اسم مساحة التخزين السحابية المخصصة. استخدام مساحة التخزين الافتراضية عند حذفها. |
| outPath | String | Query | (اختياري) مسار مجلد الإخراج. القيمة الافتراضية هي null. |
| outStorageName | String | Query | (اختياري) اسم مساحة تخزين الملف الناتج. |
| fontsLocation | String | Query | (اختياري) تحديد الخطوط المخصصة عند الحاجة. |
| region | String | Query | (اختياري) إعداد منطقة/لغة جدول البيانات (مثل en-US أو fr-FR). يؤثر على تنسيق الأرقام وتحليل التواريخ والسلوك المتعلق باللغة المحلية. |
| password | String | Query | (اختياري) كلمة المرور للوصول إلى ملف جدول البيانات. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
كودات حالة HTTP
| الكود | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | معلمات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مصدق | رمز JWT غير صحيح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة تصدير ورقة العمل إلى تنسيق آخر؟
- ترحيل الأنظمة القديمة – تحويل آلاف ملفات XLS القديمة إلى تنسيق XLSX لأنظمة حديثة.
- توحيد التنسيقات للأرشفة – جعل تنسيقات جداول البيانات المختلفة (XLS وXLSM وODS وCSV) موحدة لغرض الأرشفة.
- التوافق مع حزم المكتب – تحويل ملفات Excel إلى تنسيقات متوافقة مع LibreOffice أو Google Sheets أو Apple Numbers.
- توحيد مصادر البيانات – تحويل تنسيقات جداول البيانات المختلفة إلى CSV أو JSON لاستيرادها في قواعد البيانات.
- النشر على الويب – تحويل النماذج المالية إلى HTML لعرضها على الويب.
لماذا تستخدم واجهة تصدير ورقة العمل إلى تنسيق آخر؟
- دعم متعدد اللغات لواجهات برمجة التطبيقات (SDKs) – توفر مكتبات عميل للغات برمجة متعددة، مما يسمح للمطورين باستدعاء الواجهة مباشرةً من بيئتهم المفضلة.
- تحويل مباشر دون رفع مبدئي – تتيح تحويل ورقة عمل مخزّنة في مساحة تخزين سحابية إلى التنسيق المطلوب دون الحاجة لتنزيل الملف وإعادة رفعه.
- استخراج البيانات فقط – تُعيد محتوى ورقة العمل بالتنسيق المختار دون الحفاظ على التنسيقات البصرية.
كيفية استخدام واجهة تصدير ورقة جدول البيانات كتنسيق باستخدام واجهات برمجة التطبيقات (SDKs)؟
مواصفات واجهة تصدير ورقة العمل كتنسيق
توفر مواصفات واجهة تصدير ورقة العمل كتنسيق واجهة برمجة مفتوحة للوصول إلى التفاعلات REST مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء المكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام واجهات برمجة تطبيقات Aspose.Cells Cloud (SDKs)
استخدام واجهات برمجة التطبيقات (SDKs) هو أسرع طريقة للتطوير، لأنها تُجرّدك من التفاصيل منخفضة المستوى، مما يسمح لك بتصدير ورقة عمل جدول بيانات إلى ملف بتنسيق مطلوب بكود موجز.
يرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بواجهات Aspose.Cells Cloud SDK.
توضح أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب Aspose.Cells باستخدام SDKs المختلفة: