Creating application event actions

To be useful, each application event handler must have at least one application event action associated with it. Often, it requires a series of event actions to complete the work the handler is designed to perform.

An event action is defined as a unit of work to be done when the event handler executes.

  1. Open the Event Handlers form.
  2. Create a new event handler; or, in the Grid View, select the event handler for which you want to create the action.
  3. Click Event Actions.
    This launches the Event Actions form, populated with any information that might exist for the event handler already.
  4. To create an action for an event handler that already has event actions defined, in the grid, create a new row.
  5. Provide this information:
    Action Sequence
    Either accept the default assigned sequence number or change it as desired.
    Action Type
    Select the type of action to be performed.

    For the list of action types and what they do, see the context-sensitive help for this field.

    Action Description
    Optionally, specify a description for the action.

    This description is helpful when you have multiple actions with the same action type. This description allows you to find the appropriate action in a list.

  6. Click Edit Parameters. Based on the action type you selected, the system opens the associated event action parameter form, which you can use to construct the parameters for the action type.
    Note: If you are familiar with the parameters, functions, and syntax for the action parameters, you can click Show Details to display tabs where you can manually enter the parameter information in the text field. However, unless you are very confident in your ability to write this data from scratch or you are pasting in data from a reliable source, and to help ensure that you use only valid parameters, functions, and syntax, we recommend that you use the event action parameter forms, which have been designed specifically for this purpose.

    For more information about the event action parameter forms, see the context-sensitive help for each form.

  7. When you are finished setting up parameters in the appropriate event action parameter form, click OK.

    When you close an event action parameter form, the parameters you set up there are automatically returned to the Event Actions form, with the correct syntax. Even so, we recommend that you verify the syntax is error-free by clicking Check Syntax before you proceed.

  8. If the action involves a variable to be used in event messages and you want to restrict how the variable's value is treated, set those restrictions on the Variable Access tab.
  9. Save your work.