Events Table+

Overview

When to use it

Use this symbol when you need to:

• List the event frames of a search with the columns that matter, such as start, duration, severity and key attributes.
• Filter, sort and group events, and show counts and totals per group.
• Color cells or whole rows by the state of an attribute.
• Open an event's details, trend its attributes, or move the display to the event's time range.
• Let authorized users correct event data or add comments directly in the table.

Choose Alarm Table+ when the symbol itself should raise the alarms from limits instead of listing event frames that already exist.

Before you begin

• Event frames must exist in AF, created by analyses or by your own process, and the operators must be allowed to read them.
• Edit mode, Save, acknowledgement, comments, split, copy, creation and delete write to AF. Operators need write permission on the event frames, and attribute edits need the attribute to be on the event frame template with Manual Data Entry set.
• The table loads at most 900 event frames per search. Your PI administrator can change the limit (see the Installation and Administration Guide).

Add and set up the symbol

1. In the PI Vision navigation bar, open Events.
2. Select Edit Search Criteria (1), choose the AF database and the Event Type, and select Apply. The list shows the matching event frames.
3. In the symbol list, select Events Table+ (2).
4. Drag an attribute of an event frame (3) onto the display. The table shows one row per event frame.

To change the search later, right-click the table and select Search Criteria.... The table shows the events of the search time range, not of the display time range.

Common tasks

Choose, rename and order the columns

Use this to show only what operators act on, in your site's words.

1. Right-click the table, select Configure Events Table... and open Columns.
2. Select a column in the list (1) and set Show (2) to OFF to hide it, for example Description.
3. To rename a column, select it, set Custom Label (3) to ON and type the heading.
4. Use the arrow buttons (4) to move the column up, down, to the top or to the bottom.

The list holds the event properties and every attribute you dragged onto the table. Attributes are added by dragging more attributes onto the table. Here Description is hidden, Speed is renamed to Line speed and Severity moved before Duration.

Filter and group the events

Use this to narrow a long list to the events you act on, and to count them per severity or state.

1. Type a value in the field under a column heading and press Enter. Text filters match part of the text, ignoring case, for example loss. For time and number columns, enter a minimum and a maximum.
2. To group, open Configure Events Table... > Columns, select a column (1) and set Group (2) to ON.
3. Under Table > Group, set Auto Expand to keep the groups open and Count to show the number of events in each group header.

The filter keeps the four matching events. With the filters on, the totals row follows the filtered rows.

Grouping by Severity gives one collapsible group per level, each with its own totals.

Color events by the state of an attribute

Use this to make events such as production losses stand out.

1. Right-click the table and select Configure Multi-State....
2. Select the attribute column in the list, for example Impact, and select Enable Multi-State.
3. Under Property (1), choose how the state is shown, for example Solid Fill.
4. Select Apply to row (2) to color the whole row.
5. Under Status (3), set the color of each state.

Rows whose Impact is Production Loss or Shutdown now carry the state color.

Open an event's details and trend its attributes

Use this to investigate one event without leaving the display.

1. Select the Details button (1) at the end of the row. The Event Details window opens with the tabs Details, Attributes and Comments.
2. Open Attributes (2). It lists the values of the event.
3. Select the trend icon (3) next to an attribute.

The trend shows the attribute over the time range of the event.

To trend all attributes of the table at once, right-click the row and select Open Popup Trend From Row. The popup trend uses the event's start and end, and an event still in progress is trended up to now.

To refresh the values of a closed event from its data, select the camera button (4) on the Attributes tab. It captures the attributes of the event again in AF and needs write permission.

Let authorized users edit events

Use this when users must correct event data or fill in attributes in the table. The edits write to AF.

1. Right-click the table, select Configure Events Table... and expand Interactivity > Edit.
2. Set Mode (1) to Edit.
3. Set Highlight Input Cells (3) to All or Empty to mark the cells users can change.
4. Leave Auto Save (2) off to collect changes until the user selects Save. Turn it on to save each change at once.
5. To block a column, select it under Columns and set Allow Edit to OFF.

The toolbar shows Save and a refresh button. The highlighted attribute cells accept input, and the control depends on the data type: a text field, a check box, or a drop-down list or dialog for enumeration values.

Important: Save writes the changes to AF. The refresh button discards unsaved changes. Delete (off by default) adds delete buttons. Turn it on only when users may remove event frames.

Record who changed an event and why

Use this when edits to event data must be traceable, for example downtime losses that feed a report.

1. Right-click the table, select Configure Events Table... and expand Change Tracking.
2. Set Log Changes (1) to ON.
3. Set Ask for Reason (2) to Optional or Required to ask the user why.

With Auto Save on, the note (3) reminds you that the reason is asked for each saved cell.

When the user selects Save, the Record the change dialog lists every change with its old and new value (1). A save that covers several events puts the event name in front of each line. The user types the reason (2) and selects Save (3). With Required, Save stays unavailable until a reason is entered. Cancel writes nothing and keeps the edits.

Each save writes one annotation to every changed event frame, with the user name and time of the save. A reason becomes the first line, Reason for change: followed by the text. Without a reason, an annotation reads:

Severity: Major -> Minor
End Time: 10/21/2025 6:37:06 PM -> 10/21/2025 6:38:06 PM
Loss: 0 -> 5

Changes made with the Reason picker and in the Event Details window are logged the same way. The annotations appear on the Comments tab of Event Details and in PI System Explorer. Users need permission to annotate the event frames. Created and deleted events, and edits made outside this symbol, are not logged.

Use the symbol

• Sort by selecting a column heading. The sort is saved with the display, so it can mark the display as changed.
• Quick action buttons act on the row. The share icon opens the PI Vision event details page in a new tab. The fork icon splits the event. Details opens the Event Details window. The arrow icon applies the event's time range to the display. Set Asset Context and Apply Context are further buttons you can turn on.
• Right-click a row for Apply Time Range, Open Popup Trend From Row, Event Details and Compare Similar Events by Name or by Type.
• Event Details shows the properties, attributes and comments. Acknowledge, Edit, adding a comment, split, copy and the camera button (it captures the attributes of a closed event again) write to AF and need permission.
• Export: right-click the table and select Export Data..., or use the download button in the toolbar. Formats are csv, json, xlsx and pdf.
• Edit mode: PI Point attributes show only values inside the event's time range. Turn on Prev. Value to show the last value before the event.
• Empty table: no event frame matches the search or a filter hides every row.

Configure the symbol

Right-click the table and select Configure Events Table.... The pane has the sections Columns, Table, Time Bar, Interactivity, Change Tracking, Export Data, Style and Numbers. The right-click menu also offers Configure Multi-State..., Search Criteria... and Export Data....

Columns

Table

Time Bar and Interactivity

Change Tracking

Export, style and numbers

Troubleshooting and limitations

Limitation: Edits, acknowledgements, comments, split, copy, creation and delete write to AF and cannot be undone from the table.

Limitation: Grouping and filtering apply to the loaded event frames only.