Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Warning

This import tool is in beta, and is only available to users in the EA release group. For users in other release groups, see /wiki/spaces/KB/pages/1835910.

Info
iconfalse
Warning

If you need to import from TimeMatters, Counsel Pro, Amicus, or Bulk upload documents contact support@actionstep.com to get the desktop importer.

Importing Overview Video

Widget Connector
width720
urlhttps://vimeo.com/241448156
height480

The Data Import Tool is a powerful and flexible utility for importing and updating data. The tool supports your data in XLSX (preferred), XLS, and CSV formats. 

...

The Import data screen shows the various import types that can be used.

Matter import types

  • Matters - matter information, matter billing settings, and custom data
  • File Notes - file notes and system notes
  • Multi-row Data - multi-row custom data for one or more matters
  • Parties - add parties to matters
  • Tasks - add or update matter-associated and non-matter-associated tasks
  • Trust Accounts -add or update a Trust account for one or more matters

Contact import types

  • Contacts - contacts and their accounting settings
  • Contact Notes - system or file notes on a contact record
  • Contact Relationships
  • Default Contact Types - assign default contact types to a contact

Billing import types

...

...

Custom data import types

  • Dropdown Field Options - the options for a dropdown field in a custom data collection

Import order suggestions

The order below is what we would suggest that anyone performing all of the imports should do. This takes into account data that is dependent upon previous imports to establish a logical order.

This assumes the user has set up the items needed for each import to be successful. This includes setting up participant types, action types, rate labels, expense templates, and fee income accounts where necessary.

...

Contacts - no dependency

...

Contact notes - dependent upon contacts import

Contact relationships - dependent upon creating relationships

Default contact types - dependent upon setting up participant types

...

Matters - dependent upon contacts

File notes - dependent upon matters

Mult-row data - dependent upon matters(contacts, if Linked-participant data field is supported)

Trust accounts - dependent upon matters

...

Expenses/Disbursements - dependent upon matters/contacts

Parties - dependent upon matters/contacts

...

Dropdown fields - (potentially) dependent upon multi-row data

...

Quick-codes - no dependency

...

Tasks - dependent upon contacts, optionally matters, optionally quick-codes

...

Time entries - dependent upon contacts, optionally matters, optionally quick-codes

...

Accounts receivables - dependent upon matter/contacts/account setup

...

Collect your data

Data must be in XLSX, XLS, or CSV format.

Check your data

See Import Type Reference for acceptable data formats and a complete list of fields.

Useful Tips for Importing Data

  • Try import 1 row of data first before attempting large files to make sure everything works as expected
  • If you are worried about breaking your live system, consider signing up for a trial to test importing your data first, then run on your live system
  • Use a Microsoft Excel (xls or xlsx) file instead of CSV. This removes some common issues like date formatting
  • Review your data before importing by opening in excel and review a few lines to make sure there is no unusual data or poorly named columns
  • Most importantly, take your time with the import and don't rush!

...

Info

A matter import is being used in this example, however the same principles apply in each import. See the reference section of your import type for specifics.

Select “Start import” on your desired import

Image Removed
Upload file

Image Removed

Image Removed

  • File to import
    • Supported formats - XLSX (preferred), XLS, and CSV
  • Import mode
    • Insert new data - Add records
    • Update existing data - Update records
  • File type - format of the file to import

Select Next

Image Removed

...

Image Removed

Column header

Actionstep attempts to automatically match the column headers to a corresponding field in Actionstep.

Image Removed

Note

Field names/column headers in reference section will automatically be detected by Actionstep.

Field in Actionstep

Image Removed

Here, you match your column to a specific field in Actionstep. ANY column can be mapped to ANY field. That is, the column headers can be Actionstep field names OR be named something else.

Info

Example

Image Removed

If the matter type were entered in a column called “Matter Name,” Instead of changing the column name, you can map the Matter type field to that column.

Your data format

This column allows you to specify the format of the data in your import.

Info

Example

Image Removed

In the image above, we’re selecting a matter type on the import. Here, we can specify whether we are using the Matter type ID or the Matter type name to identify the matter type.

Data
Image Removed
Mapping

Image Removed

Select Next

Image Removed

Map data

Image Removed
This screen will confirm that data is being mapped properly.

Info

Example

Image Removed
In the previous Matter Type example, we set the Matter type to be specified by the matter type ID 11. The right column displays the Actionstep value for the ID as “Client Auditing.”

If the value is incorrect, it can be changed.

Image Removed

...

Image Removed

Confirm

Image Removed

...

Image Removed

To confirm the import, select the Begin import process button.

Image Removed

After import

A screen will be displayed with the status of the import.

Image Removed

