The button appears when your org has the Litify Matter object available. If it is missing, check that Litify is installed, or enter the values in the table above yourself.
Set up Matter matching in Salesforce for Docrio
Docrio files each client's documents on the Litify Matter stored on that client's Chronicle Client record in Salesforce. Set up the Chronicle package so it picks that Matter for you, then work through the clients it cannot decide.
Before you start
You need a Salesforce administrator account and the following in place.
Chronicle for Salesforce 1.10.0 or later is installed, and the packaged Chronicle Integration User permission set is assigned to the integration user. See Connect Salesforce to Chronicle for the connection.
Litify is installed in the org, and each client you want to file already matches a record (usually an Account) through your Chronicle matching rule.
The client has a Chronicle Client record in Salesforce. Chronicle creates it when it syncs the client.
How Matter matching works
Matching runs in two steps on your active matching rule. First, the client matches a record by last name and the last four digits of the SSN, usually an Account. Then the optional Matter Step looks for Matters under that record and picks one by status.
The package writes the chosen Matter to a lookup on Chronicle Client and copies it into Matter Id. Chronicle reads Matter Id to decide where to file documents.
Create a Matter lookup on Chronicle Client
Do this first, because the package cannot ship a lookup to Litify's Matter object without requiring Litify in every org. Staff use this lookup to see and change a client's Matter.
In Salesforce, open Setup > Object Manager > Chronicle Client.
Add a Lookup field that points to Matter (
litify_pm__Matter__c), for example named Matter.Grant field access to the profiles and permission sets that should see it, and add the field to the Chronicle Client page layout.
To keep staff to the client's own Matters, add a lookup filter: Matter: Client equals Chronicle Client: Matched Account, and Matter: Record Type equals SSD.
Turn on the Matter step
The Matter step is part of your matching rule, so you enable it from the rule's settings in the Chronicle admin page.
In Lightning Experience, open App Launcher > Chronicle > Chronicle Admin.
In the Matching Rule card, click Edit Matching Rule. Leave the client matching settings as they are.
Under Matter Step (optional), click Use Litify defaults.
Check that Matter Lookup Field (on Chronicle Client) shows your lookup. Choose it if the field is empty.
Click Save.
Use Litify defaults fills in these values. You can also enter them yourself.
Setting | Value for stock Litify | Meaning |
|---|---|---|
Matter Object |
| The object that holds Matters. |
Matter Parent Field (on Matter Object) |
| The field that points a Matter at the client's matched record. |
Matter Lookup Field (on Chronicle Client) | Your lookup, for example Matter | Where the chosen Matter is stored for staff. |
Matter Record Types |
| Only Matters with these record types are candidates. |
Matter Status Field |
| The field used to rank Matters. |
Matter Status Priority |
| Tiers separated by semicolons, statuses within a tier separated by commas. |
If your firm already fills its own Matter lookup, for example with a Flow, set only Matter Lookup Field (on Chronicle Client) and leave Matter Object blank. The package then keeps Matter Id equal to your lookup.
Link your existing clients
Run the matching job once so clients that already matched a record get a Matter, and so existing lookup values are copied into Matter Id.
In Chronicle Admin, open the Matching Rule card.
Click Run Matching Job.
The job also matches clients that have no record yet. Matters opened later are picked up the next time the job runs.
Resolve clients that need review
A client lands in review when it matched a record but has no Matter: the record has no candidate Matter, or the highest-priority tier holds more than one.
Open the Chronicle Client tab and choose the Matter Needs Review list view.
Open a client and read its Matching Log, which names the problem, for example "Matter needs review" with the competing Matters, or "No matter found".
Set the Matter lookup on the client to the correct Matter.
Edit the Matter lookup, not Matter Id. The package writes Matter Id, and neither Chronicle User nor Chronicle Integration User can edit it.
How the package chooses a Matter
The package considers Matters whose parent field points at the client's matched record and whose record type is in Matter Record Types.
The first tier in Matter Status Priority that has any candidates decides. Exactly one Matter in that tier links. More than one sends the client to review. Statuses you do not list form a last tier.
With the Litify defaults, a single Open Matter wins. With no Open Matter, a single Pending or Deferred Matter wins. With neither, a single Closed Matter links.
The package fills an empty Matter and keeps one that is already set, including one your staff chose. When the client's matched record changes and the linked Matter is not under the new record, it chooses again.
If staff clear the Matter, the Matching Log records that the Matter was cleared by hand, and the job does not refill it until the matched record changes.
A linked Matter stays linked after it closes.
What Chronicle does with the Matter
Chronicle reads Matter Id for each client and files documents only when it is the id of a Litify Matter. A Case, Opportunity or Account id is ignored, and a blank value files nothing.
We check for Matter changes every hour. A new Matter links the client and files its documents. A changed Matter files the documents again on the new Matter, and copies on the old Matter stay. A cleared Matter pauses filing for that client. Use the Litify Docrio integration covers documents and sections, and Connect Litify Docrio to Chronicle covers the connection and Test Connection.
Troubleshooting
I do not see Use Litify defaults
Matter Lookup Field says no lookup exists
Create the Matter lookup on Chronicle Client first, then reopen Edit Matching Rule. Without a lookup, the package sets only Matter Id, and staff cannot see or change a client's Matter.
Docrio does not file a client that has a Matter
Open the Chronicle Client and confirm Matter Id holds a Litify Matter id. A Case or Account id does not file. Then wait for the next hourly check, or run Test Connection in Chronicle and fix anything it reports.
Test Connection reports a missing Matter field
Upgrade Chronicle for Salesforce to 1.10.0 or later and assign Chronicle Integration User to the integration user, so Chronicle can read Matter Id.
A cleared Matter did not come back
This is intended. The Matching Log shows that the Matter was cleared by hand. Set the lookup again, or change the client's matched record to let the job choose a Matter.