Mail Poller

Overview

This version is for Appian 22.3 and above. Cloud customers on a lower version of Appian that want to install this plugin should open a support case. Self-managed customers can find the latest jar for Appian 22.2 and lower version by downloading from the app market.

Enhancement to the plug-in to enable the selection of whether or not to include the email attachments as part of the EML document. Previously, the plug-in would create an EML document with the attachments stripped out. Our client needs to preserve the original e-mail as it was sent (for auditing purposes), so the EML must include the attachments as part of it. This update extends the functionality to allow the user to select whether they want an EML with the attachments removed (original functionality), an EML with attachments included, or both (2 EMLS of original email - one without the attachments included and one with the attachments included). Any e-mail attachments will continue to be saved separately. 

Key Features & Functionality

Takes all unread email from a mailbox and adds entries directly to a database table.The original email is saved as an EML based on three attachment type options

  1. EML with attachments removed
  2. EML with attachments included
  3. Both (2 EMLs of original email) - EML with attachments removed and EML with attachments included

Each email attachment is saved as its own document. The database tables store the Appian document ids, email recipients, subject and body (text and HTML)

Anonymous
  • Hi ,

    Can an oracle version be provided for this plugin?

    We are on an On-prem installation with Oracle DB.

    Thanks in Advance.

    1. If you are using O365, I would recommend using the MSGraph Mail Poller
    2. There usually is a more detailed error in the stdOut log - I would check there first.
    3. If the issue is that the plugin cannot find the host - it may be that your VPN settings need to be adjusted to allow connection to your internal DNS to resolve the address. You could also try using the IP address of the IMAP host directly as a test.
  • Hi,

    we are doing first time set up of this plugin and facing connection time out issue, No error other than time out message. We are on cloud latest version and using VPN to connect cloud. Any additional or DNS port settings we need too consider for successful connection. any thoughts?

  • Looking at the eml, I think the attachment is not actually an attachment but an embedded document and that is why it is not being read correctly. The code is looking for Content-Disposition header value of "attachment", since none is present here, it is treating it just like another body part and skipping over the document.

  • Hi Mike,

    I assume there are no embedded attachments, and this issue has been happening for a long time. Could you provide more information to help debug the issue? I’ve also attached the structure of the email content I received for your reference.

  • Hi Mike,

    I assume there are no embedded attachments, and this issue has been happening for a long time. Could you provide more information to help debug the issue? I’ve also attached the structure of the email content I received for your reference.

    MIME-Version: 1.0
    Content-Type: multipart/mixed;
    boundary="----=_Part_8156_1874079163.1730065765988"

    ------=_Part_8156_1874079163.1730065765988
    MIME-Version: 1.0

    Content-Type: text/plain; charset="us-ascii"
    Content-Transfer-Encoding: quoted-printable

    Attached is a Fax Direct Debit Claim Request
    ************** IMPORTANT MESSAGE *****************************
    **************************************************************

    ------=_Part_8156_1874079163.1730065765988

    Content-Type: application/octet-stream; name=ddsclaimreq390370.pdf
    Content-Transfer-Encoding: base64

    JVBERi0xLjcKCjQgMCBvYmoK..........

    ------=_Part_8156_1874079163.1730065765988--



  • The first part sounds like a defect but this is not much information to go on from a troubleshooting standpoint. If there is a specific email you have experienced it with or a stack trace (there should be an error logged if the message is moved) that we would be very helpful.

  • Can you check the eml and if the attachments are embedded? The plugin does not support parts nested inside parts of a multipart email.

  • Hi,
    We are facing an issue with the Email Poller plugin. Specifically, email attachments (Doc Type: PDF) sent from a particular email ID are not being read correctly on the Appian end. However, emails sent from other email IDs are working fine.

    We have verified the EML file, and the documents are present. Unfortunately, we have been unable to find a solution to this issue. Please help us resolve it.

    Thanks in advance.

  • Hi,

    We have recently been experiencing cases where emails are moved to the "Exceptions" folder, but metadata is still written to the database. On other cases, email messages are moved to the "Exceptions" folder but on moving them back into to the Inbox folder, get successfully polled in.

    Is there an explanation for the behavior we are experiencing and how can we fix it?

    Thanks,