Uploading user-defined handlers

If you are going to modify components, you first upload the handlers for those components before creating or configuring the components. You only need to upload the user-defined handlers for the components that require them. For example, if you are adding your own validation step, you need to upload that handler from the Actions page of Handlers (as described below).

Note: As mentioned in Introduction, you upload only user-defined handlers. The handlers supplied by WebSphere Business Integration Connect are already available.

You can modify document flows by modifying fixed workflows, actions, targets and gateways. You modify these components by the handlers you associate with them.

Note: You can list the valid handler types for actions, targets, gateways, and fixed workflows by clicking Handler Types. Use this list to confirm that your handler is a valid type before uploading it. It must be one of the allowed types or it will not upload successfully.

To upload a handler, perform the following steps:

  1. From the main menu, click Hub Admin > Hub Configuration > Handlers.
  2. Select the type of handler, which can be Action, Target, Gateway, or Fixed Workflow.

    The list of handlers currently defined for that particular component is displayed. For example, if you choose Action, you see the following page:

    Notice that handlers provided by WebSphere Business Integration Connect are listed. They have a Provider ID of Product.

  3. From the Handlers List page, click Import.
  4. On the Import Handler page, specify the path to the XML file that represents the handler, or use Browse to search for that XML file.

After a handler is uploaded, you can use it to create new actions and workflows and to customize the configuration points of targets and gateways.

Note: You can update user-defined handlers by uploading the modified XML file. For an action handler, for example, you would click Hubadmin > Hub Configuration > Handlers > Action, and then click Import.

You cannot modify or delete handlers provided by WebSphere Business Integration Connect.

Copyright IBM Corp. 2003, 2004