About Notifications
COmanage Registry has a facility for delivering Notifications, which are basically short messages with a timestamp. The following roles are defined for Notifications:
- Actor: The CO Person who generated the Notification, perhaps indirectly.
- Recipient: The CO Person or CO Group the Notification is sent to.
- Resolver: The CO Person who responds to the Notification.
- Subject: The CO Person who the Notification is about.
A Notification can simply require acknowledgment, or it can require resolution. If the Notification only requires acknowledgment, then the Recipient (the CO Person or any member of the CO Group) simply views the notification and clicks Acknowledge to dismiss the Notification. If the Notification requires resolution, then the Recipient must take the appropriate action (typically by clicking the URL included in the Notification).
The Actor can cancel a Notification before it is responded to.
Subjects can view Notifications about themselves, but are not typically directly notified.
Notifications generate History Records.
Where Notifications Happen
Petitions (Enrollments)
- If a notification group is defined in the corresponding Enrollment Flow, members of the group will receive Notifications requiring acknowledgment regarding the status change.
- If a Petition changes status to Pending Approval, a Notification requiring resolution will be sent to those with the ability to approve the petition. This is (1) the approval group, if defined for the corresponding Enrollment Flow, OR (2) the group of CO Administrators AND, if the Petition was attached to a COU, the group of COU Administrators for that COU. Once anyone approves or denies the petition, the Notification is resolved.
(In addition, enrollment flows allow email to be sent to the enrollee at various points, however that process is outside of the core Registry notification engine.)
Command Line
It is possible to generate Notifications from the command line. For more information, run
$ ./Console/cake notification