Daten in Excel-Dateien importieren und Daten aus Excel-Dateien exportieren

Die Aspose.Cells Cloud API unterstützt den Import von Daten aus einer Vielzahl von Quellen und kann Excel-Arbeitsmappen, Diagramme und andere Objekte in verschiedene Formate exportieren, darunter XLSX, CSV, PDF, HTML, PNG und mehr. Dies macht das Datenmanagement und die Datenteilung einfach und effizient.

API-Version: v3.0 – Letzte Aktualisierung: 2024‑03‑15

Schnellstartanleitung

Payload vorbereiten – Erstellen Sie einen JSON-Body, der die Import- oder Exportoptionen beschreibt (z. B. ImportCSVDataOption, ExportOptions).
Anfrage senden – Verwenden Sie curl, Postman oder ein SDK, um den entsprechenden Endpunkt aufzurufen (POST /cells/import oder POST /cells/export).
Antwort verarbeiten – Bei Erfolg erhalten Sie die verarbeitete Datei (binär oder Base64). Bei einem Fehler prüfen Sie den HTTP-Statuscode sowie die im JSON-Body zurückgegebene Fehlermeldung.

Voraussetzungen

Ein aktives Aspose Cloud-Konto und ein gültiges JWT-Token.
Die Zielarbeitsmappe muss im angegebenen Speicherort vorhanden sein (für speicherbasierte APIs).
Richtiges Content-Type-Header („multipart/form-data“ für Datei-Uploads, „application/json“ für JSON-Body).

Daten aus verschiedenen Datenquellen importieren

Das Importieren von Daten in eine Excel-Datei erfordert verschiedene Überlegungen, die während des Vorgangs berücksichtigt werden müssen. Die Fähigkeit, viele Formate und Arten von Daten mit professioneller Qualität zu importieren, ist eine der wichtigsten Funktionen von Aspose.Cells Cloud.

API-Informationen zum Datenimport

Folgende APIs stehen zum Importieren von Daten in eine oder mehrere Excel-Dateien zur Verfügung:

API	Beschreibung
POST /cells/import	Daten in Excel-Dateien importieren, ohne Speicher zu verwenden.
POST /cells/{name}/importdata	Daten in eine Excel-Datei importieren, die in der Cloud gespeichert ist.

Anforderungsparameter

Ohne Verwendung von Speicher

Parametername	Typ	Position	Beschreibung
file	Datei	formData	Hochzuladende Datei
ImportOption	ImportOptions	body	Gibt das Importformat an (IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData, Picture)

Mit Verwendung von Speicher

Parametername	Typ	Position	Beschreibung
name	string	path	Name der Excel-Datei
folder	string	query	Ordnerpfad im Speicher
storageName	string	query	Name des Speichers
importData	ImportOptions	body	Nutzdaten für den Datenimport

Parameter für die Importoption

Die wichtigsten Parameter sind in den folgenden Tabellen beschrieben:

ImportBatchDataOption

Parameter	Typ	Beschreibung
BatchData	List<CellValue>	Zu importierende Stapeldaten
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

ImportCSVDataOption

Parameter	Typ	Beschreibung
ConvertNumericData	boolean	Gibt an, ob numerische Daten konvertiert werden sollen (true/false)
FirstRow	int	Index der ersten Zeile
FirstColumn	int	Index der ersten Spalte
SeparatorString	string	Spaltentrennzeichen
DestinationWorksheet	string	Name des Zielblatts
CustomParsers	List<CustomParserConfig>	Benutzerdefinierte Parserkonfigurationen
ImportDataType	string	CSVData
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

ImportPictureOption

Parameter	Typ	Beschreibung
FirstRow	int	Index der ersten Zeile
FirstColumn	int	Index der ersten Spalte
IsVertical	boolean	Gibt an, ob das Bild vertikal platziert wird (true/false)
Data	string[]	Bilddaten (Base64-Zeichenfolgen)
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	Picture
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

Import2DimensionIntArrayOption

Parameter	Typ	Beschreibung
FirstRow	int	Index der ersten Zeile
FirstColumn	int	Index der ersten Spalte
Data	int[,]	Zweidimensionales ganzzahliges Array
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

Import2DimensionDoubleArrayOption

Parameter	Typ	Beschreibung
FirstRow	int	Index der ersten Zeile
FirstColumn	int	Index der ersten Spalte
Data	double[,]	Zweidimensionales Double-Array
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

Import2DimensionStringArrayOption

Parameter	Typ	Beschreibung
FirstRow	int	Index der ersten Zeile
FirstColumn	int	Index der ersten Spalte
Data	string[,]	Zweidimensionales String-Array
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

