BuildForge Help

.bom

.bom addcategory "<Category Name>"
.bom setcolumn "<Category Name>" "<SectId>" "<Column>" "<Column>" "<Column>"
.bom data <Category Name>" "<SectId>" "<Column=Value>" "<Column=Value>" "<Column=Value>"
The .bom command adds data to the Bill of Materials (BOM) for a build. With it, you can add categories, sections, and rows and columns of data.
Categories
A category is a visible and expandable header within the BOM. It contains a table of data.
Sections
A section is a logical grouping of rows within a category. Section names are not displayed, but the system prints a new set of column headers to mark each section.

The command has three options:

As with other dot commands, you can use environment variables in the command. A command like
.bom data "Spaceships" "${SECTION}" "ShipName=${NAME}" "WarpSpeed=${SPEED}" "Tonnage=${TONNAGE}"
populates the BOM with data loaded into environment variables by earlier commands.
You can create any number of columns, but the system does not write a line to the BOM until the last column is populated. Also, if you omit a column from a data line, the system uses the value from the previous row. Using the Spaceships example, if you added a line
.bom data "Spaceships" "Section1" "ShipName=Freighter" "Tonnage=20000"
the system would repeat the WarpSpeed value, giving rows like these:
ShipName      WarpSpeed   Tonnage
SpaceShipOne      9        10000
Freighter         9       20000