User notifications
Introduction to user notifications
Universal GUI main administrator application administrator group administrator group owner user administratorDepending on your rights, you can send a notification to all the users within a tenant, application, or user group, or the subset of users you are responsible for.
You can send notifications to users in three ways:
- As an in-app notification from IAM. See In-app notifications.
- As an email notification from IAM. See Email notifications.
- As an in-app notification that is part of a system flow, for example, to notify a user that a file has been uploaded. You can configure these notifications only in the Software Factory. See System flow notifications.
In-app notifications
main administrator application administrator group administrator group owner user administratorTo send an in-app notification:
menu Authorization > Tenants/Applications/User groups/Users
- If necessary, select a Tenant.
- Start the task Add notifications .
- Select the Notification type: In-app notification.
- Add the Text you want to send.
- Add an expiration date and time.
Notifications are sent to the specified users as soon as they are logged in or, if they are already logged in, when they interact with the GUI.
Email notifications
main administrator application administrator group administrator group owner user administratorWithin IAM, you can send email notifications to users. Use this, for example, to inform users of an application about planned system downtime. You can only email users with a registered email address in IAM.
1. Configure an email provider
main administratorTo send notification emails, you must first set up an email provider for IAM.
See Email providers.
2. Configure a template
main administratorTo be able to send email notifications, you need to configure an email template. If you configured a template in the user's preferred language, they will receive it in that language. If not, IAM uses the template that you marked as default (see step 4).
To configure a template for your notification email:
menu Settings > Global settings > tab Email templates > tab Notification email templates
-
Enter a Template name.
-
In the tab Configurations, select the Notification email template.
-
Select a Language.
-
Optional: If you want this to be your default template, select the Default template box.
-
Enter a Title and Email body.
You can personalize the email with parameters in the template's email body. The available options are
{first_name}
and{sur_name}
. They will be replaced with the users' first name and surname. If this information is not available, the parameter will be left empty. You can use this, for example, asDear {first_name} {sur_name}
.
A template for a notification email
3. Send the notification emails
main administrator application administrator group administrator group owner user administratorTo send an email notification:
menu Authorization > Tenants/Applications/User groups/Users
- Start the task Add notifications .
- Select the Notification type: Email notification.
- Select an Email template. A preview is available. You can only edit it by changing the template. See Configure a template.
IAM checks the notification queue every 10 seconds. If an email notification has been added, it will be sent.
Add an email notification
Notification overview
main administrator application administrator group administrator group owner user administratorFor an overview of all the notifications:
menu Analysis > Notifications > tab Notifications
- Pending notifications remain visible until they have been shown to the user or until their expiration date.
- You can set the number of expired or sent notifications that should remain visible in the menu Settings > Global settings > group User > field Notification retention (items). Deselect the prefilter Pending to see them.
- Here, you can only add, edit, and delete the notifications without a system flow. System flow notifications can only be configured and changed in the Software Factory. See System flow notifications.
Example notification