Chat now with support
Chat with Support

Identity Manager 8.1.5 - 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 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
Setting up Job servers Configuring the One Identity Manager Service Handling processes in One Identity Manager
Tracking changes with process monitoring Conditional compilation using preprocessor conditions Scripts in One Identity Manager
Using scripts Notes on message output Notes on using date values 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 of scripts in 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 executing scripts Editing and testing script code with the System Debugger Extended debugging in the Object Browser
Reports in One Identity Manager Adding custom tables or columns to the One Identity Manager schema Web service integration SOAP Web Service One Identity Manager as SPML provisioning service provider Processing DBQueue tasks One Identity Manager Service configuration files

Querying statistic measurements

Table 54: Measurement query properties
Property Meaning

Measurements query

Enter the complete database query in SQL syntax to determine the statistic measurements. The query must return the ElementName and ElementValue columns as results.

To display statistic information in the Web Portal, you can also optionally output the ElementObjectKey, ElementObjectKey2, and ElementValue2 columns.

You can, optionally, control the display order of statistic measurements with the ElementOrder column. If the ElementOrder column does not exist, they are sorted by the ElementName column.

Base measurements query

Enter the complete database query in SQL syntax to determine the statistic measurements. The query must return the ElementName and ElementValue columns as results.

To display statistic information in the Web Portal, you can also optionally output the ElementObjectKey, ElementObjectKey2, and ElementValue2 columns.

You can, optionally, control the display order of statistic measurements with the ElementOrder column. If the ElementOrder column does not exist, they are sorted by the ElementName column.

The threshold factors entered in the fields Threshold green and Threshold red refer to the result in the ElementValue column. To determine the base measurement percentage, the result from column ElementValue is applied with 100%.

NOTE: The name of the ElementName column in the base measurements query must match the name of the ElementName column in the measurements query.

Condition

Formulate a condition with which the statistic measurements can be limited to the current user. The condition has to be formulated as a valid WHERE clause for database queries and limits the result of the query further based on the ElementObjectKey using the variable %UserUID% column.

NOTE: The condition is only taken into account for statistics that are shown in the Web Portal.

Example of calculating the threshold

Threshold factors are used to determine the percentage of the base measurement that reflects a correct or acceptable status.

Table 55: Example of finding the state
Base Measurements Threshold green Threshold red Percentage State

100

0.25

0.75

< = 25

correct

>25 to >75

acceptable

>= 75

unacceptable

0.75

0.25

> = 75

correct

<75 to <25

acceptable

<= 25

unacceptable

Related topics

Disabling statistics definition

You have the option to disable individual statistic elements as required. Statistic definitions that are disabled are not calculated. Predefined user statistic definitions remain disabled even after the schema has been updated.

To edit an statistic definition

  1. In the Designer, select a statistic definitions in the User Interface | Statistics definitions category.

  2. In the edit view, select the Properties view.

  3. Select the Properties tab and set the Disabled option.

In addition, statistic definitions can be disabled through pre-processor conditions.

Related topics

Including statistics in the user interface

In order to visualize statistics in the One Identity Manager administration tools, such as the Manager, you have to link the statistics into the user interface as a custom menu item.

You will typically find statistics in the Manager under the Info System navigation item in nearly any category. You should set up custom menu items for statistics under an info system like this. All statistics that are defined at one menu level are displayed on one form.

You can show reports that you create in the Report Editor or in the Manager in the statistics. In the Manager's info system, the report opens when you double-click on the statistics header.

Statistics can also be linked as form elements into overview forms. To do this, use the Overview Form Editor.

NOTE: If you set up a custom info system, ensure that the menu item under which you define the statistics, is labeled with Not expandable by user and Force open menu item.

For more information about general properties of menu items, see General menu item properties. Take note of the following properties for menu items.

Table 56: Statistics properties
Property Meaning

Entry type

Select the entry type Statistics.

Caption

The caption given here, overwrites the statistic definition caption. Leave this field empty if you want to use the statistic definition display name.

Statistics

Enter the statistic definition to be displayed.

Diagram type

Select the diagram type that is going to represent the statistic.

Alignment

Positioning of statistics on the overview form. This layout information is used if the statistic is used as a form element on an overview form.

Background

Background color of the form elements on the overview form. This layout information is used if the statistic is used as a form element on an overview form.

All menu items that are to be displayed in an application user interface have to be assigned to a permissions group and an application.

Related topics

Using reports in statistics

In the Manager's info system, you can display reports that you create in the Report Editor as statistics. To do this, you must alter the Manager's user interface. The report opens when you double-click on the statistic's header.

To display a report as a statistic

  1. In the Designer, create a user interface form.

    1. In the Designer, select the User interface | Forms | User interface forms category.

    2. Select the Edit form task.

    3. Select the Form | Insert menu item.

    4. Edit the interface form's master data.

      Take the following cases into account:

      • Use the VI_Report form definition

        This form definition is configured for displaying in the graphical user interface and in web applications. You only need to set up one interface form for this. Which form template will be used to display the interface form is decided dynamically, depending on usage.

      • In the form's configuration data, pass the name of the executing report (DialogReport.ReportName) in the SpecialSheetData section.

        Syntax:

        <DialogSheetDefinition FormatVersion="1.0">

        <SpecialSheetData>ReportName from the DialogReport table

        </SpecialSheetData>

        </DialogSheetDefinition>

    5. Assign the user interface form to the applications and permissions groups.

  2. In the Designer, create a menu item.

    1. In the Designer, select the User interface | User interface navigation category.

    2. In the User Interface Editor, select the menu item for the statistics item to show the report.

    3. Select New.

    4. Edit the master data of the menu item.

    5. Assign the menu item to the Manager application and permissions groups.

  3. Assign the user interface form to the menu item.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating