Reflects the current release of Nintex for SharePoint 2016. For your version, please access assistance through the Help button in the product.

SharePoint update items

Nintex external platform is required for this feature. For details, see Enable Nintex external platform features.

Updates existing list items in a SharePoint 2010, SharePoint 2013, or Office 365 SharePoint site.

Note: Not available for SharePoint 2007 sites.

Action settings

Following are the fields and options visible in the configuration settings dialog box for this action.

Section Field Description

(unlabeled)

 Destination site URL

The URL of the destination site where the items to be updated are located.

 

 List name

The name of the list or containing the items.

 

 Items to update

Specify a query to determine which items are to be updated, specify whether or not to update items within subfolders, and add filters to the query.

  • Query builder: Build a query to filter for items to update. View the CAML at any time by switching to the CAML Editor mode.

  • CAML editor: Create a more advanced query using XML encoding.

Select or clear the following check boxes.

  • Include subfolders: When selected, updates items within subfolders.

Filters: Specify the criteria that items must match for the permission to be updated. Select one of the following options.

  • Update all list items: Updates all items in the list or document library.
  • Update items only when the following is true: Updates an item based on the values set in the column.

    • Update the items when column / When column: Specify a column, select an operator, and specify a value.

    • Add filter rule: Add a filter.
    • Delete (): Delete a filter. Displayed for second and subsequent filters.

    • And / Or: Specify how to group sequential filters.

      Note: All items returned from the filter are updated.

 

 Fields to update

Specify fields.

  • Builder: Update the item fields using the UI builder or view fields to be updated in UI builder mode.

    To add a field, click Add field and specify field, type, and value.

    • Field
    • Type

    • Value

    To delete a field, click Delete ().

    To view the XML, click XML.

  • XML: Update the item fields using XML encoding or view fields to be updated in XML mode.

Credentials

Authentication mode The mode to authenticate against the destination site.

 

 Username

Specify a username with permissions to update the items in the destination site.

 

 Password

Specify the password for the above username.

 

Domain or SharePoint Online website domain

Specify the domain for the username if using Windows authentication mode, or specify the SharePoint Online domain URL if connecting to an Office 365 SharePoint Online site.

(unlabeled)

Output

Store output for this action using the following selections.

  • All matched items updated: Specify a Yes/No variable to store whether or not all matched items have been updated. Returns "Yes" if all matched items were successfully updated.
  • List item ID: Specify a collection variable to store list item IDs of the items updated.
  • List item URL: Specify a collection variable to store list item URLs to the items updated.
ClosedHow to add and remove output variables

Depending on action requirements, you may be able to add and remove output variables.

To add an output variable

  1. Select an option from the Select more drop-down list.
  2. Click Add to display a drop-down list for the selected option.
  3. Select a previously defined workflow variable from the drop-down list.

To remove an output variable

  • Click Delete ().

    Note: Some output variables cannot be deleted. For example, the output variable URL for the action Bing news search cannot be deleted.