View source for Accessing the Archive with the Microsoft Outlook integration

With the MailStore Outlook Add-in, MailStore users can access the archive directly from within Microsoft Outlook.
{{#ev:youtube|https://youtu.be/X_lTDQjQzyQ|340|right|''Tech Tip: Using the MailStore Outlook Add-in''}}
The MailStore Outlook Add-in lets users find emails easily by browsing their archive's folder structure or by using the comfortable, fast search functionality and then open, restore or print them. Opened or restored emails can also be replied to or forwarded by using the familiar facilities of Microsoft Outlook.

Our Tech Tip video provides an overview.
<br clear="all">

== Installation & Update ==
The MailStore Outlook Add-In setup file that matches your MailStore Server version is stored on the MailStore Server machine. Follow the ''Install MailStore Client on other Computers'' link on your desktop and copy the corresponding setup file to the client computer. A list of supported Microsoft Outlook versions can be found under [[System_Requirements#MailStore_Outlook_Add-in|System Requirements]].

It is a regular Windows setup program, that can by executed on the appropriate client computer by double-clicking on the setup file. Just follow on-screen instructions.

<p class="msnote">'''Notice:''' Alternatively to installing the MailStore Outlook Add-In application manually, you can also deploy it to the client computer though the Active Directories Group Policy feature. More information on that can be found in the article [[MailStore Outlook Add-in Deployment]]</p>

If an update is installed on the MailStore Server computer, MailStore Outlook Add-In usually stays compatible with MailStore Server. Therefore a re-installation of MailStore Outlook Add-In is only required if significant changes (e.g. security updates) are listed in the [https://go.mailstore.com/?product=MailStore%20Server&target=changelog&lang=en changelog].

After successful installation, a tab labeled "MailStore" will be visible in Microsoft Outlook.

[[File:Outlook2019RibbonTabEN.PNG|center|550px]]

=== Technical Considerations ===
* The MailStore Outlook Add-in uses the HTTP server integrated in MailStore Server to access the archive, which only allows encrypted HTTPS connections.  Thus using a valid TLS/SSL certificate is recommended. 
* If you have changed the configuration of the HTTPS port within the MailStore Server Service Configuration (the default HTTPS port is 8462), you must include the port number when logging in. Simply append the port number to the server name, separated by a colon (for example: <code>mailstore.example.com:443</code>)

== Login to MailStore Server ==
If the MailStore Outlook Add-in is not pre-configured, you will be asked to log in to MailStore Server as soon as you click any button in the MailStore Outlook Add-in. 
[[File:OutlookAddin_Login_01.png|right|350px]] 
The window ''Connect to MailStore Server'' appears.
* Enter the DNS host name of the computer on which MailStore Server is installed into ''Server Name''. Please refer to your system administrator for the server name and your access data.
* Click ''Connect'' to connect to MailStore Server.
<br clear=all/>

[[File:OutlookAddin_Login_02.png|right|350px]] 
Once the connection was established successfully, the user name dialog appears.
* Enter the user name of a MailStore user into the ''User Name'' field and click on ''Next''.
<br clear=all/>
[[File:OutlookAddin_Login_03.png|right|350px]] 
MailStore Server now determines how the user is to be authenticated.
* If MailStore Server is able to verify the user's credentials itself, the password dialog as shown on the right appears. Enter the password into the ''Password'' field and click on ''Log in''.
* If the user authenticates against Microsoft 365, Google Workspace or Active Directory Federation Services (AD FS), the default web browser will be opened to allow authentication through Microsoft's, Google's or the AD FS's authentication service.
* [[File:OutlookAddin_Login_04.png|right|350px]]If [[Multi-factor Authentication]] has been enabled , and the current device is not trusted, the user has to enter an MFA code.

<br clear=all/>
<p class="msnote">'''Hint:''' If you would like to log in to a different server or use different credentials, click on ''Settings'' in the MailStore Outlook Add-in and update the ''Server Name'' as desired or click on ''Clear Cached Credentials'' to use new credentials on next login.</p>

== Search by Archive Folder ==
=== Display of the Archive Folder ===

[[File:WebArchiveFolders.png|right]]

In the MailStore Outlook Add-in, click on ''Browse Archive'' to display the part of the archive that is visible to you.

=== User Archives ===
The folder ''My Archive'' contains all emails that were archived from your mailboxes. If you have read-access to the archives of additional users, their emails are located in the folders labeled ''Archive of <user name>''.

=== Display of Emails in a Folder ===
To view the emails of a specific folder, simply click on the folder name. The emails are listed below the tree structure.
{{Quick Search|Outlook Add-In|left}}
{{Advanced Search|Outlook Add-In}}
== Email Display ==
To view an email which was returned by one of the search functions described above, simply click on it. A preview of the email is displayed on the right side of the screen.

Please keep in mind that images and any formatting will not be displayed in the preview for security reasons. Emails cannot be forwarded or replied to within the preview, either.

For a comprehensive view of an archived email and the ability to use all the Microsoft Outlook features such as printing, forwarding and replying, click on ''Open Email'' in the MailStore Outlook Add-in. The email will be loaded from the archive and displayed, either immediately or after a few seconds depending on size.

<br style="clear: both;"/>

== Restoring Emails to the Application ==
[[File:OutlookAddinRestore.png|right]]

To restore an archived email which is no longer in your mailbox to Outlook, please proceed as follows:

* Locate the email within the archive and select it, so that it is shown in the preview area.
* In the MailStore Outlook Add-in, click on ''Restore Message''.
* Drag and drop the envelope icon into an Outlook email folder or a Windows Explorer file system folder.
* The email is restored immediately or after a few seconds, depending on its size. The email is restored as ''read''.

<br style="clear: both;" />

== Printing Emails ==
To quickly print an archived email on the current default printer, please proceed as follows:

* Locate the email within the archive and select it, so that it is shown in the preview area.
* In the MailStore Outlook Add-in, click on ''Print Message''.
* The email is immediately printed.

To print the message on a different than the default printer, use Outlook's built-in function accessible after you opened the message via ''Open Message'' from the add-in.

<br style="clear: both;" />

== Changing Regional Settings ==
By default the MailStore Outlook Add-in uses the same regional settings as Microsoft Outlook. The regional settings can also be set manually in the MailStore Outlook Add-in settings dialog.

[[de:Zugriff_über_die_Microsoft_Outlook-Integration]]
[[en:Accessing the Archive with the Microsoft Outlook integration]]