Chat now with support
Chat with Support

Identity Manager 9.2.1 - Configuration Guide

About this guide One Identity Manager software architecture Customizing the One Identity Manager default configuration Customizing the One Identity Manager base configuration One Identity Manager schema basics
Overview of the One Identity Manager schema Table types and default columns in the One Identity Manager data model Notes on editing table definitions and column definitions Table definitions Column definitions Table relations Dynamic foreign key Supporting file groups
Editing the user interface
Object definitions for the user interface User interface navigation Forms for the user interface Statistics in One Identity Manager Extending the Launchpad Task definitions for the user interface Applications for configuring the user interface Icons and images for configuring the user interface Using predefined database queries
Localization in One Identity Manager Process orchestration in One Identity Manager
Mapping processes in One Identity Manager Setting up Job servers
The One Identity Manager Service functionality Tracking changes with process monitoring Conditional compilation using preprocessor conditions Scripts in One Identity Manager
Visual Basic .NET scripts usage Notes on message output Notes on using date values Tips for using PowerShell scripts Using dollar ($) notation Using base objects Calling functions Pre-scripts for use in processes and process steps Using session services Using #LD notation Script library Support for processing scripts in the Script Editor Creating and editing scripts in the Script Editor Copying scripts in the Script Editor Testing scripts in the Script Editor Testing script compilation in the Script Editor Overriding scripts Permissions for running scripts Editing and testing script code with the System Debugger Extended debugging in the Object Browser
One Identity Manager query language Reports in One Identity Manager Adding custom tables or columns to the One Identity Manager schema Web service integration One Identity Manager as SCIM 2.0 service provider Processing DBQueue tasks One Identity Manager Service configuration files

Select clauses

The One Identity Manager query language Select clauses describe the data that is fetched from the underlying database. You define the minimum amount of returned data. The object layer can select more data to meet arbitrary requirements. An example is the primary key, which is always selected, or special columns like the X columns.

Multiple select clauses can be combined into one query.

Different variations of the Select clause are supported.

Selecting specific columns of a table

SELECT COLUMNS <list of columns>

Example

FROM Person

SELECT COLUMNS Firstname, Lastname, CentralAccount

Select all columns of a table

SELECT ALL

Selecting all display values of a table

SELECT DISPLAYS

Display columns that are selected are:

  • The table's display pattern (DialogTable.DisplayPattern)

  • The table's display pattern (long) (DialogTable.DisplayPatternLong)

  • Primary key of the table

In the case of returned entries, the table's display pattern and the display pattern (long) can be overwritten by a display value clause. For more information, see Display value clauses.

Selecting the table's display pattern

SELECT DISPLAYPATTERN

Selects only the columns from the table's display pattern or DISPLAY clause if it is used. This can provide improved performance over SELECT DISPLAYS because fewer columns are selected.

Select all columns of a table that are not marked as a BLOB field

SELECT NONLOBS

Selects all columns of the table that are not marked as a very long binary object or text object by the DialogColumn.IsBlobExternal column.

A matching entry exists

EXISTS

Determines whether an entry exists that fulfills the WHERE clause. The Exist clause overrides all other Select clauses except the Count clause.

Determine the number of matching entries

COUNT

Counts the entries that fulfill the where clauses. The Count clause overrides all other clauses.

Order by clauses

The Order by clause in the One Identity Manager query language, specifies the order in which entries are returned.

ORDER BY <list of columns>

The column order can be specified by

  • ASC or ASCENDING (Standard)

  • DESC or DESCENDING

When display values are selected, a default order by clause is created for the display columns.

Examples of Where clauses

ORDER BY Lastname, Firstname

ORDER BY EntryDate DESC

You can specify fallback columns, which will be used for sorting if the previous values are NULL. These fallback values are specified by the null coalescing operator ??.

Examples for a fallback column's data

ORDER BY DisplayName ?? CN

ORDER BY DisplayName ?? CN DESC, XDateInserted

Paging clauses

Paging operators of the One Identity Manager query language make it possible to return only a subset of the selected entries.

Take clause

The Take clause specifies the maximum number of entries to be returned. If more than one Take clause is specified, only the last take clause is effective.

TAKE <integer>

Example

-- Return only the first ten identities from the result set

FROM Person SELECT DISPLAYS TAKE 10

Skip clause

The Skip clause specifies how many entries should be skipped from the beginning of the results before the entries are returned.

SKIP <integer>

Example

-- Skip 50 identities and return the following 15

FROM Person SELECT DISPLAYS SKIP 50 TAKE 15

Display value clauses

Display value clauses allow the definition of a user-defined display pattern. The table's display pattern and the display pattern (long) can be overwritten by a display value clause in the returned entries.

DISPLAY 'Display pattern'

LONGDISPLAY 'Display pattern'

The parameter in both cases is a string containing the display pattern with placeholders in the form %ColumnName%.

Example

FROM Person

SELECT DISPLAYS

DISPLAY '%Lastname%, %Firstname%'

LONGDISPLAY '%Lastname%, %Firstname% - %CentralAccount%'

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating