Importera data till Excel-filer och exportera data från Excel-filer

Aspose.Cells Cloud API stöder import av data från olika källor och kan exportera Excel-arbetsböcker, diagram och andra objekt till olika format, inklusive XLSX, CSV, PDF, HTML, PNG och mer. Detta gör datahantering och delning enkel och effektiv.

API-version: v3.0 – Senast uppdaterad: 2024‑03‑15

Snabbstartsguide

Förbered nyttolasten – Skapa en JSON-body som beskriver import- eller exportalternativen (t.ex. ImportCSVDataOption, ExportOptions).
Skicka begäran – Använd curl, Postman eller ett SDK för att anropa lämplig slutpunkt (POST /cells/import eller POST /cells/export).
Hantera svaret – Vid lyckad import/export får du den bearbetade filen (binär eller Base64). Vid fel inspecterar du HTTP-statuskoden och felmeddelandet i JSON-body:en.

Förutsättningar

Ett aktivt Aspose Cloud-konto och en giltig JWT-token.
Målarbetsboken måste finnas på den angivna lagringsplatsen (för lagringsbaserade API:er).
Rätt Content-Type-headers (multipart/form-data för filuppladdningar, application/json för JSON-body:ar).

Hur man importerar data från olika datakällor

Att importera data till en Excel-fil innebär flera överväganden som måste tas i beaktande under processen. Möjligheten att importera många format och typer av data med professionell kvalitet är en av de främsta funktionerna i Aspose.Cells Cloud.

Information om API:er för dataimport

Följande API:er tillhandahålls för att importera data till en eller flera Excel-filer:

API	Beskrivning
POST /cells/import	Importera data till Excel-filer utan att använda lagring.
POST /cells/{name}/importdata	Importera data till en Excel-fil som finns lagrad i molnet.

Begärparametrar

Utan användning av lagring

Parameter Name	Type	Location	Description
file	file	formData	Fil som ska laddas upp
ImportOption	ImportOptions	body	Anger importformatet (IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData, Picture)

Med användning av lagring

Parameter Name	Type	Location	Description
name	string	path	Namn på Excel-filen
folder	string	query	Mappväg i lagringen
storageName	string	query	Lagringsnamn
importData	ImportOptions	body	Nyttolast för dataimport

Parametrar för importalternativ

De viktigaste parametrarna beskrivs i följande tabeller:

ImportBatchDataOption

Parameter	Type	Description
BatchData	List<CellValue>	Massdata att importera
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	Dataplats när BatchData är null

ImportCSVDataOption

Parameter	Type	Description
ConvertNumericData	boolean	Om numerisk data ska konverteras (true/false)
FirstRow	int	Index för första raden
FirstColumn	int	Index för första kolumnen
SeparatorString	string	Kolumnseparator
DestinationWorksheet	string	Namn på målarbetsbladet
CustomParsers	List<CustomParserConfig>	Anpassade parserkonfigurationer
ImportDataType	string	CSVData
Source	FileSource	Dataplats när BatchData är null

ImportPictureOption

Parameter	Type	Description
FirstRow	int	Index för första raden
FirstColumn	int	Index för första kolumnen
IsVertical	boolean	Om bilden ska placeras vertikalt (true/false)
Data	string[]	Bilddata (Base64-strängar)
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	Picture
Source	FileSource	Dataplats när BatchData är null

Import2DimensionIntArrayOption

Parameter	Type	Description
FirstRow	int	Index för första raden
FirstColumn	int	Index för första kolumnen
Data	int[,]	Tvådimensionell heltalsarray
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	Dataplats när BatchData är null

Import2DimensionDoubleArrayOption

Parameter	Type	Description
FirstRow	int	Index för första raden
FirstColumn	int	Index för första kolumnen
Data	double[,]	Tvådimensionell dubbelarray
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	Dataplats när BatchData är null

Import2DimensionStringArrayOption

