Adding UMS-based unit conversion to database properties

You can add the UMS-based unit conversion functionality to a normal database property. At its core, it must be a persistent property of the double type. You can base a compound property or a runtime property on a persistent double property as long as it has been enabled for UMS-based unit conversion. When the value is stored in the database, it will be stored along with its unit of measure which may differ from the displayed unit of measure. For example, if the current user is currently editing a property which is defined in kilograms, but the user displaying the Non-Metric Display Set, and they enter a value of 2.2 (lbs), the system will save the value in the database as 1 (kg), while still displaying 2.2 (lbs). Static or dynamic units There are two possible scenarios when you add UMS units to a property. One where the unit of measure remains the same once defined for the life of the property (static), and one where the unit of measure can vary during the life of the property (dynamic). Static unit If the unit associated to the property does not change per instance, set the Fnd0StorageUnitDefId property constant to the proper unit definition Id such as Mass_kg or Length_m. Dynamic unit If the unit associate to the property may vary per instance, then set the Fnd0StorageUOMProperty property constant to the name of the property which maintains the storage unit. Note In either case, you must set the Fnd0EnableDisplayUnit property constant to true to enable UMS-based unit of measure functionality. Supported property configurations Persistent property Ensure that the Fnd0StorageUnitDefId property constant has the desired unit definition id. Or that the Fnd0StorageUOMProperty identifies the name of the property which maintains the storage unit. Ensure that the Fnd0EnableDisplayUnit property constant is set to true. Runtime property If your runtime property is based upon a persistent property, ensure the source property has been enabled for unit conversion Register the source property descriptor as basedOnPropertyDescriptor for runtime property descriptor. Compound property Ensure the source persistent property in the traversal path has been enabled for conversion with the right configuration Currently unsupported The Unified Measurement System does not currently maintain unit conversion in the following areas. Dynamic Compound Properties Search results Filtering List of Values Custom server code (C/C++)