Structure Management ─ Deployment and Administration
Configure modular variants through preferences
Configure modular variants by setting the following preferences. PSEVariantsMode Determines if the modular variants functionality is used. Allowed values are: modular Use only the modular variants functionality. Users cannot view, edit, or configure legacy variants. hybrid Allows users to define modules in structures containing legacy variant data. legacy Use only legacy variants functionality. The default setting is PSEVariantsMode=hybrid. In addition to enabling the modular variants functionality, the default setting allows users to display, edit, and configure legacy variants, but with the modular variants dialog boxes. Legacy variants do not provide all of the advantages of encapsulation that modular variants enforce. Consequently, Siemens Digital Industries Software recommends you use this setting during migration from legacy variants to modular variants. Once migration is complete, you change the preference setting to modular. PSM_global_option_item_ids Set this preference to a list of all item identifiers that contain global option definitions. The default is an empty list. These definitions can be reused when authoring variant modules. For example: PSM_global_option_item_ids= 000400 000410 000420 To implement this functionality: Create an item to store the global options. Create the desired global options and allowed values. Update the PSM_global_option_item_ids preference to include the new item identifier. In Structure Manager, display the Create Option dialog box and verify the new item and options are shown in the Based On drop-down list. PSESavedConfigRelationTypes When saving a selected option set or variant configuration, the user can choose whether to save to the Home folder, the Newstuff folder or to the module (item revision) being configured. Use this preference to set the possible relation types from which the user can select when saving to a module. The default setting is: PSESavedConfigRelationTypes= TC_specification TC_manifestation TC_relation ShowModuleIcons By default, the icons of the modular variants feature are hidden because their availability affects performance. If you use modular variants, make the icons visible by setting this preference to true. PSEAllowLegacyVICreation Set this preference to true to permit the creation of variant items for structures that include classic variant options. It also permits the creation of variant items from assemblies that are not modules. The default setting is false. PSEBypassVISearch Set this preference to true to add a Create button to the Configure dialog box as soon as the user sets a value for each option. This allows the user to bypass the requirement to search for similar variant item configurations before creating a new variant item. The default setting is false. PSECreateVISameType If you set this preference to true, Teamcenter always creates a variant item with the same type as its parent and creates the variant item with a Save As action. The default setting is false. PSEShowUnconfigdVarPref Determines whether structure lines with variant conditions that do not configure for the current variant rule are shown by default in a new Structure Manager window. The preference affects classic variants as well as modular variants. If a structure line is shown even though its variant condition evaluates to false for the current variant rule, you can use the following properties to identify the lines that do not configure for the current variant rule: Copy bl_is_variant=Y bl_variant_state= PSEIsNewVILinkedToModule Determines if variant items are linked to the generic item by default. If it is set to false, they are not linked to the generic item. The default value of this preference is true.
Source: https://docs.sw.siemens.com/documentation/external/PL20251212545240207/en-US/tc_help/administering_product_structures/rsl1737253431475/sysadmin_config_modvars.html · retrieved 2026-07-11