Batch Uploads

Version 8.1 by karimpirani on 2014/07/09 17:25

Batch Data Upload Process

 

The batch data upload process allows you to quickly populate the system database with existing data that is already recorded in electronic format on one of your other data systems.  The following is a step-by-step guide to making your way through this process. 

 

You must review and fulfill these Prerequisites prior to proceeding with this Batch Upload Process.

 

Use these Batch Upload Data Formats and examples to guide you through the process of uploading your organization's data.

 

General Uploading Process

1. Log into the application

2. Select the Batch Uploads option under the Administration sidebar

batch uploads - admin bar.PNG

The following screen should appear.

bu 1.PNG

3. Select New...

4. Select the file you wish to upload and identify the type of data that it contains, and click on Submit

bu 2.PNG

 

5. Confirm successful upload

Missing.png

 

6. Select the uploaded data and click on 'Process Selected'

7. If there are errors, view the error details by clicking on the Show Error Details option

Missing.png

You will need to correct the data in the CSV file, or obtain a new, corrected copy of the data.

 

8. If there are no errors (Success Count = Total Count), then you are done!

 

General File and Field Format/Content Rules

  1. All fields are comma delimited.
  2. The first row of the file is the 'header' record that specifies which fields are in the subsequent rows.
  3. The possible fields are case sensitive. E.g. 'name' does not equal 'NaMe'
  4. Fields can be escaped using Microsoft escaping or standard escaping.
  5. Dates are to be formatted in YYYY/MM/DD format. E.g. 2009/01/23
  6. Boolean values are either TRUE or FALSE.
  7. Operation fields are not required and default to UPDATE when not specified. Here are the possible values for operation:
    1. UPDATE: inserts or updates the record in the system
    2. DELETE: removes a specific record from the system
    3. DELETE_ALL: removes all records specified by the key from the system. This really only applies to the one to many cases in the system. If not a one to many case, this will behave the same as the DELETE operation