If, for any reason, you need to undo the import, select “Attempt a rollback?”

Info

If any records on the import are rejected, they will be included in a downloadable failure file that provides the reasons for failure.

...

Image Removed

After choosing to do a rollback, you will have to confirm the deletion of the previously imported data and select “Start rollback.”

Image Removed

...

Image Removed
If the rollback was unsuccessful, a CSV with the failed records and failure reason can be downloaded.

...

Info
iconfalse

Bottom of Admin > Import data

Image Removed
Every import is recorded in the History section of the import screen.

Created

Can be selected to view import summary or attempt a rollback:

Import

Displays the type of import and file used

Status

Displays the status of the import. If an import is pending, it can be selected and finished.

Total

Number of records imported, updated, or rolled back.

Info

Use the trash icon to delete the record. This does not affect imported items, just the record of the import.

...

Info

Required import fields are highlighted red. Fields required for updating data are highlighted yellow.

Matters Import Reference

Download Matters Import Reference.xlsx

Expand
titleMatters Import Reference
FieldsValid data formatValid data example(s)
Matter IdentifierImport reference (formerly referred to as external reference)4485b
Matter ID31Matter nameJohn Smith Litigation
Matter TypeMatter type ID6
Matter type nameGeneral Litigation
Matter NamePlain textJohn Smith
File ReferencePlain text366L
Date CreatedMicrosoft Excel-formatted date8/30/16, 30/08/2016, etc.
Date ClosedMicrosoft Excel-formatted date10/1/17, 01/10/2017, etc.
Assigned toImport reference (formerly referred to as external reference)12887
Email addressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay NameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers InitialsJDS
Step tree nodeNode ID

41 Image Removed

Node path name
StatusStatusActive, Inactive, Closed, template
Priority

Number

100
Import referencePlain text4485b
DivisionDivision ID1
Participant ID27 - ID of participant assigned to the desired divisionDivision nameLaw Firm 
Related MatterImport reference (formerly referred to as external reference)4485a
Matter ID30Matter nameJohn Smith Client Contact
Warning/Banner messagePlain textThis is a banner message!
Forced billable flagTrue or FalseTRUE, FALSE
Billing statusShort text(Active|Closed)Active, Closed
Long textActive for billing, Closed for billingBilling - Bill templateTemplate IDTemplate nameLegal Invoice 2
Billing - Print countNumber0,1,2
Billing - Email bills toEmail addressesemail@example.emlemail2@example.eml *separate multiple addresses by commas
Billing - General retainer minimum balanceCurrency (2 decimal places)2500.00
Billing - General retainer topup triggerCurrency (2 decimal places)1500.00
Billing - Trust to payBilling - Trust to payNew Charges, New charges and AR
Billing - Trust pay automatically flagTrue or FalseTRUE, FALSE
Billing - Exclude from mass-billing flagTrue or FalseTRUE, FALSE
Billing - Bill only expenses flagTrue or FalseTRUE, FALSE
Billing - ArrangementBilling - ArrangementHourly, Fixed fee
Billing - Quoted amountCurrency (2 decimal places)1200.00
Billing - Quote is forBilling - Quote is forFees only, Fees and expenses, Expenses only *your system may have a different alias for expenses
Billing - WIP less than quote behaviorBilling - WIP less than quote behaviorInvoice quoted amount only, Invoice quoted amount plus WIP, Invoice WIP only
Billing - WIP greater than quote behaviorBilling - WIP greater than quote behaviorInvoice quoted amount only, Invoice quoted amount plus WIP, Invoice WIP only
Billing - fee reductions are treated asBilling - fee reductions are treated asHide line pricing and show total only, Appear as discount
Billing - Default time entry behaviorBilling - Default time entry behaviorBill, Hide, No Charge
Billing - Discount typeBilling - Discount typePercentage, Fixed amount
Billing - Discount percent or amountCurrency (2 decimal places)20
Billing - UTBMS flagTrue or FalseTRUE, FALSE
Billing - UTBMS task categoryUTBMS CodeA100
UTBMS Code descriptionActivitiesBilling - UTBMS file typeUTBMS CodeUTBMS Code description
Billing - Originator fee flagTrue or FalseTRUE, FALSE
Billing - Originator participantImport reference12887
Email addressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay nameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers initialsJDS
Billing - Originator fee percentNumber/Decimal (2dp)10
Billing - Allocate fee adjustments onBilling - Allocate fee adjustments onOriginal fee split, Reposnible lawyer, Selected timekeeper
Billing - Allocate fee adjustments - specific participantImport reference12887
Email addressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay nameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers initialsJDS
Billing - Fee allocation methodBilling - Fee allocation methodPro-rate, Responsible lawyer, Slected timekeeper
Billing - fee allocation - specific participantImport reference12887
Email addressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay nameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers initialsJDR
Billing - Sales tax enabled flagTrue or FalseTRUE, FALSE
Billing - Sales tax codeTax codeN-T
Tax code nameNo Tax
Billing - Sales tax applies toBilling - Sales tax applies toFees only, Expenses only, Fees and Expenses
Billing - Email templateTemplate ID4
Template nameBilling Email 1
Info

