فرز بيانات كائن القائمة في ورقة عمل Excel – واجهة برمجة تطبيقات Aspose.Cells Cloud
المتطلبات المسبقة
لاستدعاء هذه الواجهة، يجب أن تمتلك رمز وصول JWT ساري المفعول من Aspose Cloud، كما يجب رفع ملف المصنف إلى مساحة التخزين الخاصة بـ Aspose Cloud. تأكد من تضمين الرأس Authorization: Bearer <jwt token> في كل طلب.
تقوم هذه الواجهة REST بفرز بيانات الجدول داخل ورقة عمل Excel.
لاستخدام هذه العملية، قم بتوفير اسم المصنف، واسم ورقة العمل، وفهرس كائن القائمة المستهدف، إلى جانب جسم JSON يحتوي على كائن dataSorter يحدد معايير الفرز.
واجهة PostWorksheetListObjectSortTable API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/sort
الأمان والمصادقة
تُعتبر واجهات برمجة التطبيقات (APIs) الخاصة بـ Aspose.Cells Cloud آمنة وتتطلب المصادقة باستخدام رمز JWT.
معلمات الطلب
| اسم المعلمة | النوع | المسار / سلسلة الاستعلام / جسم HTTP | الوصف |
|---|---|---|---|
| name | نص (string) | path | اسم ملف Excel المخزن في مساحة التخزين الخاصة بـ Aspose Cloud. |
| sheetName | نص (string) | path | اسم ورقة العمل التي تحتوي على كائن القائمة (ListObject). |
| listObjectIndex | عدد صحيح (integer) | path | الفهرس المبتدئ من الصفر لكائن القائمة (الجدول) داخل ورقة العمل. |
| dataSorter | كائن (object) | body | كائن JSON يحدّد خيارات الفرز (مثل CaseSensitive، HasHeaders، KeyList، SortLeftToRight). |
| folder | نص (string) | query | مسار المجلد داخل التخزين حيث يقع ملف Excel. |
| storageName | نص (string) | query | اسم مساحة التخزين الخاصة بـ Aspose Cloud. |
ملاحظات
يجب أن يكون جسم الطلب كائن JSON صالحًا يطابق مخطط dataSorter. تأكد من وجود المصنف وورقة العمل وكائن القائمة قبل تنفيذ عملية الفرز.
يعرّف مواصفات OpenAPI واجهة برمجة قابلة للوصول علنًا، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.
عائلة واجهات برمجة التطبيقات (SDK) السحابية
استخدام واجهات برمجة التطبيقات (SDKs) هو أفضل طريقة لتسريع عملية التطوير، إذ تتعامل SDKs مع التفاصيل منخفضة المستوى، وتتيح لك التركيز على مهام مشروعك. يُرجى زيارة مستودع GitHub للحصول على قائمة كاملة بواجهات برمجة التطبيقات (SDKs) الخاصة بـ Aspose.Cells Cloud.
توضح الأمثلة التالية كيفية استدعاء خدمات الويب الخاصة بـ Aspose.Cells باستخدام SDKs مختلفة: