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:
- Click Hub Admin > Hub Configuration > Fixed Workflow.
- Click either Inbound or Outbound.
- 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.
- Click the edit icon to edit the list of handlers.
- Perform one or more of the following steps for each handler
you want to modify.
- 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.
- Remove a handler by selecting the handler from the Configured Handlers list and
clicking Remove. The handler is moved to the Available Handlers list.
- 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.
- Cause a handler to be processed more than once by selecting
it and then clicking Repeat.
- 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:
- Click Hub Admin > Hub Configuration >Action.
- 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.
- Perform one or more of the following steps for each action you
want to modify.
- 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.
- Remove a handler by selecting the handler from the Configured Handlers list and
clicking Remove. The handler is moved to the Available Handlers list.
- Rearrange the order in which the handlers are called by selecting
the handler and clicking Move Up or Move Down.
- 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.
- Configure the handler by selecting it from the Configured List and
clicking Configure. The list of attributes
that can be configured will be displayed.
- Click Save.
Creating actions
You can create an action in one of the following ways:
- Create a new action and associate handlers with the action.
- Copy a product-supplied action and, if necessary, modify the
handlers associated with it.
Creating a new action
To create a new action, perform the following steps:
- Click Hub Admin > Hub Configuration > Actions.
- Click Create.
- Enter a name for the action. This field is required.
- Enter an optional description of the action.
- Indicate whether the action is enabled for use.
- 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.
- Configure the handler by selecting it from the Configured List and
clicking Configure. The list of attributes
that can be configured will be displayed.
- Click Save.
Copying an action
To create an action by copying an existing action, perform
the following steps:
- Click Hub Admin > Hub Configuration > Actions.
- From the Actions list, click the copy icon next to the action
you want to copy.
Figure 25. The Actions page
- Enter a name for the action. This field is required.
- Enter an optional description of the action.
- Indicate whether the action is enabled for use.
- Perform one or more of the following steps for each handler
you want to modify.
- 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.
- Remove a handler by selecting the handler from the Configured Handlers list and
clicking Remove. The handler is moved to the Available Handlers list.
- 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.
- Configure the handler by selecting it from the Configured List and
clicking Configure. The list of attributes
that can be configured will be displayed.
- Click Save.
