Documentation – استرجاع صف واحد من ورقة عمل Excel باستخدام API Aspose.Cells Cloud

Developer-Guide: الحصول على معلومات الصفوف من ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

تسترجع هذه الواجهة REST معلومات الصفوف من ورقة عمل Excel.

المتطلبات الأساسية
لاستدعاء هذه النقطة النهائية (endpoint)، يجب توفير رمز JWT صالح في رأس التفويض Authorization. ويجب الحصول على الرمز باستخدام تدفق المصادقة الخاص بـ Aspose.Cloud، ويجب أن يحتوي على النطاقات (scopes) المطلوبة لعمليات خدمة Cells. وتتبع هذه الواجهة مخطط الإصدار v3.0، وهي خاضعة لسياسات التقييد القياسية (rate-limit policies).

GetWorksheetRows API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	path	اسم المصنف (الملف).
sheetName	string	path	اسم ورقة العمل.
folder	string	query	مجلد المصنف.
storageName	string	query	اسم وحدة التخزين.

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

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

Request

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Response

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

أكواد الاستجابة

الرمز	المعنى	الوصف
200	OK (تم بنجاح)	نجح الطلب واستُرجعت معلومات الصفوف.
400	Bad Request (طلب خاطئ)	الطلب غير صحيح (مثلًا: معلمات مفقودة مطلوبة).
401	Unauthorized (غير مصرّح)	رمز JWT غير صالح أو مفقود.
404	Not Found (غير موجود)	المصنف أو ورقة العمل المحددة غير موجودة.
500	Internal Server Error (خطأ داخلي في الخادم)	حدث خطأ غير متوقع في الخادم.

مجموعة أدوات SDK للسحابة

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

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

Request

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" -H "accept: application/json"

Response

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

مجموعة أدوات SDK للسحابة

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فتتولى أدوات SDK معالجة التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. فيما يلي أمثلة على الأكواد المكتوبة بلغات برمجة مختلفة لاسترجاع صفوف ورقة العمل.

Developer-Guide: الحصول على وصف الصف من ورقة عمل Excel

Mon, 01 Jan 0001 00:00:00 +0000

المتطلبات المسبقة:

احصل على رمز وصول JWT صالح وشّمله في الرأس Authorization: Bearer <jwt token>.
تأكّد من أن ملفّ المصنف مخزّن في مستودع Aspose Cloud، أو حدد مسار المجلّد الذي يوجد فيه.
استخدم إصدار API v3.0 كما هو مبيّن في عنوان URL للنهاية.

تُعيد هذه الواجهة البرمجية لـ REST استرجاع بيانات الصف باستخدام فهرسه في ورقة عمل Excel.

واجهة GetWorksheetRow البرمجية

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/{rowIndex}

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

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

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

اسم المعلّمة	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف.
sheetName	string	path	اسم ورقة العمل داخل المصنف.
rowIndex	integer	path	الفهرس بصيغة الصفر-مبني للصف المراد استرجاعه.
folder	string	query	المجلّد الذي يحتوي على المصنف.
storageName	string	query	اسم المستودع الذي يوجد فيه المصنف.

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

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات Aspose.Cells عبر الويب بسهولة. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة Cloud API باستخدام cURL. شمّل الرأس Authorization: Bearer <jwt token> لمصادقة الطلب.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/0" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

الاستجابة

{
  "Row": {
    "GroupLevel": 0,
    "Height": 13.5,
    "Index": 0,
    "IsBlank": false,
    "IsHeightMatched": true,
    "IsHidden": false,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/rows/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

مخطط الاستجابة

الخاصية	النوع	الوصف
`GroupLevel`	integer	المستوى التفصيلي (المحوري) للصف (يُستخدم للتجميع).
`Height`	number	ارتفاع الصف بوحدات النقاط.
`Index`	integer	الفهرس بصيغة الصفر-مبني للصف المُعاد.
`IsBlank`	boolean	يشير إلى ما إذا كان الصف يحتوي على أي بيانات.
`IsHeightMatched`	boolean	`true` إذا كان ارتفاع الصف مطابقًا لارتفاع الصف الافتراضي.
`IsHidden`	boolean	`true` إذا كان الصف مخفيًّا.
`Style`	object	كائن يحتوي على معلومات النمط للصف.
`link`	object	مرجع رابط تشعبي إلى مورد الصف.
`Code`	integer	رمز حالة HTTP للاستجابة.
`Status`	string	وصف نصّي للحالة (مثل “OK”).

ملاحظات / معالجة الأخطاء: قد تُعيد الواجهة البرمجية رموز الحالة التالية لـ HTTP:

200 – نجاح; تُعاد بيانات الصف.
401 – غير مصادق; رمز JWT مفقود أو غير صالح.
404 – غير موجود; المصنف أو ورقة العمل أو الصف المحدّد غير موجود.
500 – خطأ داخلي في الخادم; حدثت حالة غير متوقّعة.

الكود	الوصف	التصحيح
200	نجاح – تُعاد بيانات الصف.	–
401	غير مصادق – رمز JWT مفقود أو غير صالح.	قدم رمز JWT صالحًا.
404	غير موجود – المصنف أو ورقة العمل أو الصف مفقود.	تأكّد من أسماء الملفات وفهرس الصف.
500	خطأ داخلي في الخادم – حالة غير متوقّعة.	اتّصل بدعم Aspose.

للحصول على قائمة كاملة برموز الأخطاء، راجع مستند رموز الأخطاء في Aspose.Cells Cloud.

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

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

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