Aspose.Cells Cloud – تحويل نطاق Excel إلى HTML

تحويل نطاق محدد من ملف Excel محلي إلى ملف HTML مباشرةً عبر Aspose.Cells Cloud. تتم عملية التحويل بالكامل على خوادم السحابة، لذا لا تحتاج أبدًا إلى تحميل الملف الكامل أو تثبيت Excel محليًا.

واجهة برمجة تطبيقات تحويل النطاق إلى HTML

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

يحتوي جسم الطلب على multipart/form-data يحتوي ملف جدول البيانات. وتُزوَّد جميع الخيارات الأخرى كمعلّمات استعلام.

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

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

معلمات الطلب

الاسم	النوع	الموقع	الإجباري	الوصف
Spreadsheet	ملف	FormData	نعم	ملف Excel المراد تحويله.
worksheet	نص	استعلام	نعم	اسم ورقة العمل التي تحتوي على النطاق.
range	نص	استعلام	نعم	منطقة الخلايا المراد تحويلها، مثل `A1:C10`.
outPath	نص	استعلام	لا	مسار المجلد الذي يجب حفظ ملف HTML الناتج فيه (افتراضيًا `null`).
outStorageName	نص	استعلام	لا	اسم خدمة التخزين المستخدمة لحفظ ملف الإخراج.
fontsLocation	نص	استعلام	لا	مسار مجلد الخطوط المخصصة.
AutoRowsFit	منطقي	استعلام	لا	ضبط ارتفاع جميع الصفوف تلقائيًا في ورقة العمل.
AutoColumnsFit	منطقي	استعلام	لا	ضبط عرض جميع الأعمدة تلقائيًا في ورقة العمل.
region	نص	استعلام	لا	معرّف التوطين (مثل `en-US`, `fr-FR`). يؤثر على تنسيق الأرقام والتاريخ.
password	نص	استعلام	لا	كلمة المرور لفتح ملف Excel المحمي.
fontsLocation	نص	استعلام	لا	موقع الخطوط المخصصة.
region	نص	استعلام	لا	إعداد منطقة/لغة جدول البيانات.
password	نص	استعلام	لا	كلمة المرور لفتح ملف جدول البيانات.

الاستجابة

ترجع واجهة برمجة التطبيقات ملف HTML المحول كـ دفق ثنائي (application/octet-stream).

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

مثال على استجابة ناجحة (HTTP)

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.html"
Content-Length: 8423

<table>
  <tr><th>Product</th><th>Price</th></tr>
  <tr><td>Widget A</td><td>$10</td></tr>
  <tr><td>Widget B</td><td>$15</td></tr>
</table>

احفظ محتوى جسم الاستجابة في ملف (مثل report.html) لعرض الجدول المُرسَل في المتصفح.

أكواد حالة HTTP

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

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

مواصفات OpenAPI

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

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

Request

curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/html?worksheet=Sheet1&range=A1:C10&AutoRowsFit=true&AutoColumnsFit=true" \
     -H "Authorization: Bearer {access_token}" \
     -F "Spreadsheet=@Report.xlsx" \
     -F "outPath=output/report.html"

Response

HTTP/1.1 200 OK
Content-Type: application/octet-stream
Content-Disposition: attachment; filename="report.html"
Content-Length: 8423

<table>
  <tr><th>Product</th><th>Price</th></tr>
  <tr><td>Widget A</td><td>$10</td></tr>
  <tr><td>Widget B</td><td>$15</td></tr>
</table>

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

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

توضح أمثلة الكود التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام مكتبات SDK مختلفة. إذا تم حظر تحميل الأمثلة من Gist، يمكنك تنزيلها مباشرةً من المستودع.

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