Importa array di stringhe in un foglio di lavoro Excel – Aspose.Cells Cloud
Importare un array di stringhe in un foglio di lavoro Excel è un’operazione comune quando si popolano fogli elettronici con dati strutturati in elenco. Questa operazione risulta utile in scenari come il caricamento di valori di configurazione, il trasferimento di dati da fonti esterne o l’inizializzazione di fogli di lavoro con raccolte predefinite di stringhe.
Prerequisiti:
- Un token JWT valido ottenuto tramite il flusso di autenticazione di Aspose.Cells Cloud.
- Un foglio di lavoro esistente (o la capacità di crearne uno) nella memoria di Aspose Cloud.
- La versione appropriata dell’SDK che supporta il modello
ImportStringArrayOption.
Questa API REST importa dati di tipo array di stringhe in un foglio di lavoro Excel.
API PostImportData
POST https://api.aspose.cloud/v3.0/cells/import
Sicurezza e autenticazione
Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.
Parametri della richiesta
La richiesta utilizza contenuto HTTP multipart (vedi RFC 2046 o RFC 1341).
La prima parte del corpo multipart contiene un payload ImportStringArrayOption; la seconda parte contiene il file sorgente dei dati.
I parametri importanti sono descritti nella tabella seguente:
| Nome parametro | Tipo | Descrizione |
|---|---|---|
| FirstRow | int | L’indice della riga iniziale (1-based) in cui verranno inseriti i dati. |
| FirstColumn | int | L’indice della colonna iniziale (1-based) in cui verranno inseriti i dati. |
| IsVertical | boolean | true per inserire i dati verticalmente; false per inserirli orizzontalmente. |
| Data | String[] | L’array di stringhe da importare. |
| DestinationWorksheet | string | Il nome del foglio di lavoro che riceverà i dati. |
| IsInsert | boolean | true per inserire righe/colonne (spostando le celle esistenti); false per sovrascrivere le celle esistenti. |
| ImportDataType | string | Tipo di dati da importare (ad esempio IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData). |
| Source | FileSource | Descrive la posizione del file di dati quando BatchData è null (ad esempio CloudFileSystem, LocalFile). Obbligatorio se BatchData non è fornito. |
Esempio
<ImportStringArrayOption>
<DestinationWorksheet>Sheet1</DestinationWorksheet>
<IsInsert>false</IsInsert>
<ImportDataType>StringArray</ImportDataType>
<FirstRow>1</FirstRow>
<FirstColumn>1</FirstColumn>
<IsVertical>true</IsVertical>
<Source>
<FileSourceType>CloudFileSystem</FileSourceType>
<FilePath>Array_string_xml.txt</FilePath>
</Source>
</ImportStringArrayOption>
Risposta
Una richiesta riuscita restituisce HTTP 200 con un payload JSON simile al seguente:
{
"Code": 200,
"Status": "OK"
}
Codici di stato possibili:
| Codice | Significato |
|---|---|
| 200 | Importazione riuscita |
| 400 | Richiesta non valida – dati mancanti o errati |
| 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 pubblicamente accessibile e consentono di effettuare interazioni REST direttamente da un browser web.
Utilizzare gli SDK di Aspose.Cells Cloud
L’utilizzo di 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 chiamare i servizi web di Aspose.Cells utilizzando vari SDK: