Search Groups

Search for user groups in ServiceNow.

When you select either the First Matching Record or First 200 Matching Records options, 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 (for example, Active, Cost center, Group email) and any custom fields you added to your user group table.

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 use for the search:

  • Like: return emails where the search fully matches the entered text or number values. For example: search for all subjects that contain Important.
  • Equals: return emails where the search partially matches the entered text or number values. For example: search in the Sender field for records that contain Smith.
  • Starts With: return emails where the search results begin with the entered text or 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.

Flow

TRUE

Output

Select output fields to display.

You don't have to display an output field for a corresponding input field that you 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