Search Requests

Search for requests in ServiceNow.

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 include the 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.

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.

    Selecting this option adds a Streaming input section to the card where you can select a helper flow for streaming and add 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

If you specify multiple search criteria, they're combined to create the query. The resulting output is the group that matches all criteria.

However, if you don't specify any search criteria, the card returns all fields for available records.

Field Definition Type Required

Search

Search Criteria

Record Limit

Specify the number of records to stream.

  • When the Limit field is set to 0, the stream returns no records.

  • When the Limit field is set to greater than 0, the stream returns up to the maximum number specified.

  • When the Limit field is empty, null, or not selected, the stream returns all records.

  • The default value is 10000000 (10 million).

  • The valid range is 0 to 10000000.

This field appears when you select Stream Matching Records 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.

This field appears when you select Stream Matching Records from the Result Set option.

Number

Related topics

ServiceNow connector

Workflow elements

Guidance for ServiceNow connector

ServiceNow API reference