Q: Can I import data like customers and stocks from my MIS system into the Metrix database?

Product: Metrix
Version: 1.5, 1.6, 1.7
Operating System: Windows XP or Windows 2000
Last Updated: December 23, 2005

A: Yes. Metrix can import a comma separated file (commonly called a CSV file) to populate the database tables with customers and customer contacts, plus stocks and stock sheets. For each of these, the information must be formatted in a precise way so that Metrix can unambiguously recognize each field.

Notes

1. It is highly recommended that users backup the database files before importing data. For instructions on how to do this click here. Importing data cannot be undone (although items can be individually deleted) so the best remedy for an error is to replace the database files with the backup copies.

2. To import a file, open the Database dialog (select Database in the Settings menu) in Administration mode. Select the type of data (Stocks or Customers) and click Import. Select the relevant CVS file. After importing a file, Metrix will log the results in a file located in the Metrix installation folder.

2. When constructing the CSV data files to import, keep in mind that for text fields leading and trailing spaces are considered part of the text.

3. When importing data, Metrix does not allow duplicating any existing data records. This can potentially become confusing when the data matches previously edited or deleted database records. So that all database projects can be viewed exactly as when they were last saved, the Metrix database archives all edited or deleted records for items such as Presses, Stocks, Customers, and Inks. If a matching record has ever been entered into the database, even if it has since been edited or deleted, it is still in the database for archive purposes and is not permitted to be duplicated.

4. Text fields whose minimum value range is listed below as "empty" are optional fields. Optional fields whose data is empty still need to be represented by the appropriate separating commas, even though there will be no data between the commas. For example, click here to see an sample customer CSV file with all optional fields left empty. Note: only the Customers and Contacts import specification has optional fields - these fields are italicized below.

5. When the last field in a record is not empty, a carriage return character, a line feed character, or a carriage return character followed immediately by a line feed may be used instead of a comma to indicate the end of the record (rather than using a comma to separate the last field of one record from the first field of the next record). The sample stock files below use this method to create a list of all stock records as individual lines in the file.

Field Specifications: Stock and Sheets

Field
Data Type
Value Range
Stock Vendor Name Text (string) Min: 1 character
Max: 255 characters
Stock Name Text (string) Min: 1 character
Max: 255 characters
Stock Weight Number (integer) Min: 1
Max: 1000
Stock Weight Unit Number (integer enumerator) 0 = "gsm"
2 = "lb"
Stock Thickness Number (decimal) Min: 0.0004" (0.01016 mm)
Max: 0.25" (6.35 mm)
Stock Thickness Unit Number (integer enumerator) 0 = "millimeters"
2 = "inches"
Stock Grade Number (integer enumerator) 1 = "Gloss-Coated Paper"
2 = "Matt-Coated Paper"
3 = "Gloss-Coated, Web Paper"
4 = "Uncoated, White Paper"
5 = "Uncoated, Yellowish Paper"
Sheet Height Number (decimal) Min: 3" (76.2 mm)
Max: 144" (3657.6 mm)
Sheet Height Unit Number (integer enumerator) 0 = "millimeters"
2 = "inches"
Sheet Width Number (decimal) Min: 3" (76.2 mm)
Max: 144" (3657.6 mm)
Sheet Width Unit Number (integer enumerator) 0 = "millimeters"
2 = "inches"
Sheet Grain Direction Number (integer enumerator) 0 = "horizontal grain"
1 = "vertical grain"

Sample stock files:
sample stock data - inches.csv
sample stock data - metric.csv


Field Specifications: Customers and Contacts

Field
Data Type
Value Range
Company Name Text (string) Min: 1 character
Max: 255 characters
Company MIS ID Text (string) Min: empty
Max: 255 characters
Company Web Address Text (string) Min: empty
Max: 255 characters
Company Street Text (string) Min: empty
Max: 255 characters
Company Post Box Text (string) Min: empty
Max: 255 characters
Company City Text (string) Min: empty
Max: 255 characters
Company Region Text (string) Min: empty
Max: 255 characters
Company Postal Code Text (string) Min: empty
Max: 255 characters
Company Country Text (string) Min: empty
Max: 255 characters
Company Country Code Text (string) Min: empty
Max: 255 characters
Contact First Name Text (string) Min: 1 character
Max: 90 characters
Contact Family Name Text (string) Min: 1 character
Max: 90 characters
Contact Job Title Text (string) Min: empty
Max: 255 characters
Contact Phone Text (string) Min: empty
Max: 255 characters
Contact Fax Text (string) Min: empty
Max: 255 characters
Contact Email Text (string) Min: empty
Max: 255 characters
Contact Sales Rep Text (string) Min: empty
Max: 255 characters

Sample customer files:
sample customer data.csv
minimal customer data.csv

Back to Technical Help