ndMail Registry Settings

Follow

Table of Contents

ndMail Registry Settings

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 

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

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

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.

Folder Mapping Registry Settings

Below, you can see the list of the registry keys for Folder Mapping.

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.

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

ArchiveMailBoxKeyWords registry

Values

This key is used to add the starting names of the archive mailbox. You can use delimiter ";" to add multiple keywords.
For example: Online Archive; Email Archive.
NOTE: This registry key is optional. This is not automatically added by Folder Mapping. If needed, the user or IT admin must add this manually. 

Default or empty value is considered as "Online Archive".

AutoResync registry

Values

 

0: Emails are not resynced in mapped folders when users start Outlook.

1: All emails not copied previously are resynced in all users' 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 users' mapped folders after Outlook starts 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 starts 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

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

NOTE: Please contact NetDocuments or Standss if you need to use this field.

Empty by default.

CopyExistingEmails registry

Values

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

True: Select the checkbox by default for all new mappings.

False: Clear the checkbox by default for all new mappings.

HideAndTrue: Hide the checkbox and always copy pre-existing emails in the mapped folder.

HideAndFalse: Hide the checkbox 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.

False: Map a folder in your own mailbox only.

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

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

This registry setting is only available in HKCU.

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

FolderSuffix registry

Values

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

When empty, use the 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 (default)

1: Force users to map new Outlook folders after creation

LatestVersionUpgraded registry

Values

 

Number: <Software Major Version number>.0 

For example, 1.0 

MappingMode registry

Values

 

0: File emails in mapped folders.

1: Only mapping allowed, filing disallowed.

When set to 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.

NoPromptOnFolderCreateKeyWords registry

Values

This key is used to discard prompts to map new folders to ND. It contains keywords that are found in the Outlook folder path. There can be multiple keywords added using delimiter ";".

Empty by default.

NotificationsBalloonRepeatTime registry

Values

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

The default value is empty which signifies that every 2 minutes the error notification will display to the user if the email fails to upload.

0 shows messages about all failed emails.

PreSetupID registry

Values

 

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

PromptIntervalOnFolderCreate registry

Values

This registry key is used to suppress/not suppress the Map to NetDocuments prompt for users who have connected their email account on multiple machines.

NOTE: This registry is only for users who have Outlook open on multiple computers and are using it.

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.

The default is 0.

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.

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.

Empty by default.

This signifies that every 60 seconds the secondary queue will be checked once the main queue finishes processing.

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

Back to All Registry Settings