Creating application event triggers

An application event 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.
  1. Open the Event Triggers form and execute Filter-In-Place.
  2. Initiate a new record.
  3. Provide 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
    Verify that this read-only field is displaying your Access As identifier.
    Requested By
    Verify that this read-only field is displaying your login user ID.
    Configuration Name
    Specify the system configuration in which the selected event trigger is being created, and whose system configuration parameters control its behavior.

    To indicate that the configuration name matches the name in the Site field on the System Parameters form, leave this field as blank.

    In Process
    Leave this check box cleared.

    When selected, this check box indicates that evaluation of the selected event trigger is in process. A trigger that is in the process of being created cannot be "In Process".

    Active
    To indicate that you want the selected event trigger to be active, select this check box.

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

    If you clear this check box, even when the conditions are met, the event does not get 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
    To indicate that the event should be fired in a single transaction, select this check box.
    Clear "In Process"
    For a new trigger, this button is inactive. It is used to reset an event trigger that is in process.
  4. On the Trigger tab, provide 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
    To open the Event Action Parameter Condition form, which is used to build a condition statement using expressions, click this button.
    Condition Retest Interval (seconds)
    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 (seconds)
    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
    This read-only field displays the date and time the event was last fired as a result of this trigger's condition evaluating to true.
    Retest At
    This read-only 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.

  5. 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.
  6. Click Save.