Use event input information
Summarize
Summary of Use event input information
The Event Input pane in ServiceNow’s Event Rule designer provides essential reference information used to configure event rules and customize alert content. It offers a structured view of event data fields, expressions, and raw event information, helping you transform and compose alerts effectively.
Show less
Key Features
- Event Input Pane Sections: Includes Event Additional Info, Expressions, and Event Raw Info. These sections present default and custom event fields, expressions created from raw or additional data, and raw event form data, respectively.
- Transform and Compose Alert Output: Allows dragging fields and values from the Event Input pane to customize alert fields and tags, directly impacting the generated alert form.
- Edit Modes:
- Standard Edit Mode: Limited editing where you can select and transform text but cannot modify it directly or undo changes.
- Regex Edit Mode: Enables direct editing of text using regular expressions to define fields, with the ability to reset but not undo.
- Creating Expressions: You can create new fields by selecting and transforming text in the Event Raw Info section, which then appear in the Expressions section for use in alerts.
- Field Appearance Control: Use the
emeventruleblacklisttable to hide fields and theemeventruleorderform to control the order of fields displayed in the right-hand pane.
Practical Guidance
- The Event Input pane is read-only in most designer sections except during the alert transformation stage where you can customize alert content.
- When creating regex expressions, ensure variables are included in sequential order to maintain proper input parsing.
- Accessibility settings may disable standard edit mode, affecting how you interact with the Event Input pane.
Related Tasks
This functionality supports tasks such as creating or editing event rules, configuring event rules to customize alert content, filtering applicable events, and setting thresholds to suppress alerts.
The Event Input pane that is included in the steps to create an event rule provides a reference to the information that you can use when configuring an event rule.
In the Transform and compose alert output pane, you can also drag the information into the required fields to customize alert content. The fields in the right-hand pane appear as a reference to which fields, expressions, and their values are available when working in the Event Rule designer. The fields that display in the Transform and compose alert output left-hand workarea become the fields in the generated alert form. In addition, you can define alert tags that are specific for customization.
General components and navigation
The Event Input pane consists of these sections:
- Event Additional Info
- Expressions
- Event Raw Info
The Event Input pane displays in all Event Rule designer sections, except for the Event Rule Info section. The fields in the right-pane can be modified only in the Transform and compose alert output section. In all the other sections, the Event Input pane is read-only and available for reference purposes.
Edit modes
| Mode | Description |
|---|---|
| Standard edit mode |
Text selected in the left-hand workarea cannot be edited. Undo is not available. In this mode, you can only mark the text or values and transform it by selecting a field name. |
| Regex edit mode |
Edit text in the left-hand workarea by selecting it, as required. After you
have edited the text, you cannot go back to the standard mode.
Undo is not available. However,
Reset is available, returning the field to its original
value. You can compose text using regular expression (regex) format conventions, for
example, type (.*) to create a field name. You cannot use field values like: type
"$" to include the value of a field and specify the name of the field in parentheses
{}. You can include special characters in a field by "escaping" them, that is, by prefixing the character with a "\". For example, to include a "\" in your text, enter "\\". |
Event additional info
The Event additional info section displays default event form fields, plus fields that were created to display in alerts and that are added to the Additional information section of the alert.
When configuring text in the fields in the left-hand workarea, you can drag field names and/or their value from this section into the fields.Expressions
The Expressions section is available only if an additional information field was created. You can create expressions from event raw data or from additional information data.
- Click in a field in the Event Input pane to perform transformation actions.
- Create an expression by transforming information and associating it with a field name.
Either select a field name from the suggested list, or create a field name, as
required.
- Click in a field in the Event Input pane. In the left-hand workarea, select the required information.
Create expressions by transforming information and associating it with a field name. Select a field name from the suggested list, or you can create a field name, as required.
Event raw info
The Event raw info section is always available. Its contents are the fields from the Event form.
To transform text, click a field in the right-panel to open it in the work area on the left-panel, in the Mark Expressions section. You can select text in the Mark Expressions section where the selected text becomes the value of a newly created field. Name the new field. This new field is added to the Expressions section.- Use the exclusion list [em_event_rule_black_list] table to hide fields from the right-pane.
- Use the em_event_rule_order form to order the position of each field.
- Fields that are not in the exclusion list and also not part of the em_event_rule_order table, still appear in the event rule designer, in the right-panel and in the Transform and Compose Alert Output tab.