Configuring document processing

As described in Introduction, you can modify the system-supplied behavior for workflow steps by adding handlers to the steps. You can also modify the actions performed on a document by configuring handlers for the action. You can also create new actions.

This section describes how to add handlers for workflows and how to configure and create actions.

Configuring fixed workflows

Introduction described that there are two fixed inbound workflow steps--one for unpackaging a protocol and one for parsing the protocol. For outbound workflows, there is one step, for protocol packaging.

WebSphere Business Integration Connect supplies a set of steps for each type of workflow.

If you are going to use a user-defined handler to configure a workflow step, upload the handler, as described in Uploading user-defined handlers.

To configure a fixed workflow, perform the following steps:

  1. Click Hub Admin > Hub Configuration > Fixed Workflow.
  2. Click either Inbound or Outbound.
  3. Click the magnifying glass icon next to the name of the step you want to configure.

    The step, along with a list of handlers already configured for that step, is listed.

  4. Click the edit icon to edit the list of handlers.
  5. Perform one or more of the following steps for each handler you want to modify.
    1. Add a handler by selecting the handler from the Available Handlers list and clicking Add. (A handler would appear in the Available List if you had uploaded a user-defined handler or if you had previously removed a handler from the Configured Handlers list.) The handler is moved to the Configured Handlers list.
    2. Remove a handler by selecting the handler from the Configured Handlers list and clicking Remove. The handler is moved to the Available Handlers list.
    3. Rearrange the order in which the handlers are called by selecting the handler and clicking Move Up or Move Down.

      Remember that handlers are called in the order in which they are listed in the Configured Handlers list. The first available handler that can process the request is the one that handles the request.

    4. Cause a handler to be processed more than once by selecting it and then clicking Repeat.
  6. Click Save.

Configuring actions

Introduction described that actions can be made up of one or more steps. WebSphere Business Integration Connect supplies a series of default actions. You can add to the list of actions by uploading one or more action handlers (which are steps in the action), which you can then use in an action. You can also create new actions, as described in Creating actions.

Note: You cannot modify the actions supplied by WebSphere Business Integration Connect, although you can copy one of those actions and modify it, as described in Creating actions.

If you are going to use a user-defined handler to configure an action, upload the handler, as described in Uploading user-defined handlers.

To configure a user-defined action, perform the following steps:

  1. Click Hub Admin > Hub Configuration >Action.
  2. Click the magnifying glass icon next to the name of the user-defined action you want to configure.

    The action, along with a list of handlers (action steps) already configured for that action, is listed.

  3. Perform one or more of the following steps for each action you want to modify.
    1. Add a handler (action step) by selecting the handler from the Available Handlers list and clicking Add. (A handler would appear in the Available List if you had uploaded a user-defined handler or if you had previously removed a handler from the Configured Handlers list.) The handler is moved to the Configured Handlers list.
    2. Remove a handler by selecting the handler from the Configured Handlers list and clicking Remove. The handler is moved to the Available Handlers list.
    3. Rearrange the order in which the handlers are called by selecting the handler and clicking Move Up or Move Down.
    4. Cause a handler to be processed more than once by selecting it and then clicking Repeat.

      Remember that all handlers configured for an action are called and the steps that the handlers represent are performed in the order in which they appear in the Configured Handlers list.

    5. Configure the handler by selecting it from the Configured List and clicking Configure. The list of attributes that can be configured will be displayed.
  4. Click Save.

Creating actions

You can create an action in one of the following ways:

Creating a new action

To create a new action, perform the following steps:

  1. Click Hub Admin > Hub Configuration > Actions.
  2. Click Create.
  3. Enter a name for the action. This field is required.
  4. Enter an optional description of the action.
  5. Indicate whether the action is enabled for use.
  6. For each handler that will be invoked as part of the action, add the handler by selecting it from the Available Handlers list and clicking Add. (Any action handlers you uploaded appear in the Available List.) The handler is moved to the Configured Handlers list.

    Remember that handlers are called by the action in the order in which they appear in the Configured List, so make sure you place the handlers in the correct order. You can use Move Up or Move Down to rearrange the order of the handlers or Repeat to cause a handler to be processed more than once.

  7. Configure the handler by selecting it from the Configured List and clicking Configure. The list of attributes that can be configured will be displayed.
  8. Click Save.

Copying an action

To create an action by copying an existing action, perform the following steps:

  1. Click Hub Admin > Hub Configuration > Actions.
  2. From the Actions list, click the copy icon next to the action you want to copy.
    Figure 25. The Actions page
  3. Enter a name for the action. This field is required.
  4. Enter an optional description of the action.
  5. Indicate whether the action is enabled for use.
  6. Perform one or more of the following steps for each handler you want to modify.
    1. Add a handler by selecting the handler from the Available Handlers list and clicking Add. (A handler would appear in the Available List if you had uploaded a user-defined handler or if you had previously removed a handler from the Configured Handlers list.) The handler is moved to the Configured Handlers list.
    2. Remove a handler by selecting the handler from the Configured Handlers list and clicking Remove. The handler is moved to the Available Handlers list.
    3. Rearrange the order in which the handlers are called by selecting the handler and clicking Move Up or Move Down.

      Remember that all handlers configured for an action are called and the steps associated with the handlers are performed in the order in which they appear in the Configured Handlers list.

    4. Configure the handler by selecting it from the Configured List and clicking Configure. The list of attributes that can be configured will be displayed.
  7. Click Save.

Copyright IBM Corp. 2003, 2004