Version Control / BOM Compare Completed Sign In To Save Your Progress
Click if you find this content useful
Version Control

BOM Compare

A BOM Compare report is available in Altium Designer and Altium 365's Web Viewer interface (see BOM Compare in Altium 365 Web Viewer) for projects that include a BOM document (*.BomDoc). The BOM Compare report displays the changes between the current design and the selected released revision.

To generate a BOM Compare report in Altium Designer:

To compare two versions of a BOM, click Reports » BOM Compare. Configure the report as needed, then click Export.

Fig. 1 - BOM Compare from an ActiveBOM BomDoc
Fig. 1 - BOM Compare from an ActiveBOM BomDoc

From an Output Job (Settings » Output Job Files), right-click on [Add New Report Output] under the Report Outputs entry, then choose BOM Compare. To configure the report, right-click on the newly added BOM Compare entry, then choose Configure to open the BOM Compare version of the Report Manager dialog. Configure the report as needed, then click Export. You also can select the desired output container and then generate the report.

Fig. 2 - BOM Compare from an ActiveBOM BomDoc
Fig. 2 - BOM Compare from an ActiveBOM BomDoc

Click here to see the options and controls in the BOM Compare version of the Report Manager dialog.

Fig. 3 - Report Manager dialog
Fig. 3 - Report Manager dialog
Fig. 4 - BOM Compare report generated as a PDF outjob
Fig. 4 - BOM Compare report generated as a PDF outjob

The below figure depicts the History & Version Control menu. BOM compare results will be visible in Altium 365 Web Viewer.

Fig. 5 - BOM Compare report generated from History & Version Control menu
Fig. 5 - BOM Compare report generated from History & Version Control menu

The below figure depicts the File History document. BOM compare results will be visible in Altium 365 Web Viewer.

Fig. 6 - BOM Compare report generated from the File History menu
Fig. 6 - BOM Compare report generated from the File History menu

To use BOM Compare in Altium 365 Web Viewer:

You can compare two revisions of a BOM by selecting any commit or release. This can be accessed through Releases or Project History.

Fig. 1 - Support for BOM Compare in Project History.
Fig. 1 - Support for BOM Compare in Project History.
Fig. 2 - Support for BOM Compare in Releases.
Fig. 2 - Support for BOM Compare in Releases.

You will receive an email when performing a BOM comparison. When you see this screen, you can wait for the process to complete or close the page:

Fig. 3 - “Comparison in progress” screen
Fig. 3 - “Comparison in progress” screen

The email will be sent out as soon as the process is complete. After that, you can access the comparison by clicking the “Open in Altium 365” link:

Fig. 4 - Email from Altium’s notifications service, as received by the supplied user email address, informing the user that the process is complete.
Fig. 4 - Email from Altium’s notifications service, as received by the supplied user email address, informing the user that the process is complete.

When you open the BOM comparison, Altium 365 will automatically open (in your browser) the screen shown in Fig. 5. You can see the BOM Compare screen at a glance:

Fig. 5 - BOM Compare screen in Altium 365 Web Viewer
Fig. 5 - BOM Compare screen in Altium 365 Web Viewer

The dashboard contains the following elements:

List of Changes: View a list of changes to the BOM. This details parts and components added, modified (and not modified), or removed. Choose which changes you want to see: Check the components you do want to see on the dashboard. Uncheck the components you don't want to see on the dashboard.

Columns in BOM: This region presents the various properties/parameters for all components in the source document(s). Each property/parameter has its column. The designer simply chooses which data to include in the generated BOM report.

BOM Compare Tabs: You can compare the BOM from one revision with the BOM of another revision to see what has changed between revisions. You can quickly switch between the old BOM, the new BOM, and the comparison screen.

Icons: The three header icons are separated from the icons for search (in any column), download delta BOM (in CSV file), and switch to full-screen mode.

When you open BOM Compare, you will see the Differences panel on the left. Every item that has been added, modified, or removed is color-coded in the BOM.

Fig. 6 - BOM Compare color code
Fig. 6 - BOM Compare color code

The list of changes displays the differences found in the BOM comparison. This panel allows you to choose the differences you want to see on the screen and review the BOM report to evaluate which column those modifications occurred in.

By default, the Compare tab is visible with the list of differences:

  • Red: BOM Item removed
  • Yellow: BOM Item modified (in the screenshot, you can see that the modified parameter is in yellow)
  • Green: BOM Item added

Also, you can easily switch to the original BOMs via Tabs.

Note: Menu items should be active for managed design with an ActiveBOM document.

Click the ib icon at the top of the screen to configure the columns that should be visible in delta BOM. The default column list is:

  • Line number
  • Name
  • Description
  • Designator
  • Manufacturer Part Number 1
  • Price
  • Qty

You can download the delta BOM list in .csv format; click the iv Download: BOM Difference icon. Any included files will show details of BOM data that has changed (been updated) between the specified project releases.

Fig. 7 - The downloaded BOM comparison CSV files

The Select columns dialog is used to choose which columns to show or hide in the delta BOM:

Fig. 8 - Select columns to show in delta BOM
Fig. 8 - Select columns to show in delta BOM

 

Good job! Article is now completed!
Sign In To Save Your Progress

Read Again

article Previous
article Next
CAPTCHA
Was this article useful?
Yes No
Thank you Glad to hear it