Bommer uses "builtins" to expose values it computes (such as quantity), values that are used to set part visibility and inclusion, and values pulled from the Fusion 360 (such as part name or mass properties) as properties in your bill of materials (for more information about how to use builtins, click here).
Some builtin properties are editable, which allows Bommer users to change built-in values in Fusion 360 by editing their Bommer bill of materials. Other values are read-only; in these cases, if you want an overridable value, we suggest you use the Settings command to create a new property with a type other than builtin and set the builtin property as the default for the new property. Click here for more information on how to set this up.
The following builtin values are available for use (grouped according to their function):
Bommer values and controls
Body Quantity
A count of the bodies contained within the component represented by a bill of materials line item. Used in conjunction with the Count Bodies? property, this can be used to extract accurate quantities for subassemblies modeled as a part with multiple copies of the same body.
Count Bodies?
Whether or not the Quantity property should represent the count of components or the count of bodies contained across copies of that component. In some large-assembly use cases, modeling hardware, brackets, or other simple, repeated parts as bodies underneath one component can be more efficient.
Exclude?
Whether or not a component is excluded from the bill of materials. This works differently for parts and subassemblies; click here to learn more. Combined with Part?, this can be used to control the visibility of components in your bill of materials.
Item Number
An item number for each row in the bill of materials. In a hierarchical bill of materials, this will be formatted as "x.y.z", e.g. "1.1.2" is the second component of the first sub-subassembly of the first subassembly in the design. This property is read-only, and the root component item number is always empty.
Quantity
The computed quantity of the line item in the bill of materials. This is influenced by the Count Bodies? property and is either the count of the components within the scope of that line item (see Raw Quantity) or a count of the bodies contained in the components within the scope of the line item (see Body Quantity). This is read-only.
Part?
Whether or not a component's subcomponents are excluded from the bill of materials. This value influences how Bommer walks the feature tree to build the bill of materials; it stops traversing down any branch when it hits a component where Part? is true. Practically, this can be used to denote purchased subassemblies (e.g. a motor with one vendor SKU, but with all of its internal parts modeled as components). Click here to learn more about how this property works. Combined with Exclude?, this can be used to control the visibility of components in your bill of materials.
Level
The level (or depth) of a line item relative to the root. The root is always level 0, top-level components are level one, etc. This corresponds to the number of sections ("."s) in the Item Number value. This is read-only.
Raw Quantity
The raw quantity of the component represented by a bill of materials line item, as counted by Bommer. For hierarchical BOMs, this quantity represents the count of this component within its parent assembly; for flattened BOMs, this quantity represents the count of this component across the entire top-level assembly. This is read-only.
Parent Row Number
The absolute 1-based row number of the hierarchical parent line item to this line item in the bill of materials. This will be blank for the root row. This is read-only.
Row Number
The absolute 1-based row number of the line item in the bill of materials. The root row will always be row #1, and this is not influenced by BOM hierarchy or arrangement. This is read-only.
Thumbnail
A thumbnail image representing a small isolated screenshot of the part or subassembly. Bommer will automatically frame and capture these images, though at the time they are only visible in Excel spreadsheet exports. This is read-only.
Document properties
Document Version
The version of the document that contains this component. This is the same version that appears in the Fusion 360 data panel and on A360. This is read-only.
Reference?
A flag used to determine if this component is a linked or cross-referenced component or a component contained within the top-level design. This is read-only.
Fusion 360 properties
Description
The description of the part, subassembly, or top-level design, pulled from Fusion 360. As in the built-in Fusion properties command, editing this property in Bommer will change the Fusion 360 description for the component in Fusion 360. When editing this property on linked components, you must push your changes before they will be reflected in Fusion 360 (click here for more information).
Part Name
The name of the part, subassembly, or top-level design, pulled from Fusion 360. As in the built-in Fusion properties command, editing this property in Bommer will change the name of the component in Fusion 360 for all components except the top level of a design (which must be renamed in the Fusion 360 data panel). When editing this property on linked components, you must push your changes before they will be reflected in Fusion 360 (click here for more information).
Part Number
The part number of the part, subassembly, or top-level design, pulled from Fusion 360. As in the built-in Fusion properties command, editing this property in Bommer will change the Fusion 360 part number for the component in Fusion 360. When editing this property on linked components, you must push your changes before they will be reflected in Fusion 360 (click here for more information).
Physical properties
Physical properties represent information such as mass, volume, dimensions, and other physical attributes of the part or subassembly. Because they typically take a long time to compute, they are considered long load time properties, which means that, by default, they are not shown in the Edit bill of materials or Edit part properties commands. This can be configured in the Settings command; click here to learn how.
Area, Density, Mass, Volume
The four physical properties of a component, as pulled from Fusion 360 physical properties, and scaled to the units of the top-level design. These properties are read-only.
Appearance Properties
Properties that are pulled from the "common" appearance for a component, as stored in the Fusion 360 appearance library. These properties are read-only. The common appearance will be the material shared by all bodies and subcomponents within a component. If no common appearance is found, these properties will return (Various), similar to Fusion 360's properties page. See Fusion 360's Materials help page for information about appearances and how to edit and update your appearance property values.
Appearance
Displays the name of the component's currently selected appearance.
Material Properties
Properties that are pulled from the "common" physical material for a component, as stored in the Fusion 360 material library. These properties are read-only. The common material will be the material shared by all bodies and subcomponents within a component. If no common material is found, these properties will return (Various), similar to Fusion 360's properties page. See Fusion 360's Materials help page for information about materials and how to edit and update your material property values.
Material
Displays the name of the component's currently selected material.
Material Type
Displays the "Type" field located in the Material Editor for the currently selected material. Example values include Plastic, Metal, Glass, etc.
Material Comments
Displays the "Comment" field located in the Material Editor for the currently selected material.
Material Keywords
Displays the "Keywords" field located in the Material Editor for the currently selected material.
Material Manufacturer
Displays the "Manufacturer" field located in the Material Editor for the currently selected material.
Material Model
Displays the "Model" field located in the Material Editor for the currently selected material.
Material Cost
Displays the "Cost" field located in the Material Editor for the currently selected material.
Material URL
Displays the "URL" field located in the Material Editor for the currently selected material.
Longest Dimension, Middle Dimension, Shortest Dimension
The ordered components of the 3-dimensional tight bounding box around a component's bodies and aligned to the coordinate system of the component. These three properties can be used to compute cut lists for tubes, boards, and other parts cut from stock in your design. Click here to learn more about how this is computed.
X-Axis Dimension, Y-Axis Dimension, Z-Axis Dimension
The axis-aligned lengths of the 3-dimensional tight bounding box around a component's bodies and aligned to the coordinate system of the component. Similar to the above dimensions, these properties can be used to compute cut lists for tubes, boards, and other parts cut from stock in your design; in some workflows, "longest" does not always mean the cut length (e.g. cutting a 2" square tube to 1.5" for a frame part), so some users find better results in using these dimensions, and always modeling cut parts so that cut length in one of these 3 directions. Click here to learn more about how this is computed.
Sheet Metal Properties
Sheet Metal Thickness
Returns the thickness of the selected sheet metal component in the units specified in the sheet metal rule. This is different from most of the measurement built-in properties, in that units for sheet metal thickness are not converted to the units of the top level assembly. To avoid confusion, the unit string is printed as part of the property value.
Is Sheet Metal?
Will return True if a particular component is indeed a sheet metal part. Thing to note is that if this is Not True then sheet metal thickness will be reported as 0.0.
Flat Pattern Properties
Length, Width, and Thickness
Returns the Length, Width and Thickness of a component’s flat pattern (if one exists) in the units of the top level assembly. These are the bounding box dimensions of your sheet metal flat pattern. Length, width, and thickness are determined by looking at the X, Y, and Z dimensions in descending order: the longest will be Length, the middle will be width, and the shortest will be thickness. Note that the thickness here is scaled to the unit system of the assembly, whereas Sheet Metal Thickness uses the units from the sheet metal rule. Also note that because of this, it is possible to construct a part where the flat pattern thickness is different than the sheet metal thickness. If you routinely design sheet metal parts where your sheet metal rule uses different units than your design, or where the the pattern length or width are smaller than the thickness of your stock, you may want to use the Sheet Metal Thickness property instead.
Has Flat Pattern
Will return true if your component is marked as a flat pattern component. If this returns Not True then your Length, Width, and Thickness will return 0.0.
Partial Moments of Inertia
The partial moments of inertia, also called the inertia tensor matrix, are calculated around the origin of the component. These values are computed using the body position within a component but don’t consider account assembly placement or rotation. As a result, they will be the same for a part when it is alone or used in an assembly. To get accurate results, make sure to model your parts centered on the component’s 3D origin.
Component Partial Moment of Inertia (Ixx), (Iyy), (Izz), (Ixy), (Iyz), (Ixz)
The inertia tensor members for the component. These values are represented in 6 built-in property values that all start with Component Partial Moment of Intertia, and then display the inertia tensor matrix element in parentheses.
Comments
0 comments
Please sign in to leave a comment.