User Notification keeps users informed of new tasks, and User Notification being implemented at application level allows for greater customization of the notification content.

A one-time setup process, this plugin will be called every time a new task is created.

This feature is enhanced in Joget Workflow v6 to support placing assignment link with a special hash variable.

Figure 1: User Notification Properties

NameDescription
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.

SubjectGeneric email subject to be used across all newly created assignment.
Email Message

Generic email message to be used across all newly created assignment.

 

This is a new feature in Joget Workflow v6.

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?Check if "Email Message" is intended to be a HTML content.

Figure 2: User Notification Properties - Notification Link

NameDescription
URL

 URL

Include a link that points to a Userview Inbox.
http://localhost:8080/jw/web/userview/leave_request_app/leave_userview//inbox
In 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

Open my assignment

Parameter Name
Activity Instance ID will be passed to this parameter.

 

If you are pointing to an Inbox element in URL attribute above, then you should set this to:-

activityId

Parameter Passover Method
  • None
  •  As URL Request Parameter
  • Append to URL

 

If you are pointing to an Inbox element in URL attribute above, then you should set this to:-

As URL Request Parameter

Figure 3: User Notification Properties - SMTP Settings

NameDescription
Base URLSpecify the server context path.
From

Sender email address to send email to the assignee and/or CC.

no-reply@your-company-name.com

SMTP Host

Email Server SMTP Host

smtp.gmail.com

SMTP Port

Email Server SMTP Port

Typically, port 465 for SSL security option and 587 for TLS

Security
  • None
  • TLS
  • SSL
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.

 

Figure 4: User Notification Properties - Advanced

NameDescription
 Activity ExclusionInclude activity that you do not wish to notify its assignee.

Related: Video Tutorial on User Notification based on Joget Workflow v3

Note: This tutorial video is also applicable to Joget Workflow v6.