استيراد البيانات إلى ملفات Excel وتصدير البيانات من ملفات Excel

تدعم واجهة برمجة تطبيقات Aspose.Cells Cloud استيراد البيانات من مصادر متنوعة، كما يمكنها تصدير كتب عمل Excel والرسوم البيانية والكائنات الأخرى إلى صيغ مختلفة، تشمل XLSX وCSV وPDF وHTML وPNG والمزيد. ويجعل هذا إدارة البيانات ومشاركتها بسيطة وفعّالة.

إصدار واجهة برمجة التطبيقات: v3.0 – آخر تحديث: 2024‑03‑15

دليل البدء السريع

تجهيز حمولة الطلب – بناء هيكل JSON يصف خيارات الاستيراد أو التصدير (مثل ImportCSVDataOption وExportOptions).
إرسال الطلب – استخدام curl أو Postman أو SDK لاستدعاء نقطة النهاية المناسبة (POST /cells/import أو POST /cells/export).
معالجة الاستجابة – عند النجاح، تُستلم الملف المعالج (ثنائي أو مشفر بـ Base64). وفي حالة حدوث خطأ، تُفحَص كود حالة HTTP والرسالة الخطأ المُعادة في هيكل JSON.

المتطلبات الأساسية

حساب نشط على Aspose Cloud ومفتاح JWT صالح.
يجب أن يكون كتاب العمل الهدف موجودًا في موقع التخزين المحدّد (لواجهات برمجة التطبيقات المعتمدة على التخزين).
رؤوس Content-Type الصحيحة (multipart/form-data لتحميل الملفات، application/json للأجسام JSON).

كيفية استيراد البيانات من مصادر بيانات متنوعة

يتضمّن استيراد البيانات إلى ملف Excel عدة اعتبارات يجب أخذها بعين الاعتبار أثناء العملية. إن إمكانية استيراد تنسيقات وأنواع بيانات متعددة بدقة احترافية تُعدّ من الميزات الرئيسية في Aspose.Cells Cloud.

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

توفّر واجهات برمجة التطبيقات التالية إمكانية استيراد البيانات إلى ملف Excel واحد أو أكثر:

واجهة برمجة التطبيقات	الوصف
POST /cells/import	استيراد البيانات إلى ملفات Excel دون استخدام التخزين.
POST /cells/{name}/importdata	استيراد البيانات إلى ملف Excel المخزّن في السحابة.

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

دون استخدام التخزين

اسم المعامل	النوع	الموقع	الوصف
file	ملف	formData	الملف المراد رفعه
ImportOption	ImportOptions	body	يحدّد تنسيق الاستيراد (IntArray، DoubleArray، StringArray، TwoDimensionIntArray، TwoDimensionDoubleArray، TwoDimensionStringArray، BatchData، csvData، Picture)

باستخدام التخزين

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف Excel
folder	string	query	مسار المجلد في التخزين
storageName	string	query	اسم التخزين
importData	ImportOptions	body	حمولة استيراد البيانات

معاملات خيار استيراد البيانات

تُوصَف المعاملات المهمّة في الجداول التالية:

ImportBatchDataOption

المعامل	النوع	الوصف
BatchData	List<CellValue>	بيانات الدفعة المراد استيرادها
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

ImportCSVDataOption

المعامل	النوع	الوصف
ConvertNumericData	boolean	ما إذا كان سيتم تحويل البيانات الرقمية (true/false)
FirstRow	int	فهرس الصف الأول
FirstColumn	int	فهرس العمود الأول
SeparatorString	string	فاصل الأعمدة
DestinationWorksheet	string	اسم ورقة العمل الوجهة
CustomParsers	List<CustomParserConfig>	إعدادات محللات مخصصة
ImportDataType	string	CSVData
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

ImportPictureOption

المعامل	النوع	الوصف
FirstRow	int	فهرس الصف الأول
FirstColumn	int	فهرس العمود الأول
IsVertical	boolean	ما إذا كانت الصورة موضّعة رأسيًا (true/false)
Data	string[]	بيانات الصورة (سلاسل مشفرة بـ Base64)
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	Picture
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

Import2DimensionIntArrayOption

المعامل	النوع	الوصف
FirstRow	int	فهرس الصف الأول
FirstColumn	int	فهرس العمود الأول
Data	int[,]	مصفوفة عددية صحيحة ثنائية الأبعاد
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

Import2DimensionDoubleArrayOption

المعامل	النوع	الوصف
FirstRow	int	فهرس الصف الأول
FirstColumn	int	فهرس العمود الأول
Data	double[,]	مصفوفة ذات أبعاد مزدوجة من نوع double
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

Import2DimensionStringArrayOption

المعامل	النوع	الوصف
FirstRow	int	فهرس الصف الأول
FirstColumn	int	فهرس العمود الأول
Data	string[,]	مصفوفة سلاسل نصية ثنائية الأبعاد
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

ImportIntegerArrayOption

المعامل	النوع	الوصف
FirstRow	int	فهرس الصف الأول
FirstColumn	int	فهرس العمود الأول
IsVertical	boolean	ما إذا كانت المصفوفة رأسية (true/false)
Data	int[]	مصفوفة عددية صحيحة أحادية البعد
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

ImportDoubleArrayOption

المعامل	النوع	الوصف
FirstRow	int	فهرس الصف الأول
FirstColumn	int	فهرس العمود الأول
IsVertical	boolean	ما إذا كانت المصفوفة رأسية (true/false)
Data	double[]	مصفوفة من نوع double أحادية البعد
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

ImportStringArrayOption

المعامل	النوع	الوصف
UpperLeftRow	int	فهرس الصف العلوي الأيسر
UpperLeftColumn	int	فهرس العمود العلوي الأيسر
LowerRightRow	int	فهرس الصف السفلي الأيمن
LowerRightColumn	int	فهرس العمود السفلي الأيمن
Filename	string	اسم الملف المصدر
Data	string	البيانات النصية المراد استيرادها
DestinationWorksheet	string	اسم ورقة العمل الوجهة
IsInsert	boolean	ما إذا كان سيتم إدراج البيانات (true/false)
ImportDataType	string	StringArray
Source	FileSource	مكان ملف البيانات عند وجود BatchData كـ null

CellValue

المعامل	النوع	الوصف
rowIndex	int	فهرس الصف للخلية
columnIndex	int	فهرس العمود للخلية
type	string	نوع بيانات قيمة الخلية
value	string	قيمة الخلية
style	Style (object)	تعريف نمط الخلية

FileSource

المعامل	النوع	الوصف
FileSourceType	string	InMemoryFiles أو CloudFileSystem أو RequestFiles
FilePath	string	مسار الملف المصدر

كيفية تصدير كائنات Excel إلى صيغ ملفات متنوعة

إذا أنشأتم ملف Excel في البداية بصيغة مثل XLS أو XLSX أو XLSB أو CSV، فقد ترغبون في تحويله إلى صيغة أخرى للاستفادة من ميزات محددة. على سبيل المثال، يحمي تصدير الملف بصيغة PDF المحتوى من التعديلات غير المصرح بها، مع جعله سهل القراءة والمشاركة.

يتضمّن تصدير كائنات Excel عدة اعتبارات. وتوفّر Aspose.Cells Cloud تصديرًا عالي الجودة لكتب العمل والرسوم البيانية والأشكال والصور إلى مجموعة واسعة من الصيغ:

صيغ التصدير فقط: PDF وOTS وXPS وDIF وPNG وJPEG وBMP وSVG وTIFF وEMF وNUMBERS وFODS.
صيغ تدعم الاستيراد والتصدير معًا: XLS وXLSX وXLSB وCSV وTSV وXLSM وODS وTXT.

يستخدم الطلب محتوى متعدد الأجزاء كما هو مُعرّف في [RFC 2046] و[RFC 1341]. يحتوي الجزء الأول على ملف البيانات؛ ويحتوي الجزء الثاني على خيارات الحفظ.

معلومات واجهة برمجة التطبيقات للتصدير

POST https://api.aspose.cloud/v3.0/cells/export

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

اسم المعامل	النوع	الموقع	الوصف
file	ملف	formData	الملف المراد رفعه
objectType	string	query	نوع الكائن (`workbook` أو `worksheet` أو `chart` أو `shape` أو `picture` أو `listobject` أو `oleobject`)
format	string	query	صيغة ملف الإخراج المطلوبة (انظر صيغ الملفات المدعومة)

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

يمكنك استخدام أداة سطر الأوامر cURL لاستدعاء واجهة برمجة التطبيقات. يوضّح المثال التالي طلبًا واستجابته بصيغة JSON.

Request

curl -v "https://api.aspose.cloud/v3.0/cells/export" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'file1=@example1.xlsx' \
  -F 'file2=@example2.xlsx'

Response

{
  "Files": [
    {
      "Filename": "example1.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "example2.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

كودات حالة HTTP الشائعة

الحالة	المعنى	الإجراء الموصى به
200	نجاح – تم تصدير الملف	معالجة الملف (الملفات) المُعادة
400	طلب غير صالح – معاملات مفقودة أو غير صالحة	التحقق من حمولة الطلب وسلاسل الاستعلام
401	غير مصرّح – مفتاح JWT غير صالح أو منتهي الصلاحية	تحديث المفتاح وإعادة المحاولة
404	غير موجود – كتاب العمل أو ورقة العمل المحدّدة غير موجودة	التحقق من اسم الملف ومسار التخزين
500	خطأ داخلي في الخادم – حالة غير متوقّعة على الخادم	الاتصال بدعم Aspose مع معرّف الطلب

كيفية استدعاء واجهات برمجة التطبيقات للاستيراد والتصدير

تشرح المقالات التالية كل واجهة برمجة تطبيقات بالتفصيل، وتحتوي على أمثلة باستخدام cURL وSDKs:

دمج وتقسيم ملفات Excel تحويل ملف إكسل إلى تنسيق آخر أو حفظه بصيغة مختلفة.