Inserire un filtro di selezione in un oggetto elenco di Excel – Aspose.Cells Cloud API

Questa API REST inserisce un filtro di selezione per un oggetto elenco in un foglio di calcolo Excel.

API REST

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	Stringa	Path	Nome del file Excel.
sheetName	Stringa	Path	Nome del foglio di calcolo contenente l’oggetto elenco.
listObjectIndex	Integer	Path	Indice in base zero dell’oggetto elenco a cui verrà aggiunto il filtro.
columnIndex	Integer	Query	Indice in base zero della colonna su cui si basa il filtro.
destCellName	Stringa	Query	Riferimento alla cella (ad esempio A1) in cui verrà posizionato il filtro.
folder	Stringa	Query	Cartella nello storage contenente il file Excel.
storageName	Stringa	Query	Nome del servizio di storage Aspose Cloud.

È possibile utilizzare lo strumento a riga di comando cURL per chiamare l’API:

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}/InsertSlicer" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Nota: La richiesta richiede un token bearer JWT valido ottenuto dal servizio di autenticazione Aspose Cloud. Questo endpoint non richiede un corpo di richiesta; inviare un oggetto JSON vuoto {} se la libreria client richiede un payload.

Risposta

{
  "Code": 200,
  "Status": "OK",
  "Slicer": {
    "Name": "Slicer1",
    "ColumnIndex": 2,
    "Position": "A1"
  }
}

Intestazione di risposta: Content-Type: application/json

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.

Gestione degli errori

Quando si verifica un errore, l’API restituisce un oggetto JSON contenente un campo ErrorMessage che descrive il problema. Esaminare il codice di stato HTTP e il campo ErrorMessage per determinare l’azione correttiva.

Famiglia di SDK cloud

L’utilizzo di 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 un elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice illustrano come effettuare chiamate ai servizi web Aspose.Cells utilizzando vari SDK:

Converti oggetto elenco in intervallo – Aspose.Cells Cloud API