Common errors and warnings

Below are common import errors and their possible resolutions.

A data source of this name already exists in your workspace folder. Do you want to overwrite it?

You are attempting to open a data source with the name of a data source that already exists. You may continue by answering ‘yes’ to this dialog, but the previous version of the data source will be deleted.

A data source of the same name is already open. Please use another name or close all related panels and try again.

You are attempting to open a new data source using the name of a data source that already exists. Although similar to the above error message, you cannot continue as panels for the old data source are still open. To overwrite the old data source, close its data panels using the Close Panel menu option - you may need to show hidden data panels using the EasyCatalog Panels menu on the Window menu.

A duplicate key was detected (value). Please check your data provider configuration and try again.

EasyCatalog idenitifes each field in the document using a combination of the data source name, field name and key field value. Therefore, each of these elements must be unique in order to indentify every placed field.

In the column(s) you have nominated as the key field(s), you have duplicate values (the value that is duplicated is shown in the error). To overcome this, remove duplicate keys from the source data or check that your key field configuration is correct.

Field names must be unique - ‘(field name)’ appears more than once

EasyCatalog idenitifes each field in the document using a combination of the data source name, field name and key field value. Therefore, each of these elements must be unique in order to indentify every placed field.

In your configuration you have selected First record contains field names, but the first record contains multiple fields with the same name (shown in the error). To remedy this you must change your source data so that it does not include duplicate field names.

Field names must be unique - ‘’ appears more than once

Where no field name is shown in the above error, this usually indicates that your records contain more fields than there are field names. This error will only occur when First record contains field names is selected.

To rectify this problem, ensure that each record in the file contains the same number of fields, and that the number of fields matches the number of field names supplied in the first row/record of the file.

Duplicate records were found and have been removed

Records that contain exactly the same content cannot be imported, as each would have the same key field values. This error is informative, and the duplicate records will be removed and the file imported. You should check to see whether you need to import these missing records and, if so, include exta information in the source data to differentiate between each record.

Data cannot be loaded because blank field names were found

All fields imported must have a name, and this error is indicating that one or more have empty names. This error will only occur when First record contains field names is selected. Check the source data to ensure that each field has a name, and that the number of fields in each record does not exceed to number of field names specified in the first record/row of the file.