A&E-Row/Screen

Via the configuration panel for the table configuration, see also View of the alert and event panel, you can configure a user-defined alert and event panel. The panel contains three tabs: General AES settings, Alerts and Events. Different settings can be made on each tab. The panel opens through the AES settings button behind the Settings tab of the System Management.

Figure 1. Configuration Panel for the View of the Alert and Event Panel - "General AES Settings" Tab"

General AES settings tab

The General AES settings tab is divided into three areas, AES configurations, Global settings and Type of filter.

AES configurations

Here you can define settings for both the alert and the event panel. These settings apply project wide when using this configuration. You can configure the following settings:

  • Activity: If only one table is active, the alert and event panel works in the full screen mode and only one query is executed. Thus, you can select either one table only or both.

  • Type: (Alerts or events)

  • Proportion: This sets the height of both tables in the alert and event panel. The height can be changed through the Proportion button in incremental steps or by manually editing the text field.

  • Properties: (initialization properties for the selected type). These properties are specified in the property panel (for more information, see properties of the alert table). Select an existing property set from the combo box. The default property set is aes_propAlerts.

  • Screen configurations: Allows selecting from the predefined configurations aes_default, aes_alerts, aes_events and aes_command as well as the self created configurations.

    • aes_default: This configuration shows the alert and event panel in split mode.

    • aes_alerts: Shows only the alert table in the full screen mode (events are deactivated).

    • aes_events: Shows only the event table in the full screen mode (alerts are deactivated).

    • aes_command: Commands from a visualization and control system are generally transferred to the periphery. For this purpose, own command data points are used (see chapter state signal simulation). This configuration shows all the command data point groups with users. The data point group "Commands" is used for the configuration aes_command. This group contains all the cmd data points (see also the chapter DP group administration panel).

CAUTION:

In order to save a screen configuration externally (see the openAES() function function), you have to export the following internal data points (types) through the ASCII manager:

_AESConfig, AEScreen and AESProperties!
CAUTION:

When you create a configuration and want to print or save the view automatically, this is not possible when you use a "Bottom table" configuration with, for example, a query over the last 24 hours. In order to save or print data automatically, you have to create a "Top table" configuration with closed mode (see properties of the alert panel).

Creates a new configuration.

Saves the configuration.

Changes the name of the current configuration.

Deletes the current configuration.

Opens the property panel.

Global settings

In addition, the following settings can be made independent of the type of the table:

  • Visibility of the slider elements (changing the height, maximizing the table size).

CAUTION:

When you set the visibility of the slider elements, restart the UI manager that was used to open the AEScreen.

  • Deny "all visible alert" acknowledges that you can acknowledge all alerts individually. The common confirm button cannot be selected (appears dimmed and is not available). Without this option, you can acknowledge alerts also through the button, in addition to the option in the context menu, together with alerts of other data points.

CAUTION:

When you open the alert and event panel in the VISION with the -extend option, the acknowledgement button of the VISION is not disabled and the button is shown.

  • Defining whether the printer selection window is opened for printing or the standard printer is directly used. The current filter settings are used for the printout.

  • Hide empty rows (bottom/top table): The empty rows are not shown in the alert/event screen (top table: alerts, bottom: events).

Note:

The printer selection window is not available under Linux

Type of filter

In the area Type of filter the user can decide which other users/groups are allowed to modify the properties in the AES table configuration. The following types of filter are available:

  • "None" - no type of filter will be define

  • "Global" - all global (root/admin) users are allowed to make modifications

  • "Group" - only users of a defined group are allowed to make modifications. The group can be selected from a combo box.

  • "User" - only the selected user is allowed to make modifications. The user can be selected from a combo box.

Context menu settings

Here you can specify which options are available in the context menu of the alert and event panel:

  • Title

  • Acknowledge: acknowledge the selected alert/warning

  • Acknowledge all visible: acknowledge all visible alerts/warning

  • Insert comment: Opens the following window, which allows you to add a comment:

