User Community Service Desk Downloads
If you can't find the product or version you're looking for, visit

Import Data from a File

Importing data to ONE Data means making the data discoverable in the application. Once your data is loaded, you can enhance it by adding or removing attributes or modifying the table values.

In addition to creating a table from scratch or importing an existing catalog item from the Knowledge Catalog, you can upload a local file from your machine. Currently, you can import files in CSV, TSV, XLS, and XLSX formats.

ONE Data is a type of data source in ONE and you can access the metadata of each ONE Data table in the Knowledge Catalog as well. These tables are labeled as ONE Data catalog items.

To easily navigate to ONE Data from the Knowledge Catalog, when viewing the table in the Knowledge Catalog, go to Data > Open in ONE Data.

In the current version, we recommend working with datasets of up to 50k records for optimal performance.

Upload a file

The maximum upload size is limited as follows:

  • Microsoft Excel files (XLS or XLSX): 50 MB.

  • CSV or TSV files: 2 GB.

To import a local file, follow these steps.

  1. In ONE Data, select Import > File.

  2. Drag and drop a file or select Browse files. You can import only one file at a time.

    The following formats are supported: CSV, TSV, XLS, and XLSX.

    A validation check is performed before any data is loaded, preventing you from importing files with incorrect formatting. If the file upload fails, check the file structure for validity issues in another text editor.
    Keep in mind that importing large Excel files (with tens of thousands of records or more) will temporarily affect the application performance. We therefore recommend working primarily with files with a lower number of records.
  3. Check the file preview to make sure the data was read correctly. The first valid 50 records are displayed; any invalid records are hidden from the preview and not imported.

    • To edit the attribute name and data type: Double-click the column header and change the values as needed, then select Confirm.

      Keep in mind that while you can select any data type for any attribute, records will be labeled as invalid and omitted during the import if the parsing results don’t match what you selected.

      The attribute name must be unique. Therefore, you cannot rename an attribute to any of the reserved keywords that are used for technical attributes in ONE Data (dmm_record_id or dmm_rank).
    • To change the automatically detected file options: As needed, modify the detected file format, value and decimal separators, date and date time formats, and file encoding.

    • To use the first row as the header: Select Use first row as headers.

    • To import a selection of columns: By default, all columns are selected for import. To enable this option, click Select specific columns to import (or use the keyboard shortcut) and make your selection.

    • To import a specific Microsoft Excel sheet: If you are importing a Microsoft Excel file with more than one sheet, choose the one you want to use in Select sheet. Otherwise, the first sheet in the file is selected.

      While preparing the file for upload, you can also remove it and upload another one instead. If you prefer to go back to the default settings, select Reset settings.
      Upload a Microsoft Excel file
  4. Once you’re happy with your choice, select Continue.

  5. Enter a unique name for the table and optionally a description.

  6. Select Create ONE Data table. Depending on the size of your file, it might take a few minutes to get everything ready.

    To continue working with the platform in the meantime, select Run in background. This redirects you to the ONE Data Tables tab.

    Alternatively, remain on the same page until your ONE Data table is created. A notification lets you know when the import is finished.

  7. Your table is now ready for use. See the Next steps section for more tips about how to proceed.

Next steps

Once you have successfully created a ONE Data table, start exploring what ONE Data and ONE can offer you.

Was this page useful?