Search Requests

Search for requests in ServiceNow.

Note

When First Matching Record or First 200 Matching Records options are selected, the input and output fields are dynamically generated based on your ServiceNow instance. The input and output fields will include these default fields provided by ServiceNow (Resolve Time, Delivery address, Parent interaction, Request state, Special instructions) as well as any custom fields you've added to your requesttable.

Note

Each search field is considered cumulative, meaning that if you enter two criteria, the result will be the group that matches both criteria.

Options

Field Definition Type Required
Result Set Specifies the number of emails returned in the response.

Choose a method to filter search results:

  • First Matching Record: returns the first record that matches.
  • First 200 Matching Records: returns the first 200 matching records.
  • Stream Matching Records: passes all matching records from your parent flow to a helper flow. A Streaming input section is added to the card from which you can select a helper flow for streaming and adding custom extensible fields.
Dropdown TRUE
Search By Specifies how to compare input text values. Searches all text fields. Choose an operator to search by:
  • Like: returns emails with partial matching of entered text/number values. For example: search in the Sender field for words that contain Smith.
  • Equals: returns emails when the search fully matches the entered text/number values. For example: search for all subjects that contain Important.
  • Starts With: returns emails when the search starts with the entered text/number values.
Dropdown TRUE

Input

Field Definition Type Required
Search
Search Criteria      
Record Limit

Specify the number of records to stream.

  • When the Limit field is set to 0, no records are returned.

  • When the Limit field is set to greater than 0, records greater than 0 and up the maximum number of records specified are returned.

  • When the Limit field is empty or not selected, all records are streamed.

  • Default value is 10 million.

  • Valid range is 0 to 10 million.

Appears when Stream Matching Records is selected from the Result Set option.

Number FALSE
Streaming      
Flow

Click Choose Flow to browse and select a helper flow where the search results will be streamed, then click Choose to confirm.

Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow.

Appears when Stream Matching Records is selected from the Result Set option.

Flow TRUE

Output

Select output fields to display.

You do not have to display an output field for a corresponding input field that you've updated.

Field Definition Type
Result Appears when First Matching Record or 200 Matching Records are selected from the Result Set option unless otherwise specified.  
Records Streamed

Number of records streamed in a streaming flow.

Appears when Stream Matching Records is selected from the Result Set option.

Number

Related topics

ServiceNow connector

Elements of Workflows

Guidance for ServiceNow connector

ServiceNow Reference