Creating an action

You can create an action.

About this task

To create an action:

Procedure

  1. Open the Applications Manager and select the application that you want.
  2. In the Process Modeling window, select the Order, Load, or General tab to view the corresponding process modeling tree for that base document type.
  3. In the Process Types swimlane, right-click on the applicable process type and choose Model Process. The Repository Details window and work area display for the corresponding process type.
  4. Choose the Actions Tab.
  5. Expand the Actions branch.
  6. Choose the Create New icon. The Action Details window displays.
  7. Enter information in the applicable fields. Refer to Table 1 for field level descriptions.
  8. Choose the Save icon.
    Note: It is recommended that all Actions defined by you should contain the prefix "EXTN_" to avoid conflicts between factory-shipped actions and the custom defined actions.
    Table 1. Action details window.

    Action details field value descriptions
    Field Description
    Action Code Enter the action code.
    Action Name Enter the action's name.
    Action Group Enter the name of the action's group, if applicable. Actions belonging to the same group appear together in the Action tab in the Process Modeling tree.
    Invoked Services
    Invoke following services as part of this action Select this if you want this action to invoke a configured service.
    Note: If you configure actions that invoke a service, which inserts messages into an MQ Series queue, ensure that your System Administrator includes the following .jar files in the CLASSPATH environment variable for your application server (IBM® WebSphere®):
    • $MQSERIES_HOME/lib/fscontext.jar
    • $MQSERIES_HOME/lib/providerutil.jar
    • $MQSERIES_HOME/lib/jndi.jar
    • $MQSERIES_HOME/lib/com.ibm.mq.jar
    • $MQSERIES_HOME/lib/com.ibm.mqbind.jar
    • $MQSERIES_HOME/lib/com.ibm.mqjms.jar
    • $MQSERIES_HOME/lib/jms.jar
    Invoked Services List Lists the services that this action invokes. When you check 'Invoke following services as part of this action' you can add additional services by choosing the Create New icon. You can remove services by selecting the applicable service and choosing the Delete icon.
    Service Name The name of the service.
    Service Group Name The name of the service group the service belongs to.
    Others Important: All information in this tab can be configured within the Service Definition Framework. The information in this tab is provided solely for backward compatibility purposes. From Version 5.0 onwards, these should be configured as a service.
    Send to Alert Console Select the check box if you want an alert notice to be sent to a particular user.
    Destination Name Enter the name of the queue the alert should be sent to.
    User Name Select the name of the user who is to receive alert notices.
    Template Enter the Alert Console template. It can be any name followed by an ECT or XSL extension.

    If the template is within the EAR file:

    The value of the Template field specified in the action should be the same as the path to the template file as built within the EAR. The path should be relative to the root of the EAR.

    If the template is outside the EAR file:

    The value of the Template field specified in the action can be the path to the file relative to the path given in the CLASSPATH specified in the application server's startup script.
    Send E-Mail Select the check box if you want an e-mail message to be sent. Enter a template name in the Template field.
    Note: You must configure your e-mail server before you can activate this action.
    Template Enter the name of the e-mail template. It can be any name followed by an MLT extension (if data published is a map) or XSL extension (if data published is an XML).

    If the template is within the EAR file:

    The value of the Template field specified in the action should be the same as the path to the template file as built within the EAR. The path should be relative to the root of the EAR.

    If the template is outside the EAR file:

    The value of the Template field specified in the action can be the path to the file relative to the path given in the CLASSPATH specified in the application server's startup script.
    Call Java™ Extension Select this field if you want to call a particular Java component.
    Class Name Enter the Java class name.
    Execute Select this field if you want to call a particular executable.
    Program Enter the Program (executable) name. Make sure the executable exists in the system PATH.
    Call DB Extension Select this field if you want to call a particular stored procedure.
    Stored Procedure Enter the Stored Procedure name.
    Call HTTP Extension Select this field if you want to call a particular URL.
    URL Enter the URL to be called for the HTTP Extension.
    Send Fax This field is no longer supported.
    Template This field is no longer supported.
    Call COM Extension This field is no longer supported.
    Prog ID This field is no longer supported.
    Publish Data Select this field if you want to publish data to an external system.
    System ID Choose the Create New icon and enter the system ID in the System ID pop-up window.

    If you want to delete an existing system ID, select the system ID you want to delete and choose the Delete icon.

    Note: System IDs cannot be more than 20 characters.
    Note: Only actions linked to the primary enterprise of this node or organization are available in the drop-down. Any actions created from this screen using the create button are linked to the primary enterprise of the user's organization and hence may not be available for the node or organization being created. In a multi-enterprise situation please ensure that actions are created for the appropriate enterprises first (when logged in as that enterprise user). Subsequently mapping of nodes to actions can be done logged in either as an enterprise user or as a hub user.