Engineering BOM Management – Usage > Configure structures
Author variant formula in the editor
Author variant formula in the editor You can author variant formula by typing the formula in the text editor. This is recommended only for complex formula or combinations that cannot be selected on the grid. You can also author variant formula by selecting features from the grid. This is the recommended method. In the Variant Formula Editor, you can author complex variant conditions that cannot be authored in the grid. This view is used by expert users who want to write the expression directly in the editor. When you save such a variant condition, it is not available in the grid. Procedure Find and open the product for which you want to author variant formula. Select the BOM lines for which you want to apply variant conditions and click the Variant Conditions tab. The BOM lines you selected are displayed as columns at the top. You can hover over the column header to view the complete name of the BOM line. (Optional) Enable Variant Formula column in your work area, if it is not available. This column displays the variant formula for each BOM line, and you can edit this in the grid. In your work area, click Settings . Click Arrange and search for the Variant Formula column. Select the Variant Formula column and click Move up to bring it to the top of the Arrange panel. Select one of the BOM lines, click on the top of the column, and click Show Variant Formula Editor. Even if you select multiple BOM lines in the Variant Conditions view, you can edit only one BOM line at a time. To edit the variant condition, in the VARIANT FORMULA EDITOR, click Start Edit . Click inside the box to start creating your formula. The Intellisense autocompletion feature is turned on by default. When it is turned on, you can get suggestions by pressing either Ctrl + space bar or space bar and then make a selection. After making the selection, press the space bar again to get the appropriate logical operators. Continue to create a complete formula and click Validate Syntax to validate the syntax of the formula you have created manually. Example: ExteriorColor = NeptuneBlue When the autocompletion feature is turned on, the system honors the name or the ID as the primary business attribute depending on how the attribute is set at your site by your administrator. This means that if name is set as the primary attribute, you must type the name in the formula editor and not the ID to complete the formula. Additionally, the administrator at your site can set the visibility of option families and the display of family namespace. By default, option families are visible, and the family namespace is not displayed. In such cases, you can type the option families in the formula editor, but not the family namespace to complete the formula. The system honors the configurations set by the administrator and makes suggestions based on these configurations. Consult the administrator at your site for more information. Note If you have families or features with identical names in the configurator context, they create ambiguity when creating an expression in the formula editor. In such cases, you should use the object IDs instead of the names to create the expressions. In case the object IDs are also identical, then contact your administrator to enable the necessary preferences, allowing you to create the expression by prefixing the namespace. When you type the suggestions, the system performs validations for each suggestion when the feature is turned on. However, when the feature is turned off, the system does not perform any validation. When the autocompletion feature is turned off, you must author the formula using the internal Teamcenter formula format. You can also use custom formula in the formula editor. By default, custom formula is not enabled. Consult your administrator to enable it. Make the required changes to the variant formula for the selected BOM line. The formula displayed in the Variant Formula column is the display formula whereas it is an internal formula for the editor. The server converts the internal formula to the display formula. Examples where the logical operators are different: Variant Formula column Formula in editor Engine = V4 OR Engine =V8 (Engine = V4 | Engine =V8) Music Player = Radio AND Music Player = CD Player (Music Player = Radio & Music Player = CD Player) Click Save Edits . The system validates the expression syntax only after you save the changes. If you specify a wrong formula in the editor and click Save Edits, the system displays a syntax error or invalid error as appropriate. You cannot save the changes if they are invalid. (Optional) To validate the expression against the constraints associated with the configurator context, after saving multiple changes, click Validate All on the top of the grid. Examples The following are some examples of the differences when selections are made for single select and multiselect families. Open a structure, select a BOM line, and make selections in the Variant Conditions tab as follows. Additionally, select the BOM line, click on the top of the column, and click Show Variant Formula Editor. In a multiselect family, feature selections are connected using AND. Example: In a single select family, feature selections are connected using OR. Example: Feature selections from different families are connected using AND in the same column. Example: For split columns, the expression generated by feature selections across columns are connected using OR. Example: Engineering BOM Management ─ Usage, 2606 Unpublished work. © 2026 Siemens
Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/ebom_usage/fzf1737238794128/lsw1737238797048/xid2305950.html · retrieved 2026-07-11