UOM Conversions Editing

Create a Unit Group

You can create a unit group for which you can add units of measure conversions.

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. In the page, select .
    The Add a New Unit Group window appears.
  4. In the Unit Group Name box, enter a name for the unit group.
  5. Select Submit.

Results

A unit group is created. A next to the unit group indicates that it is a user-created record.

Rename a Unit Group

You can change the name of a unit group at any given time.

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. Select the unit group that you want to rename.
    Note: You can rename only the user-created unit groups.
  4. In the section for the selected unit group, select , and then select Rename Unit Group.
    The Rename Unit Group window appears.
  5. In the Unit Group Name box, enter the new name for the unit group, and then select Submit.

Results

The unit group is renamed.

Delete a Unit Group

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. In the page, select and select Delete Unit Group.
  4. The alert dialogue box appears, asking you to confirm the deletion of the Unit Group.
  5. Select Submit.
    The Unit Group selected is deleted.
    Note:
    • Once the Unit Group is deleted, the related Unit conversion is also deleted.
    • Once you delete a Unit Group or a Unit of Measure Conversion, the deleted Unit Group or Unit of Measure Conversion cannot be retrieved back as there is no undo option.

Create a Units of Measure Conversion

You can add a new units of measure conversion to a unit group.

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. Select the unit group for which you want to add a units of measure conversion.
    The color of the selected unit group name changes to blue.
  4. In the section for the selected unit group, select , and then select Add a new unit conversion .
    The Add New Unit Conversion window appears.
  5. As needed, enter values in the available fields.
    Field NameDescription
    DefaultIndicates whether the units of measure is set as default.

    You cannot modify this field. However, you can set a units of measure conversions as default in the Units of Measure Conversions page.

    From Unit AliasesDefines the different unit names for the units of measure for which you want to convert the value.

    The names are separated by commas (for example, kilometers, kms).

    From UnitDefines the units of measure for which you want to convert the value.

    For example, if you want to convert the input value from kilometers to miles, kilometers is the From unit of measure.

    Note:
    • The value in the From Unit field should be unique for each unit group. You cannot add the same From Unit field value that exists in another unit group.
    • Previously, the letter ‘g’ was used in Pressure to represent standard gravity unit and in Weight to represent gram unit. Now, the letters are differentiated by font: an Arial ‘g’ is used to represent standard gravity unit, and a Calibri ‘g’ is used to represent gram unit.
    To Unit AliasesDefines the different unit names for the units of measure to which the value is converted.

    The names are separated by commas (for example, miles, mi).

    To Unit Display NameDefines the units of measure to which the value will be converted.

    For example, if you want to convert the input value from kilometers to miles, miles is the To unit of measure.

    The selected name appears as a unit label for the converted value.

    Note: Previously, the letter ‘g’ was used in Pressure to represent standard gravity unit and in Weight to represent gram unit. Now, the letters are differentiated by font: an Arial ‘g’ is used to represent standard gravity unit, and a Calibri ‘g’ is used to represent gram unit.
    To System of MeasureDefines the system of measure of the To unit of measure to which the value will be converted.
    ExpressionDefines the mathematical formula that is used to convert the value.
    PrecisionDefines the number of digits that should appear after the decimal point of a value based on the following options:
    • None

      Does not change the converted value.

      If you do not select a precision value, by default, None is selected.

    • 0

      Considers only the digits before the decimal point and omits the digits after the decimal point.

      For example, if the value is 2.91 and a precision '0’ is selected, 2 is the resultant value.

    • 1 to 10

      Indicates the number of digits to be considered after the decimal point, respectively.

      Based on the specified precision, zeros are added at the end of the converted value to make the number of digits after the decimal point of the converted value match the precision selected. For example, if the value is 2.92 and a precision '4' is selected, then 2.9200 is the resultant value.

    RoundingDefines the type of approximation of a value based on the following options and the specified precision:
    • None

      Does not change the converted value.

      If you do not select a rounding value, by default, None is selected.

    • Ceiling

      Increases the value to the nearest number.

      For example, if the value is 2.926 and the precision is set to 2, the value will be increased to 2.93.

    • Floor

      Decreases the value to the nearest number.

      For example, if the value is 2.926 and the precision is set to 2, the value will be decreased to 2.92.

    DescriptionDescribes the units of measure conversion.
  6. Select Submit.

Results

The units of measure conversion is added. A appears next to it, indicating that the units of measure conversion is a user-created record.
Note: In Predix Essentials, when a System of Measure (SOM) is created and assigned to a user, and the user logs in, the same SOM (also known as UOM conversion set) will be available in the Units of Measure and Conversion Set page in Configuration Manager. However, user will have to manually create the unit of measure conversions for the new conversion set in the Units of Measure and Conversion Set page. For information on adding a units of measure conversion, see Add the Contents to a UOM Conversion Set .

Example

Example: A tenant admin creates a new SOM called Metric and creates a units of measure conversion such as Centimeter to Meter and then assigns it to UserA.

When the UserA logs in to Predix Essentials, Metric will be automatically created in the Units of Measure and Conversion Set page without the units of measure conversion. UserA must manually create the units of measure conversions such as Centimeter to Meter in the Units of Measure and Conversion Set page.

Note: This example does not apply to Predix Essentials.

Upload Units of Measure Conversions

You can upload multiple units of measure conversions using the template file.

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Upload Conversions tab.
    Note: You must add the units of measure conversions that you want to upload to the template file. To download the template file, select Download Template.
    While adding the units of measure conversions to the template file, you must ensure the following conditions are met:
    • None of the fields should be empty.
    • The order in which the fields are displayed should not be changed.
    • The From Unit value of a unit group must not be used in another unit group.
    • The To Unit and From Unit values should not have the same aliases.
    • The precision value should range from -1 to 10, where -1 retains the calculated value as-is.
    • The rounding value should be Floor, Ceiling, or None.
    • The units of measure conversions should be unique. Any replicated units of measure conversions will be discarded when the file is uploaded.
    • Only the system of measures that are available in the system should be assigned.
    • The To Unit Display value should be one of the To Unit values.
    The following table shows a sample data of the template file.
    Unit GroupFrom UnitTo Unit To Unit Display NameTo System of MeasureExpressionTest DataPrecisionRoundingDescriptionDefault
    ["Length"]["km","km","Kilometer"]["mi","Mil","Miles","Mile"]miNone(#value*0.62137119223733)[{"inputValue":1,"outputValue":0.62137119223733}]-1Nonekilometers to milesTRUE
  3. In the Select File to Upload box, select .
  4. Navigate to the folder and select the file that you want to upload, and then select Open.
  5. Select Upload.

Results

The units of measure conversions are uploaded and appear in the Manage Conversions section.
The Upload Logs section displays the following information associated with the upload of units of measure conversions:
  • The name of the file.
  • Information on the success or failure of the upload activity.
  • The date and time of the upload activity.
  • The user name of the user who initiated the action.

Modify a Units of Measure Conversion

You can modify a units of measure conversion for a unit group.

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. Select the row that has the units of measure conversion for which you want to modify the values, and then select .
    The Edit Unit Conversion window appears.
  4. As needed, modify values in the available fields, and then select Submit.

Results

The units of measure conversion is modified.
Note: You cannot modify or delete an existing unit aliases.

Export Units of Measure Conversions

You can download multiple units of measure conversions to a single Microsoft Excel file.

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. In the page, select , and then select Export.

Results

The units of measure conversions are exported to a Microsoft Excel file.
Note: The data that is exported is determined by the All, Standard, or Custom filter that is applied.

Delete a Unit of Measure Conversions

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. In the page, select settings for the unit group and select Delete Unit Conversion.
    A new column Delete is displayed which allows you to select the Unit for deletion.
  4. Select Delete.
    The selected Units of Measure is deleted.
    Note:
    • You can delete a Unit Conversion only from one group at a time.
    • The selected Unit Conversions for deletion are not saved if you move to a different group before deleting them.
    • Once you delete a Unit Group or a Unit of Measure Conversion, the deleted Unit Group or Unit of Measure Conversion cannot be retrieved back as there is no undo option.

Set a Units of Measure Conversion as Default

You can set only a user-created units of measure conversion as default. If the From Unit and System of Measure of a units of measure conversion is same as for the other units of measure conversions, only one of them can be set as default.

Before You Begin

You must have tenant admin permissions or specific permissions to access the Units of Measure Conversions page.

Procedure

  1. In the module navigation menu, navigate to Units of Measure Conversions.
  2. Select the Manage Conversions tab.
  3. Select the unit group that contains the units of measure conversion that you want to set it as default.
  4. In the Default column, select .

Results

The selected units of measure conversion is set as default.
Note: If you want to set a system-provided units of measure conversion as default, you must create the same units of measure conversion, and then set the user-created record as default.