exMon Data Management allows you to easily import data from files, such as CSV files.

This document describes how to import data from CSV into an existing table in exMon DM.


In our example here we have a CSV file with three columns, a header row and two data rows.



Open the table in exMon DM and click Import Data.



A dialog opens to select the data source. In Data source select Flat file and then Browse to find your CSV file.


You can choose or override the Delimeter and if your data uses the first row as column names.

When changing the selection, the preview below displays how exMon will interpret the data.

When you are ready, click Next.


This step is to map columns from the CSV file to the table in exMon DM.

Below you can see a preview of the the in exMon DM and how the import will map the data.


For each destination column (column in the exMon table), select a column from the CSV file. If the column names in the CSV and the exMon table are the same, then the mapping will be automatically filled out.


Source Column

For each destination column you have three options:

- Select a column from the CSV file.

- Fixed: A predefined value for all rows. When selected you will enter the value in Custom Value.

- [None]: The column will be left empty.


Action

After mapping the columns you will need to select an Action for each column. The import can either add rows from the CSV or find existing rows and update attributes when found. For example, if you are importing a customer address list you might want the import just to find the customers in exMon DM and update the addresses.

The Action determines the behavior for the import.

- Unique Key: This means that this column is what makes the row unique. For example, the customer id or product id. You can select multiple columns as the Unique Key.

- Update: The data in the exMon table will be updated with data from the CSV.

- Ignore: The column is ignored during the import. It's the same as selecting Source Column as None.


Add rows not found in existing data

When using Unique Key the import will try to find matching rows in exMon when importing. This option is to change behavior when the import does not find a row from the CSV. When unchecked, the import will not add new rows, only update existing rows.



Custom Numeric and Date formatting

When importing CSV with numbers and dates, exMon assumes that the number and date format is the same as regional settings in Windows. When working with CSV from external sources this is often not the case.

You can override both numeric and date formats using this dialog.



When you have chosen all the mapping options, click Preview to preview the import.


The preview window will show the results of the import. At the top, there is a summary of the import and below each row of the import is displayed.

If there were any errors during the import they will be displayed in this dialog.


When ready, you can click Save and Close to apply the import. Note that you have not done any changes to the exMon table until you click Save. When Save and Close has been clicked exMon will suggest the correct size for string columns depending on the longest string in each column which you can change in the 'Format & Size' tab in the Table Designer  if you prefer it differently.