Configure an events table

Use the Configure Table pane to configure the columns, style, and criteria for events of an events table. Upon creation, the table shows the events from the Events pane, and those search settings are copied to the Configure Table pane. After you create the table, use the Search Criteria menu to change the search criteria that sets the events that appear in the table. The Configure Table pane opens automatically when you create an events table.

1. To open the Configure Table pane, right-click the events table and select Configure Table.

2. Under Attributes, customize the attribute columns that appear in the table. To add an attribute column to the table, if necessary first select Modify Attribute List to open the list of unused attributes. Select the unused attribute(s) that you want to add, then select the large Add Attributes up arrow to move them into the Current Attributes list.The available attribute columns include:

   • Asset: View the name of the asset associated with each event.

   • Asset Path: View the path in PI AF to the asset associated with each event.

   • Event Type: View the event type of each event.

   • Start Time: View the start time of each event, including the date.

   • End Time: View the end time of each event, including the date.

   • Acknowledgment: View whether each event has been acknowledged by a user. If an event was not acknowledged and you have permission to acknowledge it, a button appears in this column allowing you to acknowledge the event.

   • Acknowledged By: View which user in your organization acknowledged each event. This column appears blank for any events that were not acknowledged.

   • Acknowledged Date: View the date and time when each event was acknowledged by a user. This column appears blank for any events that were not acknowledged.

   • Severity: View the severity level of each event.

   • Duration: View the duration of each event.

   • Reason: View and edit the reason for each event.

     The reason is available only when a reason trait is identified for an attribute in the event template. This requires PI AF server version 2017 R2 or later. For information about how to configure reasons, see KB01700 - Set Event Reason Codes in PI Vision.

   Note: Event frame attributes that you added to the table are listed, preceded by the pipe character (|). Reference element attributes that you added to the table are listed, preceded by the element naIme and the pipe character (|). If you remove an event frame attribute or an element attribute from the table, it appears in the Additional Attributes list during the current session.

   In addition to the default attributes listed above, you can also add attribute columns to an events table by dragging and dropping attributes from the Events pane.

   To remove an attribute column from the table, if necessary first select Modify Attribute List to open the list of unused attributes. Select the attribute(s) that you want to remove in the Current Attributes list, then select the large Remove Attributes down arrow to move them into the unused attributes list.

3. To change the order that attribute columns appear in the table, you can either select an attribute in the Current Attributes list and use the small arrow buttons to move its position or you can select a column header in the table and drag it to a new position.

4. If you want to change the column header text that appears in the table for an attribute, if necessary first select Modify Attribute Properties. Select the desired attribute in the Current Attributes list, then in the Label field select <Custom>. Replace <Custom> with the text that you want to appear in the table as the attribute's column header. You can change the header text only for attribute columns that you manually added to the events table from the Events pane; you cannot customize the header text for any of the default columns that are provided in an events table.

5. If you want to customize how text is aligned within column cells, if necessary first select Modify Attribute Properties. Select the desired column(s) in the Current Columns list then select an Alignment option to align text either left, center, or right.

6. To change the units of measurement for a column, if necessary first select Modify Attribute Properties. Select the desired column(s) in the Current Columns list then in the Units field select the units from the list. Only units appropriate for conversion from the base unit are listed.

7. To show units of measurement in the table for any attribute values, if necessary first select Modify Attribute Properties. Select the desired attribute(s) in the Current Attributes list, then select the Show Units check box.

8. If you want the values for any attributes to always appear in their entirety so that they are not truncated, if necessary first select Modify Attribute Properties. Select the desired attribute(s) in the Current Attributes list, then select Wrap text. When this option is selected, values in the table appear on multiple lines if necessary to display the values' entire text. If you do not select this option, values in the table appear on only one line and they are truncated if they do not fit within the column width.

9. Under Numbers, customize the format of numbers in the table.

   Format	Description
   Database	Show numbers in a format that depends on the data item: For PI points or PI AF attributes with a PI point data reference, the format depends on the value of the point's DisplayDigits attribute: Zero or positive numbers specify the number of digits to display to the right of the decimal point. Negative numbers specify the number of significant digits. For PI Vision calculations or PI AF attributes without a PI point data reference, numbers show 5 significant digits. All data items show the thousands separator.
   General	Show all significant digits for numbers except for trailing zeros. If the absolute value of the number is greater than 1x107 or less than 1x10-4, the format will switch to use scientific notation.
   Number	Show numbers in the custom format that you specify: Decimal Places The number of digits shown after the decimal. Use 1000 separator Select this check box to show the thousands separator in large numbers.
   Scientific	Show numbers in the format 0.00E+00.

10. Under Font, select your preferred font in the Name field.

    Note: If the selected font is not installed on your system, an alternative font is used by the browser. Roboto and Roboto Slab are installed with PI Vision, so that they display consistently for all users.

    To change the font size, either:

    • Select or enter a size in the Size field.

    • Use the Increase Font Size and Decrease Font Size buttons to change the size incrementally.

11. Under Style, change the appearance of the table to by selecting the light, dark, or striped table style.

12. If you want to reset all the settings in the pane to the default settings, select Reset to default.

13. If you want to save the current settings as the default settings for events tables, select Save as default. The saved settings are applied by default when a user creates a new events table, and they are applied when a user selects Reset to default in the Configure Table pane.

    Note: You need to have administrator privileges to save defaults.

14. To add multi-state behavior to event frame attribute columns, select the down arrow at the top of the pane and then click Add Multi-State.

    For details, see Multi-state behaviors.