Configuring the workflow extension

Use the Workflow Extension page to configure workflow extension information in the IBM® Security Identity Manager virtual appliance.

About this task

Supply workflow extension values in the Workflow Extension page.

Consider these points for XML-related information in the Workflow Extension page.
  • Select the Provide XML check box and add the entire XML information in the specified text area.
  • Clear the Provide XML check box and create activities in the Activities area.
Important: If you selected or cleared the Provide XML option when you created a workflow extension, you cannot change it when you edit a workflow extension.
A typical XML snippet can be as follows:
<ACTIVITY ACTIVITYID="asynchronousChangePasswordExtension" LIMIT="600000"><IMPLEMENTATION_TYPE>
<APPLICATION CLASS_NAME="examples.workflow.AsynchronousApplicationExtension" METHOD_NAME="asynchronousChangePasswordExtension"/>
</IMPLEMENTATION_TYPE>
</ACTIVITY>

<ACTIVITY ACTIVITYID="synchronousChangePasswordExtension" LIMIT="600000"><IMPLEMENTATION_TYPE>
<APPLICATION CLASS_NAME="examples.workflow.SynchronousApplicationExtension" METHOD_NAME="synchronousChangePasswordExtension"/>
</IMPLEMENTATION_TYPE>
</ACTIVITY>

Procedure

  1. From the top-level menu of the Appliance Dashboard, click Configure > Advanced Configuration > Workflow Extension to display the Workflow Extension page.
  2. On the Workflow Extension page, do one of these actions.
    Table 1. Workflow Extension actions
    Action Button Description
    Create a workflow extension New
    1. Click New to open the Create Workflow Extension window.
    2. Specify a name for the extension in Extension name.
    3. Specify a name for the servlet in Servlet name.
    4. Specify a description for the servlet in Servlet description.
    5. Specify a class for the servlet in Servlet class.
    6. Specify a pattern in URL pattern.
    7. Select or clear the Load on startup check box for servlet mapping.
    8. Select or clear the Provide XML check box to provide or override XML attribute values.
    9. Specify the XML attribute values in Process Definition.
    10. In the Activities area, click New to open the Create Activity window.
    11. Specify an ID value in Activity ID.
    12. Set a limit value in Limit.
    13. Specify a name for the class in Class name.
    14. Specify a name for the method in Method name.
    15. Select or clear the Enable restriction check box to restrict the types.
    16. From the Join list, restrict the type with these conditions.
      • AND
      • XOR
    17. From the Split list, restrict the type with these conditions.
      • AND
      • XOR
    18. Select or clear the Enable script check box to provide or override the script details.
    19. From the Script event list, assign a script event with these options.
      • onCreate
      • onComplete
    20. Specify a script for the workflow extension in Script.
    21. In the Parameters area, set the parameters with these options.
      Add In Param
      Do these steps.
      1. Click Add In Param to add an input parameter.
      2. In the record that you created, click and specify an ID under Parameter ID.
      3. Specify a type under Parameter Type.
        Note: The parameter category is specified as IN.
      Add Out Param
      Do these steps.
      1. Click Add Out Param to add an output parameter.
      2. In the record that you created, click and specify an ID under Parameter ID.
      3. Specify a type under Parameter Type.
        Note: The parameter category is specified as OUT.
      Delete
      Select a parameter ID record.

      Click Delete.

    22. Click Save Configuration to save the activity that you created.
    23. Click Save Configuration to save the workflow extension that you created.

    The workflow extension is listed in a table on the Workflow Extension page.

    Edit a workflow extension Edit
    1. Select a workflow extension from the table.
    2. Click Edit to open the Edit Workflow Extension window.
    3. Edit the extension name.
    4. Edit the servlet name.
    5. Edit the servlet description.
    6. Edit the servlet class.
    7. Edit the URL pattern.
    8. Select or clear the Load on startup check box for servlet mapping.
    9. In the Activities area, select an activity.
    10. Click Edit to open the Edit Activity window.
    11. Edit the ID value in Activity ID.
    12. Edit the limit value in Limit.
    13. Edit the class name.
    14. Edit the method name.
    15. Enable or disable the restriction.
    16. In Join, change the restriction condition.
    17. In Split, change the restriction condition.
    18. Select or clear the Enable script check box to provide or override the script details.
    19. In Script event, change the event.
    20. Edit the workflow extension script information.
    21. Edit the parameters. For more information about parameters, see Parameters.
    22. Click Save Configuration to save the activity that you selected to edit.
    23. Click Save Configuration to save the workflow extension that you selected to edit.
    Delete a workflow extension Delete
    1. Select a workflow extension record from the table.
    2. Click Delete.
    3. Click Yes to confirm your action.
    Refresh the workflow extension information Refresh Click Refresh to display the most recent version of the data, including changes that were made to the data since it was last refreshed.