Add new Web Properties for Incoming Mail Agent

The incoming mail agent implements the javax.mail Store and Folder packages. When retrieving the mail from the specified folder, it grabs all mail items within the folder. This creates an issue when a mail is received containing a large attachment and the mail agent stalls. Since it stalls and does not fail safely, then the email is not removed from the mailbox when the folder.close() method called. So, when the agent is bounced it reprocesses the same email multiple times.

If this continues to occur, then emails continue to pile up as they're unable to be processed.

The addition of these properties below would allow the TRIRIGA Admin user to set specific folder properties that will ensure each connection is limited to a subset of the emails in the mailbox.

Currently, the mail agent runs a ‘getMessages()’ function to return all messages within the specified mailbox folder; the options below can be added to potentially limit these types of issues:

1) Return non-deleted msg from folder (this.folder.getMessages() -> filter != Flags.DELETED)

> OR run Folder EXPUNGE prior to getMessages()

Option 1 prevents emails that have already been processed from being processed again.

2) Only return X NUBMER based on PROPERTIES FILE

> this.UNREAD_LIMIT = Long.parseLong(PropertiesLookup.getProperty(PropertiesLookup.WEB_PROPERTIES, "INCOMING_MAIL_UNREAD_LIMIT", "20"));

> this.folder.getMessages() -> return limit this.UNREAD_LIMIT

Note: The expunge() method is run when the system performs the close() function so when the agent gets hung and doesn’t end successfully nothing that was just processed gets removed from the folder.