Create or change custom tasks
As an administrator, you can create or change custom tasks for your company or organization.
Task Information
To create or change a custom task, specify information about the custom task in the following fields.- Identifier prefix
- CUSTOM_ is the predefined prefix and it cannot be changed. It is preset to prevent naming collisions with tasks that IBM provides.
- Identifier suffix
- Specify the name of the custom task. It cannot contain spaces, quotation marks ("), equal signs
(=), or hash tags (#). The combination of the identifier prefix and identifier suffix creates the
task identifier. For example, a custom task AUDIT_TAXES is identified as
CUSTOM_AUDIT_TAXES with value Custom Audit Taxes. This value displays on the
task card in the Identity Manager Service Center. The field cannot be changed after the task is
created.
To enable the translation of the task name, provide a translation for the task identifier as a property in IM_HOME/data/CustomLabels.properties.
- Description
- Specify the description of the custom task that you want to display on the task card. To enable the translation of the description, add a prefix $ to the description string and provide a translation for that property in IM_HOME/data/CustomLabels.properties.
- URL
- Specify the web link that starts your custom task.
- Icon
- Specify the web link to the image that you want to display on the task card. For example,
http://...jpg. In addition to setting a web link to an image, you can put the images on the WebSphere Application Server file system. For example,.../itim/ui/custom/images/myimage.jpg - Header category
- Specify the menu that you want to display on the page header. You can also add custom tasks to
the predefined menus that IBM provides.
- manageAccess
- requestStatusTodo
- Console
- Identifies the console for which the custom task was created.
- Show on home page
- Click this check box to display the custom task on the home page.
- Start task in new window
- Selecting this check box enables the user to view the custom task in a new browser window. By
default, when you create a new custom task, this check box is not selected.
If you create or change a custom task without selecting this check box, when the user starts the task in the IVIG Service Center, it is started in the inline frame, or iframe, of the browser window that contains the IVIG Service Center. However, if you select the check box, when the user starts the task, it is started in a new browser window or tab, depending on the configuration of the browser.
Note: If you create or change a custom task that specifies a URL corresponding to the IBM Verify Identity Governance administrative console, you must select this check box.
Task Parameters
- Custom tasks table
- Lists the custom task parameters that are already created. To sort the table by a specific column, click the arrow in the column heading. The table contains these columns:
- Select
- Select the check box in this column to select the task parameter. Selecting the check box at the top of the column selects all custom parameters.
- Name
- Identifies the custom task parameter.
- Value
- Displays the value that is assigned to the custom task parameter.
If the table contains multiple pages, you can:
- Click the arrow to go to the next page.
- Type the number of the page that you want to view and click Go.
You can use these buttons:
- Create
- Click to create a custom task parameter.
- Change
- Click to change the parameters of the selected custom task parameter.
- Delete
- Click to remove the selected custom task parameter from the system.