Customizing application settings
Administrators can customize iManage Work Desktop for Mac settings using the com.imanage.configuration.plist file located at ~/Library/Application Support/iManage/Configuration/. They can then deploy this file using Mobile Device Management (MDM) to ensure that the settings are available consistently to all users throughout the organization. Alternatively, individual users can manually updated the file in their Mac per their preferences.
The following settings are available:
Crashlytics
Set the value of the Crashlytics key to <true/> to enable crash reporting. By default, Crashlytics is disabled and no reports are sent to iManage for any crashes that may occur when you work with the application.
Example:
<key>Crashlytics</key>
<false/>
Document Class
By default, the document class is set as DOC. If some other default document class is set for iManage Work Server, replace the default document class here with the same value to ensure that no errors occur while filing emails and uploading documents using the iManage Agent.
Example:
<key>Default Document Class</key>
<string>DOC</string>
Log Level
The Log Level key enables you to configure the logging level for the logs that iManage Work Desktop for Mac captures. The following values are available:
0: INFO (default value)
1: WARNING
2: DEBUG
3: ERROR
Example:
<key>Log Level</key>
<string>0</string>
For more information about application logs, see Log files.
Permanently Delete
The Permanently Delete key enables you to configure the delete settings for documents in the Documents > iManage folder after they are checked in to iManage Work. The following values are available:
false: Files get moved to Trash in the user's Mac instead of getting permanently deleted (default value).
true: Files get permanently deleted after check in.
Example:
<key>Permanently Delete</key>
<false/>
Auto Updates
These options enable you to configure that settings for automatically updating the application.
defaultFeedURL: Specify the HTTP or HTTPS URL of the web server where the latest updates for iManage Work Desktop for Mac are hosted as the string value.
Example:
<key>defaultFeedUrl</key>
<string><URL of the server where the latest build is hosted></string>updateCheckInterval: Specify the number of seconds between updates. The default is 86400 (1 day). Setting the value to 0 disables auto updates checks. The minimum acceptable value is 3600 (1 hour) to prevent you from accidentally overloading your servers.
Example:
<key>updateCheckInterval</key>
<real>86400</real>Disable AutoUpdates: Disable the display of auto updates notifications for iManage Work Desktop for Mac (set the value to true). The default is false (auto updates notifications are displayed). When this option is set to true, the Check for Updates option in the iManage Agent menulet is disabled, that is, it appears dimmed.
Example:
<key>Disable AutoUpdates</key>
<false/>
Setting default value for Preferences
These options enable you to configure the values that appear selected by default for the options in the Preferences dialog box (when you select the Preferences option on the iManage Agent menulet).
ServerURL: The URL of the iManage Work Server to which the application must connect. Replace <URL of the server where the latest build is hosted> with the actual URL.
Example:<key>ServerURL</key>
<string>https://<URL of the server where the latest build is hosted></string>Email Client Configuration: The default email client that is used when sending documents, links, or both from the iManage Work web client.
The following values are available:
1: Default Email Application (default value)
2: Apple Mail
3: Microsoft Outlook
Example:
<key>Email Client Configuration</key><integer>1</integer>
CheckIn Default: The behavior when an iManage Work document is checked in from your Mac to iManage Work
The following values are available:
1: Replace Original
2: New Version (default value)
3: New Document
Example:
<key>CheckIn Default</key><integer>2</integer>
Indicators for emails saved to iManage
The Mark Emails as Filed option helps you to enable or disable the indicators that appear in Microsoft Outlook in Mac for emails that are saved to iManage using the Services > Save Email Message to iManage Work option:
The
label that appears for the emails in the list view.The
label that appears to the right-side of the email subject in the reading pane.
The following values are available for the option:
true: The Filed to iManage label is applied (default value).
false: The Filed to iManage label is not applied.
Example:
<key>Mark Emails as Filed</key>
<true/>
Configuring the file naming format for attachments
You can use the Attachment Filename Format option to customize the name displayed for the files when you send them using the following:
Send Link, Send Document, and Send Both options for a file in iManage Work.
Services > Insert Attachment from iManage Work to insert attachments from Microsoft Outlook or Apple Mail.
This option has a default value that users can customize to display any of the supported file attributes. For more information, see Appendix A - Attributes for customizing attachment file name .
Example:
<key>Attachment Filename Format</key>
<string>{imProfileDescription}({imProfileDocNum}.{imProfileVersion}).{imProfileExtension}</string>
Configuring the browser used for authentication
If you want to ensure that the Google Chrome browser is used for authenticating you to iManage Work, can set the Enable Chrome Browser Authentication option (disabled by default) to true. When enabled, the SSO sign in prompt uses the Chrome browser.
Example:
<key>Enable Chrome Browser Authentication</key>
<false/>
Configuring the Google Chrome authentication callback URL
Configure the redirect URL for Google Chrome authentication callback using the Chrome Browser Authentication Callback option. If this option is not configured, while authenticating users, the Chrome browser displays a prompt to confirm whether iManage Work can open iManage Agent.
Example:
<key>Chrome Browser Authentication Callback</key><string>http://127.0.0.1:17871/callback</string>
After the option is set, add the redirect URL for the iManage Work Server by signing in to iManage Control Center, and navigating to Applications > Work for Mac > Authentication > Redirect URL. Restart the iManage Agent and sign in.
Refresh token for renewing access
As an administrator, you can enable the Allow Token Refresh option (disabled by default) in iManage Control Center to ensure that the users in your organization are not prompted frequently to re-authenticate themselves to iManage Work using their sign-in credentials and can focus on their tasks. Whenever the access token expires, iManage Work Desktop for Mac uses the refresh token and the sign-in screen is displayed only when both the refresh token and the access token expire. For more information, refer to the Adding an application section in iManage Control Center Help 10.3.1.