Units¶
Predefined units are the recommended way on using units for standard metrics. In case of custom units, refer to Units in the PDC Manual.
Predefined Units¶
The predefined Units enable automated conversion between metric and imperial units of values on the DataPortal. The declaration of the include for the predefined units must be located above the "Unit" definition.
Warning
Note that the following snippet must be added to the Parsing Definition Configuration, see PDC Manual. A PDC template with the necessary elements can be downloaded here: PDC Template.
<xsi:include href="https://xml.proemion.com/ProemionDataConfiguration/predefinedUnits.xml" parse="xml" xpointer="element(/1)"/>
The following units are predefined and should always be used if possible.
| Predefined Unit Keys | Units |
|---|---|
predefined.unit.acceleration.G |
g |
predefined.unit.acceleration.METERS_PER_SECOND_SQUARED |
m/s² |
predefined.unit.angle.DEGREE |
° |
predefined.unit.area.SQUARE_METER |
m² |
predefined.unit.BITFIELD |
integer without unit symbol |
predefined.unit.capacity.AMPERE_HOUR |
Ah |
predefined.unit.current.AMPERE |
A |
predefined.unit.current.MILLIAMPERE |
mA |
predefined.unit.datavolume.BYTE |
byte |
predefined.unit.datetime.DATE |
date without additional time. Value should be provided in seconds, but hours, minutes and seconds will be ignored. |
predefined.unit.datetime.DATETIME |
date with additional seconds of day. Indicates to tooling that values should be formatted, contrary to predefined.unit.datetime.TIMESTAMP |
predefined.unit.datetime.TIMESTAMP |
sec |
predefined.unit.density.GRAM_PER_MILLILITER |
g/ml |
predefined.unit.density.KILOGRAM_PER_CUBICMETER |
kg/m3 |
predefined.unit.energy.consumption.KILOWATT_HOUR_PER_KILOMETER |
kWh/km |
predefined.unit.energy.KILOWATT_HOUR |
kWh |
predefined.unit.flow.CUBIC_METER_PER_HOUR |
m3/h |
predefined.unit.flow.GALLON_LIQUID_US_PER_HOUR |
gal/h |
predefined.unit.flow.GALLON_LIQUID_US_PER_MINUTE |
gal/min |
predefined.unit.flow.LITER_PER_HOUR |
l/h |
predefined.unit.flow.LITER_PER_MINUTE |
l/min |
predefined.unit.force.KILONEWTON |
kN |
predefined.unit.force.NEWTON |
N |
predefined.unit.force.POUND_FORCE |
lbf |
predefined.unit.fraction.PARTS_PER_MILLION |
ppm |
predefined.unit.frequency.HERTZ |
Hz |
predefined.unit.frequency.per.HOUR |
1/h |
predefined.unit.frequency.per.MINUTE |
1/min |
predefined.unit.fueleconomy.KILOMETER_PER_LITER |
km/l |
predefined.unit.geoposition.DECIMAL_DEGREE |
° |
predefined.unit.length.CENTIMETER |
cm |
predefined.unit.length.FOOT |
ft |
predefined.unit.length.INCH |
in |
predefined.unit.length.KILOMETER |
km |
predefined.unit.length.METER |
m |
predefined.unit.length.MILE |
mi |
predefined.unit.length.MILLIMETER |
mm |
predefined.unit.mass.GRAM |
g |
predefined.unit.mass.KILOGRAM |
kg |
predefined.unit.mass.METRIC_TON |
t |
predefined.unit.mass.POUND |
lb |
predefined.unit.mass.SHORT_TON |
tn |
predefined.unit.NUMBER |
number without unit symbol |
predefined.unit.PERCENT |
\% |
predefined.unit.power.KILOWATT |
kW |
predefined.unit.power.WATT |
W |
predefined.unit.powerlevel.DECIBEL-MILLIWATTS |
dBm |
predefined.unit.pressure.BAR |
bar |
predefined.unit.pressure.HECTOPASCAL |
hPa |
predefined.unit.pressure.KILOPASCAL |
kPa |
predefined.unit.pressure.MEGAPASCAL |
MPa |
predefined.unit.pressure.MILLIBAR |
mbar |
predefined.unit.pressure.opt.PSI |
psi |
predefined.unit.pressure.PSI |
psi |
predefined.unit.resistance.KILO_OHM |
kΩ |
predefined.unit.resistance.OHM |
Ω |
predefined.unit.rotation.DEGREES_PER_SECOND |
°/sec |
predefined.unit.rotation.RPM |
rpm |
predefined.unit.roughness.iri.m |
m/km |
predefined.unit.speed.FOOT_PER_SECOND |
ft/s |
predefined.unit.speed.KILOMETERS_PER_HOUR |
km/h |
predefined.unit.speed.METERS_PER_SECOND |
m/s |
predefined.unit.speed.MILES_PER_HOUR |
mi/h |
predefined.unit.stiffness.MEGANEWTON_PER_METER |
MN/m |
predefined.unit.surface_density.GRAM_PER_SQUARE_CENTIMETER |
g/cm² |
predefined.unit.surface_density.GRAM_PER_SQUARE_METER |
g/m² |
predefined.unit.temperature.CELSIUS |
°C |
predefined.unit.temperature.FAHRENHEIT |
°F |
predefined.unit.temperature.KELVIN |
K |
predefined.unit.TEXT |
text without unit symbol |
predefined.unit.time.HOUR |
hr |
predefined.unit.time.MILLISECOND |
ms |
predefined.unit.time.MINUTE |
min |
predefined.unit.time.SECOND |
sec |
predefined.unit.torque.NEWTON_METER |
Nm |
predefined.unit.velocity.FOOT_PER_MINUTE |
ft/min |
predefined.unit.velocity.FOOT_PER_SECOND |
ft/s |
predefined.unit.velocity.INCH_PER_SECOND |
inch/s |
predefined.unit.velocity.METERS_PER_MINUTE |
m/min |
predefined.unit.velocity.METERS_PER_SECOND |
m/s |
predefined.unit.velocity.MILLIMETERS_PER_SECOND |
mm/s |
predefined.unit.voltage.MILLIVOLT |
mV |
predefined.unit.voltage.VOLT |
V |
predefined.unit.volume.CUBIC_METER |
m³ |
predefined.unit.volume.CUBIC_YARD |
yd³ |
predefined.unit.volume.GALLON_LIQUID_US |
gal |
predefined.unit.volume.LITER |
l |
predefined.unit.volume.OUNCE |
fl oz |
Note
TIMESTAMP, DATE and DATETIME must be provided in UTC time.
Note
In case that there is no format defined in the value definition, the predefined.unit.time.HOUR, predefined.unit.time.MINUTE and predefined.unit.time.SECOND are displayed as HH:MM:SS format.
Note
If there are predefined units missing, you may request them via the Service and Support.
