OmniBOM User's Guide
Help Files | HelpDesk
Importing BOMs
Skip Navigation Links.
Links
Help Files Help Files
Server Home Page Server Home Page
Omnify HelpDesk HelpDesk Module
Omnify Support Portal Omnify Support Portal
Email Omnify Support Email Omnify Support
Omnify Desktop and OmniBOM support importing BOM files in the following file formats:
You can import files directly from Engineering (CAD/CAE) tools such as Cadence OrCAD, Mentor DxDesigner, SolidWorks, PTC ProEngineering/ProInterlink, etc. and from ERP/MRP systems such as SAP, Oracle, Intuitive, Made2Manage, Great Plains, etc.
To import a BOM file, use the Import command from the File menu or toolbar.


You will be asked to specify the BOM file and format.


When importing OmniBOM (.obx) files, the Import Wizard will present the following pages/options:
The Import Wizard accepts delimited, fixed width, and columnar text/ASCII files. When importing text files, it is important to first know and understand the file's format before setting up the import options. Refer to the Text Format Selection Page for more information on these file formats and import options.

When importing text files, the Import Wizard will present the following pages/options:
CSV Files are text/ASCII files where the field data is separated with a comma. Optionally double-quotation marks can be used as text qualifiers to help delimit the field data. Below is an example of a CSV (Comma-Separated Values) file:

Item,"Part Number",Qty,Refdes,Description
1,07-0010-00,1,U12,"0805, 10UF, 35V"
2,25-0005-00,1,"U1,U2",PowerQuicc 860T

Notice that for fields that contain commas in the field values, the text qualifier is used.

When importing CSV files, the Import Wizard will present the following pages/options:
When importing a Microsoft Excel file, you will be asked to select which sheet you wish to import on the Initial/Welcome Page.



You will also be able to identify if the sheet contains a column header row as the first row in the spreadsheet.



For example, if the source looked like:



You would check the First row contains field names option.

When importing Excel spreadsheets, the Import Wizard will present the following pages/options:
When importing a Microsoft Access database, you will be asked to select which table you wish to import on the Initial/Welcome Page.



If the file is password protected, you will be able to specify the password.



When importing Access tables, the Import Wizard will present the following pages/options:
The BOM File Import Wizard contains the following pages:
The Import Wizard will configure and display these pages based on the input file format and options specified during the import process.
The first page of the BOM File Import Wizard allows you to verify the import file, file format, and initial options.



You can open the file to be imported by selecting the Import File hyperlink.



The Format section will display the format that the Import Wizard has assumed for the file (based on file extensions).


When importing a Microsoft Excel file, you will be asked to select which sheet you wish to import.



You will also be able to identify if the sheet contains a column header row as the first row in the spreadsheet.



For example, if the source looked like:



You would check the First row contains field names option.

When importing a Microsoft Access database, you will be asked to select which table you wish to import.



If the file is password protected, you will be able to specify the password.



In the Options section, you can specify how the system should handle any existing data in the current BOM.



Options include:

Option Description
Append to existing BOM Preserves current BOM data and merges it with the new/imported data
Clear blank rows/columns When appending to the existing BOM, the system can clear blank rows and columns when importing
Clear existing BOM Clears all data from the current BOM and replaces

Once all options are set, click the Next button to advance to the next page.


The Import Wizard accepts delimited and columnar text/ASCII files. When importing text files, it is important to first know and understand the file's format before setting up the import options.

Delimited Text Files
Delimited files contain a single character either after or before the field data. Below is an example of a delimited file which uses a semicolon ( ; ) as the delimiting character:

#;QTY;REFDES;CORP_PARTNUM;PACKAGE;VALUE
1;1;C1;307025472;0805;4700UF
2;1;C2;306100220;;22UF
3;1;C3;310804750;CK05;4.7UF
4;1;R1;R-14-126;RES400-100;10K
5;1;R2;R-14-102;RES400-100;10
6;1;R3;R-14-152;RES400-100;1MEG


Columnar Text Files
Columnar format files are text files where the column header and value appear on the same line and delimited by a character. Individual BOM lines are delimited by a blank line (or other character line). Below is an example of a columnar file:

#=1
QTY=1
REFDES=C1
CORP_PARTNUM=307025472
PACKAGE=0805
VALUE=4700UF
 
#=2
QTY=1
REFDES=C2
CORP_PARTNUM=306100220
VALUE=22UF
 
#=3
QTY=1
REFDES=C3
CORP_PARTNUM=310804750
PACKAGE=CK05
VALUE=4.7UF


The Text Format Page provides you with a preview window, which displays the contents of the file.



On this page, you must select from the 2 different supported text file formats (Delimited or Columnar) in the Format drop list.



Once the format is selected, you can them specify the field delimiting character.



