Item-level relational imports

Relational import files create relationships between item records that are already in the database. The import file simply creates a new relationship between existing items; both parent and child items must already be in the database. Any number of parent items may be in the import file, and each parent can be related to one or more child items. It's common for some child items to be assigned to several different parents.

Use item-level relational files to initialize your database from legacy data sources, such as an MRP database or Excel files. These existing records may have been imported in bulk using the ItemMaster.csv file, although they can also be created in the normal course of using PDXpert.

You can also use item-level relation files to update item files and external links, as well as to keep parts' materials lists current.

Guidelines for importing item-level relationships §

Before importing your data, back up your database. The import tool makes significant changes to your database, and can overwrite data on previously-imported items. You cannot undo the changes it makes; you can only restore your backup database.

If you use Excel as your CSV file editor, it may make undesired changes to values that it interprets as a number. For example, part number strings beginning with zero (e.g., 001234) will often be silently converted to a numeric value (1234). If you have any part numbers, document numbers or other data with leading zeroes, don't use Excel. Instead, use a CSV file editor, Windows Notepad, or other plain text editor (not Word) to edit your import file.

Empty import file .csv templates (with existing item data, if any) can be exported using the External Data Importer tool. Select the Import Type template, then click the Export button.

  • Parent and child items in these import files are matched according to the identification rule defined in Tools | System Rules... Item uniqueness defined by: Number, Organization, Class, Type. Columns not specified by the rule (Class or Type) are ignored during matching.

  • Iterations are always ignored in the matching (in fact, none of the relational import files include columns for specifying iteration values).

  • Rows are added cumulatively. That is, you can import an additional row without affecting the current list. If you want to replace an existing materials list, you must explicitly clear the list using the special value defined for that import file.

  • The column names in the first row of the import file (the "header" row) must match the definitions in the help topic. The header names are case-sensitive and must be spelled exactly as shown. Every column with data must have a conforming header. Do not include more than one column with the same header name.
  • Defined columns may be in any order. Extra (undefined) columns in the import file are ignored.
  • Every value must conform to the column's specified type (collection member, string, number, etc.) or be empty. For example, a column that requires a numeric value cannot include non-numeric characters.
  • Leading and trailing spaces are removed from each data element before it's matched or applied. Other space characters are not affected. For example, the value   many  spaces   becomes many  spaces.


Learn More
Help Guide Contents [PDF]