Creating and editing Actions

You can add new actions that can be accessed from the Actions widget.

About this task

You can create new actions such as searching the service registry, or creating a particular type of item. You can then trigger these actions by clicking a link in the Actions widget.

You can also edit existing actions.

You can set the display order of actions in this window by dragging the action to the wanted location, or by using the associated arrow icons.

Procedure

To a create a new action, complete the following steps:

  1. Open the Edit Settings window for the Actions widget by clicking the down arrow in the title bar and selecting Edit Settings from the menu.
  2. Click Create a New Action. The Create a New Action window opens.
  3. Type the name of the action in the Action Label field and the description of the action in the Description field.
  4. Select the type of the action from the Action Type list:
    • Create a Business Object
    • Create a Policy
    • Load Documents
    • Open URL
    • Custom Query
    • Manage Subscriptions
  5. If you have selected Create a Business Object, select the type of the object to create from the Business Object Type list.
  6. If you have selected Create a Policy, select the type of policy to create from the Policy Type list. Select WS-MediationPolicy 1.6 to use with IBM® DataPower® 5 as policy enforcement point, or WS-MediationPolicy 1.7 to use with IBM DataPower 6 as policy enforcement point, or select Workload Management Policy to use with IBM Integration Bus.
  7. If you have selected Load Documents, specify a name for the Action item, and optionally enter a description.
  8. If you have selected Open URL, specify a name for the link in the Action Label field, and enter the full URL including the protocol in the URL field. When the URL has been added to the widget, clicking on it opens a new browser window with the specified URL.
    Shows the fields for creating an Open URL item
  9. If you have selected Custom Query, complete the following steps. A Custom Query is a collection of a number of individual queries.
    1. Click Add Query.
    2. Choose the type of the query you want to add from the Query Type list.
    3. For a Type Query, select a business model type from the Type list.
      Adding Query Type
    4. For a Custom Query, type the XPath for the query in the XPath field. For more information, see XPath function reference. You can use substitution parameters in your XPath query; specifically, you can specify the current logged in user with ${currentUser} and the current time, in milliseconds since Jan 1st 1970, with ${currentTime}.
      Adding Query Xpath
    5. Click Add. The query is added to the table.
    6. For Type Queries, you can restrict the query to specific States, Classifications, and Properties. The query returns objects that match one of the States specified, one of the Classifications specified, and one of the Property expressions specified. To restrict queries, complete the following instructions:
      1. To add one or more states, click the '+' icon in the States column to open the Add States list. Select the states from the Add States list. The selected states are displayed in the States column in the table. To remove a state, click the remove icon next to it.
        Adding states
      2. To add one or more classifications, click the '+' icon in the Classifications column. Select the classifications from the Add Classifications list. The selected classifications are displayed in the Classifications column. To remove a classification, click the remove icon next to it.
        Adding classifications
      3. To add a property expression, click the '+' icon in the Properties column. Select the property to apply the expression to, and the expression that needs to be applied. Click Add. The expression is displayed in the Properties column. To remove a property expression, click the remove icon next to it.
        Adding properties
    7. To edit custom queries, click the XPath in the table to edit the XPath query.
      Edit query path
    8. To delete a type query from the view, click the X next to the type name. To delete an XPath query, click the X next to the query.

    When the Custom Query is clicked in the Actions widget, these queries are executed and the results are aggregated and displayed in the Service Registry Collection widget.

  10. If you have selected Manage Subscriptions, no further actions are required.

Example

Here is an example of the Create a New Action window:
Shows the Create a new action window