A Text Qualifier represents a character that encloses values in your text file. When Omnify encounters the text qualifier character, all of the text that follows that character and precedes the next occurrence of that character is imported as one value, even if the text contains a delimiter character. For example, if the delimiter is a comma (,) and the text qualifier is a quotation mark ("), "Dallas, Texas" would be imported into one cell as Dallas, Texas. If no qualifier or if the apostrophe (') qualifier were specified, "Dallas, Texas" would be imported into two adjacent cells as "Dallas and Texas".

You can set the Text Qualifier character in the Text Qualifier drop list



Once all text file options are set, click the Next button to advance to the next page.


The Column Header and Data Line page allows you to specify:
  • Row/line that the column names/header appears
  • Row/line that the data starts


The preview window will display all line/row numbers.



To set the Field names line, specify the row number in the Field names row text box.



If no field names are present in the file, set this value to 0



To set the row where data begins, specify the row number in the Begin reading data at row text box.



Once the header and data start row are defined, click the Next button to advance to the next page.


The Column Selection Page allows you to configure the following settings:
  • Columns to Import - Include/ignore/rename columns from import
  • Special Fields - "Wrapped" data and Hierarchy fields


Including/Ignoring Columns
You can specify which fields to import (or ignore) on the Column Selection Page of the Import Wizard. To include or ignore fields, check or uncheck the fields in the Columns to import list.



Note: you can check/uncheck multiple fields by first selecting the fields and then clicking a checkbox.





Data Preview
You can preview the data to determine column settings by clicking the Preview data hyperlink.





"Wrapped" Fields
If the Check for "wrapped" data in column: option is checked, the Import Wizard will attempt to determine if data on subsequent lines is a continuation of data from the previous row. For example, an import file contains the following format:

Item Part Number Qty
1 07-0010-00 1
0805,10UF,35V
2 25-0005-00 1
PowerQuicc 860T

Notice that in the above file, the part description appears on the subsequent lines. Setting the following options:



Would result in the following:



Hierarchy Fields
If the Check for hierarchy characters option is checked, the Import Wizard will automatically create a separate column, and define which level/position each item occurs in the BOM. For example, if you were importing a file with the following format:

Qty Part Number Refdes
5 01-100-034 U1-U5
-2 01-320-001 C1,C2
--1 01-900-078 R5
-1 01-900-064 R20

Where the dashes (-) represent the level that item appears in the hierarchy. If you set the options accordingly,



the result would be:



Once all column options are set, click the Next button to advance to the next page.


The final page of the Import Wizard provides a preview of the data to be imported. It also provides you with editing functions to modify data before importing it.



Renaming a Field
To rename a field in the Data Preview form, double-click on the field heading cell



Double-clicking on any field header cell will invoke the Column Name dialog box:



To rename the column, specify a new column name and then click the OK button.





Editing Cell Data
Within the Data Preview form you can manually edit any of the BOM cells. To edit an individual cell, click the left mouse button within the cell to select.



You can then type into the cell directly.



Notice the edit icon will appear in the row header.



You can also use the standard windows hot keys to copy, cut, paste and delete (Ctrl+C, Ctrl+X, Ctrl+V, Delete) text within the cells.

Find/Replace
The Find/Replace feature allows you to replace text in all cells of the Data Preview form. To launch the Find/Replace dialog box, click the Find/Replace button from the form toolbar.





From the Replace Characters dialog box, you can select which field (or all fields) you wish to replace text in.



You can then specify the characters/text you wish to find and the characters/text you wish to replace it with.



Splitting Columns
The Import Wizard allows you to split/expand an individual column into multiple columns. To split a column, select the Split button from the form toolbar.





From the Split Column dialog box, you will need to specify the column you wish to split and the separation characters to search for as field delimiting characters.



You can then specify a new column prefix.



OmniBOM will automatically determine the number of columns to create based on the field delimiters in each item. Each new column to be created will contain the specified prefix followed by the new column count (e.g. Desc1, Desc2, etc.).

Example: Split the Description field into individual fields based on a comma separator.

Before the split:


After the split:

Merging Columns
The Import Wizard allows you to combine/concatenate data in multiple columns into a single column. To combine columns select the Merge button from the form toolbar.



The Merge Column dialog box will list all of the current columns.



To add columns you wish to merge, select the column from the Merge Columns drop list and then click the Add button.



You can add as many columns as necessary.



You can change the data order by selecting the column(s) and using the Move Up and Move Down buttons.



You will then specify the new column name and separation character.



Optionally, you can have the system remove the merged columns by checking the Remove merged columns option.



Once the fields and separation character have been specified, click the OK button to merge the specified columns.



Example: Combine the Type, Value, Package, and Tolerance fields into a Description field.

Before the merge:


After the merge:


Removing Rows
You can remove rows from the Data Preview form by first selecting the rows, and then clicking the Delete Selected Rows toolbar button.



When you have completed all edits and are satisfied with the data, click the Finish button to import the data.