rdv_set_default_variant_condition

Checks whether the input item has any qualified occurrences attached to it and sets a default variant condition on them so that the occurrence can participate in variant configuration. This utility configures the structure using the revision rule provided as input. If the revision rule is not specified, it uses the default revision rule. This utility also sets the variant condition specified as input. If the variant condition is not specified then it uses the variant condition specified in the RDV_default_variant_condition preference. Syntax rdv_set_default_variant_condition [-u=user-id {-p=password | -pf=password-file} -g=group] [-item=item-ID | -key=key-ID] [-revision_rule=revision-rule-name] -variant_condition=condition-name -delimiter=delimiter-string -qualified_occu_scan_depth=depth -h Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. Note If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. For more information about managing password files, see Manage password files. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user's default group is assumed. -item Specifies the ID of the item to be used for the variant condition. -key Specifies a string used to identify an item instead of specifying an item using the -item argument. To find the key of an object, use the get_key_string utility. For more information, see Introduction to multifield keys in BMIDE for Data Model Design. -revision_rule Specifies a named revision rule. Defaults to the site default, frequently the latest working revision. -variant_condition (Optional) Specifies the variant condition. -delimiter (Optional) Specifies the delimiter to place between records. -qualified_occu_scan_depth (Optional) Specifies the level to scan occurrences. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples The following example configures the structure using default revision rule, scans the item for null variant components, and sets the default variant condition specified in preference files: Copy rdv_set_default_variant_condition -item_id=TL109375 The following example configures the structure using the latest working revision rule, scans the item for null variant components, and sets the default variant condition specified in preference files: Copy rdv_set_default_variant_condition -item_id=TL109375 -revision_rule=Latest Working The following example configures the structure using the latest working revision rule, scans the item for null variant components, and sets the variant data (Color=Red) on null variant components: Copy rdv_set_default_variant_condition -item_id=TL109375 -revision_rule=Latest Working -variant_condition=002763:Color:Red Related Topics Structure Management on Rich Client ─ Usage