Import Setup Data Screen Field Reference

Details about the tabs of of the Import Data screen.

This screen field reference describes the following:

General tab

Use the General tab to initiate the import. If you have already clicked Get External Data, all fields except Allow Duplicate Names are disabled.

FieldDescription
Import Type

Click to select the type of data to import.

  • 2 - Contact
  • 3 - Customer
  • 4 - Vendor

Import types are listed in the order in which the data should be imported. For example, Contacts should be imported before Customers, because contact information is referenced within customer records.

Note: The import types shown in this field are based on user permissions to the corresponding screens. For example, if you do not have access to the Project screen, the Project import type is not listed.
File LocationClick and browse to the import file. Valid file types include Excel (XLSX) files and TSV files.
Posting GroupThis field is disabled.
Select DFRsThis field is disabled.
Allow Duplicate NamesSelect the checkbox to import records with duplicate names without giving any warnings. If records with duplicate names are imported, you can use Merge User Codes to combine the entities as needed. Deselect the checkbox to mark records with duplicate names as invalid. For Contacts, the name is based on the values in all five key fields (Title, First Name, Initial, Last Name, and Suffix). For Customers and Vendors, the name is in a single field in the import file.
Number of Valid RecordsInitially displays 0; after you click Get External Data, displays the number of valid records for the import type. Valid records can be imported.
Number of Invalid RecordsInitially displays 0; after you click Get External Data, displays the number of invalid records for the import type. Invalid records must be corrected before being imported.

A record is invalid if either of the following is true:

  • The record fails one or more validation checks.
  • The record is orphaned.

For more information, see Failed Records tab and Orphaned Records tab.

ClearClick Clear to clear the File Location, Posting Group, and Allow Duplicate Names fields for the import type and to clear external data.

If the external data includes invalid records, you have the option to create a Problem Records Excel file. You can use this file to identify the records with errors in the original import file.

Failed Records tab

The Failed Records tab is displayed only if one or more records in the import file failed validation checks. A record may fail a validation check for a number of reasons, including:

  • A required field is blank.
  • The value in a field is not the correct type of data (for example, a character value is in a date field).

Each row in the grid contains information about a failed record. Use this information to find and correct the record in the import file.

Field Description
Import TypeDisplays the import type.
File NameDisplays the Excel file name.
Original File RowDisplays the row number of the failed record in the first worksheet of the Excel file.
Note: If the error is on an additional worksheet of the import file, use the Problem Record Key field information to find the failed record on the additional worksheet.
Problem Record KeyDisplays the key field value(s) of the failed record.
Problem(s)Displays all failed validations for the record.

Orphaned Records tab

The Orphaned Records tab is displayed only if a detail record in the import file does not match a primary record in the import file. This match is based on the values in the key fields for the import type.

Each row in the grid contains information about an orphaned record. Use this information to find and correct the record in the original Excel file.

CAUTION: If you import before correcting orphaned records, you must manually enter the orphaned records into the system.
FieldDescription
Import TypeDisplays the import type.
File NameDisplays the Excel file name.
Problem Tab NameThe name of the tab containing the orphaned record.
Problem RowThe row number of the orphaned record.
Problem KeyThe primary key of the orphaned record.