Ordina i dati di ListObject in un foglio di lavoro Excel – Aspose.Cells Cloud API

Prerequisiti
Per chiamare questa API è necessario disporre di un token di accesso JWT valido di Aspose Cloud e il file di lavoro deve essere caricato nello storage di Aspose Cloud. Includere l’intestazione Authorization: Bearer <jwt token> in ogni richiesta.

Questa API REST ordina i dati di una tabella in un foglio di lavoro Excel.
Per utilizzare questa operazione, fornire il nome del file di lavoro, il nome del foglio di lavoro e l’indice dell’oggetto ListObject target, insieme a un corpo JSON dataSorter che definisce i criteri di ordinamento.

API PostWorksheetListObjectSortTable

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

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.

Parametri della richiesta

Nome Parametro	Tipo	Path/Query String/HTTPBody	Descrizione
name	string	path	Nome del file Excel archiviato nello storage di Aspose Cloud.
sheetName	string	path	Nome del foglio di lavoro contenente il ListObject.
listObjectIndex	integer	path	Indice in base zero dell’oggetto ListObject (tabella) all’interno del foglio di lavoro.
dataSorter	object	body	Oggetto JSON che specifica le opzioni di ordinamento (es. `CaseSensitive`, `HasHeaders`, `KeyList`, `SortLeftToRight`).
folder	string	query	Percorso della cartella nello storage in cui è situato il file Excel.
storageName	string	query	Nome dello storage di Aspose Cloud.

Note
Il corpo della richiesta deve essere un oggetto JSON valido che corrisponda allo schema dataSorter. Assicurarsi che il file di lavoro, il foglio di lavoro e il ListObject esistano prima di invocare l’operazione di ordinamento.

La Specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono di effettuare interazioni REST direttamente da un browser web.

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

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/sheet7/listobjects/1/sort" \
  -X POST \
  -d '{
        "CaseSensitive": true,
        "HasHeaders": true,
        "KeyList": [
          {
            "Key": 1,
            "SortOrder": "Ascending",
            "CustomList": "string"
          }
        ],
        "SortLeftToRight": true
      }' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

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

Codici di stato HTTP

Codice di stato	Descrizione
200	OK – ordinamento completato con successo.
400	Richiesta non valida – parametri non validi.
401	Non autorizzato – autenticazione non riuscita.
404	Non trovato – file di lavoro, foglio di lavoro o ListObject non trovato.
500	Errore interno del server – problema lato server.

Parametri della risposta

Parametro	Tipo	Descrizione
Code	integer	Codice di stato HTTP restituito dall’API.
Status	string	Descrizione testuale del risultato (es. “OK”).

Famiglia di SDK Cloud

Utilizzare un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello e consente di concentrarsi sulle attività del proprio progetto. Consultare il repository GitHub per l’elenco completo degli SDK di Aspose.Cells Cloud.

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

Torna alla panoramica dei ListObjects