MailReminderHandler

Description

The ActionHandler MailReminderHandler sets the escalation time of this activity. The offset determines how long before the processing time expires all tasks must be completed. At the time of escalation, a mail is sent to the processor for each open task of the "escalation activity".

Only with this handler can multiple escalations be configured on an activity.


Class

com.dooris.bpm.actionhandler.MailReminderHandler

Parameter

Parameter name

Default value

Description

Valid examples

Parameter name

Default value

Description

Valid examples

escalationDuration

 

If the field escalationDuration is specified, not the processing time of the activity but the value of the variable specified by escalationDuration is used.

The value of the variable must have the following format: hhmm

  • VariablenName

  • VariablenName+05

  • +5

escalationDate

 

Date and time at which the escalation mail is to be sent.

escalationDate is only considered if no escalationDuration is set!

  • ${date}

  • 01.01.2014 12:00

escalationDateFormat

 

The format in which escalationDate is specified.

The default value here is: dd. MM. yyyyy HH:mm

Date format here in Simple Date Format (e.g. dd.MM.yyyy HH:mm)

dd.MM.yyyy HH:mm

escalationMessage

 

Mail text of the escalation mail
It can contain variables.

MAILTEXT${escalationReason}

escalationSubject

 

Mail subject of the escalation mail
It can contain variables.

SUBJECT

offSet

 

The offset value is specified in the format hhmm, i. e. the last two digits are taken as minutes, the digits before as hours.

  • 10%

  • 10

escalationMailTo

 

Can be filled with variables, email addresses or expressions. These can be comma-separated! Possible would be here e. g.

  • escalationMailTo=variable;

  • escalationMailTo=variable1,variable2,group(PM),swimlane(Instanzstarter);

  • escalationMailTo=email@mailadress.com,variable1,user(pm);

It can be mixed at will.

  • email@mailadress.com, variable1, user(pm)

  • group(pm)

nodeMail

false

If this value is set to true, only one mail is sent per activity and not one mail per task.

 

skipPastReminders

false

If it is set to true and escalationDate is set, the handler only sends/creates reminders if the calculated escalation timestamp (escalationDate + offSet if given) > start time of activity.

Case 1:
escalationDate=01.01.2022
AND
Start date= 01.05.2022
No reminder will be sent.

Case 2:
escalationDate=05.05.2022
AND
Start date= 01.05.2022
Reminder will be sent.

 

Dependencies

Timer: https://tim-doc.atlassian.net/wiki/spaces/eng/pages/227608916