كيف تُصَدِّر ورقة عمل جدول بيانات عن بُعد إلى تنسيقات أخرى: دليل خطوة بخطوة
تصدير جدول بيانات سحابي (إكسل) إلى تنسيق ملف آخر.
واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق
واجهة برمجة التطبيقات الويبية
GET https://api.aspose.cloud/v4.0/cells/{name}?format={format}&folder={folder}&storageName={storageName}&outPath={outPath}&outStorageName={outStorageName}&fontsLocation={fontsLocation}®ion={region}&password={password}
الأمان والمصادقة
تُعدّ واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
معاملات الطلب:
| اسم المعامل | النوع | المسار/سلسلة الاستعلام/جسم HTTP | الوصف |
|---|---|---|---|
| name | String | المسار | (إلزامي) اسم ملف كتاب العمل الذي سيتم استرجاعه. |
| format | String | استعلام | (إلزامي) التنسيق المطلوب للملف الناتج (مثل: “Xlsx”، “PDF”، “CSV”). |
| folder | String | استعلام | (اختياري) مسار المجلد الذي يُخزَّن فيه كتاب العمل. القيمة الافتراضية هي null. |
| storageName | String | استعلام | (اختياري) اسم التخزين عند استخدام تخزين سحابي مخصّص. استخدم التخزين الافتراضي إن حُذف. |
| outPath | String | استعلام | (اختياري) مسار المجلد الذي سيتم حفظ كتاب العمل فيه. القيمة الافتراضية هي null. |
| outStorageName | String | استعلام | (اختياري) اسم تخزين الملف الناتج. |
| fontsLocation | String | استعلام | (اختياري) موقع الخطوط المخصّصة. |
| region | String | استعلام | (اختياري) إعدادات إقليم/لغة جدول البيانات (مثل: en-US، fr-FR). يؤثر على تنسيق الأرقام، وتحليل التواريخ، والسلوك الخاص باللغة المحلية. |
| password | String | استعلام | (اختياري) كلمة المرور لفتح ملف جدول البيانات. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
تحتوي الاستجابة على كائن واحد يمثّل تيار الملف المحول.
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح (OK) | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح (Bad Request) | معاملات مفقودة أو غير صالحة (مثل: نوع ملف غير مدعوم). |
| 401 | غير مُصادَق (Unauthorized) | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا (Payload Too Large) | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم (Internal Server Error) | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق آخر؟
- ترحيل الأنظمة القديمة: تحويل آلاف ملفات XLS القديمة إلى تنسيق XLSX لتناسب الأنظمة الحديثة.
- توحيد التنسيقات للأرشفة: جعل تنسيقات جداول البيانات المتنوعة (XLS، XLSM، ODS، CSV) موحدة إلى تنسيق واحد للأرشفة.
- التوافق مع حزم المكاتب: تحويل ملفات إكسل إلى تنسيقات متوافقة مع LibreOffice أو Google Sheets أو Apple Numbers.
- توحيد مصادر البيانات: تحويل تنسيقات جداول البيانات المتنوعة إلى CSV أو JSON لاستيعابها في قواعد البيانات.
- النشر على الويب: تحويل النماذج المالية إلى تنسيق HTML لعرضها على الويب.
لماذا يجب استخدام واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق آخر؟
- ملائمة للمطورين: تقدّم Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، ما يُسهّل التطوير بسرعة، ويأتي مع وثائق شاملة. وبالمقارنة مع بناء حلول مخصّصة لعرض الرسوم البيانية، تقلّل هذه الخدمة بشكل كبير من جهد التطوير.
- خفض تكاليف العمالة: تقلّل الحاجة إلى تخصيص وظائف لأغراض دمج الوثائق.
- الدفع حسب الاستخدام: لا توجد استثمارات مبدئية؛ تدفع مقابل استدعاءات API الفعلية فقط.
- لا يتطلب صيانة خوادم من جانبك: لا حاجة لصيانة الخوادم أو تحديث البرامج أو التعامل مع مشاكل التوافق.
- دعم شامل للتنسيقات: يدعم التحويل بين أكثر من 20 تنسيق لجداول البيانات.
- الحفاظ على دقة البيانات والتنسيق الأصلي: تحفظ التخطيط والمعادلات والأنماط الأصلية أثناء التحويل.
كيف تستخدم واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق مع مكتبات SDK؟
مواصفات واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق
مواصفات واجهة برمجة تطبيقات تصدير جدول البيانات كتنسيق توفر واجهة برمجة مفتوحة للوصول واجهات REST بسلاسة.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells الويبية. يوضح المثال التالي كيفية إجراء استدعاءات لواجهة Cloud API باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام مكتبة SDK هو أسرع طريقة للتطوير، لأنها تُجرّدك من التفاصيل منخفضة المستوى، ما يسمح لك بتصدير جدول بيانات إلى ملف بصيغة معينة عبر كود موجز.
قبل إجراء استدعاء لواجهة برمجة التطبيقات، احصل على رمز وصول OAuth 2.0 وأدرجْه في رأس Authorization: Bearer <token>.
يرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة لمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
توضّح أمثلة الكود التالية كيفية التفاعل مع خدمات الويب الخاصة بـ Aspose.Cells عبر مكتبات SDK مختلفة: