Overview

This is a module used to retrieve email from and send email via a Microsoft Exchange or Office 365 account.

Documentation

Description

This is a module used to retrieve email from and send email via a Microsoft Exchange or Office 365 account.

Typical usage scenario

Retrieving email

To retrieve email from an account, create a new query object and link it to the ExchangeAccount object, then pass the query to the SF_Retrieve_Email microflow.This will return a list of Email objects, including attachments, in descending order of when the emails were received/sent. The maximum number of objects you get back is 50.The Folder and (optionally) CustomFolderName attribute can be used to specify from which folder to retrieve the emails.The date_to and date_from attributes are optional.

Sending email

To send an email, create a NewEmail object and link it to the ExchangeAccount object, then pass it to SF_NewEmail_Send microflow.The content attribute should be html text.

Features and limitations

Retrieving e-mails from a specific folder, and (optionally) from a specified time period

The maximum number of retrieved e-mails is 50

Sending e-mail to one or more addressees

Currently retrieving email from a custom folder in a non-default account is not supported. The emails will actually be retrieved from the inbox folder. This might get added in a later version.

Dependencies

The module uses the Encryption module from the Mendix Appstore. In addition, the following libraries are required:

commons-codec-1.10.jar

ews-java-api-2.0.jar

httpclient-4.5.jar

httpcore-4.4.1.jar

joda-time-2.9.6.jar

org.apache.commons.lang3.jar

Mendix modeler version

5.21.3 and up

Configuring accounts

Configuration is pretty straight forward. Just create an ExchangeAccount object and set the correct values. Set the boolean DefaultMailbox to false if you do no want to read and send from the personal mailbox of the user, but from the mailbox specified by the e-mail address (The user account shouldstill have access to that mailbox of course). For Office 365 accounts, set the Exchange version to 2010 SP2.To test the credentials, you can use the IVK_TestCredentials microflow (this will try to look for the inbox of the account specified).