imEMM.config
NOTE:
If using the client-side Send and File feature, refer to Appendix D - Configuring Microsoft Exchange rule for client-side Send and File to prevent bounce-back of emails.
You can use the imEMM.config file to customize the user experience of Email Management provided by iManage Work Desktop for Windows. You can use the following options:
If your iManage Work administrator changes the settings in the application configuration files and the files are downloaded to your device, Microsoft Outlook detects and applies the changes in the background. You can then see the latest configurations without restarting the application.
NOTE:
This feature doesn't apply to ribbon bar customizations or other settings, which are only read once by Microsoft Office during application launch.
Options for the Select Filing Location dialog box
Table: Options for the Selecting Filing Location dialog box
Option | Description | Values(s) |
---|---|---|
| Show or hide the filing options in the Select Filing Location dialog box and the iManage Work toolbar in Microsoft Outlook. |
Default value: |
Example:
The same setting will apply to the Email Management (EM) task pane, too. | ||
| Specify which filing options should be selected by default in the Select Filing Location dialog box. NOTE: This option determines the initial settings displayed when users launch Outlook. Once the users select or clear any option manually, the manual selections persist whenever Outlook is relaunched. |
Default value: |
Example:
The same setting will apply to the Email Management (EM) task pane too. | ||
| Set the value for the maximum number of clients or matters shown in the client and matter autocomplete lookups. |
|
| Shows the multi-selection list control by default. NOTE: When a user manually selects or unselects the File to Multple locations check box, the value set for the EnableMultiSelection registry setting under the following location takes precedence. The value in the registry setting takes precedence until it is manually reset. HKEY_CURRENT_USER\Software\iManage\Work\10.0\EMM\Cache\UI |
Default value: |
Example:
If you set the value to If you set it to | ||
| Specify whether Search for Workspaces should be the default option. |
Default value: |
Example:
| ||
| Show or hide the Send Only button. Example:
|
Default value: |
| Show or hide the Send and File button. Example:
|
Default value: |
| Prompt you to file emails (using the Select Filing Location dialog box) while sending emails. Example:
|
Default value: |
NOTE: If set to zero, automatic searches are not triggered and have to be manually triggered by the user. | Set the interval value (in milliseconds) for automatically searching the workspace in the Select Filing Location/Browse and File dialog box. Example:
| Recommended values: Default value: |
NOTE: If you are deploying iManage Work Desktop for Windows to a multi-user environment (such as Citrix), you should remap the WorkspaceView registry setting to the users' roaming profile to retain the changes made to their column settings at the following location: HKEY_CURRENT_USER\Software\iManage\Work\10.0\EMM\ | Defines the default columns and the available columns in the Send and File dialog box, Browse and File dialog box, and the filing dialog box in the iManage Work toolbar.
NOTE: Define the width for all properties added to | Default columns:
For the list of additional columns that can be added, refer to Appendix G - List of supported property names for configuring the workspace view v10.6.0_WDW. |
Example:
| ||
| Enable the mouse-hover display, which lets you see the following in the Select Filing Location dialog box tree view:
NOTE: This option applies only to the Browse and File and Select Filing Locations dialog boxes and not the iManage Work toolbar in Microsoft Outlook. |
Default value: |
Example:
| ||
| Persist your selections when the Select Filing Location dialog box is relaunched. Example:
|
Default value: |
| Specify the maximum number of terms to be displayed in the search history when you search for workspace or folder in the Select Filing Location dialog box. | Recommended values: Default value: |
Example:
| ||
| Enable the Send and File option when sending an attachment from another application. Example:
|
Default value: |
| Specify the profile field to be used for first search field in the Browse and File dialog box. The valid values are Custom1, Custom3 to Custom12, and Custom29 Example:
|
|
| Specify the profile field to be used for second search field in the Browse and File dialog box. The valid values are Custom1 to Custom12, Custom29, and Custom30. If Custom2 or Custom30 are specified, then the value for BrowseAndFileSearchField1 must be the associated parent field. Example:
|
|
Client-side filing options
The iwWCS.exe
process is available individually on each user's machine to handle different filing related tasks (similar to the iManage Work Communications Server that communicates with the iManage Work Server to handle server-side filing). The iwWCS.exe
starts running as soon as the users' machines are started.
NOTE:
iManage Agent Service must be installed on the users' machines to ensure that the
iwWCS.exe
process starts automatically.The
UseClientSideFiling
option does NOT use theiwWCS.exe
process.
The following options are available in the wcs_config
group to enable you to configure Client-side filing behavior.
Table: Client-side filing options
Option | Description | Value(s) |
---|---|---|
| By default, the Microsoft Outlook client uses Client-side filing even if the server supports Server-side filing when:
If this option is disabled, Server-side filing is used if available. Example:
NOTE: |
Default value: |
| Enable this option if you want to use Client-side filing for the Send and File action. Example:
|
Default value: |
| When using client-side Send and File (from the Sent Items folder), this option controls whether the BCC information should be retained or not. The default setting is off, which means that messages filed using client-side Send and File will contain BCC information that may be visible to other recipients/users in the firm. If you do not want BCC information saved in iManage Work along with the message, enable this option by setting it to NOTE: This setting is used with the client-side Send and File only. Example:
|
Default value: |
| Enable Inbox Filer so that it can monitor and file all the emails in your Inbox that are sent with a luggage tag in the subject and no iManage Work folder email address in the recipient field, and then files the emails and marks them as filed. NOTE: Inbox Filer and Send and File are configured separately. If you enable Send and File and disable Inbox Filer, only the Send and File feature works. If you enable Inbox Filer then both Send and File and Inbox filer work. You cannot disable Send and File by enabling Inbox Filer. Example:
|
Default value: |
| Time duration in seconds after which the Inbox Filer process is invoked. The default interval is 120 which means that the Inbox Filer runs after every 2 minutes to check for and file emails. Example:
| Default value: |
| The option allows reprocessing of old messages. Example:
CAUTION: Enable this option only if advised to do so by iManage Support because it is meant to address certain issue scenarios. |
Default value: |
| The number of days Inbox Filer needs to regress to look for emails. The default value is 30 days (1 month). Example:
| Default value: |
| Inbox Filer processes emails only if the maximum number of recipients in the email is less than SyncRecipientsLimit. Change the default value as desired to ensure that general emails sent to a large number of people or the entire organization do not get filed. Example:
| Default value: |
| Enable this option to ensure that client-side filing is used for mapped folder. Example:
|
Default value: |
| Use this option to ignore certain type of email messages while processing mapped folders. Separate the message classes by semicolon. Example:
| Default value: (Message class for emails that couldn't be filed to iManage Work and resulted in an error.) |
| By default, the emails in mapped folders are processed in a batch of 10. Once the first 10 emails are processed, the next 10 are processed, and so on. NOTE: After the emails are processed, it may take the Inbox Filer a time ranging from 1 to 10 minutes to mark them as filed. Example:
| Default value: |
| The number of filing and marking attempts to make before ignoring an email in a mapped folder. Example:
| Default value: |
| Time duration in minutes after which the mapped folders process is invoked. The default interval is 360 minutes, which means that the process runs after every 6 hours to check for and file emails. Example:
| Default value: |
| Enable this option to ensure that processing of mapped folders begins as soon as the iwWCS process starts; without waiting for the MappedFolderInterval to elapse. Example:
|
Default value: |
| The time duration in minutes for which Inbox filer waits before processing new emails. Example:
| Default value: |
| Determines whether messages are marked as queued before filing when using client-side filing. NOTE: Doesn't apply to server-side filing or filing in offline mode. Example:
|
Default value: |
| Enables or disables the feature to set the change the email description when using Send and File option. NOTE: Example:
|
Default value: |
| When enabled, filing location path on filed messages is prefixed with double slash. Applies to client-side filing only. For consistency with iManage FileSite and Server-side filing, use 1. Example:
|
Default value: |
| Process linked (mapped) folders with Client-side filing for mailboxes you have access to (other than your own) when there are iManage Work user accounts for those mailboxes. iManage Work Desktop for Windows with Client-side filing can't process linked folders other users have created for mailboxes which don’t have iManage Work users associated to them. Example: |
Default value: |
Offline filing options
Option | Description | Value(s) |
---|---|---|
| The records of filed emails that are maintained in the offline filing tables are deleted automatically after 7 days. Modify this value to keep the records for a longer or shorter duration. Example:
| Default value: |
| Since there may be a limit for the amount of data that can be sent using RestAPI, the emails are batched before they are sent to Work Communication Server. By default, 10 emails are sent together for one iManage Work location. If there are multiple locations from different libraries, the emails are processed in a batch based on the libraries. Example:
| Default value: |
| If there are errors during filing the process, filing is attempted up to FilingRetryCount times. The count is incremented by 1 for each filing attempt. After reaching the default value, no further attempt is made to file to the emails and they are marked as Error at the last attempt. | Default value: |
| Specify the delay in seconds after which emails previously filed offline are uploaded post a successful server connection. Example:
| Default value: |
Additional options
Table: Advanced options
Option | Description | Value(s) |
---|---|---|
| Specify whether Microsoft Outlook should automatically connect to the iManage Work Server when it starts. Example:
NOTE: The behavior of
|
Default value: |
| Specify whether the filing location should be added to the CC or BCC field of filed emails. Example:
NOTE: This setting is applied to emails filed using the Send and File feature and is available for both client-side and server-side filing. |
Default value: |
| Add this option to display the Send, File, and Approve drop-down option for the Send Only button in the Select Filing Location dialog box. Example: “ |
Default value: |
| Remove the luggage tag for emails that are not filed while sending (that is, if the Send Only button is selected). Example:
|
Default value: |
| Specify whether to include the luggage tag in the subject line. Example:
|
Default value: |
| Specify ID of the organization for the luggage tag. Limit it to 3-5 characters; no special characters allowed. Example:
| Default value: |
| Use it for upgrading the old database to a new one. Example:
| Default value: |
| Decide the luggage tag location: end of the subject or beginning of the subject. Example:
|
Default value: |
| Specify the maximum number of locations to be displayed under Suggested Locations. Example:
| Recommendation: Default value: |
| Specify whether suggested filing locations must be displayed when the email recipients change. Example:
|
Default value: |
| Specify the maximum number of locations to display under Recent Locations. Example: " | Recommendation: Default value: |
| Specify the maximum number of recipients (email addresses) to be used to calculate suggestions. Example:
| Recommendation: Default value: |
| Disable default filing location suggestions by iManage Work. Set the value to 1 if you see performance issues while opening or selecting an email. Example:
|
Default value: |
| Specify whether encrypted emails should be saved while sending. Example:
|
Default value: |
| Specify whether emails should be permanently deleted if the Delete option is selected while sending emails. Example:
|
Default value: |
| Specify whether folder ID (FID), Client.Matter, or both Client.Matter and FID should be added to the luggage tag. Example:
|
Default value: |
| Hide the workspace and folder names in the email address when the folder is selected for filing. Example:
|
Default value: |
| To ensure that all emails are filed as private even when they are filed to public folders, enable this option. When enabled, the following behavior is seen:
Example:
|
Default value: |
| Select or clear the File As Private option by default. Example:
|
Default value: |
| Determines whether iManage Work saves the email to the drafts folder before initiating a send and flle. Example:
|
Default value: |
| File email as Private if mail item Sensitivity is set to PRIVATE. Example:
|
Default value: |
| Enable or disable the email management features in Outlook. When you disable email management the following changes occur:
NOTE: The Insert iManage Attachment option continues to be displayed for new email messages and new/existing calendar items even though the iManage Work toolbar is hidden. Example:
|
Default value: |
| Enable or disable the iManage Work Panel in Microsoft Outlook by showing/hiding the Work Panel ribbon bar button. Example:
|
Default value: |
| Configure the iManage Work Panel to open by default when Microsoft Outlook is started. Example:
|
Default value: |
| Configure if the iManage Work Panel should be initialized on Microsoft Outlook startup. Initialization can delay Outlook startup by a few seconds. If this is not enabled, users may experience a delay instead when the iManage Work Panel is displayed. Example:
|
Default value: |
| Number of seconds it takes for the iManage Work panel to appear after Microsoft Outlook startup. | Minimum: Default value: |
| Configure the languages available for searching in the Browse and File and Select Filing Location dialog box. As chosen, remove languages from the default value or change the order in which they appear. You can't include any additional languages. Example:
| Default value: |
| Specify the maximum number of attachments that should be saved when multiple emails are selected and Save Attachments is selected. Example:
| Recommendation: Default value: |
| Specify the maximum number of emails that should be considered when multiple emails are selected and Save Attachments is selected. NOTE: The number of attachments saved is dependent on the Example:
If you set | Recommendation: Default value: |
| Specify the location of the legacy suggestion database. This feature is useful after you upgrade, because the old suggestions can be made available in the new environment too. Example:
| Not applicable |
| Specify the suffix for Inbox folders that are linked to iManage Work folders. Example:
| Default value: |
| During the Outlook startup process, the icons in the Outlook tree are painted to indicate folders linked to iManage Work. If a mailbox contains a large number of linked folders, the startup process might be slower. iManage has introduced two keys to control the painting behavior for a set time duration. Example:
|
|
| Configure this value to set the time in each paint cycle. After the duration is complete, no more icons are painted to avoid additional delay in startup. Example:
| Default value: |
| Prompt users to link to an iManage Work folder when they create a folder in Outlook. Example:
|
Default value: |
| Control the behavior of the File message as Private option available in the Link Folder to iManage dialog box. Example:
|
Default value: |
| Enable or disable the Secure Send feature, which enables you to:
For more information about the Secure Send feature, refer to iManage Work Desktop for Windows online help. Example:
|
Default value: |
| Specify the attachment size limit (in bytes) for the Secure Send feature. If attachment exceeds this limit, it is uploaded to iManage Share. Example:
NOTE: The maximum value is 2147483647. Setting a higher value causes an error and won't parse the file correctly. | Recommendation: Default value/Maximum value: |
| Specify the number of characters to enter, after which a search is triggered. Example:
| Default value: Minimum value: |
| Specify if attaching an NRL link in an email should add an HTML link in the email body. Example:
|
Default value: |
| Specify if copying folders from Outlook to an iManage Work workspace or a folder is enabled or disabled. Example:
|
Default value: |
| Specify if moving folders from Outlook to an iManage Work workspace or a folder is enabled or disabled. Example:
|
Default value: |
| Specify the default behavior when users drag emails to iManage folders in the Work Panel. When enabled, the emails are moved to the iManage folder and the Delete Items folder in Microsoft Outlook. Example:
NOTE: From 10.6.0 onwards, Delete, Print and Private options available in the EMM toolbar when selected is applied when users drags emails to iManage Work Panel for filing or use Quick File for filing. As a result of this change, this configuration setting is deprecated and is applicable only if the EMM toolbar is hidden. This doesn't apply to Mapped folders. |
Default value: |
| Specify if users can search across all databases in the Browse and File and Select Filing Location dialog boxes. Example:
|
Default value: |
| Specify if the File To check box in a new email window must get selected automatically when a suggested filing location is available. Example:
|
Default value: |
| Use this option to set the default filing action in Send and File dialog box. Example:
|
Default value: |
| Use this option to disable the warning message stating that there are recipients in the Bcc field. Example:
|
Default value: |
| Specify the old suffix value for Microsoft Outlook folders that are linked to iManage Work folders. This is for use if you have changed from one folder suffix to another, so that folders with the old suffix are still recognized as linked folders. Example:
| Default value: |
| Use this option to configure the frequency with which you check for messages that were filed offline, and then if found, attempts to file them. The unit is in seconds (600 = 10 minutes). Example:
| Default value: |
| Use this option to allow database names to be masked in the luggage tag in email subject. The mapping can be specified in key:value pairs. Multiple maps can be separated by commas—for example, {"DB1":"DB1Alias","DB2":"DB2Alias"}. Example:
| |
| Specify the time in seconds to wait/sleep before calculating the suggestion when opening an email. Example:
NOTE: This is a tuning setting that shouldn't be changed without consulting the iManage Customer Support. | Default value: |
| Specify the comma delimited list of Microsoft Outlook message classes that are allowed to change when filing messages to iManage Work Desktop for Windows. If a message class is not in this list, then the message class in the copy of the message in Microsoft Exchange is not changed when filing the message to iManage Work Desktop for Windows. IPM.Note is supported by default. Example:
| Default: |
| Specify if the Map Subfolders option in the Link folder to iManage dialog box should be enabled or disabled. Example:
|
Default value: |
| Specifies the time in seconds to wait before updating the suggestion in the message window after filing the message. Example:
| Default: |
| Enables Send and File functionality when sending an attachment from another application. Example:
|
Default value: |
| Enables Notify Marked Folder functionality. Example:
|
Default value: |
| Describes the maximum number of folders to monitor for Marked Folders Notification. Example:
| Default: |
| Enables filing emails that are older than the Microsoft Outlook cache. Example: |
Default: |
| Defines the time intervals between retries of email filing operation. Example:
NOTE: Valid units are m (minute), h (hours), d (day) and w (week). Values are comma-delimited. Each comma-delimited element of the configuration can have only one unit. For example, 1h 30m is not a valid value to designate 1 hour and 30 minutes. Use 90m instead, in that case. | Default: Representing 30 minutes for the first retry, 2 hours after the first retry for the 2nd retry and 1 day later for the 3rd retry |
| When this option is enabled, the luggage tag is appended to the custom description specified by the user on send and file. NOTE: The option EnableChangeDescription must be enabled for this setting to be applied. Example:
|
Default: |
| Controls whether content in iManage Work Panel is preloaded in the background upon starting Microsoft Outlook. Example:
|
Default: |
| Show or hide the first progress dialog during email filing. Example:
|
Default: |
| When this configuration setting is set to 1, the File Now option is enabled in the right-click context menu on a mapped folder. Users can use File Now to sync the linked folder, on demand. This is helpful especially when users have moved emails to a mapped folders and the user wants to ensure the emails are filed promptly." Example:
When this option is enabled, you can access the File Now in the Link to iManage submenu in Microsoft Outlook by doing the following: Right-click a folder, select Link to iManage, and then select File Now. |
Default: |
| When this configuration setting is set to 1, the Retry Filing option is enabled in the right-click menu for all the emails in a mapped folder that are marked with an error icon indicating that the filing failed. Users can use this option to retry filing on those messages. Example:
|
Default: |
| In some rare cases, Microsoft Outlook does not load the EMM toolbar in a new email window. When this configuration setting is set to 1, it ensures that iManage EM toolbar is available in all new email windows. NOTE: Enabling this configuration setting can cause performance issues. Hence, we do not recommend that you enable this option, by default. Enable this configuration setting only if Microsoft Outlook does not load EMM toolbar in a new email window. Example: "CheckInspectorEMMToolbar": 0 |
Default: |
| Specifies the number of emails that can be renamed in a single batch when the option is selected and multiple emails are selected for filing. The default value is 50 and the maximum supported value is 100. If a number higher than 100 is specified, the Rename dialog box displays a message stating that only the first 100 emails of the selected emails will be filed and all the additional emails will not be filed. Example:
| Default value: |
| Shows or hides the option in the EMM toolbar and Select Filing Location dialog box. The default value is 0. Example:
|
Default: |
| Alerts if the location folder is unavailable (using the File to check box) while sending emails values. The default value is 0. Example:
|
Default: |
| Determines how comments are set when saving an attachment as a new version. Example:
| Default value: |
| The When Example:
|
Default: |
| The Example:
|
Default: |
| Ignore EE messages that have Explorer:Filed=true property, while processing mapped folders. Example:
|
Default: |
| Lets you turn on or turn off the smart attachment feature for Microsoft Office documents when custom XML with cloud information is embedded into the document attached to email. Example: |
Default: |
| Specifies whether subfolders in the Browse and File dialog should be sorted by name. Example: |
Default: |
| When The default value is
The field specified first (for example, custom 1 in the configuration "25.26" cannot contain periods in the actual metadata values in the workspaces to support proper parsing. Example:
For more information on numeric values for supported custom fields, see Custom Attribute IDs . | Default value: Represents custom 1 and custom 2 |
| Enables or disables the usage of the Example:
|
Default: |
| Sets the Email Management toolbar display delay in milliseconds. Example:
|
|
Deprecated option(s)
The
LimitClientMatterInSearchResults
configuration option is deprecated and theMaxClientMatterSearchResults
option is introduced instead.The
ShowClientMatter
andShowClientMatterDescription
options are deprecated and theWorkspaceView
option is introduced instead.The
ExcludedMessageClassesForFiling
option is deprecated andSupportedMessageClassesForFiling
is introduced instead.The
WebLocale
option is deprecated. The UI language for the iManage Work Panel can now be set using iwLocale option. For more information, refer to imWorkOptions.xml section.The
PrintSentItems
option is deprecated.The
SetChromiumDir
option is deprecated.The
EnableChangeDescription
configuration option is deprecated and theEnableOldChangeDescription
option is introduced instead.The
EnableLastFilingAction
configuration option is deprecated.