Universal Event Templates
Universal Event Templates
Universal Events are administrator-defined events with administrator-defined attributes.
Universal Events can be defined:
Globally | In a Universal Event Template. |
Locally | As part of a Universal Extension-based Universal Template. |
Note
When publishing Universal Events through the Web Service API or an extension-based Universal Task Publisher, take into consideration both Universal Controller server and Database server sizings.
Global Universal Events
For any global Universal Event, you must define a Universal Event Template for it to allow the event to be monitored by a Universal Monitor.
Local Universal Events
If a Universal Template type is Extension, and the Universal Extension can generate a local Universal Event, you must identify the Event by using the Event Templates tab on the Universal Template Details to allow the event to be monitored by an Universal Monitor.
Global and Local Universal Events
Additionally, Extension-based Universal Templates can publish global Universal Events.
Creating a Universal Event Template
Step 1 | From the Automation Center navigation pane, select Configuration > Universal Event Templates. The Universal Event Templates list displays a list of all existing Universal Event Templates. Below the list, Universal Event Template Details for a new Universal Event Template displays.
|
---|---|
Step 2 | Enter / select Details for a new Universal Event Template, using the field descriptions below as a guide.
To display more of the Details fields on the screen, you can either:
|
Step 3 | Click a Save button. The task is added to the database, and all buttons and tabs in the Universal Task Details are enabled. |
Note
To open an existing record on the list, either:
- Click a record in the list to display its record Details below the list. (To clear record Details below the list, click the New button that displays above and below the Details.)
- Clicking the Details icon next to a record name in the list, or right-click a record in the list and then click Open in the Action menu that displays, to display a pop-up version of the record Details.
- Right-click a record in the a list, or open a record and right-click in the record Details, and then click Open In Tab in the Action menu that displays, to display the record Details under a new tab on the record list page (see Record Details as Tabs).
Universal Event Template Details
The following Universal Event Template Details is for an existing Universal Event Template.
Depending on the values that you enter / select for these fields, more (or less) fields may display. See the field descriptions, below, for a description of all fields that may display in the Universal Event Template Details.
Universal Event Template Details Field Descriptions
The following table describes the fields, buttons, and tabs that display in the Universal Event Template Details.
Field Name | Description |
---|---|
Name | Name of this Universal Event. |
Label | User-friendly display name for this event, to be displayed within the client. The Label must be unique for Global Events and unique within Local Events.. |
Description | Description of this event. |
Time To Live | Default value for the length of time, in minutes, that the Universal Event data is valid. This value can be unspecified (null). The Time To Live value can be overridden in the published event. If the Time To Live does not exist in the published event, then this value, if defined, will be used. If neither value exists, the Time To Live is 0, which means the event is deleted as soon as it is published. |
Unmapped Attributes Policy | Defines how unmapped/unknown attributes that are in the published event are handled.
|
Attributes | Name, Label, and Type of each attribute.
|
System Event | Indication if this type of event is a System Event. |
Pre-Defined Global Universal Event
Universal Controller is pre-populated with a System Property Changed global Universal Event system template.
(System Templates are read-only and cannot be deleted. During a new installation or a maintenance update, System Templates are imported.)
System Property Changed Universal Event
Whenever a Universal Controller system property is updated (from an active or passive node), a UAC - Property Changed Universal Event will be published.
The event attributes shown below.