Custom Attributes

Custom attributes are user-defined fields that allow you to extend device data by adding additional, trackable attributes at the device type level.

Created custom attributes can be viewed as a list and sorted by available columns in the Custom Attributes table.

Unit Naming Rules

When defining a custom attribute with measurement units, follow these conventions:
  • Each unit can include a combination English letters and numbers, the percent symbol (%), or the Unicode symbols for degrees (°), degrees Celsius (℃), or degrees Fahrenheit (℉).
  • Unit names must not start with a number.
  • A unit name may be followed by a caret (^) and an integer to indicate a power (for example, m^2 for square meters).
  • The unit string may contain one division character ( / ) between any pair of unit names.
  • The unit string may be prefixed with a real number to represent a multiplier of the units.
Examples of valid unit strings:
m/s meters per second
in^2 square inches
0.1 inch tenths of an inch
ft/s^2 feet per second squared
% percent

Unit Conversion and Recognition

  • Most common units are automatically recognized and converted to the user’s preferred measurement system (Metric or Imperial).
  • Arbitrary unit strings are allowed but are not automatically converted.
Examples:
  • "m/s" is recognized as a metric unit and converted to "ft/s" when the user’s preference is set to Imperial.
  • "distanceUnits" is a valid custom unit string, but it will not be converted automatically.
See the following topics for managing custom attributes: