Unit Conversions

Overview

Watch Video  Video icon

Conversion classes are sets of units of measurement. Multipliers between the units in a class create conversions from one unit type to another within the conversion class. With conversion classes, units and conversion factors can be associated with float attributes.

Conversion classes can only be associated with float attributes.

When conversion classes are associated with attributes, buyers and product FullAccess users are able to indicate which units they are using when setting attribute values.

Example: If a ”temperature” numeric attribute named temperature is created, and there is a temperature conversion class, the attribute can be linked to the conversion class. The conversion class has units, such a Celsius and Fahrenheit, and the numerical relationship among these units is set up.

Users, who set a temperature value, can also select whether the temperature is in Celsius, Fahrenheit, Kelvin, or any other unit included in the class.

Administration

ClosedUsing the Conversion Class List Page

  1. ClosedNavigate to the Conversion Class List page.

    1. Click Admin to go to the Admin Home Page.

    2. Click General Site Options in the General section.

      The Options-General page opens.

  1. Make any desired changes indicated in the following table:

    To... Click... Notes
    Add a Conversion Class Add  
    Deploy new and undeployed Conversion Classes. Deploy

    All pending conversion classes are deployed immediately.
    Pending conversion classes have New listed in the Status column.

    Edit the Conversion Label Name in the Conversion Class Name column  
    Manage the units list for the selected conversion class Units in the List Units column  
    Enter text language translations for supported languages Translations

    In the Translations dialog box:

    • Click Save to save your changes. Continue entering translations.
    • Click Save and Close to save translations and close the dialog box.
    • Click Close to close the dialog box and return to the page without saving any changes.
    Delete a conversion Class Checkbox in the Select column, then Delete Only conversion classes that have not been deployed can be deleted.
Schedule conversion class deployments during low usage times.
Conversion classes must be deployed to be active in the Commerce system.
It is not possible to undo deletions and, upon a deletion, the Commerce system also deletes all units and conversions contained in the class.

ClosedAdding Conversion Classes

  1. ClosedNavigate to the Conversion Class List page.
    1. Click Admin to go to the Admin Home Page.

    2. Click General Site Options in the General section.

      The Options-General page opens.

  1. Click Add to add an item.

    The Conversion Class Administration page opens.

  1. Enter a Conversion Label.

    This is the name that identifies the class in Attribute administration areas and on the Conversion Class List page.

    Steps to add a Conversion Class

  2. Enter a Conversion Class.
  3. Click Add to save your changes and return to the previous page.

    The Conversion Class List page opens, displaying the newly added conversion class.

    Create conversion classes one at a time.

ClosedEditing Conversion Classes

  1. ClosedNavigate to the Conversion Class List page.
    1. Click Admin to go to the Admin Home Page.

    2. Click General Site Options in the General section.

      The Options-General page opens.

  1. Click a name in the Conversion Class Name column.

    The Conversion Class Administration page opens.

  1. Modify the Conversion Label.

    This is the name that identifies the class in attribute administration areas and on the Conversion Class List page.

  2. Click Update to save your changes and return to the previous page.

    The Conversion Class List page opens, displaying the modified conversion class.

    Conversion class names can only be edited in classes that have not been deployed.

ClosedAdding a Unit

  1. ClosedNavigate to the Conversion Class List page.
    1. Click Admin to go to the Admin Home Page.

    2. Click General Site Options in the General section.

      The Options-General page opens.

  1. Click Units to manage the Units List for the selected conversion class name.

    The Units List page opens for the selected conversion class.

  2. Click Add to add an item.

    The Unit Administration page opens.

    Unit Administration page

  1. Enter a Unit Label.

    This is the name that will be displayed on the Units List: <name of the selected Conversion Class> page.

  2. Enter a Unit Class.
  3. Click Add to save your changes and return to the previous page.

    The Units List: <name of the selected Conversion Class> page opens, displaying the newly added conversion class.


ClosedDefining Unit Conversions

Create conversions by setting the multiplication factor that makes one unit of measurement equivalent to another. Conversions can be edited at any time.

  1. ClosedNavigate to the Conversion Class List page.
    1. Click Admin to go to the Admin Home Page.

    2. Click General Site Options in the General section.

      The Options-General page opens.

  1. Click Units to manage the Units List for the selected conversion class name.

    The Units List page opens.

    Time Unit List

    Define Conversions does not appear until at least two units exist for the conversion class.
  2. Click Define Conversions.

    The Unit Conversion Administration page opens.

    Unit Conversion Administration convert from gravity (g) to ft/s2

  1. Enter conversion values in the Multiplication Factor and Addition Constant fields.
  2. Change which unit is the constant by choosing a different unit from the Convert Units Into drop-down.

    This change is immediately reflects in the values to be converted.

  3. Click Update to save your changes and return to the previous page.

    • The default unit type specified on the Units List page is also used as the default constant. The constant (Co) should remain 0.0, except in temperature conversions.
    • In deployed conversion classes, conversion changes take effect immediately after clicking Update.

ClosedImplement Commerce Unit Conversion Use Case

Length Unit Conversion Use Case – The input Float attribute is linked to a pre-defined length conversion class that allows the user to select whether the length is in inches, feet, yards, or any other unit included in the class. The output Float attribute contains the length in meters. The following image shows the conversion functionality.

  1. In the first step, the user is hovering over the Length attribute that has Help Text enabled.
  2. In the second step, the user enters a length of "7" and selects "Yards" for the unit of measure.
  3. In the third step, the value for the Length in Meters attribute is converted.

Steps for Length Unit Conversion Use Case

The following tasks describe how to implement unit conversion float attributes.

ClosedSelect a Conversion Unit

ClosedCreate an Input Float Attribute

ClosedCreate an Output Float Attribute

ClosedCreate a Formula to Update the Output Float Attribute

ClosedAdd Float Attributes to the Transaction UI Layout


Notes

Only FullAccess users can administer conversion classes.

After defining Unit Conversions, administrators must perform the following items to enable Unit Conversion for users:

  • Create two Commerce float type attributes
  • Set the value of Conversion Group and Conversion Unit on both the attributes, then click Save.
  • Define the formula for one of the attribute and enable auto update on that attribute.
  • Place the attributes on the Commerce layout, then Save and Deploy.
  • You can set English and metric default units for each conversion class. Whenever a conversion class is associated with a numeric attribute, the default units appear selected in the units menu.
  • Users can override default units by picking other units in the class.
  • Conversions happen automatically when units switch from one to another in the same class.
  • Changes to default unit settings take effect immediately in deployed conversion classes.
  • Conversion classes are created in a non-active, pending state. After a conversion class is complete, meaning it has both units and conversions, deploy the class to make it active.

Related Topics

Related Topics Link IconSee Also