Ottieni i dati delle celle in base a un intervallo denominato – Aspose.Cells Cloud API

Prerequisiti

  • Un token di accesso JWT valido con l’ambito appropriato.
  • Il workbook deve essere caricato nello storage di Aspose Cloud (o in una cartella specificata).
  • Assicurati di fornire il nome dello storage di destinazione se utilizzi uno storage non predefinito.

Questa API REST restituisce un elenco di celle all’interno di un intervallo identificato da un intervallo denominato o da indici riga-colonna.

Questa operazione consente agli sviluppatori di recuperare programmaticamente i valori delle celle appartenenti a un intervallo denominato specifico in un foglio di lavoro Excel. Fornendo l’identificatore namedRange oppure gli indici espliciti di riga e colonna, l’API restituisce un elenco dettagliato delle celle, inclusi il relativo indirizzo, riga, colonna, valore, tipo di dati e informazioni sul formato. La risposta può essere utilizzata per alimentare applicazioni basate sui dati, generare report o eseguire ulteriori calcoli lato server. Il servizio Aspose.Cells Cloud supporta numerose lingue di programmazione tramite i relativi SDK, garantendo un’integrazione fluida indipendentemente dalla piattaforma di sviluppo. L’utilizzo di HTTPS garantisce la trasmissione sicura dei dati, e l’API rispetta i principi REST restituendo codici di stato HTTP standard per le condizioni di successo ed errore.

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value

Parametri della richiesta

Nome parametro Tipo Posizione Descrizione
name string path Nome del file workbook.
sheetName string path Nome del foglio di lavoro all’interno del workbook.
namedRange string query Intervallo denominato da recuperare, ad esempio A1:B2 o range_name1.
firstRow integer query Indice in base zero della prima riga dell’intervallo (utilizzato quando namedRange non è fornito).
firstColumn integer query Indice in base zero della prima colonna dell’intervallo (utilizzato quando namedRange non è fornito).
rowCount integer query Numero di righe da includere nell’intervallo.
columnCount integer query Numero di colonne da includere nell’intervallo.
folder string query Cartella contenente il workbook.
storageName string query Nome dello storage cloud in cui risiede il workbook.

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

Puoi utilizzare lo strumento a riga di comando cURL per chiamare facilmente i servizi web di Aspose.Cells. L’esempio seguente illustra come richiedere i valori delle celle da un intervallo denominato.

Nota sulla sicurezza: Utilizza sempre HTTPS quando chiami l’API. Il servizio non supporta HTTP in chiaro; l’uso di HTTPS garantisce che la richiesta sia crittografata e rispetti le best practice in materia di sicurezza.

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 sul server.

Esempio di risposta di errore (400 Bad Request)

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Il parametro 'namedRange' è mancante o non valido."
}

Suggerimento: L’API utilizza indici in base zero per firstRow e firstColumn. Ad esempio, la prima riga del foglio di lavoro corrisponde a 0.

Famiglia di SDK Cloud

L’utilizzo di un SDK rappresenta il modo più efficiente per accelerare lo sviluppo. Un SDK astrae i dettagli di basso livello, consentendo di concentrarsi sulla logica di business. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

Gli esempi di codice seguenti illustrano come chiamare i servizi web di Aspose.Cells utilizzando diversi SDK:

Ottenere intervallo con nome in un foglio di calcolo Excel