The section below is used to assign participants on a matter the actual name of the column would be Participant - Client or Participant - Attorney. 

Participant - *Import reference12887email addressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay nameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers initialsJDRCustom Data - *Dependent upon field type Expand
titleFile Notes Import Reference

File Notes Import Reference

Download File Notes Import Template.xlsx

FieldsValid data formatValid data example(s)File Note IdentifierImport reference243File Note IDMatterImport reference4485bMatter ID31Matter NameJohn Smith LitigationNote textPlain textThis is a file note.Note dateMicrosoft Excel Formatted Date14 Sep 2017, 9/14/2017, etc Created byImport reference12887Email addressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay nameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers initialsJDRNote typeNote typeSystem, UserImport referencePlain text243 Expand
titleMulti-Row Data Import Reference

Multi-Row Data Import Reference

When importing multi-row custom data, you will be prompted to select the data collection into which you are importing. 

Image Removed

Info

Your data will be dependent upon the field types in your data collection. Each column should be mapped to a specific field. Below are all supported field types.

FieldsValid data formatValid data example(s)Matter identifierImport reference4485bMatter ID31Matter NameJohn Smith LitigationText LinePlain textThis is a text line.Protected Text LinePlain textPasswordText BlockPlain textThis is a text block.NumberNumber/Decimal (2dp)385.75MoneyCurrency (2 decimal places)1500.00DateMicrosoft Excel formatted date14 Sep 2017, 9/14/2017, etc Date and TimeMicrosoft Excel formatted date+time14 Sep 2017 10:30 AM, 9/14/2017 10:30 AM, etc Dropdown List (Single Select)Plain text

Option 2

Boolean (Checkbox)True or FalseTRUE, FALSE Expand
titleParties Import Reference

Parties Import Reference

Download Parties Import Template.xlsx

FieldsValid data formatValid data example(s)MatterImport reference4485bMatter ID31Matter NameJohn Smith LitigationContactImport reference12887Email Addressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay NameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers InitialsJDSParty typeParticipant Type ID14Participant Type NameClient, Attorney, Paralegal, etc.
Info

Participant type custom data can also be imported. Data format is determined by the custom field type.

Expand
titleTasks Import Reference

Tasks Import Reference

Download Tasks Import Template.xlsx

FieldsValid data formatValid data example(s)MatterImport reference4485bMatter ID31Matter NameJohn Smith LitigationTask namePlain textDo this taskTask descriptionPlain textThis is a task descriptionStatusStatusComplete, IncompleteAssigned toImport reference12887Email Adressemail@example.emlParticipant ID27First + Last NameJohn SmithDisplay NameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeepers InitialsJDSDue dateMicrosoft Excel formatted dateAny date formatted in ExcelEuropean (dd/mm/yyyy hh:mm:ss)14/09/2017 10:26:22American (mm/dd/yyyy hh:mm:ss)09/14/2017 10:26:22European long (dd mmm yyyy hh:mm:ss)14 Sep 2017 10:26:22Month Day Year (mmm dd yyyy hh:mm:ss)Sep 14 2017 10:26:22PriorityPriorityLow, Normal, HighCreated dateMicrosoft Excel formatted dateAny date formatted in ExcelEuropean (dd/mm/yyyy hh:mm:ss)14/09/2017 10:26:22American (mm/dd/yyyy hh:mm:ss)09/14/2017 10:26:22European long (dd mmm yyyy hh:mm:ss)14 Sep 2017 10:26:22Month Day Year (mmm dd yyyy hh:mm:ss)Sep 14 2017 10:26:22Completed dateMicrosoft Excel formatted dateAny date formatted in ExcelEuropean (dd/mm/yyyy hh:mm:ss)14/09/2017 10:26:22American (mm/dd/yyyy hh:mm:ss)09/14/2017 10:26:22European long (dd mmm yyyy hh:mm:ss)14 Sep 2017 10:26:22Month Day Year (mmm dd yyyy hh:mm:ss)Sep 14 2017 10:26:22Import referenceCreate time entry when complete flagTrue or FalseTRUE, FALSE Expand
titleTrust Accounts Import Reference

Trust Accounts Import Reference

The Trust Accounts import is used to add trust accounts to matter.

