ndMail Registry Settings

Follow

Table of Contents

Below you can see the list of the registry keys, their descriptions, and supported values available with the latest release.

NOTE: By default, ndMail uses the registry settings from ndOffice (if applicable to ndMail).

Default Location: Computer\HKEY_CURRENT_USER\Software\NetDocuments\ndMail

OR

Computer\HKEY_LOCAL_MACHINE\Software\NetDocuments\ndMail

NOTE: Settings on administration level prevail over user-level settings.

OneClickFilingEnabled registry

Values

Set the appropriate value to enable or disable the one-click filing option. You can also specify it on the ndMail Settings dialog box > the Enable one-click filing check box.

  • True
  • False (default)

PromptToFileOnSendEnabled registry

Values

Set the appropriate value to see or not to see a prompt to select the location when sending an item. You can also specify it on the ndMail Settings dialog box > the Prompt to file outgoing messages check box.

  • True
  • False (default)

PromptToFileOnSendAlways registry

 Values

Set the appropriate value to see or not to be forced to select the location every time when sending an item. The user MUST select an item to file. This item is not configurable in the user interface. 

  • True
  • False (default)

RankingBarEnabled registry

 Values
Set the appropriate value to see or not to see the relevancy ranking for predictions. You can also specify it on the ndMail Settings dialog box > the Show relevancy rank for predictions check box.
  • True
  • False (default)

AllowAccessOptionMe registry

 Values
Set the appropriate value to allow all access options & combinations or to prevent users from filing with Me only access selected.
  • True (default)
  • False

ExcludedPromptingTypes and ExcludedFilingTypes registries

 Values
Set the appropriate value to disable or enable prompting or filing, respectively, for specified Outlook items in Predictive Filing.

NOTE: Separate multiple values by semicolons (;).
 

Default: None

ShowOutlookPanels registry

 Values

Set the appropriate value to enable or disable the Outlook Panels feature. 

NOTE: This feature requires ndOffice 2.3.

  • True
  • False (default)

ShowSuccessfulToastNotification registry

 Values

Set the appropriate value to show all toast notifications, including successful filings ones or to hide toast notifications for successful filings. 

NOTE: Toast notifications for failed filing appear always.

  • True (default)
  • False

IsUpdateEnabled registry

 Values

Set the appropriate value to allow users to select the Check for Updates option or to prevent users from checking for updates.

  • True (default)
  • False

IsShortcutForFocusEnabled registry

Values

Set the appropriate value to put the focus on the prediction panel with a keyboard shortcut. After the focus is on the panel, other keyboard shortcuts continue to work regardless of this setting. The default value is False.

NOTE: The True setting can impact performance/speed in Outlook. 

  • True
  • False (default)

IsPanelAutoMoveEnabled registry

Values

Set the appropriate value to move the ndMail panel automatically to the bottom of the items list if the reading pane is turned off.

If set to False, ndMail panel is not displayed.

  • True (default)
  • False

ExplorerPanelHeight registry

Values

Defines the initial size of the Predictions Panel. If the user customizes their own panel height then this registry setting will not apply:

  • height (if the panel is at the top/bottom)

or

  • width (if the panel is vertical on the right/left of the Reading Pane)  
 

Integer values between 130 and 460.

The value is in pixels.

Default: 0

The ExplorerPanelExpanded registry

Values

In HKEY_CURRENT_USER (HKCU) hive, set the appropriate value to collapse the expanded predictions panel on the Outlook Reading Pane.

ndMail remembers user changes.

NOTE: Value from the HKLM hive has a higher priority.

True (this value is default)

The predictions panel expands in the default or inspector view in Outlook.

False

The predictions panel collapses in the default or inspector view in Outlook.

The InspectorPanelExpanded registry

Values

Set the appropriate value under Software\NetDocuments\ndMail root in either HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE.

True (this value is default)

The predictions panel expands in the inspector view in Outlook.

False

The predictions panel collapses in the inspector view in Outlook.

The ExplorerPanelLocation registry

Values

In HKCU hive, set the appropriate value to change the location of the predictions panel on the main Outlook view.

This is a setting for the default value. ndMail remembers user activities. The user can move the ndMail prediction panel to the needed location.

 

10 – TopReadingPane (this value is default)

11 – BottomReadingPane

12 – LeftReadingPane

13 – RightReadingPane

1 – TopSubpane

2 – BottomSubpane

The InspectorPanelLocation registry

Values

In HKCU hive, set the appropriate value to change the location of the predictions panel in the inspector Outlook view.

This is a setting for the default value. User changes are remembered. You can move the panel by clicking the ndMail top row and dragging it to other location.

 

1 – INSPECTOR_TOP_SUBPANE (this value is default)

2 –INSPECTOR_BOTTOM_SUBPANE

3 – INSPECTOR_RIGHT_SUBPANE

4 – INSPECTOR_LEFT_SUBPANE

IsAutoUpdateEnabled registry

Values

Notify that a new version is available and users can upgrade to it. 

  • True (default)
  • False

FilingOperationType registry

Values

Set the default filing action.

  • File (default)
  • FileAndMove

TracingEnabled registry

Values

Enable logs tracing that will provide detailed information about problems users might encounter during their work with ndMail. The Logs folder is located at the following path: C:\Users\[username]\AppData\Local\NetDocuments\Logs. The default value is False.

  • True
  • False (default)

RestTracingEnabled registry 

Values

Enable ndMail REST API calls tracing. The default value is False.

  • True
  • False (false)

PredictionCacheTimeInMinutes registry

Values

Set a time interval to refresh predictions. The default value is 15 (minutes).

Any integer value

Default: 15 (minutes)

FullPathCacheTimeInMinutes registry

Values

Set a time interval to refresh the full path of location. The default value is 43200 (minutes).

Any integer value

Default: 43200 (minutes)

AlternativeUpdateUrl registry

Values

URL for an alternative update source.

For example, https://somelocation.com/AppVersions.xml

Default: None

IsAlternativeUpdateUrlEnabled registry

Values

Enable/disable usage of AlternativeUpdateUrl setting.

  • True
  • False (default)

ConversationFiling registry

Values

Enable/disable the conversation filing feature. If no value data is present or if the value itself does not exist, then the default behavior is to disable conversation filing. The value in HKCU prevails for this feature if there is a difference between HKLM and HKCU values. This value has no default state (the feature is disabled).

  • True
  • False (default)

MoveItemsOnFilingToFolderWithEntryId registry

Values

Move items to the location after filing. When a user selects the folder for File&Move in Settings, the folder ID is automatically added in Value. Note that it only works with Conversation Filing disabled.

Default: None

DoNotMoveSentItems registry

Values

Move items using File & Move from the Sent Items folder to the location that the user specifies. When set to Truethe File & Move feature will not move items from the Sent Items folder. 
If the registry doesn't exist, it is equal to setting False.

  • True
  • False (default)

SendAndFileSearchInAllFoldersEnabled registry

Values

ndMail will search through your inbox (all folders of all mailboxes of the current profile) to find emails that have not been filed to NetDocuments via Send&File. When set to False (or doesn't exist) nothing will change. This logic takes into account FilingData in the local DB with statuses Ready and ItemNotFoundInSentItemsFolder.

NOTE: You may see performance degradation immediately after enabling this as we search for the items, but performance will restore after the job completes.
  • True
  • False (default)

IsFileAndMoveOperationSelected registry

Values

Enable the File&Move option. On the ndMail Predictions Panel, there will be two drop-down options: File and File & Move. The File & Move button will automatically move the filed item to the location selected in ndMail Settings.

  • True
  • False

AddMailSyncNetDocumentsCategory registry

Values

 

True: Add Filed to ND category to emails while filing to NetDocuments (default)

False: Does not add a category to emails while filing to NetDocuments

AddToRecent registry

Values

 

True: Add filed emails to the recent items in the NetDocuments (default)

False: Do not add filed emails to the recent items in the NetDocuments

AutoResync registry

Values

 

0: Emails are not resynced in mapped folders when users start Outlook (default)

1: All emails not copied previously are resynced in all user's mapped folders after Outlook start and the value is reset to 0 after that startup

2: All emails are resynced in all user's mapped folders after Outlook start and the value is reset to 0 after that startup

3: All emails not copied previously are resynced in all user's mapped folders after Outlook start and will keep the value set to after that start so that it resyncs on every Outlook startup (instead of just one)

4: Users get a prompt after Outlook start to resync all of their mapped folders. They can sync all items or just sync items that were not previously copied to NetDocuments. Then, the value is reset back to 0

The feature is disabled by default

ContainerCheck registry

Values

 

String to check folder or workspace when mapping Outlook folder to NetDocuments folders.

Empty by default

CopyExistingEmails registry

Values

 

Allows administrators to set the default values for the Copy pre-existing emails too check box when mapping a folder or to remove the option

True: Select the check box by default for all new mappings (default)

False: Clear the check box by default for all new mappings

HideAndTrue: Hide the check box and always copy pre-existing emails in the mapped folder

HideAndFalse: Hide the check box and never copy pre-existing emails in the mapped folder

DBtblQueueCreateDate registry

Values

 

Date (dd/mm/yyyy): Dates on which tblQueue table was created in the DB. The latest date is added to the left.

No default value. The value is automatically filled when the table is created.

DelegateFiling registry

Values

 

Enables mapping folders in a delegated or shared mailbox.

True: Map a folder in a mailbox owned by another user if you have the appropriate delegate/shared access to it (default)

False: Map a folder in your own mailbox only (default)

DisplayNotificationsBalloon registry

Values

 

True: Displays error messages in the notification area (default)
False: Does not display error messages in the notification area

EnableLogging registry

Values

 

True: Enable logging

False: Disable logging (default)

ExcludedFilingTypes registry

Values

 

Disable filing for specified Outlook items in Predictive Filing.
NOTE: Separate multiple values by semicolons (;).

For possible values, see Item Types & Message Classes.

Empty by default.

FolderCustomIcon registry

Values

 

True: Show custom folder icons in Outlook for your users' mapped folders.

False: Do not load custom folder icons.

The default is no value that behaves the same as False. This registry setting is only available in HKCU.

NOTE: Custom folder icons can slow down Outlook startup in some environments.

FolderSuffix registry

Values

 

String value. You can add your own custom tag to the end of the names of folders that are linked to NetDocuments.

When empty, uses default (nd) value.

FolderSuffixAdd registry

Values

 

True: Add/Remove (nd) customized tag to the end of folder names linked/unlinked to NetDocuments (default)

False: Does not add/remove (nd) customized tag to the end of folder names linked/unlinked to NetDocuments

ForceMapOnFolderCreate registry

Values

 

0: Do not force users to map new Outlook folders 

1: Force users to map new Outlook folders after creation (default)

LatestVersionUpgraded registry

Values

 

Number: <Software Major Version number>.0 

1.0 by default

MappingMode registry

Values

 

0: File emails in mapped folders (default)

1: A third-party such as Verqu can control the filing of the items in mapped folders and ndMail will only control the mapping relationship but not the filing itself for those mapped folders

NotificationsBalloonRepeatTime registry

Values

 

Determine the time interval (in minutes) for the error message to appear

Values: Any integer value. The default is 1. 0 shows messages about all failed emails

PreSetupID registry

Values

 

0032 (default)
Please contact NetDocuments if you need to use a different value

PromptIntervalOnFolderCreate registry

Values

 

NOTE: This registry is only for users who have Outlook open on multiple computers and are using PromptOnFolderCreate registry set to True.

Values: Any integer value. The default is 0.

Determine the amount of time difference (in seconds) between the folder creation time and the folder modification time. On the computer where the folder was created, these two values will be the same. On another computer, there will be some amount of time difference between the two depending on how quickly Exchange/Outlook creates that new folder on the second computer. When set to 0, the user is only prompted to map the folder on the first computer where the folder is created if multiple machines are actively running Outlook. If prompting on all machines is desired, a recommended value is 60, in which 60 seconds account for Exchange/Outlook delay in creating that new folder and would, therefore, prompt the user on all computers to map the folder. 

 

PromptOnFolderCreate registry

Values

 

True: Prompt users to map new Outlook folders to NetDocuments (default)

False: Disable the automatic prompt to map a newly created Outlook folder to NetDocuments

SearchEmailUsingUTC registry

Values

 

True: When a new folder is added, search an email in NetDocuments using UTC Date (default)

False: When a new folder is added, do not search an email in NetDocuments using UTC Date

SecondaryQueueInterval registry

Values

 

Determine the time interval (in seconds) when the secondary queue is checked after the main queue finishes processing.

Values: Any integer value. The default is 60.

UploadMethod registry

Values

 

1: Use the same upload process as ndOffice (direct upload); this is the method used by Folder Mapping versions which shipped with ndMail 1.0 and 1.1. Messages are filed directly from Outlook and are stored as .msg files

2 (default): Use the same Exchange-based filing process as predictive filing and allow the same Access options, including the Participants option. Messages are filed from Exchange and are stored as .eml files

ShowRightClickGoto registry

Values

 

True: When right-click on an email shows the Go to location in ND option which shows where the email is filed in NetDocuments.

False: When right-click on the email does not show Go to location in ND.