Figure: Add a comment

  • Process panel

  • Trend: Opens the panel variable trend

  • Details

  • Sumalert details

  • Display help info

  • Properties: Opens the properties panel

  • Close: Closes the context menu

  • Change priority/alert class

Figure: Context Menu of the Alert and Event Screen

Note:

If a new group was defined, you have to restart the AES table configuration, before you can select it in the combo box.

The system checks what UIs are running at the moment and the AES runtime data points (data point _AESProperties) of those UIs that are not running at the moment, are deleted. You have to have administrator rights to delete the data points.

Allows editing the configuration of the alert row. The configuration created here can be selected for the alert row (see chapter STD_PANELS). Only the upper table (alerts) can be changed for the alert row.

CAUTION:

If you want to use the object "alert row" in a panel of your project, use the symbol catalog in WinCC OA (see also The catalog window). If you insert the reference panel "AESRow" into a panel of your project by using the button "PanelRef", replace the defined $ parameter "$SCREENTYPE" by a meaningful configuration name (e.g. aes_alertRow) to avoid errors.

CAUTION:

You need the authorization level 3 (Advanced operator authorization) in order to configure the AES row. For more information on the authorization levels, see chapterAuthorization levels.

Note:

If you set columns for the alert row, you specify thereby the minimum width. The remainder of the columns are set dynamically.

Note:

If you want to start or stop the alert row by means of a script, you can use the functions aes_doStop and aes_doStart. These functions can be used as follows:

main()
            {
  string dp = _AES_DPTYPE_PROPERTIES + "RTRow_" + myManNum() + "_" + myModuleName()+"_Top";
             //find out the current alert row

            DebugN("Setting an alarm filter for AES property", dp);

            aes_doStop(dp);

            dpSetCache(dp+".Alerts.Filter.DpList",makeDynString("ExampleDP_AlertHdl2."));
            //the alert of the data point ExampleDP_AlertHdl2. is shown
             aes_doStart(dp);
            }

Using this code, you can set the data point for which the alerts are shown.

Loads the standard configuration of the four default configurations aes_default, aes_alerts, aes_events and aes_command. If you have, for example, executed changes and want to use the original configuration after all, use this button.

Alerts and Events tab

CAUTION:

Note that the settings made on the alerts and events tab apply to the alert and event panel in general and not to a specific screen configuration.

The alerts and events tabs are divided into two areas, Table settings and Column settings.

Figure 2. Configuration Panel for the View of the Alert and Event Panel - "Alerts" Tab

Table settings

The following general settings can be configured per table type (alerts or events):

  • Font color

  • Background color

    Select a defined color from the combo box or set the desired color manually via the color selector (click the button next to the combo box ). By selecting the option "alternating colors" you can select which colors the background of the individual rows should alternate in order to increase the readability of the alert and event screen. Select the colors via two color selection dialog windows.

Figure 3. Alert Screen and alternating Colors as well as the context menu
  • Grid color

    Select a defined color from the combo box or set the desired color manually via the color selector (click the button next to the combo box ).

CAUTION:

Any color changes of the columns are applied and shown only at the next restart of the alert and event panel.

  • OnDblClick()

    Function call when you double-click a row. The following options are available in the combo box for alerts:

    1. None

    2. DisplayDetail: Shows the details of the alert.

    3. displayAlertPanel: What panel should be shown is configured when the alert handling on the data point element (see _alert_hdl (Alert handling parameter tab) is configured. The panel is specified on the alert handling parameter tab.

    4. DisplayAlertHelpInfo: This can be a panel (*.pnl), a HTML file (*.html) or a text file (*.txt). The panel that will open, is specified at the configuration of the alert handling on the data point element (see alert_hdl (Alert handling) and parameter tab). The panel is specified on the alert handling parameter tab. If you want to open an HTML file, you have to copy the HTML file (for example,. AlertInfo.htm ) to PROJ_PATH/help/lang/Webhelp. The same HTML file also has to be selected in the alert class.

    5. doAcknowledge (acknowledge alerts through double click).

CAUTION:

Note that OnDblClick() is valid when you double-click a row. If you click again on a column, OnKlick() is valid (see chapter column configuration).

  • Use alert class font style: This activates the font properties (bold and italic) for the alert class. The alert class configuration (meaning the font in the alert class) has to be set accordingly (see _alert_class (alert class)). This setting is valid for alerts only.

  • Screen font: This sets the font for the tables in the alert and event panel. A different font can be set for each language. You have to open the Table configuration panel in the desired language and set the desired font (you have to switch once between the languages in a multilingual project so that the fonts are applied). The alert and event panel opens using this font. If you do not set a font for a language, the default font will be used. The default font is also used if you open the font selector and close it immediately via OK.

Configure functions: This shows the user-defined functions. Here you can include new functions. These functions have to correspond to the API functions. The DLL TabUtilEx.dll is required for the functions. The DLL has to be copied to the bin directory of the version. Execute the following steps:

  1. Install API if it had not been installed together with the WinCC OA version (see chapter API installation).

  2. There is a sub directory SampleTabUtil in the API directory. Compile the example.

  3. The TabUtilEx.dllis generated. Copy theTabUtilEx.dllinto thebindirectory.

  4. Open the Table configuration panel via System Management.

  5. Create API (C++) functions (for an example of API functions, see the SampleTabUtil.cxxfile in theAPI/SampleTabUtil directory) and then create the corresponding functions (that correspond to the API functions) via the Alerts/Edit functionspanel (see figure below).

CAUTION:

When creating new functions via the Alerts/Edit functions panel, the names and types of the functions as well as the parameter numbers for the functions HAVE to correspond to the names, types and the number of parameters for the API functions, otherwise a crash can occur. New functions should only be created by experienced WinCC OA users.

  1. The created functions can be selected under Value/API functions in the column configuration panel.

Figure 4. Alerts/edit Functions

Adds a function to the panel. Define first the function name and add it via the button to the table. The function is shown in the view area (see figure above).

Adds the arguments selected via the ... button, to the function.

Deletes the selected function.

Moves the function in the table one line up.

Moves the function in the table one line down.

Opens the Alerts / edit functions panel (see below). By means of this panel, you can add arguments (parameters) to the function.

Figure 5. Alerts / edit Functions Panel

Column settings

Settings such as the order of the columns or the properties of the columns can be made here. The settings are configured in the Column configuration panel and shown in the column settings panel. You can configure the following:

  • Create/Delete/Rename columns

CAUTION:

When new columns are added, these are not automatically visible in the alert and event panel. The columns have to be set visible in the properties panel.

  • Change the column positions

  • Define the column visibility (column V)

  • Set the alert class font color for the font (column F).

  • Set the alert class background color for the columns (column B).

  • Dynamic column width (D) (see table configuration).

  • Definition of the column width (table column W).

  • Properties of columns. You can define what should be shown when you click on a column (table column OnClick).

There are available and visible columns per table type. The italic font means availability. The visible columns define the order in the table of the alert and event panel. There are also protected columns. These columns are predefined and appear dimmed. Both lists contain already predefined columns.

CAUTION:

Under Linux, the Locals/Time formats defined in the system are used for the presentation of time. The file LC_TIME under /usr/share/local is read out and the time format of this file is used.

CAUTION:

Note that when you sort by time in the alert and event panel, the sorting works only when the time is displayed in the format Year/Month/Day/Hour/Minute/Second.

The following buttons are available for the settings described:

Opens the column configuration panel for changing the properties of a selected column (this panel can also be opened by double-clicking on the desired column). See chapter column configuration for more information.

Creates a new column. A maximum of 45 columns can be added.

Moves the selected column to the right. The order of the columns in the table of the alert and event panel is moved to the left.

Moves the selected column to the left. The order of the columns in the table of the alert and event panel is moved to right.

Changes the name of the column.

Deletes the selected column.

CAUTION:

The columns are deleted definitively and a great deal of properties are adjusted automatically!