Email Listener form – Completing the Process tab

Use the Process tab to specify how to process email messages at runtime.

Read criteria

  • Maximum Email Size (KB) - (Optional) Enter a maximum size, in KB, of an email message. If a value is specified, the listener does not attempt to process email messages larger than this value.A value entered in this field overrides the value specified in the configuration setting prconfig/services/emailMaxSize/default. See Dynamic System Settings data instances.
  • Process Delivery Status Notifications (DSNs) - Specify whether the listener is to process email messages that are Delivery Status Notification (DSN) messages. See the Pega Community article How to create an email service that responds to AutoReply and Delivery Status Notification messages. When cleared, the listener does not invoke the email service for messages with DSNs.

Data options

When an email listener routes a message that has files attached to it (either as attachments or as images embedded into the body of the message), the listener creates a page named pyAttachmentPage (of class Data-ServiceMessage ) and puts the file(s) on that page. Use the options in this section to specify how to manage email attachments.

  • No attachments - If enabled, the listener does not process email attachments and does not put them on the pyAttachmentPage
  • Embed data for inline images into HTML - if enabled, allows inbound email containing inline images to be rendered correctly when the email is processed as HTML. Enabling this option both base64-encodes the image as embedded HTML content, and does not attach inline images to the generated HTML message.
  • Save original email (in EML format) - Specify whether the listener saves the original email, complete with any attachments or embedded images, as an attachment. Use this option when email messages contain embedded images and it is important that users can see them in their original context. In such a case, select the No attachments option so the attachments are not saved twice — both individually and as part of the original email attachments.