كيفية تحويل ورقة عمل في ملف جدول بيانات إلى CSV باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud
يحوّل endpoint_ConvertWorksheetToCsv ورقة عمل واحدة من ملف جدول بيانات محلي إلى مستند CSV بالكامل على خوادم Aspose.Cells Cloud. وبفضل رفع الملف المصدر وتحديد ورقة العمل المستهدفة، يحصل المطوّرون على تدفق ثنائي لملف CSV دون الحاجة إلى حفظ الملف في تخزين سحابي. وتُعدّ هذه الواجهة المثالية لأتمتة استخراج البيانات، ودمج بيانات جداول البيانات في الأنظمة اللاحقة، وتقليل التكاليف المرتبطة بالتخزين.
واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV
واجهة برمجة التطبيقات عبر الويب
PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/csv
الأمان والمصادقة
تتوفّر واجهات برمجة تطبيقات Aspose.Cells Cloud بأمان، وتتطلّب مصادقة تعتمد على رمز JWT.
-H "Authorization: Bearer {access_token}"
مُعاملات الطلب
| اسم المُعامل | النوع | الموقع | إلزامي/اختياري | الوصف |
|---|---|---|---|---|
| Spreadsheet | ملف | FormData | إلزامي | ملف ثنائي لجدول البيانات المصدر (مثل .xlsx، .xls). مثال: myWorkbook.xlsx. |
| worksheet | سلسلة نصية | Query | إلزامي | اسم ورقة العمل المراد تحويلها (حالة حساسة). إذا تُرك فارغًا، تُستخدم الورقة الأولى. مثال: Sheet1. |
| outPath | سلسلة نصية | Query | اختياري | مسار المجلد المستهدف في التخزين السحابي حيث يُحفظ ملف CSV الناتج. إذا تُرك فارغًا، يُعاد ملف CSV مباشرة في تدفق الاستجابة. |
| outStorageName | سلسلة نصية | Query | اختياري | اسم خدمة التخزين (مثل Azure، AWS S3) حيث يجب وضع ملف الإخراج. مطلوب فقط عند استخدام outPath. |
| fontsLocation | سلسلة نصية | Query | اختياري | مسار مجلد الخطوط المخصصة على الخادم، مما يتيح لمحرك التحويل استخدام خطوط غير قياسية. |
| region | سلسلة نصية | Query | اختياري | معرّف محلي يؤثّر في تنسيق الأرقام/التاريخ في ملف CSV (مثل en-US، fr-FR). |
| password | سلسلة نصية | Query | اختياري | كلمة المرور لفتح جدول بيانات محمي. يجب أن تتطابق مع كلمة مرور التشفير للملف المصدر. |
الاستجابة
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | ناجح | تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | طلب غير صالح | مُعطَلات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم). |
| 401 | غير مُصادَق عليه | رمز JWT غير صالح أو مفقود. |
| 413 | حجم الحمولة كبير جدًا | تجاوز حجم الملف المرفوع الحد المسموح. |
| 500 | خطأ داخلي في الخادم | خطأ غير متوقع في الخادم. |
متى تستخدم واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV؟
- استخراج البيانات لخطوط أنابيب تحليل الأعمال (BI) – استخراج ورقة عمل محددة من تقرير Excel وإرسال ملف CSV الناتج مباشرة إلى Power BI أو Tableau دون الحاجة إلى معالجة الملفات الوسيطة.
- معالجة الفواتير بشكل آلي – تحويل ورقة العمل التي تحتوي على صفوف الفواتير إلى CSV لاستيرادها سريعًا في أنظمة المحاسبة.
- دمج مع أنظمة قديمة – تصدير بيانات ورقة العمل إلى CSV للاستهلاك من قبل تطبيقات أقدم لا تقبل سوى ملفات النصوص المفصولة بفاصل.
- توليد التقارير لحظيًا – إنشاء لقطات CSV لبيانات جدول البيانات الحية في خدمة ويب، وإعادة الملف فورًا إلى متصفح العميل.
لماذا تستخدم واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV؟
- لا يتطلب تخزينًا سحابيًا دائمًا – يُمرّر الملف مباشرةً إلى محرك التحويل ويُحذف بعد التحويل، مما يوفّر النطاق الترددي وتكاليف التخزين.
- تنفيذ عالي الأداء في السحابة – يعمل التحويل على خوادم Aspose المُحسَّنة، وغالبًا ما يكتمل خلال ثانيتين فقط للملفات التي تصل إلى 100 ميغابايت.
- تحكم دقيق – اختيار ورقة عمل واحدة، وتطبيق خطوط مخصصة، وتنسيق إقليمي، وحماية بكلمة مرور في طلب واحد.
- إخراج متسق عبر منصات مختلفة – يضمن إخراج CSV متطابق عبر SDKs مختلفة مثل .NET وJava وPython وغيرها باستخدام نفس endpoint_واجهة REST.
كيف تستخدم واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV باستخدام حزم تطوير البرمجيات (SDKs)؟
مواصفات واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV
مواصفات واجهة برمجة تطبيقات تحويل ورقة عمل إلى CSV توفر واجهة برمجة برمجية متاحة علنًا لتنفيذ تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية إجراء مكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام حزم تطوير البرمجيات (SDKs) الخاصة بـ Aspose.Cells Cloud
يسهّل استخدام SDK تبسيط التطوير من خلال إخفاء التفاصيل من المستوى المنخفض، مما يتيح لك دمج جدول بيانات في جدول بيانات آخر باستخدام كود موجز. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية التفاعل مع خدمات Aspose.Cells عبر الويب باستخدام مكتبات SDK مختلفة: