Including Design Data in an Excel-format Bill of Materials (BOM)

Design data can be passed from Altium Designer into an Excel Bill Of Materials by including special statements in the Excel template used to create the BOM.

When creating the Bill of Materials template in Excel, a combination of Fields and Columns can be used to specify the desired layout. Several example templates are provided with Altium Designer in the \Templates folder of the installation user-files. A full list of available fields is provided below.

Fields

Fields provide project-level information. These are not usually attached to each item in the BOM, but are often used in the header of the document. Fields are used in the format Field=FieldName (e.g., Field=Currency). The available fields are:

• Currency
• DataSourceFileName
• DataSourceFullPath
• GeneratorDescription
• GeneratorName
• OutputName
• OutputType
• ProductionQuantity
• ProjectFileName
• ProjectFullPath
• ReportDate
• ReportDateTime
• ReportTime
• Title
• TotalQuantity
• VariantName

Columns

Columns provide information that is supplied on a per-component basis, and would usually appear on each line in the BOM. Columns are used in the format Column=ColumnName (e.g., Column=Description). Column information can be taken from several sources, including:

• Default component parameters (such as Designator or Description).
• User-defined parameters added to components.
• PCB data.
• Supplier data.

These are discussed separately below.

Default Parameters

The following columns are provided for all components:

• Comment
• ComponentKind
• Description
• Designator
• DesignItemId
• Footprint
• LibRef
• LogicalDesignator
• PartType
• PhysicalPath
• Quantity
• UniqueIdName
• UniqueIdPath  

Document Parameters

The following document parameters are available for all components by default. They are obtained from the schematic document that contains the component.

• Address1
• Address2
• Address3
• Address4
• ApprovedBy
• Author
• CheckedBy
• CompanyName
• ConfigurationParameters
• CurrentDate
• CurrentTimeDate
• DocumentFullPathAndName
• DocumentName
• DocumentNumber
• DrawnBy
• Engineer
• ImagePath Index
• ModifiedDate
• Organization
• Revision
• Rule
• SheetNumber
• SheetTotal Time

PCB Parameters

Pick and Place information can also be included from the PCB. In order to use these columns, the checkbox Include Parameters From PCB must be enabled in the Bill Of Materials Report Manager dialog.

• Center-X(Mil)
• Center-X(mm)
• Center-Y(Mil)
• Center-Y(mm)
• Layer Pad-X(Mil)
• Pad-X(mm)
• Pad-Y(Mil)
• Pad-Y(mm)
• Ref-X(Mil)
• Ref-X(mm)
• Ref-Y(Mil)
• Ref-Y(mm)
• Rotation

Supplier Data

In Altium Designer, it is possible to retrieve online data from suppliers and feed that into the BOM. Note that these are updated live and are retrieved when the BOM is generated. Multiple suppliers can be set up for each component. 

• Manufacturer x
• Manufacturer Part Number x
• Supplier x
• Supplier Currency x
• Supplier Order Qty x
• Supplier Part Number x
• Supplier Stock x
• Supplier Subtotal x
• Supplier Unit Price x

Custom Parameters

Additional information also can be imported from a database library or from parameters added to components by the user. In these cases, simply use the parameter name as the column name.