Aggiungi un filtro a un foglio di lavoro Excel utilizzando Aspose.Cells Cloud
Prerequisiti: Prima di chiamare questa API è necessario ottenere un token JWT valido, assicurarsi che il libro di lavoro di destinazione sia caricato nell’archivio specificato e disporre delle autorizzazioni necessarie per accedere al file. Per gli esempi a riga di comando si consiglia una versione recente di cURL (7.68 o successiva).
Questa API REST aggiunge un filtro per una colonna specifica in un foglio di lavoro Excel.
API PutWorksheetFilter
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/filter
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 | Descrizione |
|---|---|---|---|
| name | string | Path | Nome del libro di lavoro. |
| sheetName | string | Path | Nome del foglio di lavoro. |
| range | string | Query | Intervallo di celle che contiene il filtro (ad esempio A1:B1). |
| fieldIndex | integer | Query | Indice in base zero della colonna a cui viene applicato il filtro. |
| criteria | string | Query | Criteri di filtro (ad esempio, un valore o un’espressione). |
| matchBlanks | boolean | Query | Impostare su true per includere le celle vuote nel filtro; altrimenti false. |
| refresh | boolean | Query | Impostare su true per aggiornare il filtro dopo l’applicazione; altrimenti false. |
| folder | string | Query | Cartella in cui è memorizzato il libro di lavoro originale. |
| storageName | string | Query | Nome del servizio di archiviazione. |
Risposta
{
"Status":"OK",
"Code":200
}
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 esempio, 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 nel server. |
Come utilizzare l’API PutWorksheetFilter con gli SDK
Specifica dell’API PutWorksheetFilter
La Specifica 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 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 di 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 di Aspose.Cells utilizzando vari SDK: