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

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 58: 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 to be set or not.

    visible

    Specifies whether the task is to displayed.

    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 executing 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 in $ notation.

To display Launchpad actions

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

  2. Select the Launchpad action The following master data is required for a Launchpad action.

    Table 59: Action properties
    Property Description

    Description

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

    Executable file

    Full name of the executable file.

    Execution parameter

    Additional execution 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.

Creating new 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.

    Detailed information about managing permissions and executing Launchpad actions with program functions can be found in the One Identity Manager Authorization and Authentication Guide.

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 so that different tasks can be shown in the user interface depending on the selected objects. By also assigning task definitions to permissions groups, these tasks are made available to system users depending on their membership in permissions groups. Apart from these object dependent task definitions, form methods are provided through the user interface form and cannot be edited.

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.

Detailed information about this topic
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating