The MailPro-Plugin offers the following features (short list):
Imap accounts: connect to Imap servers such as MS Exchange, get all folders, create folders
Imap folders: retrieve messages, add/delete/copy messages, get message counters, get folder parameters, search messages, get quotas and more...
Mail messages: get/set all headers and properties of a message, get/set addresses in flexible ways, set flags as "deleted", "read", "seen", etc., create own headers, create and read attachment, save to file, handles text and html, embeds images
Receive messages in background: MailPro can download messages while the user of the solution can continue to work normally (without be blocked and having to wait until all messages are transferred)
Receive messages automatically: MailPro can receive notifications from the mail server, get the messages and call a global method that can save those messages to the database
POP3 accounts: connect to POP3 servers, retrieve messages, get message uids, get messages by index
SMTP accounts: connect to SMTP servers, create messages with great flexibility, send messages and save sent messages to a folder on an IMAP server ("Sent items")
MailPro makes seemless email integration possible. Messages that have been read in a Servoy solution can be updated on the server and will appear in e.g. MS Outlook as read. Deleted messages can disappear as well. You can easily subscribe to IMAP folders and keep the server and the data of your solution in synch. Messages that have been sent from Servoy can be saved to the "Sent" folder on the Imap server, so they also appear in the user's standard email client in the sent folder.
The possibility to receive messages in the background instead of waiting until everything is downloaded makes it more pleasant for a user to actually store emails in a database system. The same is the case for message notifications. You don't have to start a trigger to check for new mails, but the plugin will call one of your methods in seconds when there is new mail.
More information and a demo version can be found here: www.servoy-plugins.de/mailpro.html
The biggest changes in version 2.1 are
1. ImapAccounts and ImapFolders are now cached by the plugin. In the past it was possible to open several connections to a folder or account. This is now prevented. This improvement requires every account to have an (internal) name. This requires you to change all occurences of MailPro.ImapAccount() to MailPro.ImapAccount(String accountName).
2. It is now possible to show a splash in the lower right corner of the screen. This allows you to notify a user of a new message like this:
Here is the list of changes / enhancements:
[chg] MailPro: the ImapAccount methods now take the name of the account as first argument! The name has to be unique!
[enh] MailPro: ImapAccounts and ImapFolders will now be cached by the plugin, so it is not possible anymore for example to create several folder objects for the same folder.
[enh] MailPro: added showSplash(String message) to show a splash screen in the lower right corner of either the screen or the Servoy window
[enh] ImapFolder: added optional Parameter int maxMessagesToCallMethod to getMessagesInBackground()
[enh] POP3Account: added optional Parameter int maxMessagesToCallMethod to getMessagesInBackground()
[fix] MessageReceiver: fixed a possible problem with expunged messages
[fix] SMTPAccount: fixed a possible Exception when the IMAP server does not return a UID for a copied message as it should
[enh] MailMessage: added getServerType() which returns the type of Account ("IMAP", "POP3") from which this message was received
[enh] MailMessage: added reply([boolean replyToAll]) which creates a new MailMessage that is suitable as a reply message
[enh] MailMessage: added replaceTags(IRecord record) which will replace any Servoy placeholders such as %%test%% by the corresponding value for the given record
[enh] MailMessage: added convenience method addAttachment(Attachment attachment/String name/String path, [byte[] data], String mimeType) for adding attachments one by one
[enh] SMTPAccount: added useTSL property so TSL can be used if supported by the server
[enh] POP3Account: added search(int searchField, Object criteria, [String operator])
[enh] added new search fields ReceivedDate (not possible on POP3!), SentDate to enable search by dates
[chg] changed field IDs when using search (see tooltip)
[enh] MailMessage: added setCharset(String charset) to allow using a non default charset to encode the text of a message (necessary for example to send the Euro symbol that is only available in UTF-8)
[enh] Attachment: improved mime type "guessing" if mime type is not provided
[enh] MailMessage: improved handling of message parts
[enh] MailMessage: added embedAllImages(boolean embedAllImages) method that will search HTML code for images sources and will try to download remote images (http://...) and get local (file://...) images and embeds those inline
[enh] MailPro: added closeAllAccounts([boolean expung]) method to disconnect from all accounts (closes all folders, optionally expunging messages)
[enh] MailPro: added stopAllNewMailListeners() to shutdown all newMailListeners
[enh] ImapFolder: added hasActiveReceiver property that returns true if the folder has an active background receiver
[enh] NewMailQueue: added getNumberOfRunningReceivers() to return the number of currently running background receivers
[fix] NewMailQueue: fixed synchronization problems. The queue is now thread safe.
[enh] NewMailQueue: added getItem() that returns an Array[message, methodArguments, source] from the queue and immediately removes that item from the queue
[chg] NewMailQueue: deprecated getAllMessages, getAllMethodArguments, getAllSources, getMessage, getMethodArguments, getSource
[fix] MailMessage: fixed a bug where a html message would be sent as plain/text if only html was set
[fix] MailMessage: fixed a possible problem with decoding improperly encoded subjects
A big thanks goes to Harjo who has done a lot of testing (again).
