ServiceNow Module Reference

Applies to

Bridge by Smartsheet

ServiceNow triggers

After integrating Bridge with ServiceNow, choose the events to trigger a workflow. 

Event type

  • When Records Are Created
  • When Records Are Updated
  • When Records Are Deleted

Create New Record

Use this module to create a new record in an existing table in ServiceNow.

Create New Record fields

The following fields are available in the module. 

You can use data references in all the Create Record fields.

Table Name 

In this field, enter the name of the table where you need to create a record. 

Key #1 

In this field, enter the field name of the record you need to update.

Value #1 

In this field, enter the field value in the record you need to update. 

Once Bridge executes the Create New Record module in a workflow, this information will be available in the runlog section:

  • Data
  • State: Refer to this section to check if the module worked
    • Code: This is the success/error code that the module pulls from Smartsheet
    • Message: A system-generated message that the module pulls from Smartsheet 
      • For example, if the module couldn’t find a value, the message might be “Not found”
    • Status: This is the status that the module pulls from Smartsheet 
      • These are examples of status labels you might encounter:
        • Succeeded - The module successfully found the information
        • Failed - The module didn’t find the information

Delete Record

Use this module to delete a record in ServiceNow.

Delete Record fields

The following fields are available in the module.

You can use data references in the Delete Record fields.

Table Name

In this field, enter the name of the table where you need to create a record.  

Record Sys ID 

In this field, enter the sys_id value automatically assigned to the record at the point of creation.

Once Bridge executes the Delete Record module executes in a workflow, this information will be available in the runlog section:

  • Data
  • State: Refer to this section to check if the module worked
    • Code: This is the success/error code that the module pulls from Smartsheet
    • Message: A system-generated message that the module pulls from Smartsheet 
      • For example, if the module couldn’t find a value, the message might be “Not found”
    • Status: This is the status that the module pulls from Smartsheet 
      • These are examples of status labels you might encounter:
        • Succeeded - The module successfully found the information
        • Failed - The module didn’t find the information

Get Group

This module is a group of actions that allows you to build for multiple potential outcomes.

Set up the Get Group module

  1. In the Name field, type a unique name for the module. 
  2. After setting up the module, build the workflow and identify the potential outcomes for it.

Use potential outcomes to guide your workflow building. These are the potential outcomes for the Get Group module:

  • Group found: The module found the group with the specified name
  • No Group found: The module didn’t find the group with the specified name

Continue building the workflow 

  1. In the left pane, go to the Pinned Items
  2. Then, drag a New State module to the dotted rectangular space for the path you want to follow. 
  3. In the State field, enter a name. 

Get Group fields

The following fields are available in the module.

You can use data references in all the Get Group fields except Name.

Name 

This is where you assign a name to a module after dragging it to your workflow.  

Group 

In this field, enter the name of the group.

Once Bridge executes the Get Group module, this information will be available in the runlog section:

  • Data
  • State: Refer to this section to check if the module worked
    • Code: This is the success/error code that the module returns from Smartsheet
    • Message: A system-generated message that the module pulls from Smartsheet 
      • For example, if the module couldn’t find a value, the message might be “Not found”
    • Status: This is the status that the module pulls from Smartsheet 
      • These are examples of status labels you might encounter:
        • Succeeded - The module successfully found the information 
        • Failed - The module didn’t find the information

Get Record

This module functions as a group of states and a junction. It works like the Get Group module and has three potential outcomes: 

  • Record found: The module found the record 
  • No record found: The module didn’t find the record in the specific table 
  • No table found: The module didn’t find the specific table

Get Record fields

The following fields are available in the module. 

You can use data references in all Get Record fields except Name.

Name 

This is where you assign a name to a module after dragging it to your workflow.  

Table Name 

In this field, enter the name of the table containing the record you need.  

Record Sys ID 

In this field, enter the sys_id value of the record you need to find.

Once Bridge executes the Get Group module, this information will be available in the runlog section: 

  • Data
  • State: Refer to this section to check if the module worked 
    • Code: This is the success/error code that the module returns from Smartsheet
    • Message: A system-generated message that the module pulls from Smartsheet 
      • For example, if the module couldn’t find a value, the message might be “Not found”
    • Status: This is the status that the module pulls from Smartsheet 
      • These are examples of status labels you might encounter:
        • Succeeded - The system successfully found the information 
        • Failed - The module didn’t find the information

Get Records

This returns all records from a table and lets you filter its results. 

Get Records fields

The following fields are available in the module. 

You can use data references in all the Get Records fields.

Table Name

In this field, enter the name of the table containing the records you need.

Record Offset 

In this field, enter the starting record index for which the module should begin finding records.

Results Per Page 

In this field, enter the maximum number of records you need the module to return. 

If records exceed that number, the module will separate them into pages. Each page will hold records amounting to the number you stated in this field.

Once Bridge executes the Get Group module, this information will be available in the runlog section: 

  • Data
  • State: Refer to this section to check if the module worked
    • Code: This is the success/error code that the module returns from Smartsheet
    • Message: A system-generated message that the module pulls from Smartsheet 
      • For example, if the module couldn’t find a value, the message might be “Not found”
    • Status: This is the status that the module pulls from Smartsheet 
      • These are examples of status labels you might encounter: 
        • Succeeded - The module successfully found the information
        • Failed - The module didn’t find the information

Get User

This module functions the same way as the Get Group and Get Record modules, and has two potential outcomes: 

  • User found: The module didn’t find a user
  • No user found: The module didn’t find a user with the specified email address or full name

​​​​​​

Get User fields

The following fields are available in the module. 

You can use data references in all the Get User fields except Name.

Name

This is where you assign a name to a module after dragging it to your workflow. 

User Email Address or Full Name

In this field, enter the user’s name or email address. 

Once Bridge executes the Get User module in a workflow, this information will be available in the runlog section: 

  • Data
  • State: Refer to this section to check if the module worked or failed
    • Code: This is the success/error code that the module returns from Smartsheet
    • Message: A system-generated message that the module pulls from Smartsheet 
      • For example, if the module couldn’t find a value, the message might be “Not found”
    • Status: This is the status that the module pulls from Smartsheet 
      • These are examples of status labels you might see
        • Succeeded - The module successfully found the information
        • Failed - The module didn’t find the information

Update Record

Use this module to update a record in ServiceNow.

Update Record fields

The following fields are available in the module. 

You can use data references in all the Update Record fields.

Table Name 

This is the name of the table where the module can find the record you need.  

Record Sys ID 

In this field, enter the sys_id value of the record you need to update.   

Key #1 

In this field, enter the field name of the record you need to update.

Value #1 

In this field, enter the field value in the record you need to update. 

Once Bridge executes the Update Record module in a workflow, this information will be available in the runlog section:

  • Data
  • State: Refer to this section to check if the module worked or failed
    • Code: This is the success/error code that the module returns from Smartsheet
    • Message: A system-generated message that the module pulls from Smartsheet 
      • For example, if the module couldn’t find a value, the message might be “Not found”
    • Status: This is the status that the module pulls from Smartsheet 
      • These are examples of status labels you might encounter:
        • Succeeded - The module successfully found the information
        • Failed - The module didn’t find the information