Gruppera kolumner – Aspise.Cells Molntjänst-API-dokumentation

Gruppera kolumner i ett Excel-kalkylblad

API-version: v3.0
Åtgärd: PostGroupWorksheetColumns – Gruppera kolumner i ett kalkylblad.

Översikt

Detta REST API låter dig gruppera ett intervall av kolumner i ett kalkylblad. Grupperade kolumner kan visas eller döljas, vilket möjliggör skapandet av collapsebara sektioner, liknande de i Microsoft Excel.

Förutsättningar

  • En giltig JWT-åtkomsttoken som hämtats från Aspose Cloud:s autentiseringstjänst.
  • Arbetshandboken måste lagras på en plats som Aspose.Cells Cloud har tillgång till (standardlagring eller ett anpassat lagringsnamn).
  • Nödvändig SDK-version (om en SDK används): den senaste utgåvan som stöder API-version v3.0.

Autentisering

Alla begäranden kräver Bearer token-autentisering.

Authorization: Bearer <access_token>

För detaljer om hur du hämtar en token, se JWT-autentiseringsguide.

HTTP-begäran

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/group
Parameter Plats Krävs Beskrivning
name Sökväg Ja Arbetshandbokens filnamn (t.ex. test.xlsx).
sheetName Sökväg Ja Kalkylbladet som innehåller de kolumner som ska grupperas.
firstIndex Frågeparameter Ja Nollbaserat index för den första kolumnen som ska ingå i gruppen.
lastIndex Frågeparameter Ja Nollbaserat index för den sista kolumnen som ska ingå i gruppen.
hide Frågeparameter Nej Om true döljs de grupperade kolumnerna; annars förblir de synliga.
folder Frågeparameter Nej Sökväg till mappen som innehåller arbetshandboken.
storageName Frågeparameter Nej Namn på lagringstjänsten där filen finns.

Exempel på begäran (cURL)

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/group?firstIndex=1&lastIndex=2&hide=true" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>"

Obs: Begäran använder HTTPS för att säkerställa krypterad kommunikation.

Svar

Lyckad (200)

Fält Typ Beskrivning
Code heltal HTTP-statuskod (200).
Status sträng Textuell status för åtgärden (OK).

Exempel

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

Fel (t.ex. 400 Bad Request)

Fält Typ Beskrivning
Code heltal HTTP-statuskod (400, 401, 404, 500, …).
Status sträng Textuell status (Error).
ErrorMessage sträng Människoläsbar beskrivning av problemet.
ErrorCode sträng Programmatiskt identifieringsnamn för felet.

Exempel – Bad Request

{
  "Code": 400,
  "Status": "Error",
  "ErrorMessage": "Ogiltigt kolumnindex.",
  "ErrorCode": "InvalidParameter"
}

SDK-exempel

Följande kodsnuttar visar hur man anropar operationen Gruppera kolumner i kalkylblad med de SDK:er som stöds.

Anmärkningar

  • Grupperingsbeteende: API:t skapar en kolumngrupp som kan expanderas eller kollapsas i Excel. Om hide=true sätts kollapsas gruppen omedelbart.
  • Nollbaserad indexerings: Både firstIndex och lastIndex börjar på 0; den första kolumnen i ett kalkylblad har index 0.
  • Lagringsöverväganden: Om arbetshandboken finns i en icke-standardlagring måste du ange både folder och storageName som frågeparametrar.

Se även

Illustration: Skärmbild som visar grupperade kolumner i ett Excel-kalkylblad{: .img-fluid alt=“Skärmbild som visar grupperade kolumner i ett Excel-kalkylblad” }

Ovanstående platsinnehålls-bild bör ersättas med en faktisk skärmbild som visar det visuella resultatet av att gruppera kolumner.

Ta bort kolumn från ett Excel-ark med Aspose.Cells Cloud API