GetDCIValues
- GetDCIValues(node, id, startTime, endTime, rawValues, tier, function): Array
-
Get all values for period of DCI with given ID on given node.
Table 1. Parameters node
Data collection target object instance
id
Integer
DCI ID
startTime
Integer
Start of the period (as UNIX timestamp).
endTime
Integer
End of the period (as UNIX timestamp). Optional, current time will be used if this parameter is not specified
rawValues
Boolean
False - return transformed values. True - return RAW values. Optional, False by default.
tier
String
Data tier to read from:
"auto","raw","hourly", or"daily"(case-insensitive). Optional, defaults to"auto": aggregated hourly or daily data is used when aggregation is enabled for the DCI and the period would contain more thanDataCollection.raw values. Ignored whenAggregation. MaxAutoSelectPoints rawValuesistrue. Any other name causes a runtime error.function
String
Aggregation function for tiered data:
"avg","min", or"max"(case-insensitive). Optional, defaults to"avg". Any other name causes a runtime error.
Added in version 4.4.1: rawValues parameter
Array of values (as strings) ordered from latest to earliest for given DCI (empty array if there are no values in the period), or null if DCI with given ID does not exist, is a table DCI, or the database query failed.
GetDCIValues($node, FindDCIByName($node, "Status"), time() - 3600, time()); // Values for last hour