Import data from a file

Import data from a .csv or .xlsx file to add records to an empty Data Analytic.

Note

Only Results Admins, Professional Managers, or Professional Users can complete this task.

Selecting data types

During the import process, Results suggests a data type for each column. You can confirm these data types, or if necessary, select a different data type than the process suggests. For example, you can display a number as character data instead of the suggested numeric type.

For more information about data types, see Supported data types.

Import requirements

Data Analytic must be empty

The Data Analytic you want to import data into must not contain any existing rows or records before you perform the import. If necessary, you can delete existing records, first.

Import file requirements

Requirement Value
Supported file types
  • MS Excel spreadsheet .xlsx

    If an Excel file has multiple worksheets, only the first worksheet is imported.

  • Comma-separated values .csv

Note

Excel formatting is not preserved during the import and any formulas are imported as the result of the calculation rather than the formula itself. The first row is treated as the column display header.

Maximum number of records 100,000
Maximum number of columns

100

The combined number of data columns and questionnaire columns cannot exceed 500.

Caution

Ensure each column has a unique name. Duplicate columns are automatically removed regardless of the data contained within them.

Maximum number of characters per column, including blank characters 256
Maximum file size

10 MB

Caution

The upload will fail if the file size is larger than 10 MB.

Note

If your table file size is large, but less than 10 MB, you may receive an error message saying the upload has timed out, but your records will still upload successfully. To see your records in Diligent One, you may have to wait and refresh the page.

Supported date/datetime formats
  • YYYY-MM-DD
  • YYYY-MM-DDThh:mm:ss+hh:mm
  • YYYY-MM-DDThh:mm:ss-hh:mm

Field name considerations when round-tripping Results data

Sample data files

The following sample import files meet the requirements described above and can be used to test the import process:

Import data from a file

Note

You cannot upload data to a table that was created by the Certifications feature in Projects. These tables are empty, initially, but are populated by the certification process itself.

  1. Open the Results app.
  2. Navigate to the collection and analysis that contains the empty table you want to import to.
  3. Click the table title. The Import Data page opens. If you just created a Data Analytic, this page automatically opens.
  4. To specify the file you want to import, do one of the following:
    • Drag the file into the Drag & Drop uploader.
    • Click Choose a file from your computerand select the file from your local machine.
  5. If you want to use different data types than Results suggests, use the dropdown lists to specify the data type for each column in the table.

    Note

    Ensure the data type for each column is appropriate as you will not be able to change these later. For more information, see Supported data types.

  6. To complete the import, click Confirm Data Types.