Data Management Capabilities > Using Excel to Export and Import Product Data > About Importing Product Data from Excel > About Importing Redline Product Data from Excel > Considerations for Importing Redline Product Data > Considerations for Importing Redline Product Structures or BOMs > File Format for Importing Redline Product Structures or BOMs
File Format for Importing Redline Product Structures or BOMs
The following table describes the format of data in a redline product structure or BOM import worksheet. It defines the column header, whether the column is required, and the description of the data that can be entered for each column.
* 
In a spreadsheet, all discrete values (a value that must be one of few fixed values) must be entered as an internal value, not the display value. For example, for the Default Unit attribute, use as_needed (internal), not As Needed (display).
Column Name
Required
Editable on Reimport
Description
Action
Yes
Yes (for deleting)
Includes Add or Delete.
Level
Yes
Yes
The level of a component in the redline structure hierarchy.
For example, if a root part, part_1 with an open redline had child parts with open redline versions, part_2 and part_3 , and part_3 had a child part_4 as part master, then the level for each part is specified as follows:
• for part_1, level is 0
• for part_2, level is 1
• for part_3, level is 1
• for part_4, level is 2
* 
If you do not have the parent part with an open redline at Level 0, the Preview step in the Import from Redline Spreadsheet window does not display anything.
Number
Yes
No
The part number.
OrganizationID
No
No
The owning organization for the change notice. The default value is the organization from the owning container. If not available, the value is the organization of the change notice.
* 
Organization ID is required if you want to import parts that do not belong to the target organization.
Container
No
No
The default value of the container from where import was launched.
The following example shows the full path to the container:
/wt.inf.container.OrgContainer=PTC/wt.pdmlink.PDMLinkProduct=Test_Product
where PTC is the name of the organization and the Test_Product is the name of the product.
Revision
No
Yes
Specifies which revision or redline revision of the part is getting updated.
* 
When the column is omitted or a value is not defined for it, the redline version is used as a value for a part master that exists with an open redline on the change.
View
No
Yes
Specifies which view of the redline structure is getting updated. Enter Design or Manufacturing. If you have created a customized view using the View Administrator, it can also be listed as the value.
* 
When the column is omitted or a value is not defined for it, the value is empty for a part master that exists with an open redline on the change.
Trace Code
No
Yes
The trace code value on the part usage link. Use the following values:
• untraced: 0
• serial number: S
• lot number: L
• lot/serial number: X
Quantity
No
Yes
Defines the number of parts in the assembly. The default value is 1.
* 
When the column is omitted or a value is not defined for it, the value is 1 for new part usage links.
For existing usage links, the value carried forward is used.
Unit of Measure
No
Yes
Quantity unit for the parts in the assembly. The default value is ea. Other possible values are as follows:
• as needed: as_needed
• kilograms: kg
• meters: m
• liters: l
• square meters: sq_m
• cubic meters: cu_m
* 
When the column is omitted or a value is not defined for it, the value is ea for new part usage links.
For existing usage links, the value carried forward is used.
Reference Designators
No
Yes (but it must be unique)
Reference designators specified using shorthand format (for example: R1, R3, or R1-R10).
Use the following syntax rules for specifying reference designators:
• A reference designator consists of an alphanumeric string prefix, followed by a numeric integer suffix. For example: R57, PS1, A66A2.
• The first and last characters in the prefix must be alpha characters. For example: R1, RAX3, R4X5.
• Use a comma to separate sequences of reference designators. For example, R1, R2, R7.
• Reference designators can be specified as a sequence and as a range. For example: R1-R7, R10, R12.
Component Reference
No
Alias for the component.
Quantity Option (for configurable parts)
No
Yes
Integer value parameter in the parent generic part's logic base that controls the quantity of this component.
* 
When the column is omitted or a value is not defined for it, the value is the same as Quantity for new part usage links.
For existing usage links, the value carried forward is used.
Inclusion Option (for configurable parts)
No
Yes
Boolean value parameter in the parent generic part's logic base that controls the inclusion or exclusion of this component.
Type
No
No
Part usage link type WCTYPE|wt.part.WTPartUsageLink, which is the default value.
* 
When the column is omitted or a value is not defined for it, the value is WCTYPE|wt.part.WTPartUsageLink for new part usage links.
For existing usage links, the value carried forward is used.
Line Number
No
Yes
Identifies the line number of a part within a manufacturing bill of materials. Also known as position numbers that are used with Enterprise Resource Planning systems.
Find Number
No
Yes
Represents the location of the part within the assembly drawing.
Component Id
No
No (for an existing usage link)
An alphanumeric key representing an existing usage link. Each of the usage links specified has a unique alphanumeric key.
The value is empty for a new usage link.
IBAs (soft attributes supported by the spreadsheet)
No
Yes
Attribute constraints and relationship constraints.
Was this helpful?