Excel Writer (XLS)

This Node Is Deprecated — This node is kept for backwards-compatibility, but the usage in new workflows is no longer recommended. The documentation below might contain more information.

This node writes the input data table into a spreadsheet of a workbook. The files can then be read with other applications such as Microsoft Excel.

The node supports two formats chosen by file extension:

  • .xls format: This is the file format which was used by default up until Excel 2003. The maximum number of columns held by a spreadsheet of this format is 256 (all additional columns in the data table are truncated). If the input data table has more than 65536 rows, it is split into multiple spreadsheets (all stored in the created workbook).
  • .xlsx format: The Office Open XML format is the file format used by default from Excel 2007 onwards.

This nodes does not support writing in the 'xlsm' format.

Specifying a remote URL as the destination location will force the node to overwrite this file as it is not possible to determine whether this location already exists. If no extension is specified, the file will be written in the .xlsx format.

Options

Write to
Select a file system which shall store the file you want to write. There are three default file system options to choose from:
  • Local File System: Allows you to select a file/folder from your local system.
  • Mountpoint: Allows you to choose a mountpoint. When selected, a new drop-down menu appears to choose the mountpoint.
  • Custom URL: Allows to specify a URL (e.g. file://, http:// or knime:// protocol). Browsing is disabled for this option.
To write to other file systems, click on ... in the bottom left corner of the node icon followed by Add File System Connection port. Afterwards, connect the desired file system connection node to the newly added input port. The file system connection will then be shown in the drop down menu.
File or URL
Enter a URL when writing to the Custom URL file system, otherwise enter a path to a file. The required syntax of a path depends on the chosen file system, such as "C:\path\to\file" (Local File System on Windows) or "/path/to/file" (Local File System on Linux/MacOS and Mountpoint). For file systems connected via input port, the node description of the respective connector node describes the required path format. You can also choose a previously selected file from the drop-down list, or select a destination from the "Browse..." dialog (browsing is not available for the Custom URL file system).
Overwrite existing file
Existing files will be overwritten if this option is enabled. Otherwise the node will fail during execution to retain the original file and to avoid unintentional overwrite. Remote locations will always be overwritten.
Open file after execution
Opens the file after it has been successfully created. The file will be opened in the default application of the system. This might not be supported by every system and is not available for remote locations.
Sheet name
Name of the sheet that will be created. If left empty, the name of the input table will be used.
Write column header
If checked, the column names are written out in the first row of the spreadsheet.
Write row ID
If checked, the row IDs are added to the output, in the first column of the spreadsheet.
Missing Value Pattern
Enter a pattern that is used for missing data values. If not specified, the corresponding data cell of the spreadsheet stays empty.
Autosize columns
Fits each column's width to its content.
Portrait/Landscape
Sets the print format to portrait or landscape.
Paper size
Sets the paper size in the print setup.
Exclude/Include columns
Select the columns that will be written in the file. If the columns in the input table should change, they will automatically be excluded.

Input Ports

Icon
The data table to write out.
Icon
The file system connection.

Output Ports

This node has no output ports

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.