JSON Format for Converted Values

A JSON object describing a converted value has the following syntax:

{
  "@Skill.SignalProcessing.ConvertedValue": {
    "name": "Temperature",
    "UUID": "23145a90-288e-4437-af0f-b43ebf25d4ed",
    "ACL": { ... },
    "rawValue": "Hardware.Rack 04.Temperature Sensor",
    "mappings": [
      {
        "raw": 0,
        "mapped": -20
      },
      {
        "raw": 255,
        "mapped": 150
      }
    ]
  }
}

Object Members

name	A string value containing the name of the converted value. The name is used to construct the converted value’s primary key.
UUID	A string value containing the unique UUID of the converted value.
ACL	An optional JSON object containing the element ACL of the converted value. The format of the object is described under JSON Format for ACLs.
rawValue	A string value describing the skill data point to use for the raw value. The string value must contain the primary key of the skill data point. The converted value will be readable if the skill data point supports the input direction, and writable if the skill data point supports the output direction. The value of the skill data point must be either a numeric or a Boolean value.
mappings	An array of objects describing the value mappings.

The JSON objects describing the individual value mappings have the following members:

Value Mapping Object Members

raw

The raw value to be mapped. The raw values of the individual mappings must be strictly increasing, meaning that the raw value of each mapping must be greater than that of the previous mapping. If the mapping contains only a single value, then the raw value cannot be 0.

mapped

The converted value that the raw value should be mapped to. The converted values of the individual mappings must either be strictly increasing, meaning that the mapped value of each mapping must be greater than that of the previous mapping, or or strictly decreasing, meaning that the mapped value of each mapping must be less than that of the previous mapping. This restriction is necessary to be able to perform a reverse conversion when writing to the converted value. If the mapping contains only a single value, then the mapped value cannot be 0.