ImportIntegerArrayOption

Parameter	Typ	Beschreibung
FirstRow	int	Index der ersten Zeile
FirstColumn	int	Index der ersten Spalte
IsVertical	boolean	Gibt an, ob das Array vertikal ist (true/false)
Data	int[]	Eindimensionales ganzzahliges Array
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

ImportDoubleArrayOption

Parameter	Typ	Beschreibung
FirstRow	int	Index der ersten Zeile
FirstColumn	int	Index der ersten Spalte
IsVertical	boolean	Gibt an, ob das Array vertikal ist (true/false)
Data	double[]	Eindimensionales Double-Array
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

ImportStringArrayOption

Parameter	Typ	Beschreibung
UpperLeftRow	int	Index der oberen linken Zeile
UpperLeftColumn	int	Index der oberen linken Spalte
LowerRightRow	int	Index der unteren rechten Zeile
LowerRightColumn	int	Index der unteren rechten Spalte
Filename	string	Name der Quelldatei
Data	string	Zu importierende Zeichenfolgendaten
DestinationWorksheet	string	Name des Zielblatts
IsInsert	boolean	Gibt an, ob Daten eingefügt werden sollen (true/false)
ImportDataType	string	StringArray
Source	FileSource	Speicherort der Datendatei, wenn BatchData null ist

CellValue

Parameter	Typ	Beschreibung
rowIndex	int	Zeilenindex der Zelle
columnIndex	int	Spaltenindex der Zelle
type	string	Datentyp des Zellwerts
value	string	Zellwert
style	Style (Objekt)	Zellstildefinition

FileSource

Parameter	Typ	Beschreibung
FileSourceType	string	InMemoryFiles, CloudFileSystem oder RequestFiles
FilePath	string	Pfad zur Quelldatei

Excel-Objekte in verschiedene Dateiformate exportieren

Wenn Sie eine Excel-Datei ursprünglich in einem Format wie XLS, XLSX, XLSB oder CSV erstellt haben, möchten Sie diese möglicherweise in ein anderes Format konvertieren, um bestimmte Funktionen zu nutzen. Beispielsweise schützt der Export in PDF den Inhalt vor unbefugten Änderungen und macht ihn gleichzeitig einfach lesbar und teilbar.

Beim Exportieren von Excel-Objekten sind verschiedene Faktoren zu berücksichtigen. Aspose.Cells Cloud bietet qualitativ hochwertigen Export von Arbeitsmappen, Diagrammen, Formen und Bildern in eine Vielzahl von Formaten:

Nur-Export-Formate: PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS.
Sowohl Import als auch Export: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT.

Die Anfrage nutzt mehrteiligen Inhalt gemäß [RFC 2046] und [RFC 1341]. Der erste Teil enthält die Datendatei; der zweite Teil enthält die Speicheroptionen.

API-Informationen zum Export

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

Anforderungsparameter

Parametername	Typ	Position	Beschreibung
file	Datei	formData	Hochzuladende Datei
objectType	string	query	Objekttyp (`workbook`, `worksheet`, `chart`, `shape`, `picture`, `listobject`, `oleobject`)
format	string	query	Gewünschtes Ausgabedateiformat (siehe Unterstützte Dateiformate)

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle, mit der Sie REST-Interaktionen direkt aus einem Webbrowser durchführen können.

Sie können das cURL-Befehlszeilentool verwenden, um die API aufzurufen. Das folgende Beispiel zeigt eine Anfrage und ihre JSON-Antwort.

Anforderung

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'

Antwort

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

Häufige HTTP-Statuscodes

Status	Bedeutung	Empfohlene Aktion
200	Erfolg – die Datei wurde exportiert	Zurückgegebene Datei(en) verarbeiten
400	Ungültige Anforderung – fehlende oder ungültige Parameter	Anforderungsnutzlast und Abfragezeichenfolgen prüfen
401	Nicht autorisiert – ungültiges oder abgelaufenes JWT-Token	Token aktualisieren und erneut versuchen
404	Nicht gefunden – die angegebene Arbeitsmappe oder das angegebene Blatt existiert nicht	Dateinamen und Speicherpfad überprüfen
500	Interner Serverfehler – unerwarteter Zustand auf dem Server	Aspose-Support mit der Anforderungs-ID kontaktieren

Import- und Export-APIs aufrufen

Die folgenden Artikel erläutern jede API im Detail und enthalten cURL- und SDK-Beispiele:

Excel-Dateien zusammenführen und teilen Konvertieren einer Excel-Datei in ein anderes Format oder Speichern unter einem anderen Namen.