MESSAGES: Error List, Logging and Desktop Notifications/Alerts
Messages reported by the system are output in the MESSAGES window (located in the Cross Function Area), or they are displayed as desktop notifications/alerts.
 MESSAGES | You can hide/show the window by clicking the button shown left on the Cross Function Area toolbar. For closing the window, you can also click the cross icon on the right of the window title bar:  |
 | If at least one new element is added to the window while it is closed, the icon on the Cross Function Area toolbar is shown with an envelope icon. |
How to pin/unpin the window in the Cross Function Area
You can open several windows in the Cross Function Area at the same time by pinning them. Only if pinned, a window remains visible when another window is opened. If a window is unpinned, it is closed when you open another window.
To pin/unpin a window, click the pin icon in the upper right window corner. Unpinned windows show horizontal pin icon
, pinned windows show the icon
.
How to undock/dock the window
/
By clicking the 'Undock' icon
in the window title bar, the window can be undocked from the user interface and placed anywhere on the screen (or on a second screen, if available).
To insert it at its original position, click the 'Dock' icon
.
The MESSAGES window provides several categories which can be activated via the corresponding button in the window toolbar. The categories can be combined to show several outputs.
This topic contains the following sections:
Error List
The Error List displays errors, warnings and information messages concerning the current project and which can be resolved by the user. Mainly these are compiler/parser errors and warnings that appear during programming (continuous background check) as well as, for example, invalid IP settings.
Automatic background compilation:
While editing the project, the compiler is automatically executed after a modification. This way, detected errors are reported without a manual compiler start. The error list in the message window is only updated after completing the compilation.
Logs
Several logs can be used to track the system activities. These logs are saved persistently with the project and the messages are restored when opening the project (as long as they are not resolved). The log to be displayed can be selected in the MESSAGES window toolbar.
An incoming new message in a log which is not visible, is indicated with the + icon:
The context menu in the logs provides access to all the functions available for the logs. It allows you, for example, to export the log entries to an *.csv file, delete entries of a specific log or of all logs, etc. (see below for a description of the various functions).
Log type | Message type |
Project Log | Stores messages on tool- and project related events and events concerning the engineering environment. It logs, for example, errors during import of gsdml or fdcml files, or information on the last PLCopen XML import (see topic "Importing Types (POUs, Data Types)"). It, however, only considers standard (non-safety-related) events. |
Online Log | Stores messages from the standard (non-safety-related) runtime (eCLR error catalog) and other errors/warnings concerning the online communication with the standard controller and the Safety PLC. |
Safety Log | Stores any editing operations and messages that relate to safety-related project parts. Refer to the section "Safety Log" in the topic "Safety-Related Application" for details. |
Desktop notifications/alerts
PLCnext Engineer creates notifications in some cases, for example, to inform about build steps/results or successful/failed engineering events.
There are three types of notifications: information, warnings, errors. The severity of these types is indicated by the border color and a corresponding icon.
- Notifications which are shown in the upper right corner of the screen.
These notifications are non-modal, i.e., they can remain visible while PLCnext Engineer can continue to be operated and they disappear automatically after a few seconds. You can close the notification by clicking the x icon and browse through the messages by clicking '<' and '>'.Double-clicking a notification jumps to the cause of the message if a jump target is available.
Examples
- Notifications and alerts which are shown in the center of the screen.
These are modal, i.e., PLCnext Engineer cannot be operated any further until the current message has been confirmed.
Example
What do you want to do?
Jump to cause of message (error list, logs and desktop alerts)
To directly access the editor in which the cause for the message was detected simply double-click on the corresponding message. The corresponding editor appears with the suspected position marked.
In the MESSAGES window, you can alternatively select 'Jump' from the context menu of the message text. The command is inactive if the reason of the message cannot be determined or displayed (e.g., for many log entries).
Note
Jumping to the cause of a message is even possible while the background compilation is active. |
Filter the messages (error list and logs)
The list of displayed messages in all categories of the window can be filtered with predefined filters or by text:
- Filtering with predefined filtersThe predefined filters are shown by left-clicking the filter icon at the top right above the table (see following figure). In the appearing selection list, activate/deactivate the desired filter. The settings are directly applied when activating/deactivating a checkbox. The activated filter is indicated by the framed filter icon.
To deactivate the filter, click the filter icon again and deactivate the checked filter options.
- Filtering by textThe table allows a search for specific elements. The search operates on all visible texts in the table except the group names. The search text is entered into the 'Search' input field at the top right above the table. The search is directly applied to the table when entering the text. All strings that match the entered text are highlighted.
To deactivate the search, i.e., to delete the search string entered, click the delete icon
on the right of the 'Search' input field.
An active filter is indicated by the
icon in the first column.
Sort the messages (error list and logs)
The table can be sorted alphabetically in ascending, descending or unsorted order where each column can be used as sort criterion. To sort the table by the column data, left-click on the column title field (an arrow up/down icon above the column name shows the sort order). To toggle through the sort order, click the column title field again.
Get help on messages (error list and logs)
Pressing <Shift> + <F1> while a message text is selected or right-clicking a message text and selecting the context menu command 'Help' opens the online help providing information for the error.
Copy message text (error list and logs)
Using the Windows default shortcut <Ctrl> + <C> you can copy messages to the Windows clipboard. Multi selection of entries is possible as usual. For example, hold the <Ctrl> key down while clicking the desired lines or press <Ctrl> + <A> to select all list entries.
Export log entries to a *.csv file (logs)
To export all the entries within the various logs to an *.csv file, proceed as follows:
- Right-click in the corresponding log and select 'Export To CSV File' from the context menu.
- In the 'CSV Export' dialog choose the file path and the name of the file and press 'Save'.
Delete log entries (logs)
To delete the entries of a specific log, activate the log, select the context menu command 'Delete Entries Of The Current Log' and confirm the prompt with 'Yes'.
To delete the entries of all logs, right-click into any log, select the context menu command 'Delete Entries Of All Logs' and confirm the prompt with 'Yes'.