Chat now with support
Chat mit Support

Identity Manager 9.0 LTS - 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
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 Windows 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

Recommendations for extending the Launchpad

  • To create a new category in the left-hand navigation area of the Launchpad, use menu items with the Menu category item type. The items are shown with their display text.

  • To group together tasks in the main area of the Launchpad, use menu items with the Task category item type. The items are shown with their display text.

  • For individual Launchpad tasks, use menu items with the Task, Fixed menu item, or Data-dependent menu item item types. The items are shown with their display text and description.

  • Specify the order for displaying the menu items.

  • To display the task status, enter an overlay icon definition on the menu item in VB.net syntax. Use the NavigationNodeState class.

    Syntax:

    public NavigationNodeState(string state, string imageUidOrName, string description)

    public NavigationNodeState(string state, string imageUidOrName, string description, bool enabled, bool visible, int count)

    Table 57: NavigationNodeState script parameters

    Parameter

    Description

    State

    Status returned, such as Info, Ok, Error, Warning.

    ImageUidOrName

    UID or name of the icon to be displayed.

    description

    Text displayed as tooltip.

    enabled

    Specifies whether the start button for the action is set.

    visible

    Specifies whether to display the task.

    count

    Number of affected objects.

    Calling example:

    Value = New NavigationNodeState("Ok", "QBM-33228392E9863141A9306B38ADF3D502", #LD("Project is completed.")#)

    Value = New NavigationNodeState("Error", "QBM-a486f0eabf674392bbbdf8572453258c", #LD("Project is not completed.")#)

  • You can use the condition to specify whether the task is only available for a direct database connection or a connection over an application server. To do this, use the variable SessionType.

    Condition examples:

    Direct database connection only: '%SessionType%' = 'Direct'

    Connect with the application server only: '%SessionType%' = 'AppServer'

    If no condition is defined, the task is always available.

  • If an action is going to be run from a task, link a Launchpad action to the menu item.

    This displays the Start button for the task. The Launchpad action's description is displayed in the button's tooltip.

  • If some actions in the Launchpad should not be made available to all users, you can manage the permissions by assigning Launchpad actions to program functions (QBMLaunchActionHasFeature table). Only tasks containing actions that the user's program function permissions permit him to run are shown in the Launchpad.

    For more information about managing permissions and running Launchpad actions using program functions, see the One Identity Manager Authorization and Authentication Guide.

Related topics

Actions for the Launchpad

One Identity Manager supplies a list of Launchpad actions that you can use to start applications. You can also start your own applications over the Launchpad.

At the start an application, you can pass calling parameters, tasks, and task parameters which the application can identify. Variable are permitted in this case. Supported are:

  • Environment variables with the syntax %variable%

  • Navigation variables with the syntax %variable%

  • Columns of the object passed down in $ notation.

To display Launchpad actions

  1. In the Designer, select the User interface > Launchpad Actions category.

  2. Select the Launchpad action The following main data is mapped for a Launchpad action.

    Table 58: Action properties
    Property Description

    Description

    Detailed description of the action. The description is displayed in the tooltip.

    .exe file

    Full name of the binary file.

    Calling parameter

    Additional calling parameters for starting the application.

    Action

    Action identifier.

    Administrative context

    Specifies whether the application can only be started by an administrator. The application expects authentication as an administrator.

    Method

    Method that must also be transferred as a start parameter.

    Task parameter

    Additional parameters for the method.

    Editor

    Special editor, for completing tasks in the Launchpad.

Creating new menu items and actions for the Launchpad

In the Designer, you can define your own menu items and actions for the Launchpad.

To extend the Launchpad

  1. Create new menu items for the Launchpad.

    1. In the Designer, select User interface > User interface navigation > Launchpad category.

    2. Start the User Interface Editor using the Edit navigation for application 'Launchpad' task.

    3. Create the menu item.

    4. Assign the menu items to the Launchpad application.

    5. Assign the menu items from the permissions group to QBM-LaunchPad.

  2. Assign the Launchpad actions to the menu items.

    1. In the Designer, select the User interface > Launchpad Actions category.

    2. Select the View > Select table relations menu item and enable the DialogTree table.

    3. Select the Launchpad action and assign the menu item to the action using the Menu items tab.

  3. (Optional) Assign a program function to the Launchpad action.

  4. Select the Database > Save to database and click Save.

Related topics

Task definitions for the user interface

You use tasks to carry out specific actions on objects within One Identity Manager tools. Task definitions are created for object definitions. Depending on the selected objects, you have see different methods displayed in the user interface. These interface forms are made available to system users, taking into account their permissions group memberships, by the additional assignment of interface forms to permissions groups.

If a task definition is assigned a program function (QBMMethodHasFeature table) users can only run this task if they have the necessary permissions groups. An error occurs if the user does not own this program function and tries to run it.

For more information about managing permissions and running methods using program functions, see the One Identity Manager Authorization and Authentication Guide.

Predefined configurations are maintained by the schema installation and cannot be edited apart from a few properties. You can disable individual predefined tasks to prevent them being shown in the user interface. They remain disabled even after schema installation.

NOTE: The tasks are displayed in alphabetical order in the task view of One Identity Manager.

Apart from these object dependent task definitions, form methods and customizer are provided that cannot be edited.

Detailed information about this topic
Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen