Ordina i dati di un intervallo in un foglio di lavoro Excel

L’API REST ordina i dati all’interno di un intervallo specificato in un foglio di lavoro Excel.

API REST

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/sort

Parametri della richiesta

Nome parametro	Tipo	Posizione	Obbligatorio	Descrizione
name	string	path	Sì	Nome del workbook.
sheetName	string	path	Sì	Nome del foglio di lavoro.
cellArea	string	query	Sì	Intervallo di celle da ordinare (es. `A5:A10`).
dataSorter	object	body	Sì	Oggetto JSON che definisce le impostazioni di ordinamento (vedi schema sotto).
folder	string	query	No	Cartella contenente il workbook.
storageName	string	query	No	Nome dell’archiviazione in cui si trova il workbook.

Schema dell’oggetto dataSorter – Il corpo deve contenere un oggetto JSON con le seguenti proprietà:

CaseSensitive (booleano, obbligatorio) – Determina se l’ordinamento è sensibile alle maiuscole/minuscole.
HasHeaders (booleano, obbligatorio) – Indica se l’intervallo include una riga di intestazione.
KeyList (array, obbligatorio) – Raccolta di chiavi di ordinamento. Ciascun oggetto chiave include:
- Key (intero) – Indice di colonna in base zero.
- SortOrder (stringa) – "ascending" (crescente) o "descending" (decrescente).
SortLeftToRight (booleano, obbligatorio) – Se true, l’ordinamento avviene da sinistra a destra; altrimenti dall’alto verso il basso.
(Opzionale) CaseOrder, SortLeftToRight, ecc., possono essere forniti in base alla specifica OpenAPI.

La specificazione OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile e consente di effettuare interazioni REST direttamente da un browser web.

È possibile utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API Cloud tramite cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/sort?cellArea=A5:A10" \
  -X POST \
  -d '{"CaseSensitive":false,"HasHeaders":false,"KeyList":[{"Key":0,"SortOrder":"descending"}],"SortLeftToRight":false}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

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

Gestione degli errori – L’API può restituire codici di errore HTTP standard. Le risposte tipiche includono:

Stato HTTP	Codice	Messaggio
400	400	Richiesta non valida – parametri mancanti o non validi.
401	401	Non autorizzato – token JWT non valido o assente.
404	404	Non trovato – il workbook o il foglio di lavoro non esistono.
500	500	Errore interno del server.

Nel caso di errori, il corpo della risposta segue il formato { "Code": <status>, "Message": "<descrizione>", "Status": "Error" }.

Family di SDK Cloud

Utilizzare un SDK è il modo più rapido per sviluppare. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per l’elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come chiamare i servizi web Aspose.Cells utilizzando vari SDK: