Summa, räkna, medelvärde, max, min värden efter färg i kalkylblad/Excel

Översikt

API:et kan utföra databeräkningar baserat på cellernas färg. Det kan summera, räkna antalet, beräkna medelvärde samt hitta det högsta och lägsta värdet i ett Excel-kalkylblad enligt cellernas fyllnings- eller teckensnittsfärg.

Beräkningsåtgärd Beskrivning
Räkna Bestäm antalet celler med samma färg.
Summa Beräkna det totala värdet av celler med samma färg.
Max-värde Identifiera det högsta värdet bland celler med samma färg.
Min-värde Hitta det lägsta värdet bland celler med samma färg.
Medelvärde Beräkna medelvärdet av celler med samma färg.

Webb-API

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

Säkerhet och autentisering

Aspose.Cells Cloud-API:er är säkra och kräver JWT-tokenbaserad autentisering.

Begärandeparametrar

Parametername Typ Plats Beskrivning
Spreadsheet Fil FormData Den Excel-arbetsbok som ska bearbetas.
Worksheet String Query Namn på kalkylbladet som innehåller intervallet.
Range String Query A‑1-stil-intervall (t.ex. A1:B10).
Operation String Query Beräkningsmetod – Sum, Count, Average, Min eller Max.
ColorPosition String Query Bestämmer vilken färg som ska utvärderas – Background, Font.
Region String Query Kalkylbladets regionsinställning (t.ex. us-east-1).
Password String Query Lösenord för att öppna en skyddad arbetsbok (valfritt).

Enumerationer

  • ColorPosition
    Värde Betydelse
    Background Använd cellens fyllningsfärg.
    Font Använd cellens teckensnittsfärg.

Exempel på multipart/form‑data-begäran

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"

Svar

Schemat nedan beskriver svarsobjektet. Ett konkret exempel följer efter schemat.

{
  "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" }
    }
  ]
}

Exempel på svar (världsverkliga värden)

{
  "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-statuskoder

Kod Betydelse Beskrivning
200 OK Filter tillämpades framgångsrikt; svaret innehåller åtgärddetaljer.
400 Bad Request Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds).
401 Unauthorized Ogiltig eller saknad JWT-token.
413 Payload Too Large Den uppladdade filen överskrider storleksgränsen.
500 Internal Server Error Oväntat serverfel.

Var bör vi använda API:et för att aggregera efter färg?

I ett kalkylblad är ofta data från olika kategorier färgkodad. Detta API gör det möjligt att summera, räkna antalet, beräkna medelvärde eller hitta minsta och högsta värde för varje färggrupp, vilket förenklar färgbaserad dataanalys.

Varför bör du använda API:et för att aggregera efter färg?

API:et erbjuder ett snabbt och pålitligt sätt att utföra färgbaserade beräkningar utan att skriva egen parseringslogik. Det integrerar sömlöst med Aspose.Cells Cloud SDK:er, vilket gör det möjligt för utvecklare att implementera färgbaserad aggregering med bara några rader kod.

Hur man använder API:et för att aggregera efter färg med SDK:er

API-specifikation för aggregering efter färg

API-specifikationen för aggregering efter färg definierar ett offentligt tillgängligt programmeringsgränssnitt och gör det möjligt att utföra REST-interaktioner direkt från en webbläsare.

Använd Aspose.Cells Cloud SDK:er

Att använda SDK är det snabbaste sättet att utveckla, eftersom den döljer de lågnivådetaljer som krävs, så att du kan aggregera beräkningar efter cellfärg med bara en kort kodsnutt.
Se GitHub-förrådet för en komplett lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel visar hur man gör anrop till Aspose.Cells-webbtjänster med hjälp av olika SDK:er:

Anteckningar:

  • När du arbetar med skyddade arbetsböcker inkluderar du den valfria Password-queryparametern; annars misslyckas begäran med ett 401-fel.
  • Den maximala begärandestorleken för filen Spreadsheet är 100 MB. Om du behöver bearbeta större filer bör du överväga att först ladda upp arbetsboken till Aspose Cloud-lagring och referera till den via Path-parametern (inte medföljer här).