Creating Event Handlers

In its most basic form, an event handler consists of the following:

• An association with a particular event
• A handler sequence number
• One or more actions to perform when the event is triggered

To create an event handler:

1. Open the Event Handlers form.
2. Press F3.
3. Select Actions > New.
4. In the Event Name field, do one of the following:
   • Select the event for which you want to create a handler. This sets up the event handler for an already-defined event.
   • Enter the name for an event which has not been previously defined.
5. Enter a description for the handler. This description is helpful when you have multiple handlers with the same name, because it allows you to find the appropriate handler in a list.
6. (Optional) To control the handler sequence with respect to other developers' handlers, use the Keep With and Chronology fields. For more information, see Keep With and Chronology.
7. Save the new event handler.
8. Use the Event Actions button to open the Event Actions form and create the actions to be performed when this event handler is executed.
9. After closing the Event Actions form, set the other options on the Event Handlers form as desired. For information about the other options, see the online help for each option.
10. Save the event handler.

Note: Events and event handlers are defined for an application database, not a particular site.  To allow an event handler to run only at certain sites on a database, specify the sites in the Applies To Sites field on the Event Handlers form.

For more information, see "About Event Handlers" in the Guide to the Application Event System.

To see a graphical (diagrammatic) representation of the event handler and its actions, click the Diagram button, which opens the Event Handler Diagram form. This form also allows you to edit and even add event actions to the event handler flow.

Related Topics

Events Overviews and Processes

Event Handlers