الحصول على تحقق من صحة ورقة عمل باستخدام الفهرس من ورقة عمل إكسل

تقوم هذه الواجهة البرمجية لواجهة برمجة تطبيقات REST باسترجاع التحقق من صحة ورقة العمل باستخدام فهرسه من ورقة عمل إكسل.
قبل استدعاء نقطة النهاية (endpoint)، يجب الحصول على رمز JWT عبر نقطة النهاية /connect/token، ثم تضمينه في رأس الطلب Authorization على الشكل Bearer <jwt token>.

واجهة برمجة تطبيقات REST

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	path	اسم ملف المصنف (workbook).
sheetName	string	path	اسم ورقة العمل.
validationIndex	integer	path	الفهرس الصفري (zero‑based) للتحقق المراد استرجاعه.
folder	string	query	المجلد الذي يحتوي على المصنف.
storageName	string	query	اسم خدمة التخزين.

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

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

الطلب

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

الاستجابة

{
  "Validation": {
    "AlertStyle": "Stop",
    "AreaList": [
      {
        "EndColumn": 0,
        "EndRow": 0,
        "StartColumn": 0,
        "StartRow": 0
      },
      {
        "EndColumn": 27,
        "EndRow": 0,
        "StartColumn": 26,
        "StartRow": 0
      }
    ],
    "IgnoreBlank": false,
    "InCellDropDown": false,
    "Operator": "None",
    "ShowError": false,
    "ShowInput": false,
    "Type": "AnyValue",
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/myWorkBook.xlsx/worksheets/Sheet1/Validations/0",
      "Rel": "self"
    }
  },
  "Code": "200",
  "Status": "OK"
}

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

الحقل	النوع	الوصف
AlertStyle	string	أسلوب التنبيه المعروض للمستخدم (Stop, Warning, Information).
AreaList	array	مجموعة من نطاقات الخلايا التي يسري عليها التحقق.
IgnoreBlank	boolean	إذا كانت `true`، تُتجاهل الخلايا الفارغة أثناء التحقق.
InCellDropDown	boolean	إذا كانت `true`، يُعرض قائمة منسدلة داخل الخلية.
Operator	string	عامل المقارنة المستخدم في التحقق (مثل `None`, `Between`).
ShowError	boolean	يحدد ما إذا كان سيتم عرض رسالة خطأ عند فشل التحقق.
ShowInput	boolean	يحدد ما إذا كان سيتم عرض رسالة إدخال عند تحديد الخلية.
Type	string	نوع التحقق (مثل `AnyValue`, `WholeNumber`, `Decimal`, إلخ).
link.Href	string	عنوان URL المرجعي الذاتي للمورد الخاص بالتحقق.
link.Rel	string	نوع العلاقة (دائمًا `self`).

أكواد الأخطاء الممكنة

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

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

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

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