Search users

Search for users in Oracle IAM.

Options

Field Definition Type Required

Filter

Choose one of the following filter options to search for users 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 user.

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

User Name

Username of the user.

Text

TRUE

Full Name

Full name of the user.

Text

FALSE

Email

The email address of the user.

Text

FALSE

OCID

Oracle-assigned unique identifier for the user.

Text

FALSE

Phone Number

User's phone number.

Text

FALSE

Full Address

The user's full mailing address.

Text

FALSE

Role

The value of the user's role.

Text

FALSE

User Type

The user's type or classification.

  • Contractor

  • Employee

  • Intern

  • Temp

  • External

  • Service

  • Generic

Dropdown

FALSE

External ID

Unique external ID of the user.

Text

FALSE

Title

The user's job title.

Text

FALSE

Entitlement

The value of the user's entitlement.

Text

FALSE

Created At

The date and time that the user was created.

Date & Time

FALSE

Last Updated At

The most recent date and time that the user'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 added with AND logical operators.

  • If only the Filter field is used, its value must not start with AND or OR logical operators.

See the User API attributes and Valid Filter Expression for 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 user.

Text

User Name

Username of the user.

Text

Name

Name of the user.

Object

Display Name

Name displayed for the user.

Text

Is Active

Indicates whether the user is active.

True/False

Emails

The user's email addresses.

List of Objects

Phone Numbers

The user's phone numbers.

List of Objects

Addresses

The user's addresses.

List of Objects

Groups

The user's assigned groups.

List of Objects

Roles

The user's assigned roles.

List of Objects

User Type

The user's type or classification.

Text

Locale

The user's preferred language and region.

Text

Timezone

The user's preferred timezone.

Text

OCID

Oracle-assigned unique identifier for the user.

Text

External ID

Unique external ID of the user.

Text

Description

A description of the user.

Text

Nickname

Nickname of the user.

Text

Preferred Language

The user's preferred language for communication.

Text

Profile URL

The URL for the user's profile.

Text

Title

Job title of the user.

Text

Entitlements

The user's entitlements.

Object

Created At

The date and time that the user was created.

Date & Time

Created By

The user or app that created the user.

Object

Last Updated At

The most recent date and time that the user's details were updated.

Date & Time

Last Modified By

The user or app that last modified the user.

Object

Raw Output

The full details of the user.

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

Related topics

Oracle IAM connector

Cards in flows

Oracle IAM API for users

Oracle IAM API for groups