Documentation –

Developer-Guide: Ottenere informazioni sulle righe da un foglio di lavoro Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST recupera informazioni sulle righe da un foglio di lavoro Excel.

Prerequisiti
Per chiamare questo endpoint è necessario fornire un token JWT valido nell’header Authorization. Il token deve essere ottenuto tramite il flusso di autenticazione di Aspose.Cloud e deve includere gli ambiti richiesti per le operazioni su Cells. L’API segue lo schema di versionamento v3.0 ed è soggetta alle politiche standard di limitazione del traffico.

API GetWorksheetRows

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

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 foglio di calcolo.
sheetName	string	path	Nome del foglio di lavoro.
folder	string	query	Cartella del foglio di calcolo.
storageName	string	query	Nome dell’archivio.

Lo specifica OpenAPI definisce un’interfaccia di programmazione accessibile pubblicamente 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 effettuare chiamate all’API Cloud con cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Codici di risposta

Codice	Significato	Descrizione
200	OK	La richiesta ha avuto esito positivo e le informazioni sulle righe vengono restituite.
400	Richiesta non valida	La richiesta è malformata (ad esempio, parametri obbligatori mancanti).
401	Non autorizzato	Token JWT non valido o mancante.
404	Non trovato	Il foglio di calcolo o il foglio di lavoro specificato non esiste.
500	Errore interno del server	Si è verificato un errore imprevisto sul server.

Famiglia di SDK Cloud

Utilizzare un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.

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

Richiesta

curl -X GET "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows" -H "accept: application/json"

Risposta

{
  "Rows": {
    "MaxRow": 20,
    "RowsCount": 17,
    "RowsList": [
      { "link": { "Href": "/0", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/1", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/2", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/3", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/4", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/5", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/6", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/7", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/8", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/9", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/10", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/11", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/12", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/13", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/14", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/15", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/16", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/17", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/18", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/19", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/20", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/21", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/22", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/23", "Rel": "self", "Title": null, "Type": null } },
      { "link": { "Href": "/24", "Rel": "self", "Title": null, "Type": null } }
    ],
    "link": {
      "Href": "/test.xlsx/worksheets/Sheet1/cells/rows",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Famiglia di SDK Cloud

Utilizzare un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Di seguito sono riportati esempi di codice specifici per linguaggio per il recupero delle righe del foglio di lavoro.

Developer-Guide: Ottenere la descrizione di una riga da un foglio di calcolo Excel

Mon, 01 Jan 0001 00:00:00 +0000

Prerequisiti:

Ottieni un token di accesso JWT valido e includilo nell’intestazione Authorization: Bearer <jwt token>.
Assicurati che il file di lavoro sia memorizzato nello storage di Aspose Cloud o specifica il percorso della cartella in cui si trova.
Usa la versione dell’API v3.0 come mostrato nell’URL dell’endpoint.

Questa API REST recupera i dati di una riga in base all’indice all’interno di un foglio di calcolo Excel.

GetWorksheetRow API

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

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 file di lavoro.
sheetName	string	path	Nome del foglio di calcolo all’interno del file di lavoro.
rowIndex	integer	path	Indice in base zero della riga da recuperare.
folder	string	query	Cartella contenente il file di lavoro.
storageName	string	query	Nome dello storage in cui risiede il file di lavoro.

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

Puoi 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 con cURL. Includi l’intestazione Authorization: Bearer <jwt token> per autenticare la richiesta.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/0" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

{
  "Row": {
    "GroupLevel": 0,
    "Height": 13.5,
    "Index": 0,
    "IsBlank": false,
    "IsHeightMatched": true,
    "IsHidden": false,
    "Style": {
      "link": {
        "Href": "/style",
        "Rel": "self"
      }
    },
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/cells/rows/0",
      "Rel": "self"
    }
  },
  "Code": 200,
  "Status": "OK"
}

Schema della risposta

Proprietà	Tipo	Descrizione
`GroupLevel`	integer	Livello di raggruppamento della riga (usato per l’aggregazione).
`Height`	number	Altezza della riga in punti.
`Index`	integer	Indice in base zero della riga restituita.
`IsBlank`	boolean	Indica se la riga contiene dati.
`IsHeightMatched`	boolean	`true` se l’altezza della riga corrisponde all’altezza predefinita.
`IsHidden`	boolean	`true` se la riga è nascosta.
`Style`	object	Oggetto contenente le informazioni di stile della riga.
`link`	object	Riferimento ipertestuale alla risorsa riga.
`Code`	integer	Codice di stato HTTP della risposta.
`Status`	string	Descrizione testuale dello stato (ad esempio, “OK”).

Note / Gestione errori: L’API può restituire i seguenti codici di stato HTTP:

200 – Successo; i dati della riga vengono restituiti.
401 – Non autorizzato; il token JWT è mancante o non valido.
404 – Non trovato; il file di lavoro, il foglio di calcolo o la riga specificati non esistono.
500 – Errore interno del server; si è verificata una condizione imprevista.

Codice	Descrizione	Soluzione
200	Successo – dati della riga restituiti.	–
401	Non autorizzato – token JWT mancante o non valido.	Fornire un token JWT valido.
404	Non trovato – file di lavoro, foglio di calcolo o riga mancante.	Verificare i nomi e l’indice della riga.
500	Errore interno del server – condizione imprevista.	Contattare il supporto Aspose.

Per un elenco completo dei codici di errore, consulta la documentazione sui codici di errore di Aspose.Cells Cloud.

Famiglia di SDK Cloud

L’utilizzo di un SDK è il metodo più rapido per lo sviluppo. Un SDK astrae i dettagli di basso livello, consentendoti di concentrarti sulle attività del 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: