Updating units of measure

In the following scenarios, you may wish to update a unit of measure. Always back up your existing unit definitions file before making changes to the file. Update the unit symbol displayed in Teamcenter You may wish to use a different symbol for a unit of measure in Teamcenter. This situation may arise, for example, when your legacy units of measure are migrated to the unit management system (UMS). Use the following example to guide you when making this type of update. In this example, consider you have a legacy unit of measure with the name MyMillimeter and symbol MyMm which is mapped to the Length_mm unit definition. The Length_mm unit definition has the name Millimeter and symbol mm as delivered by default in the UMS. You no longer want to use the name MyMillimeter and symbol MyMm, but we want to use the name millimeter and symbol mm. To do so, perform the following steps. Update the default values (Name and Symbol in the unit definition) provided with Teamcenter: In a unit definitions file containing a Length_mm row, add a new column named Application:MyApp1. In this example, this file is my_unit_definitions.csv. In the Application:MyApp1 column of the Length_mm row, set the value to the number 1. Ensure the Unit name and Symbol values match those of the legacy unit(s) you wish to update. In this example, we set Unit name to MyMillimeters and Symbol to Mymm. Validate your changes by generating a report with the ums_import_unit_definitions utility. For, example: Copy ums_import_unit_definitions -file=my_unit_definitions.csv -applications=MyApp1 -allowOverwrite -dryRun After reviewing the displayed summary and generated log file and then correcting any issues, remove the -dryrun parameter and use the ums_import_unit_definitions utility to update Length_mm to have the new (legacy) Unit name and Symbol values. For example: Copy ums_import_unit_definitions -file=my_unit_definitions -applications=MyApp1 -allowOverwrite Change the values to your desired values: Create a copy of the unit definitions file. For example, my_unit_definitions_copy.csv. In my_unit_definitions_copy.csv, update the Unit name and Symbol values to match those delivered by default in the UMS. In this example, we set Unit name to Millimeters and Symbol to mm. Validate your changes, using the -updateUOM parameter with the ums_import_unit_definitions utility. For example: Copy ums_import_unit_definitions -file=my_unit_definitions_copy.csv -applications=MyApp1 -allowOverwrite -updateUOM -dryRun After correcting any issues, remove the -dryrun parameter and commit the change to the UMS with the ums_import_unit_definitions utility. For example: Copy ums_import_unit_definitions -file=my_unit_definitions_copy.csv -applications=MyApp1 -allowOverwrite -updateUOM The next time you log on to Teamcenter, updated units of measure will be available. Update default units of measure You may wish to change the default (as delivered with Teamcenter) symbol for a unit. This situation may arise, for example, when your organization has an established symbol in place for a certain unit of measure. Use the following example to guide you when making this type of update. In this example, we no longer want to use the cm symbol, which is the default unit symbol. Instead, we want to use the symbol cms. To do so, we perform the following steps. In a unit definitions file containing a Length_cm row, add a new column named Application:MyApp2. In this example, this file is my_unit_definitions.csv. In the Application:MyApp2 column of the Length_cm row, set the value to the number 1. In my_unit_definitions.csv, set the value in the Symbol column to the symbol value you wish to use. In this example, we set Symbol to cms. Validate your changes by generating a report with the ums_import_unit_definitions utility. For, example: Copy ums_import_unit_definitions -file=my_unit_definitions.csv -applications=MyApp2 -allowOverwrite -updateUOM -dryRun After correcting any issues, remove the -dryrun parameter and commit the change to the UMS with the ums_import_unit_definitions utility. For example: Copy ums_import_unit_definitions -file=my_unit_definitions.csv -applications=MyApp2 -allowOverwrite -updateUOM The next time you log on to Teamcenter, the updated units of measure symbol is displayed.