كيفية تصدير نطاق جدول بيانات موجود في السحابة إلى تنسيقات أخرى: دليل خطوة بخطوة
Contents
[
Hide
]
تصدير نطاق جدول بيانات (أو Excel) الموجود في السحابة إلى ملف بتنسيق معيّن. يمكن حفظ ملف التنسيق في السحابة أو تصديره إلى التخزين المحلي.
واجهة برمجة تطبيقات تصدير النطاق كتنسيق
واجهة برمجة التطبيقات عبر الويب (Web API)
GET https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/ranges/{range}
الأمن والمصادقة
واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مُعاملات الطلب (Request Parameters)
| اسم المُعامل | النوع | الموقع | الوصف |
|---|---|---|---|
| name | سلسلة نصية (String) | المسار (Path) | (إجباري) اسم ملف المصنف (workbook) المطلوب استرجاعه. |
| worksheet | سلسلة نصية (String) | المسار (Path) | اسم ورقة العمل في جدول البيانات. |
| range | سلسلة نصية (String) | المسار (Path) | النطاق المراد تحويله (مثال: A1:C12). |
| format | سلسلة نصية (String) | استعلام (Query) | (إجباري) تنسيق الإخراج المطلوب (مثال: pdf، png، svg). |
| folder | سلسلة نصية (String) | استعلام (Query) | (اختياري) مسار المجلد الذي يحتوي على المصنف. |
| storageName | سلسلة نصية (String) | استعلام (Query) | (اختياري) اسم التخزين في حال استخدام تخزين سحابي مخصص. |
| outPath | سلسلة نصية (String) | استعلام (Query) | (اختياري) مسار ملف الإخراج في التخزين السحابي. |
| outStorageName | سلسلة نصية (String) | استعلام (Query) | (اختياري) اسم التخزين المُستخدم لملف الإخراج. |
| fontsLocation | سلسلة نصية (String) | استعلام (Query) | (اختياري) موقع خطوط مخصصة. |
| region | سلسلة نصية (String) | استعلام (Query) | (اختياري) إعداد المنطقة/اللغة لجدول البيانات (مثال: en-US، fr-FR). يؤثّر على تنسيق الأرقام، وتحليل التواريخ، والسلوك المرتبط بالمنطقة. |
| password | سلسلة نصية (String) | استعلام (Query) | (اختياري) كلمة المرور المطلوبة لفتح ملف جدول البيانات. |
الاستجابة (Response)
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
رموز حالة HTTP
| الرمز | المعنى | الوصف |
|---|---|---|
| 200 | OK (تم بنجاح) | تم تطبيق التصفية بنجاح؛ تحتوي الاستجابة على تفاصيل العملية. |
| 400 | Bad Request (طلب خاطئ) | مُعاملات مفقودة أو غير صالحة (مثال: نوع ملف غير مدعوم). |
| 401 | Unauthorized (غير مُصادَق) | رمز JWT غير صالح أو مفقود. |
| 413 | Payload Too Large (حمولة كبيرة جدًا) | تجاوز حجم الملف المرفوع الحد المسموح به. |
| 500 | Internal Server Error (خطأ داخلي في الخادم) | خطأ غير متوقع في الخادم. |
أين يجب استخدام واجهة برمجة تطبيقات تصدير النطاق إلى تنسيق آخر؟
سيناريوهات تصدير البيانات والنقل (Data Export & Migration)
- دمج مع قواعد البيانات (Database Integration) – تصدير نطاقات Excel محددة مباشرةً إلى أنظمة قواعد البيانات.
- دمج مع التطبيقات (Application Integration) – إمداد تطبيقات SaaS ببيانات جدول البيانات المحددة.
- الترحيل بين الأنظمة (System Migration) – نقل نطاقات بيانات محددة بين الأنظمة القديمة والحديثة.
- المشاركة عبر منصات مختلفة (Cross‑Platform Sharing) – مشاركة مجموعات فرعية من البيانات المحددة عبر منصات متنوعة.
التقارير والتحليلات (Reporting & Analytics)
- التقارير المُوجّهة (Targeted Reporting) – تصدير أقسام تقارير محددة إلى تنسيقات أخرى لتحليل مركّز.
- تغذية بيانات لوحة التحكم (Dashboard Data Feeds) – تزويد أدوات لوحات تحكم BI بنطاقات بيانات محددة.
- مقاييس الأداء (Performance Metrics) – استخراج نطاقات KPI لأنظمة مراقبة الأداء.
- التقارير المالية (Financial Reporting) – تصدير أقسام البيانات المالية لغرض التدقيق الخارجي.
التطوير والاختبار (Development & Testing)
- إدارة بيانات الاختبار (Test Data Management) – تصدير نطاقات بيانات محددة لأغراض الاختبار.
- بيئات التطوير (Development Environments) – مشاركة نطاقات بيانات مثال مع فرق التطوير.
- اختبار واجهة برمجة التطبيقات (API Testing) – إنشاء بيانات اختبار بصيغة CSV من أقسام محددة من جدول البيانات.
- تطوير النماذج الأولية (Prototype Development) – توفير مجموعات بيانات مركّزة لنماذج التطبيقات الأولية.
العمليات التجارية (Business Operations)
- مشاركة بيانات انتقائية (Selective Data Sharing) – مشاركة نطاقات بيانات محددة مع شركاء خارجيين.
- نسخ احتياطي جزئي للبيانات (Partial Data Backup) – النسخ الاحتياطي ل نطاقات بيانات حرجة بصيغة محددة.
- نقل البيانات بين الإدارات (Departmental Data Transfer) – مشاركة نطاقات بيانات محددة بين الإدارات المختلفة.
- التقارير الامتثالية (Compliance Reporting) – تصدير نطاقات بيانات تنظيمية لأغراض تقديم تقارير الامتثال.
سير العمل الآلي (Automation Workflows)
- تصدير النطاقات المجدولة (Scheduled Range Exports) – تصدير نطاقات محددة تلقائيًا وفق جدول زمني.
- الاستخراج المُحفَّز بالحدث (Trigger‑Based Extraction) – تصدير النطاقات استنادًا إلى أحداث أو مُحفّزات تجارية.
- دمج تصدير النطاقات في سير العمل (Workflow Integration) – دمج عمليات تصدير النطاقات في سير العمل للعمليات التجارية.
- المعالجة الدُفعية للنطاقات (Batch Range Processing) – معالجة نطاقات محددة متعددة في عمليات دفعية.
لماذا يجب استخدام واجهة برمجة تطبيقات تصدير النطاق إلى تنسيق آخر؟
- سهلة الاستخدام للمطورين (Developer‑Friendly) – توفر Aspose.Cells Cloud مكتبات SDK بلغات برمجة متعددة، مما يتيح تطويرًا سريعًا مع توفر وثائق شاملة. ومقارنةً ببناء حلول مخصصة لعرض الرسوم البيانية، فإنها تقلّل بشكل كبير من جهد التطوير المطلوب.
- خفض تكاليف العمالة (Reduced Labor Costs) – الحاجة الأقل إلى الموظفين المخصصين لدمج الوثائق.
- دفع مقابل الاستخدام فقط (Pay‑per‑Use) – لا استثمار مبدئي؛ تدفع فقط مقابل طلبات واجهة برمجة التطبيقات التي تستخدمها فعلًا.
- لا صيانة للخوادم (No Server Maintenance) – لا خوادم مطلوب صيانتها، ولا تحديثات برمجيات، ولا مشاكل توافق.
- الحفاظ على تنسيقات Excel المعقدة (Preserves Complex Excel Formatting) – تحافظ ملفات الإخراج على التنسيق الأصلي لجدول البيانات.
كيفية استخدام واجهة برمجة تطبيقات تصدير نطاق جدول البيانات كتنسيق باستخدام مكتبات SDK؟
مواصفات واجهة برمجة تطبيقات تصدير النطاق كتنسيق
توفر مواصفات واجهة برمجة تطبيقات تصدير النطاق كتنسيق واجهة برمجة تطبيقات قابلة للوصول علنًا، مما يتيح التفاعل عبر REST مباشرةً من متصفح ويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب الخاصة بـ Aspose.Cells بسهولة. يوضح المثال التالي كيفية إرسال طلبات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud
استخدام SDK هو أسرع طريقة للتطوير، نظرًا لأنها تُجرّدك من التفاصيل من المستوى المنخفض، مما يتيح لك تصدير نطاق جدول البيانات إلى ملف بصيغة محددة عبر كود موجز. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات SDK الخاصة بـ Aspose.Cells Cloud.
توضح أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات SDK مختلفة: