You are currently reviewing an older revision of this page.

DRAFT-XXXX Appian receive email fails when using a routing alias with recipient name in 'Bcc' field

Symptoms

Appian receive email fails when used in the following way:

  • Destination process model is specified with the routing alias field conf.mailhandler.alias.<recipientName>=<routing> in custom.properties.
  • A destination key/value pair such as [DestinationPMUUID=<ProcessModelUUID>] is not being used when sending emails.
  • The recipient name is specified in the 'Bcc' field of an email.

The following error also appears in mail-listener.log:

[Appian EmailHandlerBean - 64] INFO com.appiancorp.process.emailpoller.EmailHandlerBean - EmailHandlerBean received email message. (email subject)
[Appian EmailHandlerBean - 64] ERROR com.appiancorp.process.emailpoller.EmailHandlerBean - Error receiving message in EmailHandlerBean MDB
javax.mail.MessagingException: Message could not be sent;
nested exception is:
com.appiancorp.messaging.ProcessRouteMissingException: APNX-1-8001-001: No Process Routing Information Provided: Needs one of DestinationEventPersistentID, DestinationProcessID, DestinationPMID, DestinationPMUUID

Cause

This issue has been reported to the Appian Product Team.

Workaround

Appian receive email still functions properly if used in the following ways:

  • Specify recipient name in the 'To' email field instead of 'Bcc'
  • Specify recipient name in the 'Cc' email field instead of 'Bcc'
  • Specify [DestinationPMUUID=<ProcessModelUUID>] in the subject line or body of the email when recipient name is in the 'Bcc' email field.

See the Routing Email Messages section of the Mail Server Setup guide for more details on specifying a destination key/value pair.

Affected Versions

This article applies to Appian 17.4 and later

Last Reviewed: October 2018