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

Extending the Launchpad

The Launchpad is the central tool for starting One Identity Manager administration tools and configuration tools. You can use the Launchpad to check the existing One Identity Manager installation and start One Identity Manager tools to run individual tasks.

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

You can control how and where menu items are displayed in the Launchpad. You use the menu hierarchy and the different types of menu items to do this. For more information about the structure of a menu hierarchy and the individual menu items and their properties, see User interface navigation.

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

Detailed information about this topic

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 > Commit to database and click Save.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating