تحويل ملفات إكسل إلى PDF وCSV وJSON والمزيد باستخدام Aspose.Cells Cloud

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

المتطلبات الأساسية
قبل استدعاء واجهات برمجة تطبيقات التحويل، احصل على رمز وصول OAuth 2.0 من Aspose Cloud، وتأكد من أن كتاب العمل مخزن في مساحة التخزين الخاصة بحسابك في Aspose Cloud (أو متضمن في جسم الطلب لنقطة النهاية PUT للتحويل).

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

يعمل الخدمة بسلاسة لأي نوع من تنسيقات المستندات. يمكنك استيراد وتصدير المستندات بالتنسيقات التالية:

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

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

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

API	الوصف
`GET /cells/{name}`	يُعيد استرجاع كتاب عمل إكسل من التخزين السحابي ويُحوّله إلى التنسيق المطلوب.
`PUT /cells/convert`	يُحوّل كتاب عمل إكسل مُزوَّد في جسم الطلب إلى التنسيق الناتج المحدّد.
`POST /cells/{name}/saveAs`	يحفظ كتاب عمل إكسل موجود بصيغة أخرى مباشرةً في التخزين السحابي.

تفاصيل واجهة البرمجة

GET /cells/{name}
- مُدخلات المسار (Path parameters): name – اسم ملف كتاب العمل (إلزامي).
- مُدخلات الاستعلام (Query parameters): format – التنسيق المستهدف (مثل: pdf، csv، json)؛ storage – اسم مساحة التخزين السحابية (اختياري)؛ folder – مسار المجلد داخل مساحة التخزين (اختياري).
- الاستجابة: تدفق ملف لكتاب العمل المحول؛ Content‑Type يطابق التنسيق المستهدف.
- رموز الحالة (Status codes): 200 OK، 400 Bad Request، 401 Unauthorized، 404 Not Found، 500 Internal Server Error.
PUT /cells/convert
- جسم الطلب (Request body): multipart/form‑data يحتوي على ملف كتاب العمل المصدر (file) وحقل format إلزامي يُحدد التنسيق المطلوب.
- الاستجابة: تدفق ثنائي للملف المحول.
- رموز الحالة (Status codes): 200 OK، 400 Bad Request، 401 Unauthorized، 500 Internal Server Error.
POST /cells/{name}/saveAs
- مُدخلات المسار (Path parameters): name – اسم كتاب العمل الحالي.
- مُدخلات الاستعلام (Query parameters): format – التنسيق المستهدف؛ outPath – مسار الوجهة في التخزين السحابي (اختياري)؛ storage – اسم مساحة التخزين (اختياري).
- الاستجابة: كائن JSON يحتوي على نتيجة العملية ومسار الملف المحفوظ. مثال على الاستجابة:
```
{
  "status": "OK",
  "code": 200,
  "message": "تم حفظ الملف بنجاح.",
  "path": "Converted/MyWorkbook.pdf"
}
```
- رموز الحالة (Status codes): 200 OK، 400 Bad Request، 401 Unauthorized، 404 Not Found، 500 Internal Server Error.

مثال على أمر cURL لتحويل إلى PDF

curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx?format=pdf" \
  -H "Authorization: Bearer {access_token}" \
  -o MyWorkbook.pdf

مقتطف SDK لـ Java (GET /cells/{name})

CellsApi apiInstance = new CellsApi();
String name = "MyWorkbook.xlsx";
String format = "pdf";
File result = apiInstance.cellsGetWorkbook(name, format, null, null);
result.renameTo(new File("MyWorkbook.pdf"));

مقتطف SDK لـ .NET (PUT /cells/convert)

var api = new CellsApi();
var file = File.ReadAllBytes("MyWorkbook.xlsx");
var format = "pdf";
var result = api.ConvertWorkbook(new MemoryStream(file), format);
File.WriteAllBytes("MyWorkbook.pdf", result);

مقتطف SDK لـ Python (POST /cells/{name}/saveAs)

import asposecellscloud
api = asposecellscloud.CellsApi()
api.post_save_as(name="MyWorkbook.xlsx", format="pdf", out_path="Converted/MyWorkbook.pdf")

تشرح المقالات التالية كل واجهة برمجة تطبيقات بالتفصيل، وتشمل أمثلة إضافية لأوامر cURL وSDKs:

دمج وتقسيم ملفات Excel معالجة دفعات من ملفات إكسل: التحويل، القفل، الحماية، التقسيم، وفك القفل