Contents

Events

SAVE AS PDF

Events

Event are special records the system uses to log when certain conditions occur and to
take some kind of action in response to the conditions.

The system uses business rules to monitor for system conditions and to generate event records
in the Event [sysevent] table, which is also known as the event log or event queue.

Event-generating business rules typically use this script logic:

If [some condition is true for the current record], then [add a specific event to the
queue].

For example, here are some of the conditions in the incident event
business rule:

If a user adds a comment to an incident record, add an
incident.commented event.

If a user adds an incident record, add an incident.inserted event.

If a user updates an incident record, add an incident.updated
event.

Event-generating business rules use the GlideSystem eventQueue method to
insert event records, which typically contain this information:

Table 1. Event fields

Field

Description

Name

The unique name of event. Baseline event names include the record effected and the
triggering action such as incident.commented.

Parm1

An event-specific parameter the system uses to pass record information to other parts
of the system, such as a record Sys ID or a field value.

Parm2

Another event-specific parameter the system uses to pass record information to other
parts of the system, such as a record Sys ID or a field value.

Table

The table to which the event applies. This is the same table on which the business
rule ran.

Instance

The Sys ID of the record to which this event applies.

Scheduled jobs periodically read the event queue and forward them to the appropriate handler
for processing. The handler uses information from event records to take some kind of action such
as:

Send a notification

Run a script action

Trigger a workflow activity

By default, the system provides events covering a broad view of application activity. If
existing events do not meet your needs, you can create your own events to watch for specific
changes to records.