step_export

Exports Teamcenter data from the database to STEP-compliant physical files. There are two ways to use this utility: single-line and batch mode. The single-line method uses the -item=item-id argument and other optional arguments to export one object at a time; batch mode uses the -i=input-file argument and an input file to export several objects at once. Syntax step_export [-u=user-id {-p=password | -pf=password-file} -g=group] {-i=input-file | [-item=item-id | -key=[keyAttr1=keyVal1] [,keyAttr2=keyVal2]…[,keyAttrN=keyValN]] [-item_rev=item-rev-id] [-ds=dataset] [-rel=relation-name]} -fmt=AP203 | AP214 | IMAN [-full_assembly] [-all_ds_versions] [-f=file-name] [-cmt=comments] [-h] [-v] 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. -i Specifies the input file containing the list of objects to export. The complete path name must be provided. -item Specifies the item ID of the item being exported. -item_rev Specifies the item rev ID of the item revision being exported. -ds Specifies the dataset being exported. -rel Specifies the name of the Teamcenter relation containing the dataset. -key Specifies the keys of the items to export. Use the following format: Copy [keyAttr1=keyVal1] [,keyAttr2=keyVal2]…[,keyAttrN=keyValN] To find the key of an object, use the get_key_string utility. For more information, see BMIDE for Data Model Design. -fmt Specifies the data output format: AP203, AP214, or IMAN. -full_assembly Specifies that the full assembly, including product structure and all component parts that constitute the assembly, are exported. -all_ds_versions Specifies that all version of the datasets are included in the export. -f Specifies the output file name. The complete file specification (full path and file name) must be supplied unless the desired location is the current working directory. -cmt Describes the data being exported. This comment is placed in the file_description section of the output file. -v Runs utility in verbose mode, displaying maximum amount of information. Typically, nonverbose utility sessions only display error messages. -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 and the following: Copy $ROSE_DB/*.rose .rose files are STEP schema files used by the STEP Translator. The step_export utility must be able to write these files in this directory. Restrictions Either the -item=item-id or the -i=input-file argument must be supplied. Examples To export several objects in batch mode (using an input file), perform the following: Create an input file and add one line for each object you want to export in the following format: Note Ensure that you separate each argument with a semicolon (;) and put each object on its own line. Copy -item=item-id;-item_rev=item-rev-id;-ds=dataset;-rel=relation-name -item=item-id;-item_rev=item-rev-id;-ds=dataset;-rel=relation-name Run the step_export utility using the -i=input-file argument: Copy $TC_ROOT/bin/step_export -u=Tc-admin-user -p=password -g=group -i=input-file Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration