Skip to main content

Get Data (IoT)

Synopsis

Retrieves all property values associated with a specified thing, list of things, or whole category.

Description

Given a list of IoT Thing UIDs or a IoT Thing Category, this function fetches all the historic values for their properties.

Input

connection

Optional Connection object. See the parameter connection entry for more information.

Output

output

Historic values associated with the queried Altair IoT things.

connection

The same connection from the input port. If the connection input port is not connected, the connection output port delivers nothing.

Parameters

Connection source

Only available when the connection input port is not connected. Whether the connection should be predefined or retrieved from repository.

Connection entry

Only available when the connection source parameter is set to ** repository**. It is used to specify a repository location that represents a connection entry.

Connection

Only available when the connection source parameter is set to ** predefined**. The connection details for the Altair IoT connection have to be specified. If there is already a configured Altair IoT connection, it can be selected from the drop-down list. In other case, select the icon to the right of the drop-down list. Create a new Altair IoT connection in the Manage connections box. The access key, secret key and the region are required.

Use category

Whether to query a whole Altair IoT category instead of a list of thing UUIDs.

Thing ids

Only available when the use category flag is not set. List of Altair IoT Things UUIDs to be queried.

Category

Only available when the use category flag is set. Altair IoT Things category to be queried.

Start time

Optional filter for the attribute changes query. The format is "yyyy-MM-dd HH:mm:ss". If it is empty, the whole history is queried. If it is set, the query filters attribute changes starting at this date.

End time

Optional filter for the attribute changes query. The format is "yyyy-MM-dd HH:mm:ss". Must be only set together with start time. If it is empty, the attribute changes are queried until the current date when the operator is executed. If it is set, the query filters attribute changes until this date.

Time zone

The time zone used as reference for the start time and end time parameters.

See Also