Configuration for Deleting List Items Window

Specifies the SharePoint list items you want to delete. You can delete all list items within a SharePoint list or a folder, or you can identify a field name and value pair to delete a limited set of list items.



Navigation

  1. In AgilePoint Envision, open a process template.
  2. Navigate to the SharePoint stencil.
  3. On the SharePoint stencil, drag the Delete List Item AgileShape, and drop it on the process template.
  4. To view the entire list of properties, in the Design Tasks pane, click Show Properties.
  5. On the DeleteListItemsConfiguration field, click the Ellipses button.

Field Definitions

Field Name Definition

Site URL

Definition:
Specifies the URL for your SharePoint site.
Allowed Values:
A valid SharePoint site URL.
Default Value:
${DocUrl}
Custom Attributes:
Yes
Example:
http://mysharepoint:8000/sites/${mysite}

List Name

Definition:

Specifies the name of the SharePoint list you want.

Allowed Values:
The name of your SharePoint list.
Default Value:
None
Custom Attributes:
Yes

Folder Name

Definition:
Specifies the name of a SharePoint folder.
Allowed Values:
The name of your SharePoint folder

If the folder does not exist within the specified SharePoint list, the AgilePoint system creates it.

Default Value:
None
Custom Attributes:
Yes

ListItem Field Name

Definition:
Specifies the name of a SharePoint list column or field. Along with the field value, the field name specifies a particular group of list items to delete.

To identify a list item group, you must provide a filed name and value. If you do not specify a field name and value, all list items are deleted from the list or folder you specify.

Allowed Values:
The name of your SharePoint list column.
Default Value:
"ID", the list column that specifies the unique list item ID.
Custom Attributes:
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.

ListItem Field Value

Definition:
Specifies the value of the field defined in ListItem Field Name.

To identify a list item group, you must provide a filed name and value. If you do not specify a field name and value, all list items are deleted from the list or folder you specify..

Allowed Values:
The value of the list column specified in the ListItem Field Name.
Default Value:
${ListItemID}

A custom attribute representing a SharePoint List Item ID. This value corresponds to ID, the default value of ListItem Field Name.

Custom Attributes:
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.

Common Configuration Tasks