كيفية تحويل نطاق جدول بيانات محلي إلى ملف CSV: دليل خطوة بخطوة

تصدير نطاق معيّن من ملف إكسل محلي إلى CSV باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud.

واجهة برمجة تحويل النطاق إلى CSV

المتطلبات الأساسية
للاستدعاء هذا الطرفية، يجب أن تمتلك معرف عميل وسر عميل صالحين لحساب Aspose Cloud، واحصل على رمز وصول JWT، وتأكد من أن ملف جدول البيانات الأصلي بصيغة XLSX أو XLS.

واجهة برمجة الويب

PUT https://api.aspose.cloud/v4.0/cells/convert/range/csv

مثال باستخدام cURL

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv?worksheet=Sheet1&range=A1:C10" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@sample.xlsx"

الأمان والمصادقة

واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

متغيّرات الطلب:

اسم المتغيّر النوع المسار/سلسلة الاستعلام/جسم HTTP الوصف
Spreadsheet ملف FormData رفع ملف جدول البيانات.
worksheet نص استعلام اسم ورقة العمل في جدول البيانات.
range نص استعلام تحديد منطقة الخلايا (مثال: A1:C10).
outPath نص استعلام مسار المجلد الذي سيُخزّن فيه ملف العمل (اختياري). القيمة الافتراضية هي null.
outStorageName نص استعلام اسم مساحة التخزين الخارجة.
fontsLocation نص استعلام تحديد خطوط مخصّصة إن لزم الأمر.
region نص استعلام يحدّد إعدادات منطقة جدول البيانات.
password نص استعلام كلمة المرور المطلوبة لفتح ملف جدول البيانات.

الاستجابة

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

مثال لمحتوى CSV المُعاد (الصفوف الأولى فقط):

Name,Date,Amount
John Doe,2023-01-15,1250.00
Jane Smith,2023-01-16,980.50

رموز حالة HTTP

الرمز المعنى الوصف
200 ناجح (OK) تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 طلب غير صالح (Bad Request) مُعطَلات ناقصة أو غير صالحة (مثال: نوع ملف غير مدعوم).
401 غير مصرّح (Unauthorized) رمز JWT غير صالح أو ناقص.
413 حمل البيانات كبير جدًا (Payload Too Large) تجاوز حجم الملف المرفوع الحد المسموح.
500 خطأ داخلي في الخادم (Internal Server Error) خطأ غير متوقّع في الخادم.

أين يجب استخدام واجهة برمجة تطبيقات تحويل النطاق إلى CSV؟

1. سيناريوهات تصدير البيانات والترحيل

  • دمج قواعد البيانات: تصدير نطاقات محددة من إكسل مباشرة إلى أنظمة قواعد البيانات.
  • دمج التطبيقات: تغذية بيانات جدول البيانات المختارة إلى تطبيقات SaaS.
  • ترحيل الأنظمة: نقل نطاقات بيانات محددة بين الأنظمة القديمة والحديثة.
  • المشاركة عبر منصات مختلفة: مشاركة مجموعات بيانات مركّزة عبر منصات متعددة.

2. التقارير والتحليلات

  • التقارير الهدفية: تصدير أقسام تقرير محددة إلى CSV لتحليلها بدقة.
  • تغذية بيانات لوحات التحكم: تزويد أدوات لوحات التحكم بالبيانات المحددة.
  • مقاييس الأداء: استخراج نطاقات مؤشرات الأداء (KPI) لأنظمة متابعة الأداء.
  • التقارير المالية: تصدير أقسام البيانات المالية لمراجعتها خارجيًا.

3. التطوير والاختبار

  • إدارة بيانات الاختبار: تصدير نطاقات بيانات محددة لأغراض الاختبار.
  • بيئات التطوير: مشاركة نطاقات بيانات تجريبية مع فِرق التطوير.
  • اختبار واجهات برمجة التطبيقات: إنشاء بيانات اختبار CSV من أقسام جدول البيانات المحددة.
  • تطوير النماذج الأولية: توفير مجموعات بيانات مركّزة لتطبيقات النماذج الأولية.

4. العمليات التجارية

  • مشاركة بيانات انتقائية: مشاركة نطاقات بيانات محددة مع شركاء خارجيين.
  • نسخ احتياطي جزئي للبيانات: نسخ نطاقات بيانات حرجة احتياطيًا بصيغة CSV.
  • نقل البيانات بين الأقسام: مشاركة نطاقات بيانات محددة بين الأقسام المختلفة.
  • التقارير الامتثالية: تصدير نطاقات بيانات تنظيمية لأغراض الامتثال.

5. سير عمل الأتمتة

  • تصديرات النطاقات المجدولة: تصدير نطاقات محددة تلقائيًا وفق جدول زمني.
  • الاستخراج المُحفَّز: تصدير نطاقات استنادًا إلى أحداث أو محفزات تجارية.
  • دمج سير العمل: دمج تصديرات النطاقات في سير العمل لعمليات الأعمال.
  • معالجة النطاقات بالجملة: معالجة نطاقات محددة متعددة في عمليات جملية.

لماذا يجب استخدام واجهة برمجة تطبيقات تحويل النطاق إلى CSV؟

  • يمكنك تحويل نطاق من جدول البيانات دون رفع ملف العمل أولاً، مما يوفّر مساحة التخزين ويقلّل التكاليف.
  • يمكن إكمال التطوير بسرعة باستخدام SDKs الموجودة لـ Aspose.Cells Cloud.
  • دمج بسيط: واجهة برمجة تطبيقات REST مع توثيق واضح.
  • بنية قابلة للتوسّع: تتعامل مع عمليات صغيرة ومتوسطة وضخمة على حد سواء.

كيف تستخدم واجهة برمجة تطبيقات تحويل النطاق إلى CSV مع SDKs؟

مواصفات OpenAPI

تُحدّد مواصفات OpenAPI واجهة برمجة تطبيقات متاحة للعامة، ما يسمح بالتفاعل عبر REST مباشرة من متصفّح الويب.

استخدام SDKs لـ Aspose.Cells Cloud

استخدام SDK هو أسرع طريقة للتطوير، حيث يُجرّد التفاصيل منخفضة المستوى، ويسمح لك بتحويل نطاق من البيانات إلى ملف CSV باستخدام كود معدود.
استكشف القائمة الكاملة لـ SDKs الخاصة بـ Aspose.Cells Cloud في مستودع GitHub.

توضّح أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة. في حال حظر تحميل الأمثلة من Gist، يمكنك تنزيلها مباشرة من المستودع.

ConvertRangeToPdf