كيفية تحويل جدول بيانات إلى تنسيق آخر: دليل خطوة بخطوة

قم بتحويل ملف جدول بيانات/Excel محلي إلى تنسيق آخر باستخدام واجهة برمجة تطبيقات Aspose.Cells Cloud الويبية.

واجهة برمجة تطبيقات تحويل جدول البيانات

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

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

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

معلمات الطلب:

اسم المعلمة النوع المسار/سلسلة الاستعلام/جسم HTTP الوصف
Spreadsheet ملف FormData رفع ملف جدول البيانات المراد تحويله.
format نص استعلام (إلزامي) التنسيق الناتج المطلوب (مثل: “XLSX”، “PDF”، “CSV”).
outPath نص استعلام (اختياري) مسار المجلد الذي سيتم حفظ المصنف المحول فيه. القيمة الافتراضية هي null.
outStorageName نص استعلام تحديد اسم تخزين للملف الناتج.
fontsLocation نص استعلام استخدام خطوط مخصصة لجدول البيانات.
region نص استعلام تحديد إعداد منطقة جدول البيانات.
password نص استعلام كلمة المرور لفتح ملف جدول البيانات إذا كان مشفرًا.

الاستجابة

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

حالة النجاح

  • 200 OK – تمّ التحويل بنجاح، وتحتوي حِمْل الاستجابة على تيار الملف المحول.
  • يُظهر الرأس Content-Type نوع MIME لتنسيق الإخراج المطلوب (مثل: application/pdf لتنسيق PDF).

رموز حالة HTTP

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

التنسيقات المدعومة

تنسيق الإخراج الوصف
XLS مصنف Excel 95/5.0 - 2003.
XLSX تنسيق ملف Excel SpreadsheetML المفتوح.
XLSB مصنف Excel الثنائي.
XLSM مصنف Excel المُمكّن للماكرو.
XLT قالب Excel من 97 إلى 2003.
XLTX قالب Excel.
XLTM قالب Excel المُمكّن للماكرو.
XLAM ملف إضافة Excel المُمكّن للماكرو، ويُستخدم لإضافة وظائف جديدة إلى Excel.
CSV ملف CSV (قيم مفصولة بفواصل).
TSV ملف TSV (قيم مفصولة بمسافات.tab).
TXT ملف نصي عادي مفصول.
HTML تنسيق HTML.
MHTML ملف MHTML.
ODS ملف جدول بيانات OpenDocument (ODS).
SpreadsheetML ملف Excel 2003 XML.
Numbers الملف تم إنشاؤه باستخدام تطبيق Apple “Numbers”، وهو جزء من حزمة iWork لأنظمة macOS وiOS.
JSON تدوين كائن جافا سكريبت (JavaScript Object Notation).
DIF تنسيق تبادل البيانات (Data Interchange Format).
DBF ملف الامتداد .dbf هو ملف قاعدة بيانات يُستخدم من قبل نظام إدارة قواعد بيانات dBASE.
PDF تنسيق مستند Adobe Portable (Adobe Portable Document Format).
XPS تنسيق مواصفات ورقة XML (XML Paper Specification).
SVG تنسيق الرسومات المتجهة القابلة للتوسع (Scalable Vector Graphics).
TIFF تنسيق ملف الصور المُوسّم (Tagged Image File Format).
PNG تنسيق الرسومات الشبكية المحمولة (Portable Network Graphics).
BMP تنسيق صورة نقطية (Bitmap).
EMF تنسيق Metafile المُحسّن (Enhanced Metafile).
JPEG JPEG هو نوع من صور الملفات المحفوظة باستخدام ضغط فاقد للبيانات.
GIF تنسيق تبادل الرسومات (Graphics Interchange Format).
MARKDOWN يمثل مستند Markdown.
SXC تنسيق قائم على XML يُستخدم في OpenOffice وStarOffice.
FODS هذا تنسيق Open Document محفوظ بصيغة XML مسطحة.
DOCX تنسيق معروف لمستندات Microsoft Word، يجمع بين ملفات XML والثنائية.
PPTX يعتمد تنسيق PPTX على تنسيق ملف العرض التقديمي المفتوح لـ PowerPoint من Microsoft.
SqlScript لغة الاستعلام المهيكلة (Structured Query Language).
XHtml XHTML هو تنسيق ملف نصي يعتمد على علامات XML، ويستخدم إعادة صياغة لـ HTML 4.0.
Epub الملفات ذات الامتداد .epub هي تنسيق للكتب الإلكترونية يوفّر معيارًا للنشر الرقمي للمؤلفين والمستخدمين.
Xml XML تعني لغة الترميز القابلة للتوسع (Extensible Markup Language)، وهي مشابهة لـ HTML لكنها تستخدم العلامات لتعريف الكائنات.
Ots ملف قالب جدول بيانات Open Document (OTS).
AZW3 AZW هو تنسيق ملف كتب إلكترونية طوّرته أمازون لأجهزة Kindle. AZW3، ويُعرف أيضًا باسم Kindle Format 8 (KF8).

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

  • ترحيل الأنظمة القديمة: تحويل آلاف ملفات XLS القديمة إلى XLSX للاستخدام في الأنظمة الحديثة.
  • توحيد تنسيقات الأرشفة: جعل تنسيقات جداول البيانات المختلفة (XLS، XLSM، ODS، CSV) موحّدة في تنسيق واحد للأرشفة.
  • التوافق مع حزم المكاتب: تحويل ملفات Excel إلى تنسيقات متوافقة مع LibreOffice أو Google Sheets أو Apple Numbers.
  • توحيد مصادر البيانات: تحويل جداول بيانات متنوعة إلى CSV أو JSON لاستهلاكها في قواعد البيانات.
  • النشر على الويب: تحويل النماذج المالية إلى HTML لعرضها على الويب.

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

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

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

تُظهر الأمثلة التالية كيفية استخدام واجهة برمجة تطبيقات تحويل جدول البيانات باستخدام مكتبات SDK مختلفة.

مواصفات واجهة برمجة تطبيقات تحويل جدول البيانات

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.

استخدام مكتبات Aspose.Cells Cloud SDK

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

تحويل نطاق إكسل إلى CSV – واجهة برمجة تطبيقات Aspose.Cells Cloud تحويل الجدول إلى PDF