SharePoint List Writer

This node writes a KNIME table to a SharePoint list.

Notes:

  • Writing tables with more than a few hundred rows can take long time. Overwriting an existing table can be also very slow in case a lot of rows need to be deleted.
  • When appending data to an existing list, the name of the input table columns are matched to the display names of the respective columns in the SharePoint list. In this process read-only columns are ignored. If multiple list columns have the same display name, the first will be chosen. The node will fail if there is no list column matching a specific table column or if a required list column is not present in the input table. Any list columns which are not present in the table will be populated with their default value by SharePoint.
    This node will not perform any type checking when appending values.
  • The default "Title" column of the list (which may have a different display name) is used by this node to store the RowID. Use a RowID node to specify a custom one. If a column with the same name is already present in the input table, it will be mapped to a (new) column with the same display name.
  • If an input table contains columns whose name are already used by read-only system columns, the node will create new writable list columns of the same name when creating a new list or overwriting an existing one.
  • This node exports the ID of the written list to a flow variable called sharepoint_list_id. The ID can be used in subsequent nodes to control the listId setting via flow variable.

KNIME column type support

Fully supported KNIME column types:

Partially supported KNIME columns types:

  • Long columns map to Number . The node will fail for more than 15 significant digits (digits which remain after leading and trailing zeros are removed, i.e. in "401220500000" the digits "4012205" are significant and in "0.0004050114" the digits "4050114" are significant).
  • Double columns map to Number . The node will fail for infinity, NaN and values outside of [1.79E308,-1.79E308], as well as for numbers with more than 15 significant digits.
  • Local Date and Local Date Time columns map to Date and Time , which stores a UTC timestamp with second-precision. Hence, values from KNIME are mapped to an instant in UTC and truncated to second-precision. For example, 2022-02-02 08:00:00 is stored as 2022-02-02 08:00:00 UTC. The node will fail for values before 1900-01-01 00:00:00 UTC and after 8900-12-31 23:59:59 UTC.
  • Zoned Date Time columns map to Date and Time , which stores a UTC timestamp with second-precision. Hence, Zoned Date Time values are converted to the UTC timezone and truncated to second-precision. For example, 2022-02-02 08:00:00 CET is stored as 2022-02-02 07:00:00 UTC. The node will fail for values before 1900-01-01 00:00:00 UTC and after 8900-12-31 23:59:59 UTC.

Unsupported KNIME column types:
All column types that do not belong to the above categories are unsupported and the node cannot be executed, since there is no corresponding type in SharePoint.

Options

Connect via
Select how to connect to the SharePoint site.
  • Root site: Connect to the root site of the domain of the current user
  • Web URL: Specify the web URL of a SharePoint site.
  • Group site: Connect to the team site of a particular Office 365 group.
URL
The web URL of the SharePoint site, for example https://mycompany.sharepoint.com
Group
The Office 365 group whose team site to connect to.
Connect to subsite
A (nested) subsite of the SharePoint site specified above. If selected, the node will connect to the subsite instead of the parent site. Note that access is limited to content of the subsite, not those of the parent site(s).
List mode
Specify whether to select an existing list or create a new one.
  • Select: Select an already existing list.
  • Create: Use the first list with the specified display name. If no such list exists, create one.
List
An existing SharePoint list. The drop down menu shows lists in the format <display-name> (<internal-name>). The display name is a user-chosen name that is editable in SharePoint, whereas the internal name is fixed and auto-generated by SharePoint. The node stores a unique technical ID which is used to find the list.
List name
The display name of the list to use. If no such list exists, it will be created. The list will be matched by its display name only. If there are multiple lists with the same name, the first one returned by the API will be used, which may lead to unexpected results if the list is renamed in SharePoint. Thus it is best to use “select” mode if the list exists or was created by a previous execution of this node.
List write mode
How to write to the selected list.
  • Append: Append the data at the bottom of the list. There are limitations to appending. Please check the note in the node introduction for more information.
  • Overwrite: Overwrite the list by removing all columns and items beforehand.
If list already exists
How to handle the situation when a list with the same name already exists.
  • Fail: Fail node execution if an list already exists.
  • Append: If the list already exists, the data will be appended at the bottom of the list. There are limitations to appending. Please check the note in the node introduction for more information.
  • Overwrite: Overwrite an existing list by removing all columns and items beforehand.
Connection timeout in seconds
The timeout in seconds to establish a connection, or 0 for an infinite timeout.
Read timeout in seconds
The timeout in seconds to read data from an established connection, or 0 for an infinite timeout.

Input Ports

Icon
A JWT credential as provided by the Microsoft Authenticator node.
Icon
The table to be written to SharePoint.

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.