فرز بيانات النطاق في ورقة عمل Excel

تقوم واجهة برمجة التطبيقات (REST API) بفرز البيانات داخل نطاق مُحدّد في ورقة عمل Excel.

واجهة برمجة التطبيقات (REST API)

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/sort

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

اسم المعلمة	النوع	الموقع	مطلوبة	الوصف
name	string	path	نعم	اسم المصنف.
sheetName	string	path	نعم	اسم ورقة العمل.
cellArea	string	query	نعم	نطاق الخلايا المراد فرزه (مثل `A5:A10`).
dataSorter	object	body	نعم	كائن JSON يُعرّف إعدادات الفرز (انظر المخطط أدناه).
folder	string	query	لا	المجلد الذي يحتوي على المصنف.
storageName	string	query	لا	اسم وحدة التخزين التي يوجد فيها المصنف.

مخطط كائن dataSorter – يجب أن يحتوي الجسم على كائن JSON يحتوي على الخصائص التالية:

CaseSensitive (boolean, مطلوب) – يحدّد ما إذا كان الفرز حسّاسًا لحالة الأحرف (كبير/صغير).
HasHeaders (boolean, مطلوب) – يشير إلى ما إذا كان النطاق يحتوي على صف رئيسي (Header).
KeyList (array, مطلوب) – مجموعة مفاتيح الفرز. يحتوي كل كائن مفتاح على:
- Key (integer) – مؤشر العمود (بدءًا من الصفر).
- SortOrder (string) – "ascending" أو "descending".
SortLeftToRight (boolean, مطلوب) – إذا كانت قيمته true، فيتم الفرز من اليسار إلى اليمين؛ وإلا من الأعلى إلى الأسفل.
(اختياري) يمكن أيضًا توفير خصائص إضافية مثل CaseOrder، SortLeftToRight وفقًا لمواصفات OpenAPI.

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

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

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/sort?cellArea=A5:A10" \
  -X POST \
  -d '{"CaseSensitive":false,"HasHeaders":false,"KeyList":[{"Key":0,"SortOrder":"descending"}],"SortLeftToRight":false}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Code": 200,
  "Status": "OK"
}

معالجة الأخطاء – يمكن أن تُرجع الواجهة رموز أخطاء HTTP قياسية. من بين الاستجابات الشائعة:

الحالة (HTTP)	الرمز	الرسالة
400	400	طلب غير صالح – مَعلمات مفقودة أو غير صحيحة.
401	401	غير مُصادَق – رمز JWT غير صالح أو مفقود.
404	404	غير موجود – المصنف أو ورقة العمل غير موجودين.
500	500	خطأ داخلي في الخادم.

يكون هيكل جسم الاستجابة في حالات الخطأ على النحو التالي: { "Code": <status>, "Message": "<description>", "Status": "Error" }.

عائلة SDK للحوسبة السحابية

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

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