This Mailbox Connector provides access to internet mailboxes (POP3 or IMAP). You can use the Mailbox Connector in AddOnly, Iterator, Lookup, Update and Delete modes.
The Mailbox Connector uses predefined attribute names for the headers that are used most often. If you need more than this,f use the mail.message property to retrieve the native message object.
On initialization, the Connector gets all available mail messages from the mailbox on the server and stores them into an internal Connector buffer. Later the Connector retrieves the messages one by one on each getNextEntry() call; that is, on each Iteration. When all the messages from the buffer have been retrieved, the parameter Poll Interval governs what happens next; see Configuration. This is different from earlier implementations of this Connector.
If the IMAP protocol is specified the Mailbox Connector registers for notifications for messages added and messages removed from the mailbox on the server. When a notification that a message has been added to the mailbox is received, the Connector adds this message to its internal buffer. If a notification that a message has been removed from the mailbox is received, the Connector removes this message from its internal buffer.
For all supported modes except Addonly (Iterator, Update, Lookup, Delete) the Mailbox connector iterates on all folders in the mailbox, if no folder is specified in the configuration. Otherwise, there is the option to iterate on subfolders of the supplied folder. In both cases you can specify a list of comma-separated folders to be excluded when browsing the mailbox.