Point Lists
Point lists are a list of valid combinations of asset and property.
They are most often created with the POINTS command, or the VALUES macro, combining a list of properties with a list of assets.
When returned as a JSON object, each point will contain…
| Name | Meaning |
|---|---|
| assetid | The ARDI ID number of the asset |
| assetname | The name or ERN of the asset |
| propertyid | The ARDI ID number of the property |
| propertyname | The name of the property |
| propertytype | The type name of the property |
| map | (Optional) A guide to converting the value from a number to a string |
| units | (Optional) A string to attach to the end of the raw value |
| value | A human-readable version of the value |
| rawvalue | A numeric, computer-readable version of the value |
| history | (Optional) A list of key-value pairs containing the requested history, in the format ( timestamp, value ) |
This is an example JSON record…
{
"query": "('TE101') ASSET ('Temperature - Stove') PROPERTY VALUES { \"start\": \"2020-01-02 00:00:00\", \"end\": \"2020-01-02 00:01:00\", \"grain\": -1 } GETHISTORY",
"results": [{
"type": "pointlist",
"value": [{
"assetid": "58",
"sourceid": "58",
"value": 1451,
"rawvalue": 1451,
"propid": 37,
"fullvalue": "0| Deg C|0|1600|0",
"type": "MEASUREMENT",
"name": "Stove #1 Pile Temp Sensor",
"units": " Deg C",
"min": "0",
"max": "1600",
"places": "0",
"propname": "Temperature - Stove",
"ern": "TE101",
"history": [
["2020-01-02 12:00:00", "1017.567"]
]
}]
}]
}
-----