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	You may never need to map this field, map only when your metadata is not indexed or you need to give hint for SPO Write operation incase you got 400 Bad request. Possible values can be Collection(Edm.String), Collection(Edm.Int32), ...
[Dynamic Column]LookupId	`DT_I4`	`int`		[Dynamic Column] Id
[Dynamic Column]LookupIdOdataType	`DT_WSTR`	`nvarchar(100)`	100	You may never need to map this field, map only when your metadata is not indexed or you need to give hint for SPO Write operation incase you got 400 Bad request. Possible value is 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).