Raggruppa Colonne – Documentazione Aspise.Cells Cloud API

Raggruppare Colonne su un Foglio di Lavoro Excel

Versione API: v3.0
Operazione: PostGroupWorksheetColumns – Raggruppa le colonne del foglio di lavoro nel foglio di lavoro.

Panoramica

Questa API REST consente di raggruppare un intervallo di colonne in un foglio di lavoro. Le colonne raggruppate possono essere mostrate o nascoste, consentendo di creare sezioni comprimibili simili a quelle di Microsoft Excel.

Prerequisiti

  • Un token di accesso JWT valido ottenuto dal servizio di autenticazione di Aspose Cloud.
  • Il workbook deve essere memorizzato in una posizione accessibile ad Aspose.Cells Cloud (archivio predefinito o un nome di archivio personalizzato).
  • Versione SDK richiesta (se si utilizza un SDK): l’ultima release che supporta la versione API v3.0.

Autenticazione

Tutte le richieste richiedono l’autenticazione con token Bearer.

Authorization: Bearer <access_token>

Per maggiori dettagli su come ottenere un token, consulta la guida all’autenticazione JWT.

Richiesta HTTP

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/group
Parametro Posizione Obbligatorio Descrizione
name Path Sì Nome del file del workbook (es. test.xlsx).
sheetName Path Sì Nome del foglio di lavoro contenente le colonne da raggruppare.
firstIndex Query Sì Indice in base zero della prima colonna da includere nel gruppo.
lastIndex Query Sì Indice in base zero dell’ultima colonna da includere nel gruppo.
hide Query No Se true, le colonne raggruppate vengono nascoste; altrimenti rimangono visibili.
folder Query No Percorso della cartella contenente il workbook.
storageName Query No Nome del servizio di archiviazione in cui si trova il file.

Esempio di Richiesta (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>"

Nota: La richiesta utilizza HTTPS per garantire la crittografia della comunicazione.

Risposta

Successo (200)

Campo Tipo Descrizione
Code integer Codice di stato HTTP (200).
Status string Stato testuale dell’operazione (OK).

Esempio

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

Errore (es. 400 Bad Request)

Campo Tipo Descrizione
Code integer Codice di stato HTTP (400, 401, 404, 500, …).
Status string Stato testuale (Error).
ErrorMessage string Descrizione leggibile dell’errore.
ErrorCode string Identificatore programmatico dell’errore.

Esempio – Richiesta non valida

{
  "Code": 400,
  "Status": "Error",
  "ErrorMessage": "Indice di colonna non valido.",
  "ErrorCode": "InvalidParameter"
}

Esempi SDK

I seguenti frammenti mostrano come chiamare l’operazione Raggruppa Colonne Foglio di Lavoro utilizzando gli SDK supportati.

Note

  • Comportamento del raggruppamento: L’API crea un gruppo di colonne che può essere espanso o compresso in Excel. Impostando hide=true, il gruppo viene immediatamente compresso.
  • Indicizzazione in base zero: Sia firstIndex che lastIndex iniziano da 0; la prima colonna in un foglio di lavoro ha indice 0.
  • Considerazioni sull’archiviazione: Se il workbook si trova in un archivio non predefinito, fornire entrambi i parametri di query folder e storageName.

Vedi Anche

Illustrazione: Schermata che mostra colonne raggruppate in un foglio di lavoro Excel{: .img-fluid alt=“Schermata che mostra colonne raggruppate in un foglio di lavoro Excel” }

L’immagine di seguito è un segnaposto e dovrebbe essere sostituita con una schermata reale che dimostri il risultato visivo del raggruppamento delle colonne.