SharePoint Online List Updater

Updates rows in a SharePoint Online list based on their ID.

Notes:

  • Updating more than a few hundred items can take long time.
  • When updating a 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.
    This node will not perform any type checking when appending values. Unlike the specific error messages when writing a new row, the SharePoint API only returns a generic 400 Invalid Request code if the types in the existing list do not match the types this node tries to write. Please check the input types if you receive such an error.
  • Any list columns which are not present in the table will be left as they are. A missing value will clear the respective cell.

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 Online.

Options

Settings

SharePoint site
There are three ways to specify SharePoint site:
  • Root site: Connect to the root site of the domain of the current user (see "Microsoft Connection" input port).
  • Web URL: Specify the web URL of a SharePoint site, for example https://mycompany.sharepoint.com.
  • Group site: Connect to the team site of a particular Office 365 group.
Subsite
If checked, then connect to a (nested) subsite of the SharePoint site specified above. Use the "Refresh" button to list all available subsites of the chosen SharePoint site. Note that this allows you only to access the document libraries of the subsite, not those of the parent site(s).
SharePoint list
Here you can select the list you want to update. The drop down menu shows the display name of the list and the internal name it in parentheses.
ID column
A string column from the input table that specifies the list item IDs to update. The list item IDs can be retrieved using the SharePoint Online List Reader, which outputs a string column called “ID”.

Advanced

Connection timeout in seconds
Timeout in seconds to establish a connection or 0 for an infinite timeout.
Read timeout in seconds
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

Popular Predecessors

  • No recommendations found

Popular Successors

  • No recommendations found

Views

This node has no views

Workflows

  • No workflows found

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.