Event- Global

The Event API provides methods that enable the setting and getting of values within an event.

These events are sent from a MID Server to a ServiceNow instance. Before you are able to successfully send events, the connection between the MID Server and the ServiceNow instance must be defined.

Use the Event API to add/update fields within an event. Use the SNEventSenderProvider API to instantiate an event sender object. Then use the IEventSender API to send the event to a ServiceNow instance.

You must activate the Event Management (com.glideapp.itom.snac) plugin before attempting to access this API. The Event Management plugin requires a separate subscription and must be activated. This plugin includes demo data and activates related plugins if they are not already active.

For additional information on event management, see Event Management.

Parent Topic:Server API reference

Event - Event()

Instantiates an Event constructor.

var event = new Event();
var esource = event.getField("source");
var eseverity = event.getField("severity");       

Event - getField(String field)

Returns the current value of the passed in event management field.

var event = new Event();
var eventSource = event.getField("source");
var eventSeverity = event.getField("severity");       

Event - setAdditionalInfo(String additionalInfo)

Replaces the existing additional_info field in the associated event with the passed in JSON string.

Note: You can use the setField() method to update a specific field within the additional_info field.

event.setAdditionalInfo("{\"evtComponent\":\"Microsoft-Windows- WindowsUpdateClient\",\"evtMessage\":\"Installation Failure: Windows failed. Error 0x80070490\"}");

Event - setField(String key, String value)

Sets the specified field in the associated event.

If the passed in key matches a predefined event field, the method updates the corresponding event field. Otherwise, the method adds the key parameter to the additional_info section of the event before applying the passed in value.

The following are the predefined event fields that you can modify using this method:

Note: You can also use the setText() method to update the description field and the setTimeOfEvent() method to update the event time.

For additional information on events, see Event Management.

var event = new Event();
event.setField("source","SAP Solman");
event.setField("severity","3");
event.setField("time_of_event", "2019-18-05 13:12:05");
event.setField("type", "SAP object");
event.setField("user", "admin"); // parameter will be added to additional_info section       

Event - setText(String text)

Sets the description field of the associated event to the passed in value.

Note: You can also use the Event - setField(String key, String value) method to set the text field in the current event. Unlike the setField() method, this method does not trim the passed in text.

var event = new Event();
event.setText("SAP Solman");       

Event - setTimeOfEvent(String timeOfEvent)

Sets the time_of_event field in the associated event to the passed in UTC time value.

Note: You can also use the Event - setField(String key, String value) method to set the time_of_event field.

var event = new Event();
event.setTimeOfEvent("2019-18-05 13:12:05");