Defining message outcomes
since 2.7.0
Introduction
The Script Field Processor allows the outcome of a message's processing to be decided preemptively.
This can be useful when you want messages to fail for reasons that they would not normally.
Methods
There are currently five outcomes which can be decided via a script:
Dropped
jemhUtils.dropMessage(String reason)Filtered
jemhUtils.filterMessage(String reason)Forwarded
jemhUtils.forwardMessage(String reason)Rejected
Dropped (Drop and exit group)
Outcome results
Message Outcome | Sender Notified? | Admin Notified? | Read/Deleted? |
|---|---|---|---|
Dropped | No | No | Yes |
Filtered | No | No | No |
Forwarded | No | Yes | Yes |
Rejected | Yes | No | Yes |
Dropped (Drop and exit group) | No | No | Yes |
If HintOgrams are turned off, rejections will be treated as being forwarded.
Example Script
This could be used to reject a message if it contains a certain word within the subject:
The above example produces the following results within the Processing Detail Report:
Enable Auditing by clicking Enable on the Auditing page to see these when running Test Cases and for previously processed mail
Email (HTML) received by the sender:
To customise the contents of these emails, please Use Template Sets (Custom Templates).
Further information
The documentation for each of the jemhUtils methods can be found here:
http://ppl-docs.s3-website-us-east-1.amazonaws.com/JEMH/4.1.0/com/javahollic/jira/emh/api/IJEMHVelocityContextUtils.html