تصدير ورقة عمل إكسل إلى تنسيقات متنوعة – Aspose.Cells Cloud

يمكنك تصدير ورقة العمل إلى التنسيقات التالية:

استكشف عمليات التصدير ذات الصلة مثل تصدير ملف العمل كاملاً أو مخطط بياني.

واجهة PostExport API

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

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

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

معلمات الطلب

اسم المعلمة النوع المسار/سلسلة الاستعلام/محتوى جسم HTTP مطلوب الوصف
file ملف formData نعم الملف المراد تحميله
objectType سلسلة نصية استعلام نعم نوع الكائن المراد تصديره. لتصدير المخططات استخدم chart. قيم أخرى محتملة: worksheet (ورقة عمل)، picture (صورة)، إلخ.
format سلسلة نصية استعلام نعم التنسيق المطلوب للإخراج. القيم المدعومة: png، jpeg، gif، bmp، svg، tiff، emf، wmf، pdf.

الاستجابة

{
  "Files": [
    {
      "Filename": "Book1_xlsx_Sheet1.tif",
      "FileSize": 390,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet2.tif",
      "FileSize": 10040,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet3.tif",
      "FileSize": 2824,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet4.tif",
      "FileSize": 1350,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet5.tif",
      "FileSize": 12978,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet6.tif",
      "FileSize": 7002,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "Book1_xlsx_Sheet7.tif",
      "FileSize": 11532,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet1.tif",
      "FileSize": 382,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet2.tif",
      "FileSize": 382,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet3.tif",
      "FileSize": 130084,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "myDocument_xlsx_Sheet4.tif",
      "FileSize": 120062,
      "FileContent": "-----Base64String--------"
    }
  ]
}

معالجة الأخطاء

إذا فشل الطلب، تُعيد واجهة API كائن JSON يحتوي على حقول مثل Code و Message. تشمل رموز حالة HTTP الشائعة 401 Unauthorized (رمز مفقود أو غير صالح) و 400 Bad Request (معلمات غير صالحة).

رموز حالة HTTP

الرمز المعنى الوصف
200 نجاح تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400 طلب غير صالح معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401 غير مصدق رمز JWT غير صالح أو مفقود.
413 حجم الحمولة كبير جدًا تجاوز حجم الملف المرفوع الحد المسموح به.
500 خطأ داخلي في الخادم خطأ غير متوقع في الخادم.

ملاحظات

  • الحد الأقصى لحجم الملف المسموح برفعه هو 50 ميغابايت.
  • تدعم واجهة API تصدير عدة أوراق عمل في طلب واحد؛ تُعاد كل ورقة عمل كملف منفصل داخل المصفوفة Files.
  • تتوفر المعالجة غير المتزامنة لملفات العمل الكبيرة؛ استخدم رمز الحالة 202 Accepted لمراقبة حالة العملية عبر الاستبيان (polling).

كيفية استخدام واجهة PostExport API مع مكتبات SDK

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

قبل استدعاء واجهة API، احصل على رمز وصول JWT صالح باستخدام عملية مصادقة Aspose.Cells Cloud. تأكد من تضمين الرمز في رأس الطلب Authorization لكل طلب. تتعامل مكتبات SDK مع الحصول على الرمز تلقائيًا عند تكوينها ببيانات اعتماد العميل الخاصة بك.

مواصفات واجهة PostExport API

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

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

# تصدير ورقة عمل إلى تنسيق TIFF
curl -X POST "https://api.aspose.cloud/v3.0/cells/export?objectType=worksheet&format=tiff" \
     -H "Authorization: Bearer <access_token>" \
     -H "accept: multipart/form-data" \
     -H "Content-Type: multipart/form-data" \
     -H "x-aspose-client: Containerize.Swagger" \
     -F "File=@MyWorkbook.xlsx"

استخدام مكتبات SDK الخاصة بـ Aspose.Cells Cloud

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

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر مكتبات SDK متنوعة:

استيراد صورة إلى ورقة عمل Excel استيراد مصفوفة أعداد صحيحة إلى ورقة عمل إكسل