جمع وحساب القيم (المجموع، العدد، المتوسط، القيمة الصغرى، القيمة العظمى) حسب اللون في جدول بيانات/إكسل

نظرة عامة

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

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

PUT https://api.aspose.cloud/v4.0/cells/calculate/aggregate/color

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

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

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

التعدادات

• ColorPosition

  القيمة	المعنى
  Background	استخدام لون ملء الخلية.
  Font	استخدام لون خط الخلية.

مثال على طلب multipart/form‑data

curl -X PUT "https://api.aspose.cloud/v4.0/cells/calculate/aggregate/color?Worksheet=Sheet1&Range=A1:B10&Operation=Sum&ColorPosition=Background" \
  -H "Authorization: Bearer <access_token>" \
  -F "Spreadsheet=@/path/to/workbook.xlsx"

الاستجابة

توضّح المخطط التالي كائن الاستجابة. يلي المخطط مثال حقيقي.

{
  "Name": "AggregateResultByColorResponse",
  "Type": "Class",
  "ParentName": "CellsCloudResponse",
  "IsAbstract": false,
  "Properties": [
    {
      "Name": "AggregateResults",
      "DataType": {
        "Identifier": "Array",
        "Reference": "AggregateResultByColor",
        "ElementDataType": {
          "Reference": "AggregateResultByColor"
        }
      }
    },
    {
      "Name": "Code",
      "DataType": { "Identifier": "Integer" }
    },
    {
      "Name": "Status",
      "DataType": { "Identifier": "String" }
    }
  ]
}

مثال على استجابة حقيقية (بقيم فعلية)

{
  "Code": 200,
  "Status": "OK",
  "AggregateResults": [
    {
      "Color": "#FF0000",
      "Count": 12,
      "Sum": 345.67,
      "Average": 28.8,
      "Min": 5.0,
      "Max": 80.0
    },
    {
      "Color": "#00FF00",
      "Count": 7,
      "Sum": 210.0,
      "Average": 30.0,
      "Min": 10.0,
      "Max": 50.0
    }
  ]
}

رموز حالة HTTP

أين ينبغي استخدام واجهة برمجة تطبيقات جمع الخلايا حسب اللون؟

في جدول البيانات، غالبًا ما تُرمّز البيانات الخاصة بالفئات المختلفة بلون معيّن. وتتيح لك هذه الواجهة حساب المجموع، والعدد، والمتوسط، أو تحديد القيمة الصغرى والعظمى لكل مجموعة ألوان، ما يبسّط تحليل البيانات المعتمد على اللون.

لماذا يجب استخدام واجهة برمجة تطبيقات جمع الخلايا حسب اللون؟

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

كيفية استخدام واجهة برمجة تطبيقات جمع الخلايا حسب اللون مع مكتبات SDK

مواصفات واجهة برمجة تطبيقات جمع الخلايا حسب اللون

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

استخدام مكتبات Aspose.Cells Cloud SDK

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

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

ملاحظات:

• عند العمل مع ملفات جدول عمل محمية، تأكد من تضمين المتغير الاختياري Password في استعلام الطلب؛ وإلا فستفشل الطلب مع خطأ 401.
• الحد الأقصى لحجم طلب الملف Spreadsheet هو 100 ميغابايت. وإذا احتجت إلى معالجة ملفات أكبر، فكر في رفع جدول العمل إلى مستودع Aspose Cloud أولًا ثم الإشارة إليه عبر المتغير Path (وهو ما لا يظهر هنا).