Delete ServiceNow Record

UiPath.ServiceNow.Activities.DeleteRecord

The Delete ServiceNow Record activity uses the ServiceNow Table - DELETE API to delete a specific record (sys_id).

After deleting the record, the activity outputs the status of the request (success/failure information) in a ResponseStatus object (ServiceNowStatus) that you can use in subsequent activities (e.g., conditional logic).

How it works

The following steps and message sequence diagram is an example of how the activity works from design time (i.e., the activity dependencies and input/output properties) to run time.

1. Complete the Setup steps.
2. Add the ServiceNow Scope activity to your project.
3. Add the Delete ServiceNow Record activity inside the ServiceNow Scope activity.
4. Click the Configure button inside the Delete ServiceNow Record activity (this opens the Object Wizard).
5. Select the Object that you want to delete and enter values for the Input properties.
6. Create and enter a ResponseStatus variable for the Output property.
   • Your input property values are sent to the Table - DELETE API.
   • The API returns the ResponseStatus value to your output property variable.
     
     

     

     
     

Configure

To enter your Delete ServiceNow Record property values, click the Configure button to open the Object Wizard and select a ServiceNow object (you also have the option to enter the object as a String).

To learn more about the Object Wizard, see the Business Activity Frameworks page.

• Object - The type of ServiceNow object that you want to delete. Use the Object Wizard to select an object or enter a valid String or String variable.

Properties

Common

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Input

• Id - The sys_id of the ServiceNow record that you want to retrieve. Enter a String or String variable. To get the sys_id value, you can follow one of the methods shown in the ServiceNow unique record identifier (sys_id) documentation or right-click on the record in the ServiceNow UI and select the Copy sys_id option in the pop-out menu.

Misc

• Private - If selected, the values of variables and arguments are no longer logged at Verbose level.

Output

• ResponseStatus - The status of the request (success/failure information). Enter a ResponseStatus variable (UiPath.BAF.Models.ResponseStatus). The ResponseStatus object includes three properties that you can use in other activities.
  • Success - Boolean - Specifies whether the API request was successful.
  • ErrorCode - String - The response error if the API request is unsuccessful (Success=False).
  • Message - String - The error message.

Example

The following image shows an example of the activity dependency relationship and input/output property values.

For step-by-step instructions and examples, see the Quickstart guide.