Notification Manager
Use Case
Notifications in PLCnext Technology are messages referring to special events. The Notification Manager enables sending and receiving notifications between components of a controller. Notifications can also transport user data (payload) which is information data without control or protocol information (no process data, no real-time requirements).
The Notification Manager is suitable for the different scenarios, for example:
- Network settings have been changed
- Network interface up/down (link up/link down: connection established/interrupted)
- New component added
- Recognized error, exception in one component
Concept
Notifications are identified via a notification name that the sender registers with the Notification Manager and thus make it known publicly. Then, it can send notifications.
As a basis, the Notification Manager uses RSC services to transmit messages between the components. Communication can be from one component to one or several recipients.
Notification names are structured hierarchically. Recipients subscribe under the notification name, and then receive all notifications that are published under this or a subordinate name. When a part of the name is indicated, all subordinate notifications can be received.
Both the PLCnext Technology firmware and user-defined components can send notifications. For an overview to the notifications of the PLCnext Technology firmware itself, see Notifications of PLCnext Runtime.
How to
Notifications are available under C++ only.
On using the Notification Manager in a C++ component, please refer to the Using Notifications with C++ section.
User roles with access permissions
The following table shows which user role is authorized to what extent to call the methods of the INotificationLoggerService
or the INotificationLoggerService2
.
SecurityAdmin
and SecurityAuditor
user roles have access, and can only read values.User roles that are not contained in these tables do not have access permission.
INotificationLoggerService
User role | QueryStoredNotifications QueryNotifications
|
DeleteNotifications |
ListArchives |
Other |
Admin |
✔ | ✔ | ✔ | ✔ |
Engineer |
✔ | ✔ | ✔ | |
Commissioner |
✔ | ✔ | ||
Service |
✔ | ✔ | ||
DataViewer |
✔ | ✔ | ||
DataChanger |
✔ | ✔ | ||
Viewer |
✔ | ✔ |
INotificationLoggerService2
Available from 2022.0 LTS
User role | QueryStoredNotifications QueryNotifications
|
DeleteNotifications |
ListArchives |
Other |
Admin |
✔ | ✔ | ✔ | ✔ |
SecurityAdmin |
✔ | ✔ | ✔ | ✔ |
SecurityAuditor |
✔ | ✔ | ||
CertificateManager |
✔ | ✔ | ||
UserManager |
✔ | ✔ | ||
Engineer |
✔ | ✔ | ✔ | |
Commissioner |
✔ | ✔ | ||
Service |
✔ | ✔ | ||
DataViewer |
✔ | ✔ | ||
DataChanger |
✔ | ✔ | ||
Viewer |
✔ | ✔ |