MyCase Field Mappings

MyCase Field Mappings

The following table indicates customizations to how fields are mapped into MyCase.

Calendar Entries

Final_Subject => Name
Final_Description + Final_Location => Description

Contact Categories

Final_Subject => Name

Contacts

When Final_Kind = Company

Final_FullName => Name

When Final_Kind = Person

Final_FirstName => First_Name
Final_MiddleName => Middle_Name
Final_LastName => Last_Name

Important Notes about "Addresses"

The Best-Fit Algorithm

Some systems allow an unlimited number of Phone Numbers, Email Addresses, Postal Addresses, and Web Addresses to be assigned to contacts.  When these systems are migrated into MyCase, a "Best Fit" algorithm is used to import as many fields as possible.  The algorithm works as follows:
  1. Make a list of all the addresses
  2. Order the list by DisplayOrder ascending.
  3. For each address field:
    1. Assign the first address that matches that field's preferences.
    2. Remove that address from the list.
  4. For each address field that does not have an address assigned:
    1. Assign the first address from the list.
    2. Remove that address from the list.
  5. If there are still any addresses left on the list, they are ignored.

This algorithm allows each address to be assigned to its best field and allows extra addresses to squeeze into any open spot.

Address Preferences for Company Contacts

A Company contact supports the following addresses:
  1. 2 Phone Numbers
    1. Main (Preferences: Location = Billing, Kind = Phone OR Location = Work, Kind = Phone)
    2. Fax (Preferences: Kind = Fax)
  2. 1 Email Address
    1. Email (Preferences: Location = Billing OR Location = Work)
  3. 1 Postal Address
    1. Address (Preferences: Location = Billing OR Location = Work)
  4. 1 Website Address
    1. Website (Preferences: Location = Billing OR Location = Work)

Address Preferences for Person Contacts

A Person contact supports the following addresses:
  1. 4 Phone Numbers
    1. Home (Preferences: Location = Home, Kind = Phone)
    2. Cell (Preferences: Location = Mobile, Kind = Phone)
    3. Work (Preferences: Location = Work, Kind = Phone)
    4. Fax (Kind = Fax)
  2. 1 Email Address
    1. Email (Preferences: Location = Billing OR Location = Work)
  3. 1 Postal Address
    1. Address (Preferences: Location = Billing OR Location = Work)
  4. 1 Website Address
    1. Website (Preferences: Location = Billing OR Location = Work)

Custom Field Definitions

Final_Subject => Name

Notes (Contacts and Matters)

Final_Date => Date
Final_Subject => Subject
Final_Description_Html => Note

Practice Areas

Final_Subject => Name

Matter Stages

Final_Subject => Name

Time Activities

Entry_Date => Final_Date OR Final_Created_At OR <Unknown>
Description => Final_Subject and Final_Description
Final_HourlyRate => Rate
Final_Duration => Hours

Important Notes about Time Activities

When a Time Activity is imported into MyCase, a "Best-Fit" algorithm will be used to make sure that the billable amount of the time entry is preserved.  This happens when the Final_Rate * Final_Duration amount will not equal the Final_Total_Override (either due to rounding, truncation, or discounts).
In situations like this, the time entry will be imported as a flat-fee item.
When importing, time entries, the Duration field supports a single decimal place (ie. 1.1 hours, not 1.15 hours).

Expense Activities

Entry_Date => Final_Date OR Final_Created_At OR <Unknown>
Description => Final_Subject and Final_Description
Final_Units => Units
Final_UnitPrice => Cost

Important Notes about Expense Activities

When an Expense Activity is imported into MyCase, a "Best-Fit" algorithm will be used to make sure that the billable amount of the time entry is preserved.  This happens when the Final_Units * Final_UnitPrice amount will not equal the Final_Total_Override (either due to rounding, truncation, or discounts).
In situations like this, the Expense Activity entry will be imported with Units = 1 and Cost = Final_Total_Override.

Fee Activities

Entry_Date => Final_Date OR Final_Created_At OR <Unknown>
Description => Final_Subject and Final_Description
Rate => Final_Total_Override

Task Entries

Due_Date => Final_Due_At OR <Unknown>
Name => Final_Subject
Description => Final_Description
Final_Stage => Completed
Final_Priority => Priority

    • Related Articles

    • MyCase Injections: Error Creating Custom Fields

      A bug exists in the MyCase application (not Universal Migrator) that can cause all attempts at creating any custom field to fail. In the event that this happens, please open a support ticket with MyCase and direct your representative to this article. ...
    • MyCase Drive: Post-Migration Operations

      Clear the MyCase Drive Cache After a large migration of documents into MyCase, you should clear your MyCase Drive cache. To do that, do the following: Click on the "Show More Icons" ^ in the system tray. Right-click on the MyCase Drive icon. Click on ...
    • Connecting to MyCase: Special Permissions

      In order to link Universal Migrator to a MyCase account, the following must all be true. The Subscription Must Allow Integrations Some MyCase plans (such as the Basic plan) do not allow integrations. The MyCase account must be on a subscription tier ...
    • MyCase Injections: Pre-Migration Homework

      Prior to restoring data into MyCase the following items should be cleaned up in your legacy system. Activities with Sub-Decimal Hours When activities are transferred to MyCase, the duration of all entries will be rounded up to the nearest 0.1 hours. ...
    • Time Matters: Custom Field Extractions

      Among practice management systems, Time Matters is unique in terms of how it stores custom field data. This translates into a unique experience backing it up and working with it. The purpose of this article is to help you understand how Time Matters ...