Configuring Event Handlers

Event handlers are defined by events, condition, priority, and actions. When an event is received, the corresponding event type and condition of the handler are evaluated based on the priority. When a condition is met, the corresponding actions are performed according to the event attributes. The action can update or add event attributes to the events for subsequent processing of the same event. An action invokes a function provided by a processor and must provide the parameters required by that function. After an event handler has completed its processing, event processing continues with the next applicable event handler.

To configure event handlers:

  1. In the VTA Configuration Manager navigation pane, select Edit.
  2. Select Current Event Handlers.

    A list of configured event handlers appears. For example:

    Image g015847.gif

 

You can create, delete, or modify event handlers.

  • To add an event handler, enter a name for the action in the New Event Handler box, and click Create.
  • To delete an event handler, click Delete next to the event handler that you want to delete.
  • To modify an event handler, select the event handler that you want to modify.

If you create or modify an event handler, the event handler configuration screen appears. For example:

Image g015942.gif

Event Handler Fields

In VTA Configuration Manager, you can edit the following fields in the Event Handler screen.

Priority

  • Priority for evaluating and running this event handler.
  • Value—Integer in the range 1–1000; the smaller number has the higher priority
  • Default—No value

Events

  • List of events.
  • Value—Select from the list of configured events. Use the Ctrl or Shift keys to select multiple events.
  • Default—No value

Condition

  • Condition that the event handler evaluates to determine whether the event handler should handle the event.
  • Value—You can specify the condition as a formula, as a JavaScript program, or as one of the following values returned by the JavaScript program:
    • true—Event handler should handle the event.
    • false—Event handler should not handle the event.
  • Guidelines—If no condition is specified, true is returned as the value. If a referenced attribute does not exist in the event, the referenced attribute’s value is null.
  • Default—true
  • Example—The following example is a condition that must be met to refill a quota:
    var newBalance=<balance_BoughtQuota>+<balance_PeriodicQuota>;
    if(<old_balance_PeriodicQuota>==null) <old_balance_PeriodicQuota>=<balance_PeriodicQuota>;
    if(<old_balance_BoughtQuota>==null) <old_balance_BoughtQuota>=<balance_BoughtQuota>;
    return <old_balance_PeriodicQuota>+<old_balance_BoughtQuota><=0&&newBalance>0;

Actions

  • Actions that the event handler performs in response to an event.
  • Value—Use the Add and Remove buttons to create a list of selected actions. Multiple actions are performed in the order specified in the list.
  • Default—No value