Reference

Endpoint Update List Item


Name

update_list_item

Description

No description available

Related Tables

[Dynamic Table] , ListItems

Parameters

Parameter Required Options
Name: ListId

Label: ListId (Re-Enter ListItemId after you change this)

Specify a list id to search items for
YES
Name: ListItemId

Label: ListItemId

Specify a list item id
YES
Name: SiteId

Label: SiteId (Re-Select ListId after you change this)

Specify a site

Output Columns

Label Data Type (SSIS) Data Type (SQL) Length Description
Id DT_WSTR nvarchar(200) 200
CreatedOn DT_DBTIMESTAMP datetime
CreatedById DT_GUID uniqueidentifier
CreatedByDisplayName DT_WSTR nvarchar(200) 200
ModifiedOn DT_DBTIMESTAMP datetime
LastModifiedId DT_GUID uniqueidentifier
LastModifiedDisplayName DT_WSTR nvarchar(200) 200
[Dynamic Column] DT_WSTR nvarchar(2000) 2000 [Dynamic Column]
If the column you are looking for is missing, consider customizing SharePoint Online Connector.

Input Columns

Label Data Type (SSIS) Data Type (SQL) Length Description
Id DT_WSTR nvarchar(200) 200
[Dynamic Column] DT_WSTR nvarchar(2000) 2000 [Dynamic Column]
[Dynamic Column]OdataType DT_WSTR nvarchar(100) 100 [Dynamic Column]@odata\u002Etype must be set as Collection(Edm.String)
[Dynamic Column]LookupId DT_I4 int [Dynamic Column] Id
[Dynamic Column]LookupIdOdataType DT_WSTR nvarchar(100) 100 [Dynamic Column]@odata\u002Etype must be set as Collection(Edm.Int32)
Required columns that you need to supply are bolded.

Examples

SSIS

Use SharePoint Online Connector in API Source or in API Destination SSIS Data Flow components to read or write data.

API Destination

This Endpoint belongs to the [Dynamic Table] table, therefore it is better to use it, instead of accessing the endpoint directly. Use this table and table-operation pair to update list item:

API Destination - SharePoint Online
SharePoint Connector can be used to read, write data in SharePoint Online List / Document Library, perform file operations such as upload, download, create, move, delete, rename in a few clicks!
SharePoint Online
[Dynamic Table]
Update
Required Parameters
ListId (Re-Enter ListItemId after you change this) Fill-in the parameter...
ListItemId Fill-in the parameter...
Optional Parameters
SiteId (Re-Select ListId after you change this)
SSIS API Destination - Access table operation

ODBC application

Use these SQL queries in your ODBC application data source:

Update list item (SharePoint Document Library)

UPDATE update_list_item
SET Title = 'My super title', OrderId = 12345
WITH (ListId='14bdfd1d-1090-4cfe-adc1-XXXXXXXXXXXXX'
     ,ListItemId='775'
     ,Output=1)
--You can get ListId by selecting from 'list_lists' endpoint.
--ListItemId can be retrieved by selecting from 'get_list_items' endpoint.

Update data in a named list

UPDATE MyList
SET Name = 'Elizabeth', Surname = 'Johnson'
WHERE Id = '123'

Update Multi Select Lookup or Person/Group IDs field

UPDATE MyList
SET Title = 'Elizabeth Johnson',
	--Method#1 (Pass type info in the same value)
    ManyPersonsLookupId = '[11,22,33]', "fields.ManyPersonsLookupId@odata\u002Etype" = 'Collection(Edm.Int32)'
    --Method#2 (Pass type info via ODataField)
	--OR--
	--ManyPersonsLookupId = '[11,22,33]',
    --ManyPersonsLookupIdODataType" = 'Collection(Edm.Int32)
	
WHERE Id = '123'

update_list_item endpoint belongs to [Dynamic Table] , ListItems table(s), and can therefore be used via those table(s).

SQL Server

Use these SQL queries in SQL Server after you create a data source in Data Gateway:

Update list item (SharePoint Document Library)

DECLARE @MyQuery NVARCHAR(MAX) = 'UPDATE update_list_item
SET Title = ''My super title'', OrderId = 12345
WITH (ListId=''14bdfd1d-1090-4cfe-adc1-XXXXXXXXXXXXX''
     ,ListItemId=''775''
     ,Output=1)
--You can get ListId by selecting from ''list_lists'' endpoint.
--ListItemId can be retrieved by selecting from ''get_list_items'' endpoint.';

EXEC (@MyQuery) AT [LS_TO_SHAREPOINT_ONLINE_IN_GATEWAY];

Update data in a named list

DECLARE @MyQuery NVARCHAR(MAX) = 'UPDATE MyList
SET Name = ''Elizabeth'', Surname = ''Johnson''
WHERE Id = ''123''';

EXEC (@MyQuery) AT [LS_TO_SHAREPOINT_ONLINE_IN_GATEWAY];

Update Multi Select Lookup or Person/Group IDs field

DECLARE @MyQuery NVARCHAR(MAX) = 'UPDATE MyList
SET Title = ''Elizabeth Johnson'',
	--Method#1 (Pass type info in the same value)
    ManyPersonsLookupId = ''[11,22,33]'', "fields.ManyPersonsLookupId@odata\u002Etype" = ''Collection(Edm.Int32)''
    --Method#2 (Pass type info via ODataField)
	--OR--
	--ManyPersonsLookupId = ''[11,22,33]'',
    --ManyPersonsLookupIdODataType" = ''Collection(Edm.Int32)
	
WHERE Id = ''123''';

EXEC (@MyQuery) AT [LS_TO_SHAREPOINT_ONLINE_IN_GATEWAY];

update_list_item endpoint belongs to [Dynamic Table] , ListItems table(s), and can therefore be used via those table(s).