The Study notification module allows you to implement different listeners that will be triggered by specific events.
Upon being triggered the event will do one of the following:
- Send an email to specified email addresses (Does not have to be SMART-TRIAL users)
- or a HTTP POST to a specified endpoint
The notification will send an email or a POST to the endpoint every time the notification is triggered.
You can enable study notifications when creating your study or by clicking on "Edit study" in the study overview.
When setting up a notification, you must give it a name, select a trigger, specify if it should send an email or a webhook. Depending on the trigger, you will have the option of adding additional information, or only have it trigger for specific data events.
The table below describes which triggers are available, and which additional information can be included in the email or the webhook.
|Trigger||Info for EMAIL||Info for WEBHOOK|
|Amendment is finished||User email||Study Id, User email,|
|Subject is enrolled||User email||Site database Id, Study Id, Enrollment Id, User email|
|AE/SAE report created||User email, AE report id||Site database Id, Study Id, Enrollment Id, User email, AE id|
|Query is created by the system||Data event Name, Form Name, Comment/Query text||Site Id, Study Id, EnrollmentId, Data event Name, Form Name, Comment/Notification text|
|Randomization blind is broken||User email, randomization id, reason for unblind, unblind time||User email, study id, site id, enrollment id, randomization id, reason for unblind, unblind time|
|Subject is randomized||User email, randomization Id||Site database Id, Study Id, Enrollment Id, User email, Randomization Id|
|Data event has expired||data event name, Time of expiration,||enrollment id, data event name, site id, Time of expiration, study id|
|Reminder sent||data event name, Time of reminder sent,||enrollment id, site id, data event name, Time of reminder sent, study id|
User email, is the email of the person performing the action, and thereby triggering the notification.
Note: The ids available for webhooks (site, study, enrollment) are long strings of characters, and not meant for humans to read. They are unique identifiers in SMART-TRIAL and are meant to be used with out API to automate actions.
Notifications will always include the following information:
- Subject id (unless trigger = amendment)
- Randomisation id (only for randomisation related notifications)
- Study name
- Site name
- Study notification name (for email)
You can create as many study notifications as you would like. E.g. you can have both "Subject is enrolled" and "Subject is randomized" setup.