Legalsense integrates with iManage's cloud-based iManage Work product, a document management system many law firms use to manage matters and documents. This article explains how to set up and use the integration, including workspace templates and the synchronization queue.
To activate this integration, contact Legalsense Support.
In this article
Setting up the integration
Once Legalsense Support has activated the iManage integration for your environment, configure it further at Settings → Integrations → iManage. Under Configuration, fill in the following fields. Fields marked with an asterisk (*) are required.
iManage integration configuration page, showing the Hostname, Customer ID, Default library, Username, Password, Client ID, and Client secret fields.
-
Hostname*: the hostname of the iManage server Legalsense should integrate with. For most customers, this is
cloudimanage.com, but if you use on-premise hosting, this value may be different. -
Customer ID*: one iManage server can host multiple customers, called tenants, each with a unique ID. If you use an on-premise host, this is likely
1. Otherwise, iManage provides the correct ID. - Default library*: the name of the iManage library Legalsense should use. You can find this name in iManage. Legalsense can integrate with multiple libraries at once; ask Legalsense Support about the possibilities.
- Username*: the username of the iManage user responsible for the integration. We recommend using a dedicated user for the integration with Legalsense. This user needs permission to create workspaces, folders, and custom values in iManage. Legalsense never deletes anything from iManage, so delete permissions aren't required.
- Password*: the password of the iManage user responsible for the integration.
- Client ID*: the ID of the API client Legalsense uses to make requests. Legalsense provides this value.
- Client secret*: the password the API client uses to make requests. Like the Client ID, Legalsense provides this value.
Using the integration
The integration makes all Legalsense matters visible in iManage, so that when you save a document, you can choose to save it in an iManage workspace that corresponds to a Legalsense matter.
To achieve this, Legalsense continuously pushes the list of current matters to iManage. When you create a matter in Legalsense, an iManage workspace with the same name appears after a short time. When you change the name of a matter in Legalsense, the name of the iManage workspace changes too.
Workspace templates
The integration supports workspace templates, a convenient way to structure newly created workspaces to your liking. To use this:
- Create a new workspace to use as the template for other workspaces. You can call it Template workspace, for example, or use a more specific name if the template applies only to certain matters.
- Inside the template, create the folders you want all workspaces based on it to inherit. Legalsense doesn't create folders marked as optional automatically.
- Note the ID of this workspace (a value containing the
!character). - Contact Legalsense Support and provide the workspace ID.
Legalsense Support then bases all future workspaces on this template. You can even use different templates for different kinds of matters; ask Legalsense Support about the possibilities.
The synchronization queue
You can see the current list of operations Legalsense is about to perform on the Queue page. Go to Settings → Integrations → iManage → Queue to view it.
iManage synchronization queue, showing the list of pending and completed operations.
Under normal conditions, the queue is empty. When you create or update a matter in Legalsense, it appears in the queue; once Legalsense synchronizes the change, the queue empties again.
Two buttons are available on the queue page:
- Add all active matters to sync queue: adds every matter that isn't archived to the queue. This is useful when you're just getting started with iManage or Legalsense, because it quickly synchronizes all matters by creating a workspace for each one. It's safe to add matters that haven't changed: Legalsense only verifies that the corresponding workspace still exists, without making changes. In other words, queue elements are idempotent.
- Sync now: triggers synchronization immediately. By default, Legalsense synchronizes every couple of minutes, but you can click this button if you've just added matters to the queue and don't want to wait.
Troubleshooting
Matters don't appear in iManage
Legalsense processes the queue every 2 minutes. If a matter doesn't appear in iManage or isn't updated, check the following:
- Go to Settings → Integrations → iManage → Queue.
- Check the Failed column for matters that couldn't be synchronized.
- Click Sync now to try again.
- If many matters fail, check the credentials under Settings → Integrations → iManage → Configuration, for example after the password of the iManage user has changed. Click Save. Legalsense tests the connection and shows an error such as Invalid credentials. if it can't connect.
Note: Legalsense waits longer between each new attempt for a matter that keeps failing, and eventually stops retrying it. To try again, add the matter to the queue again, for example by clicking Add all active matters to sync queue.
Duplicate workspaces
When you connect an existing iManage installation to Legalsense for the first time, Legalsense may not know exactly which existing workspaces correspond to which Legalsense matters, and it may create a duplicate workspace. You can prevent this by giving our migration consultant an accurate list of which workspaces belong to which matters, preferably as a spreadsheet with these columns:
- The ID of the workspace in iManage (a value containing the
!character). - The name, number, or ID of the matter in Legalsense.
Once a matter is linked to a workspace, Legalsense keeps updating that workspace. If a matter has no linked workspace, Legalsense looks for an existing workspace with the same identifying details, such as the client and matter number, and uses the matter name to choose between multiple matches. If it doesn't find one, it creates a new workspace. This means a duplicate can appear when those details were changed in iManage, or when you change a client or matter number in Legalsense.
To see which workspace a matter is linked to, open the matter and click Workspace next to iManage. If Legalsense created a duplicate workspace, contact Legalsense Support with the ID of the workspace you originally intended to use.
Connection errors
Sometimes Legalsense can't reach the iManage servers because of a connection error. When this happens, the queue size keeps increasing, and changes you make in Legalsense are no longer immediately reflected in iManage. These errors are often temporary and resolve on their own. If you're in a hurry, click Sync now to try to synchronize immediately.
Legalsense doesn't send an email when the synchronization with iManage fails, so check the queue regularly. For authentication errors, follow the steps in Matters don't appear in iManage. For other errors, such as server outages or bugs, contact Legalsense Support.
Comments
0 comments
Article is closed for comments.