Categories

Versions

Get Data (IoT) (IoT Connector)

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 (Connection)

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

Output

  • output (Data table)

    Historic values associated with the queried Altair IoT things.

  • connection (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. Range: selection
  • 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. Range: string
  • 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. Range: configurable
  • use_category Whether to query a whole Altair IoT category instead of a list of thing UUIDs. Range: boolean
  • thing_ids Only available when the use category flag is not set. List of Altair IoT Things UUIDs to be queried. Range: string
  • category Only available when the use category flag is set. Altair IoT Things category to be queried. Range: string
  • 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. Range: string
  • 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. Range: string
  • time_zone The time zone used as reference for the start time and end time parameters. Range: selection