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
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
-
In the Designer, select the User interface > Launchpad Actions category.
-
Select the Launchpad action The following main data is mapped for a Launchpad action.
Table 58: Action properties
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
-
Create new menu items for the Launchpad.
-
In the Designer, select User interface > User interface navigation > Launchpad category.
-
Start the User Interface Editor using the Edit navigation for application 'Launchpad' task.
-
Create the menu item.
-
Assign the menu items to the Launchpad application.
-
Assign the menu items from the permissions group to QBM-LaunchPad.
-
Assign the Launchpad actions to the menu items.
-
In the Designer, select the User interface > Launchpad Actions category.
-
Select the View > Select table relations menu item and enable the DialogTree table.
-
Select the Launchpad action and assign the menu item to the action using the Menu items tab.
-
(Optional) Assign a program function to the Launchpad action.
-
Select the Database > Commit to database and click Save.
Related topics