ps_exportconfignxassembly

Enables a site to export a configured NX assembly. The assembly is configured using the given revision rule and saved variant rule. Syntax ps_exportconfignxassembly [-u=user-id -p=password | -pf=password-file -g=group] -item=top-item-id | -key=keyAttr1=keyVal1 [,keyAttr2=keyVal2]…[,keyAttrN=keyValN] -rev=top-rev-id [-revrule=revision-rule] -variant=saved-variant-rule [-scopeitem=item-id] [-scoperev=rev-id] [-display] [-verbose=y | yes | n |no]] [-exclude=itemid1,itemid2,itemiid3,... | -excludekeys=keyAttr1=keyVal1 [,keyAttr2=keyVal2]…[,keyAttrN=keyValN]; keyAttr1=keyVal1 [,keyAttr2=keyVal2]…[,keyAttrN=keyValN];...] [-h] Arguments -u Specifies the user ID. This is a required argument unless the TC_auto_login site preference is set. 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 is a required argument unless the TC_auto_login site preference is set. 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. This is a required argument unless the TC_auto_login site preference is set. If used without a value, the user's default group is assumed. -item Specifies the item ID of the item to be exported. This argument is required unless -key is defined. If both -item and -key are defined, -key takes precedence. -key Specifies the key of the item to be exported. This argument is required unless -item is defined. If both -item and -key are defined, -key takes precedence. 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. -rev Specifies the revision ID of the top line of the structure to be exported. This argument is optional. If specified, the rest of the structure below the top line is configured by the -revrule argument. If not specified, the entire exported structure is configured by the -revrule argument. -revrule Specifies the revision rule to use to configure the structure. This argument is required. -variant Specifies the name of the variant rule to apply to configure the structure. This argument is required. -scopeitem This is an optional argument. Include this argument if and only if the given variant rule is not attached to the exporting item (top item) but is attached to this scope item’s revision. The item revision is specified in the scoperev argument. -scoperev This is an optional argument. Include this argument if and only if the given variant rule is not attached to the exporting item (top item) but is attached to this scoperev. -display Displays the output folder to the screen. This argument is optional. If this argument is not specified, the output folder is not displayed at the end of the successful operation. -verbose Prints the debug statement. This argument is optional. The default value is n. -exclude Specifies the list of item IDs to exclude from exporting after the structure is configured using the revision rule and saved variant rule. This argument is optional. -excludekeys Specifies the list of keys to exclude from exporting after the structure is configured using the revision rule and saved variant rule. This argument is optional. -h Displays help for this utility. Environment NX must be installed and configured. As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions The files are created in the folder specified by the TC_TMP_DIR variable. The value of TC_TMP_DIR must be set to the desired destination directory temporarily before running the utility. Examples Exports TopAssmRevA after configuring the structure below the top line with the Latest Working revision rule and Tire200 saved variant rule. SubAssm1 is excluded from the export even though it was configured. Copy ps_exportconfignxassembly -u=Tc-admin-user -p=password -g=group -item=TopAssm1 -rev =TopAssmRevA -revrule=Latest Working -variant=Tire200 -display -verbose=y -exclude=SubAssm1 Exports TopAssmRevA after configuring the structure below the top line with the Latest Working revision rule and Tire200 saved variant rule. There is no exclusion list provided in this example. Copy ps_exportconfignxassembly -u=Tc-admin-user -p=password -g=group -item=TopAssm1 -rev =TopAssmRevA -revrule=Latest Working -variant=Tire200 -display -verbose=n Exports SubAssmRevA after configuring the structure below the top line with the Latest Working revision rule and Tire200 saved variant rule. The saved variant rule is attached to TopAssmRevA. Copy ps_exportconfignxassembly -u=Tc-admin-user -p=password -g=group -item=SubAssm1 -rev =SubAssmRevA -revrule=Latest Working -variant=Tire200 -scopeitem=TopAssm1 -scoprev=TopAssmRevA Exports revision A of the item with key of CarModel. The structure below the top line is configured with the Latest Working revision rule and Car1 saved variant rule. Copy ps_exportconfignxassembly -u=xxx -p=yyy -key=item_id=CarModel -rev=A -revrule="Latest Working" -variant=Car1 -verbose=y Related Topics Structure Management on Rich Client ─ Usage