Applying additional user preferences
Who is this article for?Administrators responsible for managing user settings.
AdminEmailFiling.cfg edit access is required.
Additional settings can be applied to a user's EmailFiling.cfg, either manually or automatically via AdminEmailFiling.cfg. When applying these, make sure you use a plain text editor, like Notepad. This article will walk you through the available settings and how to add them to the files.
1. Overview
1.1. Advanced mobile search
Used to enable the advanced searching on mobile apps for Microsoft 365 Locations.
AllowMobileAdvancedSearch=1
(Default value=0)
1.2. Auto discovered locations interval
Used to extend the interval between discovering Locations.
AutoDiscoveryIntervalHours=2
(Default value=1)
1.3. Auto discovery version 2
v2 uses a different authentication (SharePoint REST instead of Graph). Fewer queries, more in-memory processing.
EnableSharePointAutoDiscoveryV2=1
(Default value=0)
1.4. Cache folder
Used to limit the number of items located in the filing cache folder:
%Localappdata%\Oasys\Mail Manager\FilingCache
Applying a value of zero means that items will only be present in the Filing Cache folder if they do not have a status of completed, cancelled or cancelling when next checked.
The check occurs at the "Full Activity interval", which by default is every 15 minutes.
Example:
CacheSizeMbLimit=0
(Default value =1000)
1.5. Change filed items folder
Used to change the name and location of the "Filed Items" folder. The path is relative to the mailbox account.
Example:
MoveAfterFilingFolder=Inbox\Filed messages
(Default value =Inbox\Filed Items)
1.6. Change Teams channel sub-folder name
Used to change the name of the folder that is discovered or created.
TeamsEmailsFolderName=Emails
(Default value =Email Messages)
1.7. Enable adding an individual location for Synergy from the locations tool
Normally locations for Synergy are discovered automatically.
EnableSynergyLocations=1
(Default value =0)
1.8. Enable adding an individual location for Viewpoint for Projects from the locations tool
Normally, Locations for Viewpoint for Projects are discovered automatically.
EnableAddViewPointLocations=1
(Default value =0)
1.9. Enable indexing of Microsoft Information Protection (MIP) messages
Normally, Locations for Viewpoint for Projects are discovered automatically.
EnableMIPSDK=1
(Default value =0)
1.10. Enable respawning of MailManager.Startup.exe
Should only be used when the Mail Manager ribbon buttons are being disable after the PC has recovered from hibernation mode.
EnableStartupRespawn=1
(Default value =0)
1.11. Disable adding or creating new collections
Will prevent users from adding or creating new Collections.
DisableNewCollection=1
(Default value =0)
1.12. Disable adding SharePoint metadata
Should only be used when metadata is not required during filing to SharePoint.
EnableSharePointMetaData=1
(Default value =0)
1.13. Disable hardware rendering
When applied the hardware rendering for WPF windows will not be used.
DisableHardwareRendering=1
(Default value =1)
1.14. Filename subject length
Number of characters used from the email subject in the filename.
SubjectTruncateLength=
(Default value =40)
1.15. Filing prompt to exclude
Used to prevent being prompted to file a message when the email address matches. This variable works only during sending an email and checks for any recipient in the email matches the pattern.
Singular Domain
Always include [ .* ] before the email domain.
FilingPromptSkipOnRecipientPattern=.*@hubspot.com
Multiple domains
Always include [ | ] in between each email domain, and always wrap email domain in brackets.
FilingPromptSkipOnRecipientPattern=(.*@mailmanager.com)|(.*@zoho.com)|(.*@hubspot.com)
(Default Value = blank)
1.16. Index Import
Used to import a pre-populated index into a new user's installation of Mail Manager.
IndexImportLocation=
Example: IndexImportLocation=\\server01\Mail Manager\Mail Manager Config
1.17. Limit Mail Manager to work with only one email domain
When implemented, users that use Outlook with mailboxes with different domains will only be prompted to file emails when using the mailbox from the specified domain.
AllowedMailBoxDisplayName=
Example: AllowedMailBoxDisplayName=@mailmanager.com
1.18. Overwrite existing messages in network folders
Used to avoid creating multiple versions of the same message when version history is enabled.
OverwriteFiledNetworkMessage=1
(Default value =1)
1.19. Overwrite existing messages in SharePoint
Used to avoid creating multiple versions of the same message when version history is enabled.
OverwriteFiledSharePointMessage=1
(Default value =0)
1.20. Prompt to file received messages by selecting another message in the list
Used to enable the prompt to file window to appear when selecting another message in the Outlook list view.
FilingPromptOnExplorerSelectionChange=1
(Default value =0)
1.21. Populate SharePoint metadata columns (legacy format)
To continue populating SharePoint metadata columns in the legacy format.
UseLegacySharepointMetadataColumns=0
(Default value =1)
1.22. Shell extension loader logging
To turn on logging of the shell extension loader (right-click in Windows File Explorer).
EnableShellExtensionLogging=1
(Default value =0)
1.23. Subject changes e.g. [pending], [Pending] and [Filed 15 Aug 2023 17:33]
Used to reduce Exchange to Outlook synchronisation issues when Mail Manager updates the subject during the filing process.
SubjectChangesAllowed=0
(Default value =1)
1.24. Only run FileSystem AutoDiscovery when Mail Manager can reach the server
Used to stop File System Auto Discovery running and removing current filing locations when a user is working from home and not using a VPN.
DiscoverOnlyWhenAllAccessible=1
2. Using EmailFiling.cfg
To apply settings manually:
- Open Windows File Explorer.
- Go to %appdata%\oasys\Mail Manager.
- Open EmailFiling.cfg.
- Add the setting on a new line.
- Set the required value.
- Save the file.
Your changes will be applied to that user immediately.
Note: settings prefixed with * disables the setting in the User Preferences UI.
3. Using AdminEmailFiling.cfg
To apply settings automatically:
- Go to the Shared Configuration Folder.
- Open AdminEmailFiling.cfg.
- Add the setting on a new line.
- Set the required value.
- Prefix the new line with #
This will ensure the setting is applied to all users. - Increment the value of the AdminUpdateDateTime setting by 1.
This will prompt the settings to be updated for all users. - Save the file.
Your changes will be applied to all users within a few minutes.