Importa array di interi in un foglio di lavoro Excel – API Aspose.Cells Cloud
Questa REST API importa un array di interi in un foglio di lavoro Excel.
La richiesta deve essere una POST HTTP con contenuto multipart (vedi RFC 2046 o RFC 1341). La prima parte del corpo multipart contiene il payload JSON ImportIntegerArrayOption, mentre la seconda parte contiene il file di dati sorgente (ad esempio, un file CSV o un file Excel binario).
API PostImportData
POST https://api.aspose.cloud/v3.0/cells/import
Entrambi gli endpoint accettano lo stesso payload multipart. Il primo endpoint esegue un’operazione di importazione generica, mentre il secondo si concentra su un workbook specifico identificato da {name}.
Sicurezza e autenticazione
Le API di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione tramite token JWT.
Parametri della richiesta
ImportIntegerArrayOption
| Nome parametro | Tipo | Descrizione |
|---|---|---|
| FirstRow | int | Indice in base zero della prima riga in cui verranno posizionati i dati. |
| FirstColumn | int | Indice in base zero della prima colonna in cui verranno posizionati i dati. |
| IsVertical | boolean | true per inserire l’array verticalmente (giù per una colonna); false per inserirlo orizzontalmente (attraverso una riga). |
| Data | Integer[] | L’array di interi da importare. |
| DestinationWorksheet | string | Nome del foglio di lavoro che riceverà i dati. |
| IsInsert | boolean | true per inserire righe/colonne prima di scrivere i dati; false per sovrascrivere le celle esistenti. |
| ImportDataType | string | Tipo di dati da importare. Valori validi: IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData. |
| Source | FileSource | Indica la posizione del file di dati quando il parametro BatchData è null. |
Esempio di corpo della richiesta
{
"Data": [1, 2, 4],
"DestinationWorksheet": "Sheet1",
"FirstRow": 1,
"FirstColumn": 2,
"IsVertical": true,
"IsInsert": true,
"ImportDataType": "IntArray"
}
Risposta
Una richiesta riuscita restituisce HTTP 200 con un payload JSON simile a:
{
"Code": 200,
"Status": "OK"
}
Codici di stato possibili:
| Codice | Significato |
|---|---|
| 200 | Importazione riuscita |
| 400 | Richiesta non valida – dati mancanti o non validi |
| 401 | Non autorizzato – token non valido o mancante |
| 500 | Errore interno del server |
Come utilizzare l’API PostImportData con gli SDK
Specifica dell’API PostImportData
La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.
Utilizzo degli SDK di Aspose.Cells Cloud
L’utilizzo di un SDK è il modo più rapido per integrare questa funzionalità. Gli SDK astraggono i dettagli di basso livello, consentendoti di concentrarti sulla logica di business. Consulta la repository GitHub per l’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: