briefcase_validator

Briefcase files must be created using a Siemens Digital Industries Software application. Data in Briefcases created using unsupported third-party applications (such as with an archiving application and then renamed as a .bcz file) cannot be imported. briefcase_validator lets you quickly validate that a Briefcase file was created using a Siemens Digital Industries Software application and not a third-party application. Validating the integrity of a Briefcase file before attempting to import the data minimizes import errors and reduces the likelihood of needing to re-import data. By default, briefcase_validator lists its results in the command window. You can optionally send the results to an HTML file for viewing. For more information about validating Briefcase TC XML files, see tcxml_export and Transferring a briefcase package. You can also use the briefcase_validator -file argument to create Briefcase files based on existing Briefcase files, but containing changed data and metadata. Doing so can be useful when sharing data with other organizations for testing purposes. For example, the receiving organization can update the text-based XML data in the Briefcase file to match their data model and site names. They can then import and review the Briefcase data. Syntax briefcase_validator -u=user-ID {-p=password | -pf=password-file} -g=group [-inputfile=path-to-input-XML-file [-ruleFile=rule_file_name] [-show] [-report=report_name.html]] [-file=file_name {-add=file_to_add | -dir=dir_name} [-props=srcsite_id?destsite_id?tcxml_file_name[?briefcase_type]] [-ll_bcz_mode]] [-h] Arguments -u Specifies the user ID. -p Specifies the user's password. This argument is mutually exclusive with the -pf argument. -pf Specifies the password file. This argument is mutually exclusive with the -p argument. For more information about managing password files, see Manage password files. -g Specifies the group associated with the user. The group value must be dba to run this utility. -inputfile Specifies the full path to the Briefcase or TC XML file to be validated. -ruleFile The mapping rule file to use when validating the file specified by -inputfile. -show Displays the contents of the file specified by -inputfile. -report Specifies a file to be created containing the validation report in the current directory if a full path is not specified. Use the extension .html on the file name. -report is used with -inputfile. -file Specifies the full path and file name of the Briefcase file to be created. -add Specifies the attachments to package in the Briefcase file being created. Separate multiple attachments with commas. Include the full absolute path and file name of each attachment. -add is used with -file and cannot be used with -dir. -dir Specifies a directory containing attachments to package in the Briefcase file being created. Include the full absolute path of the directory. -dir is used with -file and cannot be used with -add. -props Specifies property values to set in the new Briefcase manifest file. Property values are separated by ? characters. Used with -file. Property values must be set in the following order. srcsite_id specifies the site ID of the source Teamcenter site. This value must match the source site ID specified in tcxml_file_name. destsite_id specifies the site ID of the target Teamcenter site. This value must match the target site ID specified in tcxml_file_name. tcxml_file_name specifies the Briefcase XML file containing the Teamcenter data to include in the new Briefcase file. briefcase_type specifies the type of Briefcase file being created. Values are case-sensitive. Value File created M2M (the default) Managed Briefcase file M2U Unmanaged Briefcase file generated at a Teamcenter site and targeted for a Briefcase Browser site U2M Unmanaged Briefcase file generated at a Briefcase Browser site and targeted for a Teamcenter site U2None Unmanaged Briefcase file -ll_bcz_mode Specifies that the Briefcase file be created as a low-level Briefcase file. Used with -file. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in the Log files produced by Teamcenter. Restrictions This utility validates the low-level TC XML in an existing Briefcase file or other low-level TC XML file. High-level TC XML is not supported. Examples List the contents of the specified Briefcase file. Copy briefcase_validator -u=Tc-admin-user -p=password -g=group -file= c:\temp\sample_briefcase.bcz -show Evaluate the exported TC XML in an existing Briefcase file. Copy briefcase_validator -u=Tc-admin-user -p=password -g=group -inputfile= c:\temp\sample_briefcase.bcz -report=c:\temp\validation_report.html Evaluate a stand-alone low-level TC XML file. Copy briefcase_validator -u=Tc-admin-user -p=password -g=group -inputfile=c:\temp\sample_tcxml.xml -report=c:\temp\validation_report.html Create a new Briefcase file using data changed from a source Briefcase file. Copy briefcase_validator -u=Tc-admin-user -p=password -g=group -file= c:\temp\new_briefcase.bcz -dir=c:\temp\new_bc001
-props=vender01?oemtest01?trans6216b0f0000420?U2M Related Topics TC XML and PLM XML Configuration for Data Import and Export Multi-Site Collaboration