Creating Event Triggers

A trigger is a condition that causes an application event to fire. Triggers can be based on conditions that are created in these cases:

  • By user actions, such as saving and closing a form, changing a record, and so on
  • Apart from user actions, such as the passage of time or the result of a database calculation
    Note: The Event Triggers form is used to set conditions of the second type.

To create an event trigger:

  1. Open the Event Triggers form.
  2. Select Actions > Filter > Cancel in Place.
  3. Select Actions > New.
  4. Specify this information:
    Event Name
    Select the application event for which you want to define a trigger.
    Note: You cannot define a trigger for a framework event.
    Access As
    Disabled. This field displays the current Access As identifier, which is used to identify who created the metadata object.
    Requested By
    Disabled. This field displays who created the event trigger.

    If you are creating a new event trigger, this field display the user ID for your current logon.

    Configuration Name
    Specify the system configuration in which the selected event trigger was created, and whose system configuration parameters control its behavior.

    Leave this field as blank to indicate that the configuration name matches the name in the Site field on the System Parameters form.

    In Process
    Disabled. This check box indicates that evaluation of the selected event trigger is in process.

    To reset the event trigger if you have evidence that the processing malfunctioned, click the Clear "In Process" button.

    Active
    Select this check box to indicate that the selected event trigger is active.

    When you select this check box, the event service monitors the condition. Whenever the condition is met, event handlers associated with that event are executed.

    When you clear this check box and even when the conditions are met, the event is not triggered and no event handlers for it execute.

    You can use this option to test a new event trigger or temporarily disable an event trigger.

    Transactional
    Select this check box to indicate that the event should be fired in a single transaction.
    Clear "In Process"
    Click this button to reset the event trigger.
  5. On the Trigger tab, specify this information:
    Condition
    Specify the condition that causes the event to fire.

    This condition typically involves either a time operation or a database calculation, or both. Each condition consists of one of these values:

    • A Boolean keyword
    • Two non-Boolean expressions separated by a comparison operator
    Edit
    Click this button to open the Event Action Parameter Condition form, which is used to build a condition statement using expressions.
    Condition Retest Interval
    Specify the number of seconds the system is to wait before retesting for the condition, in the case where the test for the condition returns a negative value.

    For example, if you want the system to wait five minutes before testing for the condition again, specify 300 in this field.

    Note: The Minimum Interval setting on the System Configuration Parameters form overrides this setting. For example, if you set this field to 300 and the Minimum Interval field is set to 600, the system does not retest for the condition until 600 seconds have passed.

    If set to 0 (zero), the system does not retest for the condition after the initial test.

    Trigger Reset Interval
    Specify in this field the number of seconds the system is to wait after an event fires successfully before the condition can be tested for again.

    For example, if you want the system to wait five minutes after the event fires before it can fire again, specify 300 in this field.

    Note: Similar to the Condition Retest Interval field, the Minimum Interval setting on the System Configuration Parameters form overrides this setting.

    If set to 0 (zero), the system does not reset the condition after it fires successfully.

    Last Fired
    Disabled. This field displays the date and time the event was last fired as a result of this trigger's condition evaluating to true.
    Retest At
    Disabled. This field displays the date and time at which the system is set to retest for this condition.

    The data in this field is influenced by a number of different factors, which includes the event handler or trigger condition settings, retry interval settings, and when the event last fired.

  6. On the Parameters tab, specify the names and values for any event parameters for which you must pass values to the event handlers when the event fires.
  7. Click Save.