Importare dati in file Excel ed esportare dati da file Excel

L’API Aspose.Cells Cloud supporta l’importazione di dati da una vasta gamma di origini e consente di esportare cartelle di lavoro Excel, grafici e altri oggetti in diversi formati, tra cui XLSX, CSV, PDF, HTML, PNG e altri. Ciò rende la gestione e la condivisione dei dati semplici ed efficienti.

Versione API: v3.0 – Ultimo aggiornamento: 2024‑03‑15

Guida rapida

Preparare il payload – Costruire un corpo JSON che descriva le opzioni di importazione o esportazione (ad esempio ImportCSVDataOption, ExportOptions).
Inviare la richiesta – Utilizzare curl, Postman o un SDK per chiamare l’endpoint appropriato (POST /cells/import o POST /cells/export).
Gestire la risposta – In caso di successo, riceverai il file elaborato (binario o in Base64). In caso di errore, esamina il codice di stato HTTP e il messaggio di errore restituito nel corpo JSON.

Prerequisiti

Un account Aspose Cloud attivo e un token JWT valido.
La cartella di lavoro di destinazione deve esistere nella posizione di archiviazione specificata (per le API basate su archiviazione).
Intestazioni Content‑Type corrette (multipart/form-data per il caricamento di file, application/json per i corpi JSON).

Come importare dati da varie fonti

L’importazione di dati in un file Excel coinvolge diverse considerazioni che devono essere affrontate durante il processo. La capacità di importare molti formati e tipi di dati con qualità professionale è una caratteristica principale di Aspose.Cells Cloud.

Informazioni sulle API di importazione dati

Le seguenti API sono fornite per importare dati in uno o più file Excel:

API	Descrizione
POST /cells/import	Importa dati in file Excel senza utilizzare l’archiviazione.
POST /cells/{name}/importdata	Importa dati in un file Excel archiviato nel cloud.

Parametri della richiesta

Senza utilizzare l’archiviazione

Nome parametro	Tipo	Posizione	Descrizione
file	file	formData	File da caricare
ImportOption	ImportOptions	body	Specifica il formato di importazione (IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData, Picture)

Con utilizzo dell’archiviazione

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file Excel
folder	string	query	Percorso della cartella nell’archiviazione
storageName	string	query	Nome dell’archiviazione
importData	ImportOptions	body	Payload dei dati da importare

Parametri dell’opzione di importazione dati

I parametri importanti sono descritti nelle seguenti tabelle:

ImportBatchDataOption

Parametro	Tipo	Descrizione
BatchData	List<CellValue>	Dati in blocco da importare
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	Posizione del file di dati quando BatchData è null

ImportCSVDataOption

Parametro	Tipo	Descrizione
ConvertNumericData	boolean	Indica se convertire i dati numerici (true/false)
FirstRow	int	Indice della prima riga
FirstColumn	int	Indice della prima colonna
SeparatorString	string	Separatore di colonna
DestinationWorksheet	string	Nome del foglio di destinazione
CustomParsers	List<CustomParserConfig>	Configurazioni dei parser personalizzati
ImportDataType	string	CSVData
Source	FileSource	Posizione del file di dati quando BatchData è null

ImportPictureOption

Parametro	Tipo	Descrizione
FirstRow	int	Indice della prima riga
FirstColumn	int	Indice della prima colonna
IsVertical	boolean	Indica se l'immagine è posizionata verticalmente (true/false)
Data	string[]	Dati immagine (stringhe in base64)
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	Picture
Source	FileSource	Posizione del file di dati quando BatchData è null

Import2DimensionIntArrayOption

Parametro	Tipo	Descrizione
FirstRow	int	Indice della prima riga
FirstColumn	int	Indice della prima colonna
Data	int[,]	Array bidimensionale di interi
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	Posizione del file di dati quando BatchData è null

Import2DimensionDoubleArrayOption

Parametro	Tipo	Descrizione
FirstRow	int	Indice della prima riga
FirstColumn	int	Indice della prima colonna
Data	double[,]	Array bidimensionale di numeri in virgola mobile
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	Posizione del file di dati quando BatchData è null

Import2DimensionStringArrayOption

Parametro	Tipo	Descrizione
FirstRow	int	Indice della prima riga
FirstColumn	int	Indice della prima colonna
Data	string[,]	Array bidimensionale di stringhe
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	Posizione del file di dati quando BatchData è null

ImportIntegerArrayOption

Parametro	Tipo	Descrizione
FirstRow	int	Indice della prima riga
FirstColumn	int	Indice della prima colonna
IsVertical	boolean	Indica se l'array è verticale (true/false)
Data	int[]	Array unidimensionale di interi
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	Posizione del file di dati quando BatchData è null

ImportDoubleArrayOption

Parametro	Tipo	Descrizione
FirstRow	int	Indice della prima riga
FirstColumn	int	Indice della prima colonna
IsVertical	boolean	Indica se l'array è verticale (true/false)
Data	double[]	Array unidimensionale di numeri in virgola mobile
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	Posizione del file di dati quando BatchData è null

ImportStringArrayOption

Parametro	Tipo	Descrizione
UpperLeftRow	int	Indice della riga superiore sinistra
UpperLeftColumn	int	Indice della colonna superiore sinistra
LowerRightRow	int	Indice della riga inferiore destra
LowerRightColumn	int	Indice della colonna inferiore destra
Filename	string	Nome del file di origine
Data	string	Dati stringa da importare
DestinationWorksheet	string	Nome del foglio di destinazione
IsInsert	boolean	Indica se inserire i dati (true/false)
ImportDataType	string	StringArray
Source	FileSource	Posizione del file di dati quando BatchData è null

CellValue

Parametro	Tipo	Descrizione
rowIndex	int	Indice di riga della cella
columnIndex	int	Indice di colonna della cella
type	string	Tipo di dati del valore della cella
value	string	Valore della cella
style	Style (object)	Definizione dello stile della cella

FileSource

Parametro	Tipo	Descrizione
FileSourceType	string	InMemoryFiles, CloudFileSystem o RequestFiles
FilePath	string	Percorso del file di origine

Come esportare oggetti Excel in diversi formati file

Se hai creato inizialmente un file Excel in un formato come XLS, XLSX, XLSB o CSV, potresti volerlo convertire in un altro formato per sfruttare funzionalità specifiche. Ad esempio, esportando in PDF si protegge il contenuto da modifiche non autorizzate, rendendolo al contempo facile da leggere e condividere.

L’esportazione di oggetti Excel comporta diverse considerazioni. Aspose.Cells Cloud fornisce un’alta qualità di esportazione di cartelle di lavoro, grafici, forme e immagini in una vasta gamma di formati:

Formati solo per esportazione: PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS.
Formati sia per importazione che per esportazione: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT.

La richiesta utilizza contenuto multipart come definito in [RFC 2046] e [RFC 1341]. La prima parte contiene il file di dati; la seconda parte contiene le opzioni di salvataggio.

Informazioni sull’API di esportazione

POST https://api.aspose.cloud/v3.0/cells/export

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
file	file	formData	File da caricare
objectType	string	query	Tipo di oggetto (`workbook`, `worksheet`, `chart`, `shape`, `picture`, `listobject`, `oleobject`)
format	string	query	Formato di output desiderato (vedi Formati file supportati)

La Specifiche OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile che consente di eseguire interazioni REST direttamente da un browser web.

Puoi utilizzare lo strumento a riga di comando cURL per chiamare l’API. L’esempio seguente mostra una richiesta e la relativa risposta JSON.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/export" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'file1=@example1.xlsx' \
  -F 'file2=@example2.xlsx'

Risposta

{
  "Files": [
    {
      "Filename": "example1.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "example2.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Codici di stato HTTP comuni

Stato	Significato	Azione consigliata
200	Successo – il file è stato esportato	Elaborare il/i file restituito/i
400	Richiesta non valida – parametri mancanti o non validi	Verificare il payload della richiesta e le stringhe di query
401	Non autorizzato – token JWT non valido o scaduto	Aggiornare il token e riprovare
404	Non trovato – la cartella di lavoro o il foglio specificati non esistono	Verificare il nome del file e il percorso di archiviazione
500	Errore interno del server – condizione imprevista sul server	Contattare il supporto Aspose con l’ID della richiesta

Come chiamare le API di importazione ed esportazione

I seguenti articoli spiegano dettagliatamente ciascuna API e contengono esempi cURL e SDK:

Unisci e Dividi File Excel Converti un file Excel in un altro formato o salvalo in modo diverso.