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
  • 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,

  • Are you commenting on the right poller? This one is specifically for IMAP connections, is this for the Exchange Web Services poller?
    For IMAP, the content-disposition value of the body part in the message needs to be "attachment". You can check that in the eml file of the email.

    I have not used the plugin in some time but from what I recall it does not support inline attachments since these are nested inside other body parts. I may be incorrect on this one - would be good to have someone from the community comment here.

  • Hello,

    we are currently using version 1.1.7 on Appian 21.3.

    Mail Poller does not recognize attachments for a specific email address. The email itself is stored normally, but the attachment is nowhere to be found. According to the email exchange team, they don't see an issue with this email address or the attachment.

    Is there any way to find out what the issue might be? Which email property does mail poller access to find attachments? 

    "X-MS-HASATTACH: yes" is present in the header.

    Thank you in advance.

  • v.2.0.3 - Release Notes
    • Added License file and upgraded json library