Introduction
User Notification is a Plugin Default Properties to automatically send assignees email notification on every new activity tasks. Plugin Default Properties allows you to pre-select and set properties for plugins that you intend to use in your application.
User Notification is implemented at the application level and allows for greater customization of the notification content. A one-time setup process, this plugin will be called every time a new activity task is created. If you use User Notification plugin, you do not need to create the tools for Emails in your process design.
User Notification Properties
Configure User Notification
Figure 1: User Notification Properties
| Name | Description |
|---|---|
| CC | Fully qualified address is expected. Multiple values can be accepted by separating them with semicolons. CC: lets you send a copy of a message to someone who's interested, but is not the primary recipient. |
| Subject | Generic email subject to be used across all newly created assignment. |
| Email Message | Generic email message to be used across all newly created assignment. You can use the special hash variable #assignment.link# to anchor the task hyperlink at a specified line in your email message. By default, the task hyperlink will appear at the bottom of the email message. |
| HTML Content? | Click checkbox to enable HTML content in email message, especially if you provide the "Link Name" as a hyperlink. |
Notification Link
Figure 2: User Notification Properties - Notification Link
| Name | Description |
|---|---|
| URL | URL Sample Include a link that points to a Userview Inbox. http://localhost:8080/jw/web/userview/leave_request_app/leave_userview//inboxIn addition, you will need to include the extra parameter below in order for the assignment to show up. http://localhost:8080/jw/web/userview/leave_request_app/leave_userview//inbox?_mode=assignment |
Link Name | Link label to open the assignment. Click the "HTML Content" checkbox to enable HTML content in email message if you provide the "Link Name" as a hyperlink. |
| Parameter Name | Activity Instance ID will be passed to this parameter. Sample If you are pointing to an Inbox element in URL attribute above, then you should set this to:- activityId |
| Parameter Passover Method |
Sample If you are pointing to an Inbox element in URL attribute above, then you should set this to:- As URL Request Parameter |
SMTP Settings
Figure 3: User Notification Properties - SMTP Settings
| Name | Description |
|---|---|
| Base URL | Specify the server context path. |
| From | Sender email address to send email to the assignee and/or CC. |
| SMTP Host | Email Server SMTP Host Example |
| SMTP Port | Email Server SMTP Port Typically, port 465 for SSL security option and 587 for TLS |
| Security |
|
| SMTP Username | Email Server Account Username On Google email account, use your full email address. |
| SMTP Password | Email Server Account Password Password submitted will be encrypted for security reason. |
Digital Signature
Figure 4: User Notification Properties - Digital Signature Settings
| Name | Description |
|---|---|
| Key Store File Path (P12) | |
| Key Store Passphase | |
| Issuer Alias |
Error Handling
Figure 5: User Notification Properties - Error Handling Settings
| Name | Description |
|---|---|
| Number of Retry When Fail to Send Out Email | Number of Retries to be made when the email is failed to be sent. |
| Retry Interval (Seconds) | Interval of time between each retry. |
Web Push Settings
| Name | Description |
|---|---|
Disable Web Push Notifications | Click the checkbox to disable mobile web notification. |
Attachments
If the form you used for the workflow process contains an image or file attachment, you can configure these properties to include the attachments in the email.
| Name | Description |
|---|---|
Form | Select the Form containing the file or image attachment. |
| Form Upload Fields | Select the field ids containing the file or image attachments. You can add more than one attachment field. |
| Files | Configure here if you want to attach specific files file the Joget server, via "system path" or "URL". |
Advanced
Figure 4: User Notification Properties - Advanced
| Name | Description |
|---|---|
| Activity Exclusion | Include activity that you do not wish to notify its assignee. |