Mail app documentation – version 5.1

2.Configuration part for administrators

Important!!! Mail app prerequisites

  • Exchange 2013 or later version
  • MS Outlook 2013 or later desktop version or OWA.
  • Proxy installed over HTTPS connection.
  • Default shortcut and a default retention must be set in contentACCESS Central Administration.
  • On the System page (System tab => Services group => System button => External accessibility settings) a HTTPS alias must be configured.
  • Roles Org Custom Apps, Org Marketplace Apps and User Options must be assigned for the EWS user on the Email archive System settings page in section EWS settings. These roles enable an administrator to install and manage custom apps for the organization (read more about the roles here).

If the user wants to use the Mail app in shared mailbox(es), the following is required:

  • Office 1.8 API minimum. Supported Exchange and Outlook versions are described in this article (Supported API requirement sets column)

The following is NOT supported, therefore you won’t be able to use Mail app in these:

  • Public folders
  • Office365 group folders

The administrator is required to do the following configurations for manual email archiving. He has to

  1. configure a shortcut that Mail app will use and set this shortcut as default (refer to section Shortcuts in email archiving);
  2. configure a retention that Mail app will use and set this retention as default (refer to section Retentions);
  3. install the Proxy server with HTTPS connection;
  4. configure HTTPS based alias In Central Administration under System => Services => System => External accessibility settings;
  5. allow Mail app activation for selected mailboxes/groups/servers from Central Administration => Address book;
  6. run the Email archive Provisioning job to apply the changes.

To allow the Mail app activation, navigate to Email Archive ⇒ Archive ⇒ View address book on the ribbon.

In the column Enable mail app it is possible to see if the Mail app activation was allowed for the selected object (mailbox, group or server). By default, the objects inherit the Mail app activation from their parent, so if the parent has it set to allow/forbid, so will the child.

The Mail app activation can be set from the context menu of the selected object to:

  • Inherit
  • Explicitly allow
  • Explicitly forbid.

If you selected Explicitly allow, the contentWEB user role pop-up will open. Here you need to specify the contentWEB user role (containing user permissions) to be assigned to the contentWEB user(s). It is possible to select a custom role from the dropdown list or you can use the role defined in the Email archive Provisioning job.

After the changes have been made, it is necessary to start the Provisioning job to apply them.

Important: To successfully install the Mail app, the Exchange server must have access to the contentACCESS server and to the Mail app’s .xml manifest file. The manifest file can be accessed using the following links:

  • https://[SERVERNAME]/contentACCESSWS/Mailapp/Mailapp.xml
  • https://[SERVERNAME]/contentACCESSWS/Mailapp/Mailapp_no_ribbon_button.xml

The administrator should be able to browse the file using the links above without any issues.

Yes No Suggest edit
Help Guide Powered by Documentor
Suggest Edit