Questa API REST filtra gli elementi Top 10 in un elenco.
Prerequisiti
• Ottenere un token JWT valido tramite l’autenticazione di Aspose.Cells Cloud.
• Caricare il file Excel nello storage di Aspose Cloud (o specificare lo storage/cartella in cui si trova).
• Conoscere il nome del foglio di lavoro e l’intervallo di celle da filtrare.
API PutWorksheetFilterTop10
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/filterTop10
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 | Posizione | Obbligatorio | Valore predefinito | Descrizione |
|---|---|---|---|---|---|
| name | string | path | Sì | — | Nome del file Excel. |
| sheetName | string | path | Sì | — | Nome del foglio di lavoro contenente i dati. |
| range | string | query | Sì | — | Intervallo di celle a cui viene applicato il filtro (ad es. A1:B10). |
| fieldIndex | integer | query | Sì | — | Indice in base zero della colonna su cui viene applicato il filtro. |
| isTop | boolean | query | Sì | true |
true per filtrare gli elementi superiori; false per quelli inferiori. |
| isPercent | boolean | query | No | false |
true per interpretare itemCount come percentuale; false per un conteggio assoluto. |
| itemCount | integer | query | No | 10 |
Numero di elementi da includere nel filtro. |
| matchBlanks | boolean | query | No | false |
true per includere le celle vuote nei risultati del filtro. |
| refresh | boolean | query | No | false |
true per aggiornare il filtro dopo averlo applicato. |
| folder | string | query | No | — | Cartella nello storage in cui si trova il file Excel. |
| storageName | string | query | No | — | Nome dello storage Aspose Cloud. |
Risposta
{
"Status":"OK",
"Code":200
}
Risposte di errore tipiche
{
"Code":400,
"Message":"Richiesta non valida – parametri mancanti o non validi."
}
{
"Code":401,
"Message":"Non autorizzato – token JWT non valido o mancante."
}
{
"Code":413,
"Message":"Payload troppo grande – il file caricato supera la dimensione consentita."
}
{
"Code":500,
"Message":"Errore interno del server – condizione imprevista del server."
}
Codici di stato HTTP
| Codice | Significato | Descrizione |
|---|---|---|
| 200 | OK | Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione. |
| 400 | Richiesta non valida | Parametri mancanti o non validi (ad es. tipo di file non supportato). |
| 401 | Non autorizzato | Token JWT non valido o mancante. |
| 413 | Payload troppo grande | Il file caricato supera il limite di dimensione. |
| 500 | Errore interno del server | Errore imprevisto del server. |
Come utilizzare l’API PutWorksheetFilterTop10 con gli SDK
Specifica dell’API PutWorksheetFilterTop10
La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente 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 chiamare l’API con cURL.
Utilizzo degli SDK di Aspose.Cells Cloud
L’utilizzo di un SDK rappresenta il modo più rapido per sviluppare. Un SDK gestisce i dettagli a basso livello, consentendoti di concentrarti sul tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come chiamare i servizi web Aspose.Cells utilizzando vari SDK: