الحصول على النطاقات المسماة في مصنف إكسل – واجهة برمجة التطبيقات السحابية Aspose.Cells

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

الخلفية – يُعد النطاق المسماة مُعرِّفًا يُعرِّفه المستخدم ويُشير إلى خلية محددة أو مجموعة محددة من الخلايا في ورقة عمل. وتساعد النطاقات المسماة في تبسيط إنشاء الصيغ، وتحسين قابلية القراءة، وتمكين الوصول البرمجي إلى المناطق المستخدمة بشكل متكرر في المصنف.

المتطلبات الأساسية – يتطلب الوصول إلى واجهة برمجة تطبيقات Aspose.Cells Cloud رمز وصول JWT صالح. احصل على الرمز المميز من خلال المصادقة باستخدام مُعرِّف العميل وسر العميل الخاصين بك على خدمة OAuth 2.0. وقم بتضمين الرمز المميز في رأس الطلب Authorization: Bearer <jwt token> في كل طلب.

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

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

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

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

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

اسم المعامل	النوع	الموقع	الوصف
name	string	Path	اسم مستند إكسل.
folder	string	Query string	المجلد الذي يحتوي على المستند.
storageName	string	Query string	اسم وحدة التخزين التي يوجد فيها المستند.

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح	تم تطبيق الفلتر بنجاح؛ ويتضمن الاستجابة تفاصيل العملية.
400	طلب غير صالح	معاملات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	غير مُصادَق	رمز JWT غير صالح أو مفقود.
413	حجم البيانات أكبر من المسموح به	حجم الملف المرفوع يتجاوز الحد المسموح به.
500	خطأ داخلي في الخادم	خطأ غير متوقع في الخادم.

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

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

Request

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

Response

{
  "Ranges": {
    "RangeList": [
      {
        "ColumnCount": 7,
        "ColumnWidth": 8.428571428571429,
        "FirstColumn": 1,
        "FirstRow": 9,
        "Name": "data",
        "RefersTo": "=Sheet1!$B$10:$H$10",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }
    ]
  },
  "Code": 200,
  "Status": "OK"
}

نموذج الاستجابة

الحقل	النوع	الوصف
`ColumnCount`	integer	عدد الأعمدة في النطاق.
`ColumnWidth`	number	عرض كل عمود (بالنقاط).
`FirstColumn`	integer	فهرس العمود الأول (مبني على الصفر) في النطاق.
`FirstRow`	integer	فهرس الصف الأول (مبني على الصفر) في النطاق.
`Name`	string	الاسم المُعرَّف من قِبل المستخدم للنطاق.
`RefersTo`	string	صيغة تُعرِّف مرجع الخلية (مثل `=Sheet1!$B$10:$H$10`).
`RowCount`	integer	عدد الصفوف في النطاق.
`RowHeight`	number	ارتفاع كل صف (بالنقاط).
`Worksheet`	string	اسم ورقة العمل التي يحتوي عليها النطاق.

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

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

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

الحصول على بيانات الخلايا بناءً على النطاق المسماة