When documents are moved from one iManage library to another, the NRL translator capability in Work Desktop for Windows makes sure existing NRL links continue to work.

TIP: This capability is useful when migrating an on-premises iManage Work environment to iManage Work in the Cloud. During a migration, it's common for multiple libraries in the on-premises environment to be combined into one library in the cloud.

The iwINRL.exe process looks for an nrl_translation.xml file in any of the following locations:

  • %localappdata%\iManage\Work\Configs

  • %appdata%\iManage\Work\Configs (deployed using iManage Control Center)

  • %programfiles%\iManage\Work10\<build number>

When this file is present on a user’s device, and the user accesses an NRL link, the NRL translator process converts the NRL to point to the new library and document number.

Sample nrl_translation.xml files

<databases>
<database name="old_library_name1">
<conversion start="1" end="2000000000" offset="0">
<database name="new_library_name" dms="cloudimanage.com"/>
</conversion>
<database name="old_library_name2">
<conversion start="1" end="2000000000" offset="0">
<database name="new_library_name" dms="cloudimanage.com"/>
</conversion>
</database>
</databases>
<databases>
<database name="old_library_name">
<conversion start="1" end="2000000000" offset="0">
<database name="new_library_name" dms="new_workerver_name"/>
</conversion>
</database>
</databases>

NOTES:

  • The dms value is optional, and is required only when the new library exists in a different iManage Work environment. For example, cloudimanage.com or a different on-premises Work Server.

  • If you have configured a custom subdomain for your cloudimanage.com environment, include the subdomain. For example, dms="company.cloudimanage.com".

  • The document number referenced in the .nrl link must be within the conversion range. If it’s not, NRL translator won’t perform the conversion.

  • The offset value is used when users have an offset in document numbers. For example, if the document number in the old library was 1 and the new library is 11, the offset value should be 10.