Skip to content

XLSX File

Reads and writes data from a XLS/XLSX file.

Categories: helpers

Type: xlsxFile/v1


Actions

Read from File

Name: read

Reads data from a XLS/XLSX file.

Properties

NameLabelTypeDescriptionRequired
fileEntryFileFILE_ENTRYThe object property which contains a reference to the XLS/XLSX file to read from.true
sheetNameSheet NameSTRINGThe name of the sheet to read from in the spreadsheet. If not set, the first one gets chosen.null
headerRowHeader RowBOOLEAN
Options true, false
The first row of the file contains the header names.null
includeEmptyCellsInclude Empty CellsBOOLEAN
Options true, false
When reading from file the empty cells will be filled with an empty string.null
pageSizePage SizeINTEGERThe amount of child elements to return in a page.null
pageNumberPage NumberINTEGERThe page number to get.null
readAsStringRead As StringBOOLEAN
Options true, false
In some cases and file formats, it is necessary to read data specifically as string, otherwise some special characters are interpreted the wrong way.null

Example JSON Structure

{
"label" : "Read from File",
"name" : "read",
"parameters" : {
"fileEntry" : {
"extension" : "",
"mimeType" : "",
"name" : "",
"url" : ""
},
"sheetName" : "",
"headerRow" : false,
"includeEmptyCells" : false,
"pageSize" : 1,
"pageNumber" : 1,
"readAsString" : false
},
"type" : "xlsxFile/v1/read"
}

Output

The output for this action is dynamic and may vary depending on the input parameters. To determine the exact structure of the output, you need to execute the action.

Write to File

Name: write

Writes the data to a XLS/XLSX file.

Properties

NameLabelTypeDescriptionRequired
sheetNameSheet NameSTRINGThe name of the sheet to create in the spreadsheet.null
rowsRowsARRAY
Items [{}]
The array of rows to write to the file.true
filenameFilenameSTRINGFilename to set for binary data. By default, “file.xlsx” will be used.true

Example JSON Structure

{
"label" : "Write to File",
"name" : "write",
"parameters" : {
"sheetName" : "",
"rows" : [ { } ],
"filename" : ""
},
"type" : "xlsxFile/v1/write"
}

Output

Type: FILE_ENTRY

Properties

NameTypeDescription
extensionSTRING
mimeTypeSTRING
nameSTRING
urlSTRING

Output Example

{
"extension" : "",
"mimeType" : "",
"name" : "",
"url" : ""
}