Parameter	Type	Description
FirstRow	int	Index för första raden
FirstColumn	int	Index för första kolumnen
Data	string[,]	Tvådimensionell strängarray
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	Dataplats när BatchData är null

ImportIntegerArrayOption

Parameter	Type	Description
FirstRow	int	Index för första raden
FirstColumn	int	Index för första kolumnen
IsVertical	boolean	Om arrayen är vertikal (true/false)
Data	int[]	Endimensionell heltalsarray
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	Dataplats när BatchData är null

ImportDoubleArrayOption

Parameter	Type	Description
FirstRow	int	Index för första raden
FirstColumn	int	Index för första kolumnen
IsVertical	boolean	Om arrayen är vertikal (true/false)
Data	double[]	Endimensionell dubbelarray
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	Dataplats när BatchData är null

ImportStringArrayOption

Parameter	Type	Description
UpperLeftRow	int	Övre vänstra radindex
UpperLeftColumn	int	Övre vänstra kolumnindex
LowerRightRow	int	Nedre högra radindex
LowerRightColumn	int	Nedre högra kolumnindex
Filename	string	Namn på källfilen
Data	string	Strängdata att importera
DestinationWorksheet	string	Namn på målarbetsbladet
IsInsert	boolean	Om data ska infogas (true/false)
ImportDataType	string	StringArray
Source	FileSource	Dataplats när BatchData är null

CellValue

Parameter	Type	Description
rowIndex	int	Radindex för cellen
columnIndex	int	Kolumnindex för cellen
type	string	Data typ för cellvärdet
value	string	Cellvärde
style	Style (object)	Definition av cellstil

FileSource

Parameter	Type	Description
FileSourceType	string	InMemoryFiles, CloudFileSystem eller RequestFiles
FilePath	string	Sökväg till källfilen

Hur man exporterar Excel-objekt till olika filformat

Om du ursprungligen skapade en Excel-fil i ett format såsom XLS, XLSX, XLSB eller CSV, kan du vilja konvertera den till ett annat format för att utnyttja specifika funktioner. Att exportera till PDF skyddar till exempel innehållet från obehöriga ändringar samtidigt som det blir lättare att läsa och dela.

Att exportera Excel-objekt innebär flera överväganden. Aspose.Cells Cloud tillhandahåller högkvalitativ export av arbetsböcker, diagram, former och bilder till ett brett utbud av format:

Endast export-format: PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS.
För import och export: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT.

Begäran använder multipart-innehåll enligt definitionen i [RFC 2046] och [RFC 1341]. Den första delen innehåller datafilen; den andra delen innehåller sparalternativen.

Information om export-API

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

Begärparametrar

Parameter Name	Type	Location	Description
file	file	formData	Fil som ska laddas upp
objectType	string	query	Objekttyp (`workbook`, `worksheet`, `chart`, `shape`, `picture`, `listobject`, `oleobject`)
format	string	query	Önskat utdatafilformat (se Stödda filformat)

OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt som låter dig utföra REST-interaktioner direkt från en webbläsare.

Du kan använda kommandoradsverktyget cURL för att anropa API:et. Exemplet nedan visar en begäran och dess JSON-svar.

Begäran

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'

Svar

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

Vanliga HTTP-statuskoder

Status	Betydelse	Rekommenderad åtgärd
200	Lyckades – filen exporterades	Bearbeta den returnerade filen/n
400	Felaktig begäran – saknade eller ogiltiga parametrar	Verifiera begärans nyttolast och frågesträngar
401	Obehörig – ogiltig eller utgången JWT-token	Uppdatera token och försök igen
404	Inte hittad – den angivna arbetsboken eller arbetsbladet finns inte	Kontrollera filnamn och lagringsväg
500	Internt serverfel – oväntat tillstånd på servern	Kontakta Aspose-support med begärans-ID

Hur man anropar import- och export-API:er

Följande artiklar förklarar varje API i detalj och innehåller cURL- och SDK-exempel:

Sammanfoga och dela Excel-filer Konvertera en Excel-fil till ett annat format eller spara den på ett annat sätt.