Changing a custom task

As an administrator, you can change the task parameters that you specified for a customized task.

About this task

After a task is created, you cannot change the identifier prefix, the identifier suffix, or the console.

Selecting the Start task in new window check box enables the user to view the custom task in a new browser window. By default, this check box is not selected. If you change a custom task without selecting this check box, when the user starts the task in the Identity Manager Service Center, it is started in the inline frame, or iframe, of the browser window that contains the Identity Manager 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.

If you change a custom task that specifies a URL corresponding to the Identity Manager administrative console, you must select this check box.

Procedure

  1. From the navigation tree, select Set System Security > Manage Views.
  2. On the Define Views page, click Manage Custom Tasks in the Views table.
  3. In the Manage Custom Tasks table, select a task and click Change.
  4. Optional: Under Task information, modify the parameters that you want to change.
  5. In the Identifier suffix field, if needed, you can define a label for the custom task by editing the IM_HOME/data/CustomLabels.properties file. The name of the property is CUSTOM_<Identifier suffix> (all in capital letters). The value must be what you want to display in the Identity Manager Service Center. For example, if the identifier suffix is consoleui, then the property to add to CustomLabels.properties can be CUSTOM_CONSOLEUI = Identity Manager Console UI
  6. Optional: In the Description field, 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, where IM_HOME is the Identity Manager installation directory.

    If you want to display Custom task as the description of the task in the Identity Manager Service Center, you must enter $customTask in the Description field. You must also add an entry in CustomLabels.properties: customTask = Custom task.

    If you want to translate the description in another language, you must edit the CustomLabels_xx.properties file, where xx is the locale. For example, CustomLabels_fr.properties might have an entry customTask = Tâche Personnalisée.

  7. Optional: Create or change custom task parameters.
    1. In the Task Parameters table, click Create or select a parameter and click Change.
    2. Specify a parameter name.
    3. Specify a parameter value
    4. Click OK.
  8. Optional: Delete custom task parameters.
    1. In the Task Parameters table, select one or more parameters and click Delete.
    2. On the Confirm page, ensure that the parameters are the ones you want to delete, and then click Delete.
    Note: The parameter changes are not saved until you click OK to save the updates to the custom task.
  9. When you are finished, click OK.
    The Success page is displayed.
  10. Select an action or click Close to return to the Define Views page.

What to do next

Log in to the Identity Manager Service Center user interface and verify that your changes are applied.