Microsoft Graph E-Mail Import Object

In the next step, a “Microsoft Graph E-Mail Import” object has to be created. This object enables the import of e-mails from Microsoft Azure Active Directory (AD) to Fabasoft Approve using the Microsoft Graph API.

Properties

The following fields are available for Microsoft Graph E-Mail Import Objects:

• Name
  The name of the “Microsoft Graph E-Mail Import” object is entered here, which is solely for descriptive purposes.
• Client ID
  The “Application (client) ID” shown in the “Overview” tab inside the AD has to be entered here. This is the unique identifier of the previously generated application and is needed to authenticate with AD.
• Client Secret
  This is the secret application key and can be created during the registration of application in AD. It is a secret string used by the application to request an OAuth-token. It is often also referred as “application password”. The value (not the ID) of the Client Secret has to be entered in this input field.
• Account Type
  In this field you have to select the account type. In most enterprise scenarios this will be “Organizations Only”.
• Mailbox Type
  In this field you have to select the mailbox type, either “Personal Mailbox” or “Shared Mailbox”.
• E-Mail Folder
  In this field you can specify the name of the e-mail folder to import e-mails from. If left undefined, e-mails will be imported from the e-mail folder “Inbox”.
• Target Folder
  In this field you have to select the target folder where the imported e-mails will be created.
• Target List
  In this field you have to select the list of the target folder where to store the imported e-mails.
• Enable Check for Duplicate E-Mails
  If enabled, a check for duplicate e-mails will be performed based on the “Internet Message ID” (IMID) of the processed e-mails. A list with the IMIDs of the e-mails already processed is kept in the background and a new e-mail is only imported if its IMID is not yet in the list. For performance reasons, it is advisable to periodically clean up the e-mail folder from which e-mails are imported by removing or moving e-mails that have already been processed and then executing the “Reset Synchronization State” and “Reset List of Processed E-Mail Message IDs” use cases.
• Fetch Interval
  In this field the time interval for the automated import of e-mails in the background can be set. The following intervals are available:
  • 5 Minutes
  • 15 Minutes
  • 30 Minutes
  • 1 Hour
  • 12 Hours
  • 1 Day
• Expression for Filtering E-Mails
  This expression is executed on the Microsoft Graph Mail Import object that triggered the e-mail import. If the expression is specified and returns false, the e-mail is ignored and not processed any further. If the expression is not specified or returns null or true, the e-mail is imported.
• Expression for Initializing Imported E-Mails
  This expression is executed on the Microsoft Graph Mail Import object that triggered the e-mail import and can be used for the initialization of an imported e-mail. The result of the expression is ignored.
• E-Mail Address for Error Notifications
  If an e-mail address is specified in this field, an e-mail containing additional information about the cause of the error will be sent to this address in the event of an error when importing e-mails.
• Ignore E-Mail Retrieval Errors
  If this field enabled, any errors encountered during the e-mail import will be ignored.

Actions

The following actions are available for the Microsoft Graph E-Mail Import Object:

Manual Import

In order to trigger the e-mail import manually, select “Import Now” from the context menu or task pane of the “Microsoft Graph E-Mail Import” object.

(Re-)Authenticate

The “(Re-)Authenticate” use case is only visible when the Client ID and the Client Secret of the in the “Microsoft Graph E-Mail Import” object is set. When executing this use case, the authentication process is started. As a result of this action a new user consent is received. Before the first e-mail import, this use case needs to be executed and an authorized user has to grant the application the requested permissions to read and retrieve e-mail folders and e-mails from AD.

Reset Synchronization State

This use case allows you to reset the synchronization state retrieved from AD. If you reset the synchronization state, all e-mails in the specified e-mail folder will be processed again during the next import operation.

Reset List of Processed E-Mail Message IDs

If the field Enable Check for Duplicate E-Mails is enabled, a list of the “Internet Message ID” (IMID) of the e-mails already processed is kept in the background and a new e-mail is only imported if its IMID is not yet in the list. For performance reasons, it is advisable to periodically clean up the e-mail folder from which e-mails are imported by removing or moving e-mails that have already been processed and then executing the “Reset Synchronization State” and “Reset List of Processed E-Mail Message IDs” use cases.