تصدير الأشكال – Aspose.Cells Cloud

يمكّن تصدير الأشكال من ملفات Excel من إعادة استخدام المحتوى التخطيطي عبر منصّات وتطبيقات مختلفة. المتطلبات المسبقة: رمز وصول JWT صالح وملف Excel المصدر المراد رفعه.

يمكنك تصدير الأشكال إلى التنسيقات التالية: PNG، GIF، JPEG، BMP، SVG، TIFF، EMF، WMF.

واجهة PostExport API

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

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

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

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

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

مثال على الطلب

curl -X PUT "https://api.aspose.cloud/v3.0/cells/export?objectType=shape&format=tiff" \
     -H "accept: multipart/form-data" \
     -H "Content-Type: multipart/form-data" \
     -H "Authorization: Bearer <your_access_token>" \
     -H "x-aspose-client: Containerize.Swagger" \
     -d '{"File":{}}'

الاستجابة

{
  "Files": [
    {
      "Filename": "Book1_xlsx_Sheet1_Shapes_0.tif",
      "FileSize": 390,
      "FileContent": "-----Base64String--------"
    }
    // ... كائنات ملفات إضافية ...
  ]
}

تتراوح أحجام حمولة الملفات المشفرة بـBase64 عادةً من بضعة مئات من البايتات إلى عدة ميغابايت، حسب أبعاد الصورة وتنسيقها.

رموز حالة HTTP

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

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

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

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

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

curl -X PUT "https://api.aspose.cloud/v3.0/cells/export?objectType=shape&format=tiff" \
     -H "accept: multipart/form-data" \
     -H "Content-Type: multipart/form-data" \
     -H "Authorization: Bearer <your_access_token>" \
     -H "x-aspose-client: Containerize.Swagger" \
     -d '{"File":{}}'

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

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

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

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