GetDCIValues

Deprecated in 6.2.

Please use getValues() method of DCI class instead.

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

DataCollectionTarget

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 than DataCollection.Aggregation.MaxAutoSelectPoints raw values. Ignored when rawValues is true. 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.

Return

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