Delete a SharePoint List Item

Delete List Items Configuration Screen

Good to Know

• In most text fields, you can use process data variables as an alternative to literal data values.

How to Start

1. On the Organizer, do one of these:
   • Open a process.
   • Create a process.
2. Do one of these:
   • Add an activity:
     1. In the Process Builder, go to the Activity Library, and open the SharePoint tab.
     2. On the SharePoint tab, drag the Delete List Item activity onto your process.
   • Change an activity:
     1. In your process, double-click your activity.
3. Click Delete List Item Configuration .

Procedure

1. To configure your settings to delete a SharePoint list item, complete these fields as necessary.

   Field Name	Definition
   SharePoint	Function: Specifies the access token that connects to your SharePoint site. Accepted Values: A list of access tokens configured for your environment. Default Value: None Accepts Process Data Variables: No
   Add Token	Opens this Screen: New SharePoint Access Token Function of this Screen: Configures a new access token for SharePoint.
   Site	Function: Specifies the URL for your SharePoint site. Accepted Values: A valid SharePoint site URL A process data variable Default Value: None Accepts Process Data Variables: Yes Example: http://[machine name]:[port]/sites/[site name] You must include the /sites in the Site URL for the site to be created successfully.
   List	Function: Specifies the name of your SharePoint list. Accepted Values: The name of your SharePoint list. Default Value: None Accepts Process Data Variables: Yes

2. (Optional) If you want to delete only the files in a folder, select a folder in the Folder field.
3. (Optional) If you want to specify only specific list items that reflect a field name and value, complete these fields:

   Field Name	Definition
   List Item Field	Function: Specifies the name of a SharePoint list column or field. Along with the field value, the field name specifies a group of list items to delete. To specify a list item group, you must give a field name and value. If you do not give a field name and value, all list items are deleted from your list or folder. Accepted Values: The name of your SharePoint list column. Default Value: None Accepts Process Data Variables: No Example: If ListItem Field Name is set to ID, and ListItem Field Value is set to 5, only the list item with the ID equal to 5 is deleted. If ListItem Field Name is set to Created By, and ListItem Field Value is set to Mary Jones, all list items created by Mary Jones are deleted.
   List Item Field Value	Function: Specifies the value of the field defined in ListItem Field Name. To specify a list item group, you must give a field name and value. If you do not give a field name and value, all list items are deleted from your list or folder.. Accepted Values: The value of the list column specified in the ListItem Field Name. Default Value: None Accepts Process Data Variables: Yes Example: If ListItem Field Name is set to ID, and ListItem Field Value is set to 5, only the list item with the ID equal to 5 is deleted. If ListItem Field Name is set to Created By, and ListItem Field Value is set to Mary Jones, all list items created by Mary Jones are deleted.

RelatedTopics

• Configure General Options for a System Activity
• Delete List Item activity
• Process Data Variables