Difference between revisions of "Accessing the Archive with the MailStore Client software"

[unchecked revision][checked revision]
(67 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= Searching by Folder Structure =  
+
== Installation & Update ==
 +
The MailStore Client 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.
  
MailStore stores all archived emails in a MailStore-specific folder structure, in which emails are displayed using the same structure as their corresponding source application. This means that folders created in the source application (e.g. Microsoft Outlook) are not changed during the archiving process and can be found easily in MailStore as well.
+
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.
  
[[File:accs_folders_01.png|right|200px]]
+
<p class="msnote">'''Notice:''' Alternatively to installing the MailStore Client 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 Client Deployment]]</p>
  
== User Archives ==
+
If an update is installed on the MailStore Server computer, MailStore Client updates itself automatically on first login to stay compatible with MailStore Server. Therefore a re-installation of MailStore Client is usually not required.
  
For every user, MailStore creates a folder called ''My Archive'' on the highest level of the folder structure. Each folder corresponds to the user archive of the respective user and contains all his or her emails.
+
== Starting and Login ==
 +
Start MailStore Client by using the appropriate link on the desktop.  
  
If the user has access to the archives of other users, their folders are listed as Archive of ''<User Name>''.
+
[[File:Gsta_useclient_00.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''. Be aware, that the pre-filled entry ''localhost'' only works if the MailStore Client is run from the same machine where MailStore Server is installed.
 +
* Click ''Connect'' to connect to MailStore Server.
 +
<br clear=all/>
 +
<br/>
 +
'''Hint: '''Did you activate the option ''Always connect to this server'' and you want to change the destination server later? Hold the <code>Shift</code> key pressed while opening MailStore Client.
  
== Opening a User Archive ==
+
After establishing the connection to MailStore Server, MailStore Client checks if newer a version of its own program files is available for downloading and, if necessary, updates these automatically.
  
To open a folder, click on the plus sign [+] next to the folder name (as is done in Windows Explorer). Proceed the same with any subfolders.
+
[[File:Gsta_useclient_01.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:Gsta_useclient_02.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&nbsp;365, Google Workspace or Active Directory Federation Services (AD&nbsp;FS), the default web browser will be opened to allow authentication through Microsoft's, Google's or the AD&nbsp;FS's authentication service.<br clear=all/>
  
== Viewing the Emails in a Folder ==
+
== The MailStore Folder Structure ==
 +
[[File:Accs_folders_01.png|right|240px]]
 +
For each user, MailStore creates a folder on the highest level of the folder structure which corresponds to the archive of the respective user. It contains all emails that were archived for this user and is labeled ''My Archive''.
  
To view the emails in a folder, simply click on the folder name. The emails will be listed below the folder structure.
+
If the user has access to the archives of other MailStore users (as MailStore administrator, for example), their folders are listed as ''Archive of <User Name>'' under the top level folder ''Other Archives''
  
Click on the text Sorted by: <value> to change the order in which emails are displayed. Emails can be sorted according to:
+
Below these main folders, the individual email sources (e.g. Microsoft Outlook or Exchange mailboxes) and their folder structures (e.g. ''Inbox'') are listed.
  
* Date
+
'''Notice: '''For MailStore administrators, accessing the archives of other users via the folder structure is blocked by default; this setting can be changed in the  [[Compliance_General|compliance settings]]. Additionally, MailStore administrators can manage archives via the [[Archives]] page.
* From/To (sender/recipient of the email)
 
* Subject
 
  
Click on the Field to the right of ''Sorted by'' (called ''New to old'' in the graphic) to reverse the order in which emails are arranged. By default, the latest email is displayed first.
+
=== Deleting Folders ===
 +
Folders and the emails contained therein can only be deleted after the appropriate user privileges have been assigned explicitly by the administrator. If the folder to be deleted contains any subfolders, they will be deleted as well.
  
<br style="clear:both;">
+
=== Moving, Renaming, and Creating Folders Manually ===
 +
Within MailStore, folders can be moved, renamed or created. Regular users can only do this within their own user archive, while MailStore administrators can move and rename folders beyond the boundaries of user archives.During the archiving process, MailStore adopts the folder structure and the folder names of the source (e.g. Microsoft Outlook).
  
== Number of Emails Contained in a Folder ==
+
Please note that moving large archives across the borders of user archives can take some time because the emails being moved have to be gathered by the full text index of the target user.
 +
 +
The features ''New Folder...'', ''Rename'' and ''Move to Folder...'' can be accessed by right-clicking on the corresponding archive folder.
 +
 +
If a MailStore administrator renames a user archive (Folder: ''Archive of <user name>'') without renaming the corresponding user, an empty archive will exist with this user name until it is changed.
  
The number of emails in the current folder is shown below the list of messages.
+
'''Hint:''' Using an already existing folder name when renaming a folder, allows to merge the content of both folders.
  
== Refreshing the View ==
+
=== Changing Message Type ===
 
+
In case the message recipient is shown wrongly instead of the message sender or vice versa, an administrator is able to change the ''message type'' of a message.
To refresh the list of folders, click on a folder and press F5 on your keyboard.
 
  
Click on the folder again to refresh the list of emails.
+
Highlight the emails and select ''Change Message Type'' in the context menu.
  
== Creating, Renaming and Deleting Folders ==
+
In case the message type of other users' message should be changed, [[Compliance_General#Archive_Access|archive access]] has to be unblocked.
  
Information about how to create, rename and delete folders is available in the chapter [[Users,_Folders_and_Settings#The_MailStore_Folder_Structure|The MailStore Folder Structure]].
+
Verify the [[Email_Archiving_with_MailStore_Basics#Archiving_Specific_Folders|archiving profile settings]] if necessary, so that the message type is already set correctly during archiving.
  
= Quick Search =
+
=== Deleting Emails ===
 +
Highlight the emails to be deleted by clicking on the emails while holding down the <code>Ctrl</code> key (<code>Ctrl+A</code> will highlight all emails). Right-click on the highlighted item(s) and select ''Delete''. Users are only allowed to delete emails if they have received this privilege explicitly from the MailStore administrator.
  
With MailStore's integrated quick search feature, users can browse through all emails in all user archives they have access to. Quick search is especially suitable for simple queries. Alternatively, an Extended Search can be used.
+
<p class="msnote">Please keep in mind that allowing users to delete emails is not recommended; assigning such privileges makes it difficult, if not impossible, to comply with legal requirements regarding the storage of emails.</p>
  
[[File:accs_quicksearch_01.png|right|200px]]
+
=== Moving Emails ===
 +
Highlight the emails to be moved by clicking on the emails while holding down the <code>Ctrl</code> key (<code>Ctrl+A</code> will highlight all emails). Right-click on the highlighted item(s), select ''Move To Folder...'' and select a destination folder. Alternatively, drag and drop the highlighted emails into the destination folder. Emails can only be moved within a user archive unless you are a MailStore administrator.
  
== Using Quick Search ==
+
== Searching by Folder Structure ==
 +
MailStore sorts all archived email into MailStore's own folder structure. Below the main folders, the individual email sources (e.g. Microsoft Outlook or Exchange mailboxes) and their folder structures (e.g. ''Inbox'') are listed.
  
Quick search is located in the upper left area of the application window. Simply enter one or more keywords into the search field and click on Search or press Enter. Search results are displayed in the lower left area or the window. If a keyword appears in the header or the subject line, it is highlighted.
+
<br style="clear: both;" />
  
== Searching for Word Fragments ==
+
[[File:accs_folders_02.png|right|240px]]
 +
=== Viewing the Emails in a Folder ===
 +
To view the emails in a folder, simply click on the folder name. The emails will be listed below the folder structure.
  
To view all emails containing a particular word fragment, use the wildcard character ( * ). For example:
+
Click on the text ''Sorted by: <value>'' to change the order in which emails are displayed. Emails can be sorted according to:
  
auto*
+
* Date
 +
* From/To (sender/recipient of the email)
 +
* Subject
  
would locate "auto", "automatic", "automobile" and others.
+
Click on the Field to the right of ''Sorted by'' ("New to Old" in the screenshot) to reverse the order in which emails are arranged. By default, the latest email is displayed first.
  
== Searching for Phrases ==
+
=== Refreshing the View ===
 +
To refresh the list of folders, click on a folder and press F5 on your keyboard.
  
To search for words appearing consecutively and in a certain order, use quotation marks ( "" ). For example:
+
Click on the folder again to refresh the list of emails.
 
 
"Microsoft Windows"
 
 
 
would only locate Microsoft Windows, not Microsoft Works or Windows 95.
 
 
 
<br style="clear:both;">
 
 
 
== Narrowing by Fields ==
 
 
 
A search for keywords or phrases can be limited to particular fields. For example:
 
 
 
subject:News                  only in Subject
 
from:[email protected]      only in From
 
to:[email protected]      only in To
 
cc:[email protected]        only in Cc
 
bcc:[email protected]  only in Bcc
 
 
 
== Excluding Words ==
 
 
 
To narrow a search, it may be desired to specify words that must NOT be present in the emails. To exclude keywords from the search results, simply place a minus ( - ) sign in front of them. For example:
 
 
 
ZDNet -download-hint
 
 
 
would locate all emails from ZDNet, but not download-hint.
 
 
 
== Combining Search Options ==
 
 
 
The search options described above can also be combined. For example:
 
 
 
ZDNET -"Daily Update"
 
 
 
would locate all emails from ZDNet which do not contain the consecutive words Daily Update.
 
 
 
= Extended Search =
 
 
 
With MailStore's integrated extended search, complex search processes can be carried out. Not only can the email content be searched but also parameters such as date and email size.
 
 
 
== Using the Extended Search ==
 
 
 
In the MailStore application window, click on Search Email. Specify the search criteria for the emails that are to be included in the results. The criteria are AND-connected, meaning that the search results include only those emails that satisfy all criteria specified. Click on ''Search'' to start the search.
 
 
 
[[File:accs_extsearch_01.png|center|500px]]
 
 
 
== Search Criteria under "Extended Search - Search For" ==
 
 
 
Enter a keyword or phrase into the text field, and specify where MailStore is to direct the search.The following options are available:
 
 
 
*'''Subject''' - The subject line of the email is searched.
 
*'''Sender/Recipient''' - The fields "From", "To", "Cc", and "Bcc" are searched.
 
*'''Message body''' - The text-only or HTML sections of the email are searched (depending on availability).
 
*'''Attachments''' - The file names of the email attachments are searched.
 
*'''Attachment contents''' - The contents of the email attachments are searched. If and to what extent attachments can be searched depends on the indexing options specified (under ''Administrative Tools'').
 
 
 
In the textfield ''Search for'', all options described in section Quick Search, such as phrases and wildcards, are available here as well.
 
  
== Search Criteria under "General" ==
+
=== Starting an Advanced Search in a Folder ===
 
+
To start an advanced search in a folder, right click on the folder and select ''Search here...''. The [[#Advanced Search|advanced search]] is shown and the folder is preselected.
Under ''General'', the following options are available:
+
<br style="clear: both;" />
 
+
{{Quick Search|Client|upper left}}
*'''Folder''' - The folder to be searched by MailStore can be selected here. By default, this is the main folder of the current user. By clicking the button to the right of the text field, folders can also be selected using the folder structure. As administrator, the folders of all users can be searched.
+
{{Advanced Search|Client}}
*'''Include subfolder''' - If selected, MailStore not only searches the selected folder (e.g. ''Inbox''), but all subfolders created therein (e.g. ''Inbox / Projects 2008 / Profit Optimization'') as well.
 
*'''From''' - Any keywords or email addresses entered here are searched for only within the email's sender field.
 
*'''To/Cc/Bcc''' - Any keywords or email addresses entered here are searched for only within the email's recipient fields.
 
*'''Date''' - The timeframe the search is to cover can be selected here. Either a predefined range, such as ''Yesterday'' or ''This year'', can be selected or, by choosing ''Custom'', a specific period can be specified manually. In this case, the start and end dates will be included.
 
 
 
In the fields ''From'' and ''To/Cc/Bcc'', all options, such as phrases and wildcards, described in section Quick Search are available.  
 
 
 
== Search Criteria under "Extended" ==
 
 
 
Under Extended, the following options are available:
 
 
 
*'''Messages with/without attachments''' - By default, all messages are searched, regardless of whether or not they have any file attachments. Clear one of the check boxes to remove certain emails, such as those without attachments, from the results. '''Important:''' These searches can be imprecise at times because items like background pictures could be regarded as attachments.
 
*'''Size''' - By default, all messages are searched regardless of their size. Use the appropriate fields provided to limit the search according to the size of the emails, e.g. at least ''5 MB'' or between ''400 and 600 KB''.
 
*'''Priority''' - Emails are searched according to the priority level of the email as assigned by the sender. When choosing ''Low'', all emails with a priority level lower than ''Normal'' are returned, when choosing High, all emails with a priority level higher than ''Normal are returned''. Emails not containing any information regarding priority are assumed to have a priority level of ''Normal''.
 
 
 
== Starting the Search ==
 
 
 
Click on ''Search'' to start the search. Results are displayed in a list in the left section of the main window.
 
 
 
== Refining the Search Results ==
 
 
 
Click on ''Extended Search'' again to further narrow the results after a search has been executed. Specify any additional search criteria and click on ''Search'' once more.
 
 
 
== Starting a New Search ==
 
 
 
Click on ''New Query'' to start a new search. All search criteria will be reset to their default values (i.e. an unrestricted search of the folders of the current user).
 
 
 
== Saving Search Criteria for Reuse ==
 
 
 
Search criteria that are used repeatedly (such as "all receipts from last month") can be saved and reused at a later time: In the upper area of the application window, click on ''Save Criteria'' and provide a meaningful name for the search. To access, edit or restart the search, click on ''Load Criteria''.
 
 
 
To rename or delete saved search criteria, click on ''Manage Criteria''.
 
 
 
= Email Preview =
 
  
 +
== Email Preview ==
 
MailStore offers an integrated email preview displaying emails the same way as standard email applications. To activate the preview, simply click on an email or use the arrow keys to highlight the desired email in the list.
 
MailStore offers an integrated email preview displaying emails the same way as standard email applications. To activate the preview, simply click on an email or use the arrow keys to highlight the desired email in the list.
  
[[File:accs_preview_01.png|center|350px]]
+
[[File:Access client.png|center|550px]]
  
 
The menu bar above the email preview shows all functions available for the email currently displayed.
 
The menu bar above the email preview shows all functions available for the email currently displayed.
  
== Open in... ==
+
=== Save as... ===
 
+
Click on ''Save as...'' to save the current email in any Windows folder. Emails can be saved in the following file formats:
In order to forward or reply to an email, users can temporarily restore the current email in the MailStore preview to an email application. The following options are available:
 
 
 
*Open in Outlook
 
*Open in Windows Mail / Outlook Express
 
*Open in Windows Live Mail
 
*Open in Thunderbird
 
 
 
Please note: Emails are simply opened, not stored, in the application. To restore emails to an email application, please use MailStore's Export Feature.
 
 
 
== Print ==
 
 
 
Using the print function, the email currently displayed will be printed including header information such as Date and Subject.
 
 
 
== Save ==
 
 
 
Click on Save as to save the current email in any Windows folder. Emails can be saved in the following file formats:
 
 
 
*'''RFC822 EML''' - These files can be opened independently from MailStore by double-clicking and can be moved to applications such as Outlook Express by drag & drop.
 
*'''Outlook MSG''' - These files can be opened with or imported to all versions of Microsoft Outlook (not Outlook Express) directly.
 
 
 
== Export ==
 
 
Using the Export feature, the current email can be exported to other applications, such as Microsoft Outlook, forwarded using SMTP, or burned to a CD. Additional information about this topic is available in section Exporting Emails.
 
 
 
== Internet Headers... ==
 
 
 
Click on Internet Headers to view the header of the current email, including all MIME parts. Hold down the SHIFT key while clicking on Internet Headers to view the entire source code of the message.
 
 
 
== Delete (only with the appropriate privilege) ==
 
 
 
Click on Delete to delete the current email from the archive. Please keep in mind that, in order to use this function, the appropriate privilege has to be in place.
 
 
 
= Reopening Emails in an Email Application =
 
 
 
Emails previewed in MailStore can be reopened in any email application to reply to or forward them. Simply click on Email Commands and select one of the following options:
 
 
 
[[File:accs_openclient_01.png|right|250px]]
 
 
 
*Open in Outlook
 
*Open in Windows Mail / Outlook Express
 
*Open in Windows Live Mail
 
*Open in Mozilla Thunderbird
 
 
 
<br/>
 
Please note: Emails are simply opened, not stored, in the application. To restore emails to an email application, please use MailStore's Export Feature.
 
 
 
= Exporting Emails =
 
 
 
MailStore provides several functions regarding the export of archived emails. Emails can be exported directly into server mailboxes, or to the file system as individual email files (EML or MSG format), for example.
 
 
 
Please note: Backup strategies (a backup of the entire archive) are discussed separately in the chapter [[Backup_and_Restore#Backup|Backup]].
 
 
 
== Available Export Destinations ==
 
 
 
*'''Microsoft Outlook''' - A folder named MailStore Export is created in Microsoft Outlook into which emails are copied.
 
*'''Exchange mailbox''' - A folder named MailStore Export is created in the Exchange mailbox into which emails are copied.
 
*'''IMAP mailbox''' - A folder named MailStore Export is created in an IMAP mailbox into which emails are copied.
 
*'''Directory (File System)''' - Either EML or MSG files are created (one per email).
 
*'''Email address using SMTP'''- Emails are forwarded to a specified email address using SMTP, the standard protocol for sending emails.
 
*'''CD/DVD''' - Either EML or MSG files (one per email) are burned to CD or DVD. MailStore can also distribute the backup among several storage media; CDs and DVDs can be used interchangeably. Rewritable disks (CD-RW or DVD-/+RW) can be used as well.
 
 
 
Please note: '''EML files''' can be opened independently from MailStore by double-clicking and moving to applications such as Outlook Express via drag & drop. '''Outlook MSG files''' can be opened or archived directly with all versions of Microsoft Outlook (except Outlook Express).
 
 
 
== Starting an Export ==
 
 
 
'''Using the email preview''' - To export an email currently displayed in the Email Preview, click on Export in the menu bar above the preview and select the export destination. A window appears in which additional settings may have to be specified.
 
 
 
'''Using the list of emails (folder contents or search results)''' - Highlight the emails to be exported by holding down the control key (Ctrl) and right-clicking onto the emails. Pressing Ctrl and A highlights all emails. Click ''Export To'' and select the export destination. A window appears in which additional settings may have to be specified.
 
 
 
'''Using the page "Export Email"''' - On this page, exporting tasks can be created and executed as export profiles (just like archiving profiles). Export profiles hold information about which emails will be exported to which destination. Each profile (i.e. the exporting task) can be executed manually or regularly according to a schedule. To learn more, please read on in the next section.
 
 
 
== Creating an Export Profile Using the Page "Export Email" ==
 
 
 
To create a new export profile, please proceed as follows:
 
 
 
*Start MailStore Client on the computer which is to execute the export. Log on as administrator if the emails of other users are to be exported as well. Only a MailStore administrator is allowed to export the emails of others.
 
*In MailStore, click on ''Export Email''.
 
 
 
[[File:accs_export_01.png|center|350px]]
 
 
 
*From the list in the upper right area, select the destination to which emails are to be exported.
 
*A wizard opens to assist in specifying the export settings.
 
*At the first step, specify which folder is to be exported (subfolders are always included). Depending on the export destination, the file format to be used (e.g. EML , MSG or database backup) can be selected as well. Click on ''Next''.
 
*'''Please note:''' Below the list of folders, a saved search can also be selected. MailStore runs the search before executing the actual export procedure; all emails returned by the search will be exported.
 
*At the second step, specify the exact target location to which emails are to be exported. For example, if ''Exchange Mailbox'' was selected as export destination earlier, the access data for the target mailbox can be specified and verified by clicking on ''Test''. Then click on ''Next''.
 
*Depending on the export destination specified, additional settings can be selected at the next step. For example, if ''IMAP mailbox'' was selected as the destination, a timeout value can be set, if needed.
 
*At the last step, a name for the export profile can be specified. After clicking on ''Finish'', the  profile will be listed under ''Saved Settings (Profiles)'' and can be run immediately, if desired
 
 
 
Just like archiving profiles, already existing export profiles can be executed, edited or deleted at any time. Additional information is available in chapter [[Email_Archiving_with_MailStore_Basics#Working_with_Archiving_Profiles|Working with Archiving Profiles]].
 
 
 
== Executing an Export Profile Using the Page "Export Email" ==
 
 
 
On the start page of MailStore Client, click on Export Email. From the list under Saved Settings (Profiles), select the profile to be executed and click on Run. After the export process has finished, a message appears containing information about any errors that may have occurred.
 
 
 
=== Executing an export profile regularly according to a schedule ===
 
In addition to being executed manually, archiving profiles can also be run automatically according to a schedule. For further information please read on in the next chapter: Automating the Export Process.
 
 
 
= Automating the Export Process =
 
 
 
With MailStore, every exporting task (every export profile) can be executed automatically according to specified points in time.
 
 
 
== Procedure ==
 
 
 
*Start MailStore Client on the computer on which the exporting task is to be executed according to a schedule. Please keep in mind that, if a full backup is to be performed, this has to be the computer on which MailStore Server is installed. If the emails of other users are to be exported, log on as administrator.
 
*On the start page of MailStore Client, click on ''Export and Backup''.
 
*Right-click on an existing profile and select ''Schedule Task''. Information about creating exporting tasks is available in the previous chapter: Exporting Emails.
 
 
 
[[File:arch_schedule_01.png|center|350px]]
 
 
 
In the next window ("Schedule Task"), the following settings of the planned task can be specified:
 
 
 
'''Task - Name:''' The task name can be chosen freely. By default, the name of the export profile and its internal MailStore ID are used.
 
 
 
'''Trigger:''' A time for daily execution (the task is executed once a day) or a time time interval (e.g. every 60 minutes) can be specified.
 
 
 
If the option Other Trigger is chosen, the exporting task is created as Windows task but execution times still have to be specified. This has to be done using the Windows task planner and is described in Windows Help. All options offered by your current Windows version can be used.
 
 
 
'''Windows Account:''' Specify here which user account is to be used when executing the scheduled task. The option Local System Account can be used for exports with destination Directory (File System) or CD/DVD, for example, and has the advantage that no password is required to execute the task. If the emails are to be archived from the applications of the current user (e.g. from Microsoft Outlook), the corresponding user account must be selected. In such cases, the option Local System Account is deactivated.
 
 
 
'''Log Messages''' - File Name: If a log file is to be created, the name for that file can be specified here. The placeholders {DATE} and {TIME} can be used in the file name which will be replaced by the actual date and time during the archiving process. If desired, the log file can also be created on a network drive.
 
 
 
After all settings have been specified, the task can be created by clicking on OK. Confirm the following safety prompt by clicking OK again. If any account other than the Local System Account has been selected under Windows Account, the Windows password of the currently logged on user has to be entered.
 
 
 
A list of scheduled tasks is displayed in MailStore's Administrative Tools, showing all tasks created on the current computer up to this point.
 
 
 
== Managing Scheduled Tasks ==
 
 
 
Scheduled tasks created on the current computer are managed in Administrative Tools under Scheduled Tasks.
 
 
 
[[File:arch_schedule_02.png|center|450px]]
 
  
The list shows all scheduled tasks for archiving and export processes that were created on the current computer.
+
* '''RFC822 EML''' - These files can be opened independently from MailStore by double-clicking and can be moved to applications such as Mozilla Thunderbird by drag & drop.
 +
* '''Outlook MSG''' - These files can be opened with or imported to all versions of Microsoft Outlook directly.
  
'''Run Task:''' The selected task is executed immediately regardless of its scheduled runtime.
+
=== Print ===
 +
Using the print function the email currently displayed will be printed including header information such as Date and Subject.
  
'''Properties:''' The Windows task planner is opened for the selected task; all options offered by the current Windows version can be used.
+
=== Find in Email ===
 +
Click on ''Find in Email...'' to search the message body of the current email.
  
'''Delete Task:''' The selected task is deleted. This does not affect the underlying archiving profile or any of the archived emails.
+
=== Internet Headers... ===
 +
Click on ''Internet Headers'' to view the header of the current email, including all MIME parts.
  
'''Open Log Files Directory:''' The directory containing the protocols for the selected task is opened.
+
=== Message Source ===
 +
Click on ''Message Source'' to show the full source of the current message including all MIME-parts.
  
== Viewing the Command Line ==
+
=== Delete (only with the appropriate privilege) ===
 +
Click on ''Delete'' to delete the current email from the archive. Please keep in mind that, in order to use this function, the appropriate privilege has to be in place.
  
If desired, the export process can be incorporated into a larger procedure, such as one run by a batch file (.bat). To simplify this process, MailStore offers the option Copy Cmd Line in the Schedule Task window (see above). Click on it to view a command line that can be incorporated into the desired procedure. For example:
 
  
REM *** Microsoft Outlook (ID 77) ***
+
=== Retention Details (Administrators only) ===
+
This button is only available if [[Retention_Policies|retention policies]] are configured and enabled.<br/>
"C:\Program Files\deepinvent\MailStore Server\MailStoreCmd.exe"
+
[[File:Retention_Policies_05.png|right|350px]] Click on ''Retention Details'' to view the minimum and maximum retention date and the corresponding retention policies if applicable.
--h="localhost" --pkv3="16:0e:95:b0:79:d2:e8:e0" -u="admin" --p="admin"
 
--o="C:\ProgramData\MailStore\TaskLog\77_{DATE}-{TIME}.log"
 
-c export-execute --id=77 --user="admin" --verbose
 
  
The command line is to be read as follows:
 
  
'''"...\MailStoreCmd.exe"''' - MailStoreCmd.exe is the MailStore Management Shell. It was developed for the automated execution of certain processes in MailStore. Additional information about MailStoreCmd is available in chapter The MailStore Management Shell.
+
By clicking on a retention policy you can view its configuration directly.<br style="clear: both;" />
  
'''--h="localhost"''' - The computer name of the MailStore server to which MailStoreCmd.exe is to connect.
+
=== Reopening Emails in an Email Application ===
 +
Emails previewed in MailStore can be reopened in any email application to reply to or forward them. Select an email client you want to open email messages in first, by clicking on ''Email Client:''. MailStore only lists email clients that are supported and that are installed on the computer from which MailStore Client is executed.  
  
'''--pkv3="..."''' - Public Key Fingerprint. It ensures that the MailStore server at the time of archiving is the same as it was at the time when the scheduled task was created (optimal safety feature).
+
[[File:accs_openclient_01.png|center|450px]]
  
'''--u="admin"''' - User name.
+
Depending on the selected email client, additional button may be visible:
  
'''--p="admin"''' - Password.
+
* '''Open in <email client>''' - Open the current message to the selected email client. Please note, that emails are simply opened, not stored, in the application. To restore emails to an email application, please use [[Exporting Email|MailStore's Export Feature]].
  
'''-c''' - The actual command follows (non-interactive mode).
+
* '''Restore to <email client>...''' - Restore the current message to the selected email client. If further settings are required an additional button ''Settings..'' will be shown.
  
'''import-execute --id=77 --user="admin"''' - Execute the archiving profile of user admin with the  internal ID 77.
 
 
[[de:Zugriff_über_die_MailStore_Client-Software]]
 
[[de:Zugriff_über_die_MailStore_Client-Software]]
 +
[[en:Accessing the Archive with the MailStore Client software]]

Revision as of 15:01, 26 April 2021

Installation & Update

The MailStore Client 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.

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.

Notice: Alternatively to installing the MailStore Client 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 Client Deployment

If an update is installed on the MailStore Server computer, MailStore Client updates itself automatically on first login to stay compatible with MailStore Server. Therefore a re-installation of MailStore Client is usually not required.

Starting and Login

Start MailStore Client by using the appropriate link on the desktop.

Gsta useclient 00.png

The window Connect to MailStore Server appears.

  • Enter the DNS host name of the computer on which MailStore Server is installed into Server Name. Be aware, that the pre-filled entry localhost only works if the MailStore Client is run from the same machine where MailStore Server is installed.
  • Click Connect to connect to MailStore Server.



Hint: Did you activate the option Always connect to this server and you want to change the destination server later? Hold the Shift key pressed while opening MailStore Client.

After establishing the connection to MailStore Server, MailStore Client checks if newer a version of its own program files is available for downloading and, if necessary, updates these automatically.

Gsta useclient 01.png

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.


Gsta useclient 02.png

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.

The MailStore Folder Structure

Accs folders 01.png

For each user, MailStore creates a folder on the highest level of the folder structure which corresponds to the archive of the respective user. It contains all emails that were archived for this user and is labeled My Archive.

If the user has access to the archives of other MailStore users (as MailStore administrator, for example), their folders are listed as Archive of <User Name> under the top level folder Other Archives

Below these main folders, the individual email sources (e.g. Microsoft Outlook or Exchange mailboxes) and their folder structures (e.g. Inbox) are listed.

Notice: For MailStore administrators, accessing the archives of other users via the folder structure is blocked by default; this setting can be changed in the compliance settings. Additionally, MailStore administrators can manage archives via the Archives page.

Deleting Folders

Folders and the emails contained therein can only be deleted after the appropriate user privileges have been assigned explicitly by the administrator. If the folder to be deleted contains any subfolders, they will be deleted as well.

Moving, Renaming, and Creating Folders Manually

Within MailStore, folders can be moved, renamed or created. Regular users can only do this within their own user archive, while MailStore administrators can move and rename folders beyond the boundaries of user archives.During the archiving process, MailStore adopts the folder structure and the folder names of the source (e.g. Microsoft Outlook).

Please note that moving large archives across the borders of user archives can take some time because the emails being moved have to be gathered by the full text index of the target user.

The features New Folder..., Rename and Move to Folder... can be accessed by right-clicking on the corresponding archive folder.

If a MailStore administrator renames a user archive (Folder: Archive of <user name>) without renaming the corresponding user, an empty archive will exist with this user name until it is changed.

Hint: Using an already existing folder name when renaming a folder, allows to merge the content of both folders.

Changing Message Type

In case the message recipient is shown wrongly instead of the message sender or vice versa, an administrator is able to change the message type of a message.

Highlight the emails and select Change Message Type in the context menu.

In case the message type of other users' message should be changed, archive access has to be unblocked.

Verify the archiving profile settings if necessary, so that the message type is already set correctly during archiving.

Deleting Emails

Highlight the emails to be deleted by clicking on the emails while holding down the Ctrl key (Ctrl+A will highlight all emails). Right-click on the highlighted item(s) and select Delete. Users are only allowed to delete emails if they have received this privilege explicitly from the MailStore administrator.

Please keep in mind that allowing users to delete emails is not recommended; assigning such privileges makes it difficult, if not impossible, to comply with legal requirements regarding the storage of emails.

Moving Emails

Highlight the emails to be moved by clicking on the emails while holding down the Ctrl key (Ctrl+A will highlight all emails). Right-click on the highlighted item(s), select Move To Folder... and select a destination folder. Alternatively, drag and drop the highlighted emails into the destination folder. Emails can only be moved within a user archive unless you are a MailStore administrator.

Searching by Folder Structure

MailStore sorts all archived email into MailStore's own folder structure. Below the main folders, the individual email sources (e.g. Microsoft Outlook or Exchange mailboxes) and their folder structures (e.g. Inbox) are listed.


Accs folders 02.png

Viewing the Emails in a Folder

To view the emails in a folder, simply click on the folder name. The emails will be listed below the folder structure.

Click on the text Sorted by: <value> to change the order in which emails are displayed. Emails can be sorted according to:

  • Date
  • From/To (sender/recipient of the email)
  • Subject

Click on the Field to the right of Sorted by ("New to Old" in the screenshot) to reverse the order in which emails are arranged. By default, the latest email is displayed first.

Refreshing the View

To refresh the list of folders, click on a folder and press F5 on your keyboard.

Click on the folder again to refresh the list of emails.

Starting an Advanced Search in a Folder

To start an advanced search in a folder, right click on the folder and select Search here.... The advanced search is shown and the folder is preselected.

Quick Search

With quick search you can browse all emails located in the archives you have access to. This feature is especially suitable for simple queries; alternatively, the advanced search can be used.

Using Quick Search

The input field is located in the upper left part of the MailStore Client. Simply enter one or more keywords and press ENTER. The search results are displayed. Keywords which appear in the header or the subject line are highlighted.

Searching for Word Fragments

To display all emails containing a word with a particular fragment, use the wildcard character (*). For example:

auto*

will return auto, automatic, automobile etc.

*example.com

will return all email addresses and domains of example.com.

firstname.lastname*

will return all email addresses of firstname.lastname.

Searching for Words with unknown letters

To view all emails containing a word where you do not know how to spell it correctly, you can use the question mark (?). For example

Me?er

would locate Meier and Meyer, but not Maier.

The question mark (?) cannot be used at the beginning of a word or at the end of a word, use the wildcard character (*) instead.

Searching for Phrases

To search for words appearing consecutively and in a specific order, use quotation marks (""). For example:

"Microsoft Windows"

will return the text Microsoft Windows but not Microsoft Works or Windows 95.

Narrowing by Fields

A search for keywords or phrases can be limited to specific fields. For example:

subject:News                  only in Subject
from:[email protected]       only in From
to:[email protected]      only in To
cc:[email protected]         only in Cc
bcc:[email protected]   only in Bcc
bcontent:billing              only in Body of message
acontent:billing              only in Attachments of message

Excluding Words

To narrow a search, you may want to specify words which must not be present in the emails. To exclude words from the search results, prepend the word with the minus character (-). For example:

ZDNet -download-tip

returns all emails from ZDNet which do not contain download-tip.

Combining Search Options

Any of the search options described above can be combined. For example:

ZDNET -"Daily Update"

returns all emails from ZDNet which do not contain the consecutive words Daily Update.

from:ZDNET bcontent:MailStore

returns all emails from ZDNET which have MailStore somewhere in their message body.

from:[email protected] acontent:bill

returns all emails from [email protected] which have bill in any attachment.

to:[email protected] -sales

returns all emails to [email protected] which do not have sales in any part of the email.

from:[email protected] to:[email protected] acontent:bill -subject:admonition

returns all message from [email protected] to [email protected] which have bill in any attachment but do not have admonition in the subject.

About Special Characters

Words inside indexed emails or attachments which are a combination of alphanumeric (letters, digits) and non-alphanumeric characters (white space, line break, delimiter or other control characters), may be returned in search results when searching for the alphanumerical part only.

For instance, when searching for firstname, firstname.lastname and lastname, e-mails containing the word firstname.lastname will be returned.

Commonly occurring characters are:

  • Period (.)
  • Comma (,)
  • Semicolon (;)
  • Hyphen (-)
  • Underscore (_)
  • AT-Sign (@)
  • Slash & Backslash (/,\)
  • Null character (NUL)


Advanced Search

Using the advanced search, you can execute complex queries through the MailStore Client. Queries can be scoped to certain archive folders and may not only refer to the email content but also include fields such as email date, archiving date or email size.
Email attachments can be searched specifically, too if search indexing has been configured appropriately.

Using the Advanced Search

In the MailStore Client, click on Search Email and enter the search parameters. The criteria are AND-combined, i.e. the search returns only those emails that satisfy all criteria. Click on Search to start the search.

Accs extsearch 01.png

Search Criteria under "Search"

Enter a keyword or phrase into the text field and specify where MailStore is to conduct the search. The following options are available:

  • Subject - The subject line of the email is searched.
  • Sender/Recipient - The fields "From", "To", "Cc", and "Bcc" are searched.
  • Message body - The text-only or HTML sections of the email are searched (depending on availability).
  • Attachments File Names - The file names of the email attachments are searched.
  • Attachment Contents - The contents of the email attachments are searched. If and to what extent attachments can be searched depends on the specified indexing options.

All options described in section Quick Search, such as phrases and wildcards, are available in the textfield Search for as well.

Search Criteria under "General"

Under General, the following options are available:

  • Folder - The folder to be searched by MailStore can be selected here. By default, all folders readable by the current user are selected. By clicking the button next to the text field, folders can also be selected using the folder structure.
  • Include subfolder - If selected, MailStore not only searches the selected folder (e.g. Inbox), but all subfolders created therein (e.g. Inbox / Projects 2008 / Profit Optimization) as well.
  • From - Any keywords or email addresses entered here are searched for within the email's sender field only.
  • To/Cc/Bcc - Any keywords or email addresses entered here are searched for within the email's recipient fields only.
  • Date - The time frame the search is to cover can be selected here. Either a predefined range, such as Yesterday or This year, can be selected or, by choosing Custom, a specific period can be specified manually. In this case, the start and end dates will be included.
  • Archiving Date - The archiving time frame the search is to cover can be selected here. Either a predefined range, such as Yesterday or This year, can be selected or, by choosing Custom, a specific period can be specified manually. In this case, the start and end dates will be included.

All options described in section Quick Search, such as phrases and wildcards, are available in the fields From and To/Cc/Bcc as well.

Search Criteria under "Advanced"

Under Advanced, the following options are available:

  • Archive Store - If the archive consists of more than one archive store, the search can be limited to just one of the. By default all archive stores are searched.
  • Messages with/without attachments - By default, all messages are searched, regardless of whether or not they have any file attachments. Clear one of the check boxes to remove certain emails, such as those without attachments, from the results.
    Important: These searches can be imprecise at times because items like background pictures could be regarded as attachments.
  • Size - By default, all messages are searched regardless of their size. Use the appropriate fields provided to limit the search according to the size of the emails, e.g. at least 5 MB or between 400 and 600 KB.
  • Priority - Emails are searched according to the priority level of the email as assigned by the sender. When choosing Low, all emails with a priority level lower than Normal are returned, when choosing High, all emails with a priority level higher than Normal are returned. Emails not containing any information regarding priority are assumed to have a priority level of Normal.

Starting the Search

Click on Search to start the search. Results are displayed in a list in the left section of the main window.

Refining the Search Results

Click on Search Email again to further narrow the results after a search has been executed. Specify any additional search criteria and click on Search once more.

Starting a New Search

Click on New Query to start a new search. All search criteria will be reset to their default values (i.e. an unrestricted search of the folders readable by the current user).

Saving Search Criteria for Reuse

Search criteria that are used repeatedly (such as "all receipts from last month") can be saved and reused at a later time: Click on Create Search Folder... and provide a meaningful name for the search.

The new search folder will be available under the Search Email folder on the left side of the application window.

Through the context menu you can view the search criteria of a search folder (New Search Query) and rename or delete it.

About Special Characters

Words inside indexed emails or attachments which are a combination of alphanumeric (letters, digits) and non-alphanumeric characters (white space, line break, delimiter or other control characters), may be returned in search results when searching for the alphanumerical part only.

For instance, when searching for firstname, firstname.lastname and lastname, e-mails containing the word firstname.lastname will be returned.

Commonly occurring characters are:

  • Period (.)
  • Comma (,)
  • Semicolon (;)
  • Hyphen (-)
  • Underscore (_)
  • AT-Sign (@)
  • Slash & Backslash (/,\)
  • Null character (NUL)


Email Preview

MailStore offers an integrated email preview displaying emails the same way as standard email applications. To activate the preview, simply click on an email or use the arrow keys to highlight the desired email in the list.

Access client.png

The menu bar above the email preview shows all functions available for the email currently displayed.

Save as...

Click on Save as... to save the current email in any Windows folder. Emails can be saved in the following file formats:

  • RFC822 EML - These files can be opened independently from MailStore by double-clicking and can be moved to applications such as Mozilla Thunderbird by drag & drop.
  • Outlook MSG - These files can be opened with or imported to all versions of Microsoft Outlook directly.

Print

Using the print function the email currently displayed will be printed including header information such as Date and Subject.

Find in Email

Click on Find in Email... to search the message body of the current email.

Internet Headers...

Click on Internet Headers to view the header of the current email, including all MIME parts.

Message Source

Click on Message Source to show the full source of the current message including all MIME-parts.

Delete (only with the appropriate privilege)

Click on Delete to delete the current email from the archive. Please keep in mind that, in order to use this function, the appropriate privilege has to be in place.


Retention Details (Administrators only)

This button is only available if retention policies are configured and enabled.

Retention Policies 05.png

Click on Retention Details to view the minimum and maximum retention date and the corresponding retention policies if applicable.


By clicking on a retention policy you can view its configuration directly.

Reopening Emails in an Email Application

Emails previewed in MailStore can be reopened in any email application to reply to or forward them. Select an email client you want to open email messages in first, by clicking on Email Client:. MailStore only lists email clients that are supported and that are installed on the computer from which MailStore Client is executed.

Accs openclient 01.png

Depending on the selected email client, additional button may be visible:

  • Open in <email client> - Open the current message to the selected email client. Please note, that emails are simply opened, not stored, in the application. To restore emails to an email application, please use MailStore's Export Feature.
  • Restore to <email client>... - Restore the current message to the selected email client. If further settings are required an additional button Settings.. will be shown.