الحصول على قواعد التنسيق الشرطي

تسترجع هذه الواجهة البرمجية REST قواعد التنسيق الشرطي المطبقة على ورقة عمل.

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

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

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

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

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	سلسلة نصية	المسار	اسم ملف إكسل.
sheetName	سلسلة نصية	المسار	اسم ورقة العمل.
folder	سلسلة نصية	استعلام	مسار المجلد الذي يُخزَّن فيه الملف.
storageName	سلسلة نصية	استعلام	اسم خدمة التخزين (اختياري).

استجابات الأخطاء

رمز HTTP	السبب	مثال على جسم الاستجابة
400	طلب غير صالح – معلمات مفقودة أو غير صالحة.	`{ "Code":"400", "Message":"Invalid parameter value." }`
401	غير مصرّح به – رمز JWT مفقود أو غير صالح.	`{ "Code":"401", "Message":"Access token is missing or invalid." }`
404	غير موجود – ملف العمل أو ورقة العمل غير موجودين.	`{ "Code":"404", "Message":"File not found." }`
500	خطأ داخلي في الخادم – فشل غير متوقع في الخادم.	`{ "Code":"500", "Message":"An unexpected error occurred." }`

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

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

Request

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet1/conditionalFormattings" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>"

Response

{
  "Status": "OK",
  "ConditionalFormattings": {
    "Count": 1,
    "ConditionalFormattingList": [
      {
        "sqref": "A1:B10",
        "FormatConditions": [
          {
            "Priority": 1,
            "Type": "CellValue",
            "Operator": "GreaterThan",
            "Formula1": "100",
            "Style": {
              "Font": {
                "Color": { "A": 255, "R": 255, "G": 0, "B": 0 },
                "IsBold": true
              }
            }
          }
        ]
      }
    ]
  }
}

يعرض المثال أعلاه فقط أبرز الحقول ذات الصلة للحفاظ على اختصار حمل البيانات.

معلمات الاستجابة

المعلمة	النوع	الوصف
Status	سلسلة نصية	حالة نتيجة الطلب (مثل OK).
ConditionalFormattings	كائن	حاوية لبيانات التنسيق الشرطي.
ConditionalFormattings.Count	عدد صحيح	عدد قواعد التنسيق الشرطي المسترجعة.
ConditionalFormattings.ConditionalFormattingList	مصفوفة	قائمة كائنات التنسيق الشرطي.
ConditionalFormattingList[].sqref	سلسلة نصية	نطاق الخلايا الذي يُطبَّق عليه التنسيق (مثل A1:B10).
ConditionalFormattingList[].FormatConditions	مصفوفة	مجموعة كائنات شروط التنسيق الخاصة بالنطاق.
FormatConditions[].Priority	عدد صحيح	أولوية تقييم الشرط.
FormatConditions[].Type	سلسلة نصية	نوع الشرط (مثل CellValue).
FormatConditions[].Operator	سلسلة نصية	العامل المستخدم في الشرط (مثل GreaterThan).
FormatConditions[].Formula1	سلسلة نصية	الصيغة أو القيمة الأولى للشرط.
FormatConditions[].Style	كائن	التنسيق المطبّق عند استيفاء الشرط.
Style.Font.Color	كائن	تعريف اللون RGBA لخط النص.
Style.Font.IsBold	منطقي	يُشير إلى ما إذا كان الخط عريضًا أم لا.

رموز حالة HTTP

الرمز	المعنى	الوصف
200	OK	تم تطبيق الفلتر بنجاح؛ تحتوي الاستجابة على تفاصيل العملية.
400	Bad Request	معلمات مفقودة أو غير صالحة (مثل نوع ملف غير مدعوم).
401	Unauthorized	رمز JWT غير صالح أو مفقود.
413	Payload Too Large	حجم الملف المرفوع يتجاوز الحد المسموح به.
500	Internal Server Error	خطأ غير متوقع في الخادم.

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

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

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

الحصول على التنسيق الشرطي إضافة CellArea إلى التنسيق الشرطي