Lägg till ett ikonfilter i ett Excel-ark – Aspose.Cells Cloud-dokumentation

REST API

Denna REST API lägger till ett ikonfilter i ett Excel-ark med hjälp av Aspose.Cells Cloud REST API.

Bakgrund: Ett ikonfilter tillämpar ett visuellt ikonset på celler baserat på deras värden, vilket möjliggör snabb visuell analys av datatrender. Vanliga användningsfall inkluderar att framhäva prestandamätare, statusindikatorer eller kategorisera värden med trafikljus-ikoner direkt i Excel-ark.

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/iconFilter

Säkerhet och autentisering

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

Begärandeparametrar:

Parameternamn	Typ	Plats	Beskrivning
name	string	Path	Arbetsbokens namn.
sheetName	string	Path	Arkets namn.
range	string	Query	Cellintervallet (t.ex. `A1:B1`) som filtret ska tillämpas på.
fieldIndex	integer	Query	Nollbaserat index för den kolumn som filtret riktar sig mot.
iconSetType	string	Query	Det ikonset som ska användas. Tillåtna värden: `Arrows3`, `ArrowsGray3`, `Flags3`, `Signs3`, `Symbols3`, `Symbols32`, `TrafficLights31`, `TrafficLights32`, `Arrows4`, `ArrowsGray4`, `Rating4`, `RedToBlack4`, `TrafficLights4`, `Arrows5`, `ArrowsGray5`, `Quarters5`, `Rating5`, `Stars3`, `Boxes5`, `Triangles3`, `None`, `CustomSet`, `Smilies3`, `ColorSmilies3`.
iconId	integer	Query	Identifieraren för den specifika ikonen inom det valda ikonsetet.
matchBlanks	boolean	Query	Bestämmer om tomma celler inkluderas (`true` eller `false`).
refresh	boolean	Query	Anger om filtret ska uppdateras efter tillämpning (`true` eller `false`).
folder	string	Query	Mappen som innehåller den ursprungliga arbetsboken.
storageName	string	Query	Namnet på lagringsplatsen där arbetsboken finns.

Svar

{
    "Status":"OK",
    "Code":200
}

HTTP-statuskoder

Kod	Betydelse	Beskrivning
200	OK	Filtret har tillämpats framgångsrikt; svaret innehåller åtgärdens detaljer.
400	Felaktig begäran	Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds).
401	Oautentiserad	Ogiltig eller saknad JWT-token.
413	För stor nyttolast	Den uppladdade filen överskrider storleksgränsen.
500	Internt serverfel	Oväntat serverfel.

Hur du använder PutWorksheetIconFilter API med SDK:er

PutWorksheetIconFilter API-specificering

OpenAPI-specificeringen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.

Du kan använda verktyget cURL för att enkelt komma åt Aspose.Cells webbtjänster. Följande exempel visar hur du gör ett anrop till Cloud API med cURL.

Begäran

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/autoFilter/iconFilter?range=A1:B1&fieldindex=0&iconsettype=ArrowsGray3&iconid=1" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Svar

{
  "Code": 200,
  "Status": "OK"
}

Möjliga svarsstatuskoder:

Kod	Beskrivning
200	Filtret har tillämpats framgångsrikt.
400	Felaktig begäran – saknade eller ogiltiga parametrar.
401	Oautentiserad – ogiltig eller saknad autentiseringstoken.
404	Arbetsbok, ark eller angivet intervall hittades inte.
500	Internt serverfel.

Använd Aspose.Cells Cloud SDK:er

Att använda en SDK är det bästa sättet att påskynda utvecklingen. En SDK hanterar detaljer på lågnivånivå, så att du kan fokusera på dina projektuppgifter. Se GitHub-förrådet för en komplett lista över Aspose.Cells Cloud SDK:er.

Följande kodexempel visar hur du anropar Aspose.Cells webbtjänster med olika SDK:er:

För övriga AutoFilter-funktioner, se dokumentationen för Lägg till färgfilter, Lägg till datumfilter och Rensa AutoFilter.

Lägg till en dynamisk filter i ett Excel-ark med Aspose.Cells Cloud API AutoFitterOptions – Egenskaper och användningsguide | Aspose.Cells Cloud API