Configuring actions

Introduction described that actions can be made up of one or more steps. WebSphere Partner Gateway 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 Partner Gateway, although you can copy one of those actions and modify it, as described in Copying an action.

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

Modifying a user-defined action

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

  1. Click Hub Admin > Hub Configuration > Actions.
  2. Click the View details 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 step by selecting the associated handler from the Available List and clicking Add. The handler is moved to the Configured List.
    2. Remove a handler by selecting the handler from the Configured List and clicking Remove. The handler is moved to the Available 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 List.

    5. Configure the handler by selecting it from the Configured List and clicking Configure. The list of attributes that can be configured is 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 step that will be invoked as part of the action, add the associated handler by selecting it from the Available List and clicking Add. The handler is moved to the Configured List.

    Remember that handlers are called by the action in the order in which they appear in the Configured List. 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 a handler by selecting it from the Configured List and clicking Configure. The list of attributes that can be configured is 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.
  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. Notice that one or more steps are already on the Configured List. These are the steps associated with the action you copied. For example, if you cloned the system-supplied Community Manager Cancellation of RosettaNet Process action, you would see the following list of available and configured handlers:
    Figure 19. Cloning an action
    This figure shows the two configured handlers and the list of other available handlers for the Community Manager Cancellation of RosettaNet Process action

    To modify the Configured List, perform one or more of the following steps:

    1. Add a step by selecting the associated handler from the Available List and clicking Add. The handler is moved to the Configured List.
    2. Remove a step by selecting the associated handler from the Configured List and clicking Remove. The handler is moved to the Available 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 List.

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

Copyright IBM Corp. 2003, 2005