Download Trust Accounts Import Template.xlsx

FieldsValid data formatValid data example(s)MatterImport reference4485bMatter ID31Matter NameJohn Smith LitigationAccountAccount ID273Account Name1-1210Opening balance dateMicrosoft Excel formatted dateAny date formatted in ExcelEuropean (dd/mm/yyyy hh:mm:ss)14/09/2017 10:26:22American (mm/dd/yyyy hh:mm:ss)09/14/2017 10:26:22European long (dd mmm yyyy hh:mm:ss)14 Sep 2017 10:26:22Month Day Year (mmm dd yyyy hh:mm:ss)Sep 14 2017 10:26:22StatusStatusOpen, ClosedNotesPlain textThis is a trust account note Expand
titleTime Entries Import Reference

Time Entries Import Reference

Import billable and non-billable time.

Download Time Entries Import.xlsx

Info

Fields highlighted in green are required when the time entry is billable.

FieldsValid data formatValid data example(s)TimekeeperImport reference344bEmail addressjohn.smith@email.dom

Participant ID

27First Name + Last NameJohn SmithDisplay nameSmith, John || John Davis Smith - Set in System preferences > Contact name formatTimekeeper's initialsJDSDateMicrosoft Excel formatted date11/20/17European (dd/mm/yyyy)20/11/2017American (mm/dd/yyyy)11/20/2017European long (dd mmm yyyy)20 Nov 2017Month Day Year (mmm dd yyyy)Nov 20 2017DescriptionPlain textThis is a description.Quick-codeImport referencete299Quick-codepifDescriptionProcessing intake formsQuick-code ID3Start timeDefault (hh:mm)11/20/17

European (dd/mm/yyyy hh:mm)

20/11/2017American (mm/dd/yyyy hh:mm)11/20/2017European long (dd mmm yyyy hh:mm)20 Nov 2017ISO (yyyy-mm-dd hh:mm)Nov 20 2017Hours workedNumber/Decimal (2dp)2.25Hours to billNumber/Decimal (2dp)3.75UTBMS activity codeUTBMS codeA105UTBMS code descriptionCommunicate (within legal team)UTBMS task codeUTBMS codeB130UTBMS code descriptionAsset DispositionUTBMS timekeeper codeUTBMS codeCLKSECUTBMS code descriptionClerk or SecretaryAssociated taskImport reference78tskTask ID377Task NameFile documentsAssociated matterImport reference4485bMatter ID31Matter NameJohn Smith LitigationBilling behaviorBilling behaviorBill, No charge, or HideRate sheetImport reference554Rate sheet nameAttorneyRate sheet ID3Rate sheet hourly priceNumber/Decimal (2dp)200Rate sheet sourceRate sheet sourceDefault rate, or Timekeeper rate (if the rate has been overridden for a specific timekeeper)Billable amountCurrency (2 decimal places)1400Import referencePlain textte334Billable flagTue or FalseTrue or False Expand
titleDisbursements/Expenses Import Reference

Disbursements/Expenses Import Reference

Download Disbursements - Expenses Import Template.xlsx

FieldsValid data formatValid data example(s)TemplateTemplate IDTemplate NameMatterImport referenceMatter IDMatter nameTimesheet dateExcel formatted dateEuropean (dd/mm/yyyy)American (mm/dd/yyyy)European long (dd mmm yyyy)Month Day Year (mmm dd yyyy)DescriptionPlain textQuantityNumber/Decimal (2dp)Unit of measureUnit IDUnit nameUnit priceCurrency (2 decimal places)Unit price includes tax flagTrue or FalseTax codeTax codeTax code nameIncome accountAccount numberAccount IDAccount nameTimekeeperImport referenceEmail AddressParticipant IDFirst Name + Last NameDisplay NameEntered dateExcel formatted dateEuropean (dd/mm/yyyy)American (mm/dd/yyyy)European long (dd mmm yyyy)Month Day Year (mmm dd yyyy)UTBMS Expense codeUTBMS CodeUTBMS Code DescriptionImport referencePlain text Expand
titleQuick-codes Import Reference

Quick-codes Import Reference

Download Quick-codes Import Template.xlsx

FieldsValid data formatValid data example(s)Quick-codePlain textrfcDescriptionPlain textReceived from clientSort orderNumber10Use with retainer transfers flagTrue or FalseTrue, FalseUse with receipts flagTrue or FalseTrue, FalseUse with tasks flagTrue or FalseTrue, FalseUse with time entries flagTrue or FalseTrue, False Expand
titleContacts Import Reference

Contacts Import Reference

Download Contacts Import Template.xlsxSee updated article in Actionstep Help Center: Data Imports