Delete List Item

This activity deletes a SharePoint® list item that had been added by a Create List Item activity earlier in the workflow definition. See the tokens this activity produces.

ClosedHow does this activity look in the Designer Pane?

To add this activity to a workflow definition

To configure this activity

Select the activity in the Designer Pane to configure the following property boxes in the Properties Pane.

  • Once added to a workflow definition, the default name of an activity can be changed. Providing a custom name for an activity helps you remember the role it plays.

    To name an activity

    1. Add an activity to your workflow by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
    2. Select the activity in the Designer Pane.
    3. Under Activity Name in the Properties Pane, replace the default name.

      4. Note: Activity names cannot be the same as any other activity name in the workflow, they cannot be the same as the workflow's name, they must be less than 100 characters, they must contain at least one alphanumeric character, they cannot be "Name," and they cannot be the same as the activity's runtime type (which is usually only an issue with custom activities).

  • Use the Activity Description to provide descriptive text to help you remember the role that the activity plays in the workflow. All activities contain a default description that you can modify while constructing your workflow.

    To modify an activity description

    1. Add an activity to your workflow by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
    2. Select the activity in the Designer Pane.
    3. Under ClosedActivity Description in the Properties Pane, replace the default description.

  • sharepoint, Sharepoint, SharePoint

    In the ClosedList Item to Delete property box you can choose which SharePoint® list item you want to delete with the Delete List Item activity. You can only delete SharePoint® list items that were created by a Create List Item activity earlier in the workflow definition.

    Note: Some SharePoint® lists do not allow their list items to be deleted. These lists include some of SharePoint®'s default lists and custom lists specifically configured to prevent item deletion.

    To delete a list item

    1. Add the Delete List Item activity to your workflow definition by dragging it from the Toolbox Pane and dropping it in the Designer Pane.
    2. Select the activity in the Designer Pane.
    3. Under List Item to Delete in the Properties Pane, click the Select link.
    4. In the ClosedSelect List Item dialog box, click the green arrow next to the SharePoint® list item you want to delete.

    5. Click OK.

Tokens for Delete List Item

The Delete List Item activity produces the following tokens.

Name Description Sample Syntax*
List Name The name of the SharePoint® list the item was deleted from. %(DeleteListItem_List Name)
List Item ID The ID of the deleted list item. %(DeleteListItem_List Item Id)
Folder The folder (if any) the list item was deleted from. This token is be replaced by a fully qualified URL. %(DeleteListItem_Folder)
Root The name of the host Web service. %(DeleteListItem_Root)
Was Deleted Whether the list item was deleted or not. This token can have one of two values: True or False. %(DeleteListItem_WasDeleted)

*The "DeleteListItem" portion of the syntax changes to match the activity's name as specified in the Activity Name property box. Note that all non-alphanumeric characters, except underscores, are removed from the name. For example, if you rename the activity Remove!SP* the syntax for the Folder token will be %(RemoveSP_Folder).