Search groups

Search for groups in Oracle IAM.

Options

Field	Definition	Type	Required
Filter	Choose one of the following filter options to search for groups where the selected attributes match: Equal: The selected attributes are equal to the provided values. Not Equal: The selected attributes aren't equal to the provided values. Contains: The selected attributes contain the provided values. Before: The selected attributes have a date earlier than the provided values. After: The selected attributes have a date older than the provided values.	Dropdown	TRUE
Sort Order	Indicate the sort order for the filtered results: Descending Ascending Results are sorted by the Created At attribute of the group.	Dropdown	TRUE
Result Set	Choose one of the following options to return your 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 user records from your parent flow to a helper flow. Adds a Streaming input section to the card where you can select a helper flow for streaming and adding custom extensible fields.	Dropdown	TRUE

Field

Definition

Type

Required

Filter

Choose one of the following filter options to search for groups where the selected attributes match:

Equal: The selected attributes are equal to the provided values.
Not Equal: The selected attributes aren't equal to the provided values.
Contains: The selected attributes contain the provided values.
Before: The selected attributes have a date earlier than the provided values.
After: The selected attributes have a date older than the provided values.

Dropdown

TRUE

Sort Order

Indicate the sort order for the filtered results:

Descending
Ascending

Results are sorted by the Created At attribute of the group.

Dropdown

TRUE

Result Set

Choose one of the following options to return your 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 user records from your parent flow to a helper flow. Adds a Streaming input section to the card where you can select a helper flow for streaming and adding custom extensible fields.

Dropdown

TRUE

To learn how to return large numbers of records, see Stream matching records with a helper flow.

Input

Field	Definition	Type	Required
Search By
Display Name	The group's unique display name.	Text	FALSE
Non Unique Display Name	A human-readable name for the group.	Text	FALSE
OCID	Oracle-assigned unique identifier for the group.	Text	FALSE
External ID	Unique external ID of the group.	Text	FALSE
Created At	Date and time when the object was created.	Date & Time	FALSE
Last Updated At	The most recent date and time that the group's details were updated.	Date & Time	FALSE
Custom Filter
Filter	To make your search more flexible, provide a group API attribute name with a filter operator. If the Filter field is used with other input fields its value is with AND logical operators. If only the Filter field is used, its value must not start with AND or OR logical operators. See the Group API attributes and Valid Filter Expression for a full list of available attributes and filter operators.	Text	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. This field appears when Stream Matching Records is selected from the Result Set option. The input field on the Helper Card in the streaming helper flow must reference the key Record (type object) to obtain streamed records. To obtain state input values, reference the key State (type object) of the Record object.	Flow	TRUE
Record Limit	Specify the number of records to stream. The 0 value for the field isn't allowed When the Record Limit field is set to greater than 0, records greater than 0 and up to the maximum number of records specified are returned. When the Record Limit field is empty, null or not selected, all records are streamed. The default value is 500000. The valid range is from 1 to 500000.	Number	FALSE

Output

Field	Definition	Type
Result
ID	Unique identifier of the group.	Text
Display Name	The group's unique display name.	Text
Non Unique Display Name	A human-readable name for the group.	Text
OCID	Oracle-assigned unique identifier for the group.	Text
External ID	Unique external ID of the group.	Text
Created At	Date and time when the object was created.	Date & Time
Created By	The user or app that created the group.	Object
Last Updated At	The most recent date and time that the group's details were updated.	Date & Time
Last Modified By	The user or app that last modified the group.	Object
Members	The users in the group.	List of Objects
Raw Output	The full details of the group.	Object
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

Search groups

Options

Input

Output

Related topics