On this Page

Snap type:

Write


Description:

This Snap connects to the particular instance provided by ServiceNow, deletes the records by the IDs (fetched from the incoming documents) from the given table, and returns the response as a document stream.

  • Expected upstream Snaps: Any Snap that provides a document output view such as a Mapper Snap.
  • Expected downstream Snaps: [None] or any Snap that has a document input view such as a Filter or a Data or a JSON Formatter.
  • Expected input:  A Table Name and record ID.
  • Expected output:  Deletes a record.


Prerequisites:

[None]


Support and limitations:Works in Ultra Task Pipelines.
Account: 

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring ServiceNow Accounts for information on setting up this type of account.


Views:


Input

This Snap has exactly one input view.

Output

This Snap has exactly one output view

ErrorThis Snap has at most one error view and produces zero or more documents in the view.


Settings

Label


Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Table name




Required. The name of the table in the instance. The table name is suggestible but requires an account setting for the suggestions to appear.

Example: incident

Default value: [None]


Number of retries

Specifies the maximum number of retry attempts when the Snap fails to write.

Example: 3

Minimum value: 0

Default value: 0

Retry interval (seconds)

Specifies the minimum number of seconds the Snap must wait before each retry attempt.

Example: 3

Minimum value: 1

Default value: 1


 Example

The example assumes that you have configured & authorized a valid ServiceNow account (see Configuring ServiceNow Accounts) to be used with this Snap. 

The following pipeline shows how you can pass the record ID of ServiceNow record to be deleted from a specified table using a ServiceNow Delete Snap.

 

In the pipeline execution:

Mapper Snap maps ServiceNow record's ID (sys_id) to the input fields of ServiceNow Delete Snap:

ServiceNow Delete Snap deletes the specified record in the catalog_category_request table: 

After a successful validation of the Snap, you will see a data preview that shows details of the deleted record: