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?

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: