Introduction
Syncope workflow process supports e-mail notification sending to deliver information and requests for action to administrators, approvers, and users.
This wiki page aims to show how to manage notifications by using Syncope console.
Create new notification
- Click on Configuration tab.
- Click on Notifications subtab.
- Click on Create new notification button.
- Click on Notification tab and provide the following information
- Sender
e-mail sender. - Subject
e-mail subject. - Recipients e-mail attribute type
type of schema from which to get recipient mail. - Recipients e-mail attribute schema
schema from which to get recipient mail. - Template
e-mail template. - Trace level
trace level. - Enabled
flag to enable/disable notification, if not flagged notification tasks won't be created and e-mail(s) will not be sent.
- Sender
- Click on About subtab and provide a condition to filter users or roles interested by the specified events. Filter condition can be expressed as combination of "and", "or" and "not" conditions; for each condition you can specify different matching criteria:
- User/Role attribute matching criteria
- Resource matching criteria
- Role matching criteria (without inheritance: users of child roles are not included) for Users, for Roles instead you can specify Entitlements matching criteria
- Click on Events subtab and provide events to be notified.
Events are divided into 6 macro-categories:- REST
events triggered by controllers (UserController, RoleController, etc.) - TASK
events triggered by jobs associated to tasks - PROPAGATION
events triggered by user, role, membership propagation on some resource. - SYNCHRONIZATION
events triggered by user, role, membership synchronization from some resource. - PUSH
events triggered by push actions on user, role, membership towards some resource. - CUSTOM
events created by user (needs implementation of custom events).
- REST
- Click on Recipients subtab and provide filter to search for e-mail recipients. Recipients can be a combination of:
- users matching About (optionally selectable)
- additional recipients (optionally selectable) based on search filter condition like About described above.
- static recipients (optionally selectable): a list of one or more recipients specified (manually) by user.
- Click on Save button.
Edit notification
- Click on Configuration tab.
- Click on Notifications subtab.
- Click on Edit link and provide information
- Click on Save button.
Delete a notification
- Click on Configuration tab.
- Click on Notifications subtab.
- Click on Delete link.
- Confirm operation.
Customize notification e-mail message
Refer to Customize notification e-mail templates to customize email message body.