UVALUES
Parameters
| Order | Name | Type | Desc |
|---|---|---|---|
| 1 | assets | asset list | A list of assets |
| 2 | properties | property list | A list of properties |
Returns
Places a list of points onto the stack, searching upstream into parent assets if no match can be found on the assets in the list.
Description
Returns a list of points given both a list of assets and a list of properties.
The properties returned from this function will not contain live values or history - these are usually loaded when needed by later functions, or when the values are returned. This avoids needless data loading, as requesting live data can be expensive for large numbers of points.
Note that only valid points are returned - if you ask for a property on an asset that doesn't contain that property, nothing will be returned.
All assets in each list will be compared to one-another. So you will have points for any asset in the asset list that has any property in the property list.
Example
'TE101' ASSET 'Position' PROPERTY UVALUES
This function will return a point for Position on asset TE101, if such a point exists. If none can be found, it will search the parents of that asset until either…
- An asset with a Position property is located, or
- No more assets remain
This is useful when you have complex systems with many parts that share an ID, inspection time, location or other useful piece of information that doesn't flow through any relationships.