icsutility

Imports the following types of Classification data: Class definitions. This can optionally include the attributes, groups, parent classes, subclasses, or the class hierarchy from the root. Any individual attribute or Key-LOV object. Resource Manager resource assemblies. This can optionally include root-level components, intermediate components, bottom-level components, and propagation start points. The hierarchical component positions are maintained. icsutility also allows you to import class-specific and instance-specific files. Note This utility is primarily used to import legacy data. If you need to do this, contact your Siemens Digital Industries Software representative. To import and export classification data, use PLM XML. Syntax icsutility[-u=user-id {-p=password | -pf=password-file} -g=group] 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. -mod Specifies the type of modification: insert, update, or revise. insert Creates a new ICO, item, and item revision. If an ICO or item with the corresponding name already exists, nothing is imported. Attribute values are imported in the new ICO. Class-specific and instance-specific files (for example, HPGL files, GIF files, JT files, and PRT files) are attached to the new item revision. -update Updates the values in the ICO attached to the latest item revision (or to the item) and the assembly structure in the latest item revision (or item), as well as the class-specific and instance-specific files. -revise Creates a new item revision and ICO and imports the attribute values in the new item revision and ICO that classifies the new item revision. Class-specific and instance-specific files are attached to the new item revision. You can specify an additional argument, -forceConversion=1 (default value 0). In this case, the relationship to the item is converted to a relationship from the ICO to the latest item revision. -dbg Specifies the debug level. Any positive integer number up to level 7. 0 turns off debugging mode. The higher the debug level, the more detailed is the trace being output. -del Specifies the list of characters used to delimit multiple search directories and file extensions in the following file path and extension options: -fid Specifies the name of a folder into which imported items and datasets are placed. This folder is placed in the Newstuff folder. -sfn Specifies the name of the SML file to be processed. Do not include the .sml file extension. -sfp Specifies the path of the directory containing the .sml file. Paths must be terminated using the platform-specific path delimiter, as follows: \ Windows delimiter / Linux delimiter -cfp Specifies the directory path (or paths) containing the class-related files to be imported, such as class image files. -cfe Specifies the file extension of the class-related files to be imported. Accepts multiple file extensions separated by the delimiter set using the -del argument. -ofp Specifies the directory path (or paths) of the object-related files to be imported. -ofe Specifies the file extension of the object-related files to be imported. Accepts multiple file extensions separated by the delimiter set using the -del argument. -ffp Specifies the directory path containing the file types configuration file to be used. -ffn Specifies the name of the file types configuration file to be used, including the file extension. -clr If used, specifies that item revisions are classified when importing data. If not used, items are classified upon import. When you specify the -clr argument and try to import an ICO that is already in the database and the item, but not the item revision, was classified, an error message is output when insert mode is used. When update mode is used, the relationship to the item is converted to a relationship from the ICO to the latest item revision. -cit Creates items of the specified item type, rather than the standard items. Environment This utility must be run in the Teamcenter shell environment. Files As specified in Log files produced by Teamcenter and the filetypeDefaults.txt configuration file. The entries in the filetypeDefaults.txt configuration file map the extensions of all imported files to specific Teamcenter data structures: GRM relationship type, dataset type, named reference, optional default tool, and optional subdirectory name. The mapping of file extensions to specific Teamcenter data structures can be configured per import directory/subdirectory combination. Restrictions You must have the corresponding privileges (create/modify) to start the import process. If you do not have the privileges, the data is not imported and a message is written to the log file. Only the initial population of an empty Resource Manager database is fully supported. Examples To import the C:\import\sml\test.sml file using the file type configuration file C:\import\config\filetypeDefaults.txt together with GIF class image files residing in the C:\import\class\ directory and object-related JT, GIF, and Word files residing in the C:\import\object\ directory, enter the following command on a single line: Copy icsutility -u=smith -p=secret -g=admin -mod=update -dbg=1 -del=, -fid=import01 -ffp=C:\import\config\ -ffn=filetypeDefaults.txt -sfp=C:\import\sml -sfn=test -cfp=C:\import\class\ -cfe=gif -ofp=C:\import\object\ -ofe=jt,gif,doc