item_import

Imports multiple items (in batch mode) into the Teamcenter database. It is the companion to the item_export utility. This utility supports part family templates and members. Syntax item_import [-u=user-id {-p=password | -pf=password-file} -g=group] -dir=directory [-folder=folder-name] [-preview] [-report=file-name] [-filename=file-name] [-classoffile=class-name] [-list_metafile] [-include_pfmembers=part-family-members] [-include_pftemplate=part-family-templates] [-part_family_bom_treatment={members | templates | all | none}] [-script=pre-import-script] [-email=email-address] [-parallel=number-of-parallel-processes] [-continue_on_error] [-verbose] [-transaction_id=tid] [-restart] [-h] Arguments Entries in parentheses are accepted abbreviations for arguments. -u Specifies the user ID. This is a user with Teamcenter administration privileges. 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 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. -dir Specifies the path name to the directory containing the metafile and the data files to be imported. -folder (fol) Specifies the destination folder in which imported items are placed. If the folder does not exist or the argument is not supplied, the imported items are placed in the user's Newstuff folder. -preview (pre) Performs an import dry run and generates a dry run report to the file specified by the -report argument. If the -report argument is not specified, the report is output to the screen. -report (rep) Outputs a preview or completion report to the specified report file. If no report file name is specified, the report is output to the screen. -filename (fn) Specifies the name of the text file listing objects for selective import, one name per line. -classoffile (cof) Specifies the class of objects contained in the input file. If not specified, the default class is Item. -list_metafile (lm) Lists only the contents of the metafile; does not import objects. -include_pfmembers Identifies the related part family members to be imported when handling part family templates. -include_pftemplate Identifies the related part family template to be imported when handling part family members. -part_family_bom_treatment Identifies the part family objects associated with the assemblies to be imported. The argument must be used in conjunction with the -include_bom argument. Valid options are: -members Includes part family member components present in the assembly. -templates Includes part family template rather than part family member components. -all Includes both the part family member components and templates. -none Includes neither the part family member components nor the templates. -script Specifies the name of the script to be executed prior to import. If a script is defined by the TC_post_export_script preference, this argument overrides the preference setting. If specified as NONE, the script defined in the preference file is executed. -email Sends email to the user at the specified email address after completion. If no email address is specified, the email address in the user's Teamcenter user profile is used. -parallel (par) Specifies the number of processes to be started automatically. If this argument is not specified, the system imports the deferred objects with a sequential process. -continue_on_error (con) Specifies that the import operation proceeds when an error has occurred on an optional object, such as a reference or manifestation attachment. -verbose (v) Runs the utility in verbose mode to display the maximum amount of information. Typically, nonverbose utility sessions only display error messages. -transaction_id (trid) Specifies the transaction ID for a given checkpoint-related operation. -restart (rs) Restarts a given transaction at the point of failure. -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 To restart a transaction at a site where a failure occurred: Copy item_import -transaction_id=transaction-id -restart Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration