تحويل كائن القائمة إلى نطاق باستخدام واجهة Aspose.Cells Cloud API
تقوم هذه الواجهة REST بتحويل كائن القائمة (جدول) إلى نطاق داخل ورقة عمل Excel.
المتطلبات المسبقة:
قبل استدعاء نقطة النهاية (endpoint)، تأكد من أن ملف المصنف مُحمّل في مساحة التخزين الخاصة بـ Aspose Cloud، وتحتوي ورقة العمل على كائن القائمة المستهدف، وأنك تستخدم تنسيق ملف مدعوم (مثل .xlsx أو .xlsm).
واجهة REST API
المصادقة
لاستدعاء هذه العملية، يجب أن تتضمن رأس Authorization رمزًا صحيحًا من نوع JWT. احصل على الرمز بإرسال طلب POST إلى نقطة نهاية رموز OAuth 2.0 باستخدام مُعرّف العميل (client ID) والسر السري لمُعرّف العميل (client secret). يجب أن يشمل الرمز النطاق Cells.ReadWrite، ويظل صالحًا لمدة الوقت المُعيّن من خدمة الرموز.
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/ConvertToRange
الأمان والمصادقة
واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.
مَعلمات الطلب
| الاسم | النوع | الموقع | مطلوب | القيمة الافتراضية | الوصف |
|---|---|---|---|---|---|
| name | سلسلة نصية | مسار | نعم | – | اسم ملف Excel. |
| sheetName | سلسلة نصية | مسار | نعم | – | اسم ورقة العمل التي تحتوي على كائن القائمة. |
| listObjectIndex | عدد صحيح | مسار | نعم | – | المؤشر المُعد من الصفر لكائن القائمة (الجدول) المراد تحويله. |
| folder | سلسلة نصية | استعلام | لا | – | مسار المجلد الذي يُخزَّن فيه الملف. |
| storageName | سلسلة نصية | استعلام | لا | – | اسم خدمة التخزين. |
ملاحظة: تعمل هذه العملية فقط مع تنسيقات Excel الحديثة مثل .xlsx و .xlsm. لا يجب أن يكون كائن القائمة محميًا. لمزيد من المعلومات حول كائنات القوائم، راجع نظرة عامة على كائنات القوائم. وللحصول على تفاصيل حول العمل مع النطاقات، راجع وثيقة النطاقات.
مثال على cURL (الطلب)
عائلة SDK للسحابة
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى SDK التعامل مع التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب الخاصة بـ Aspose.Cells باستخدام SDKs مختلفة: