Resolution

Last modified: Jan 21, 2019 @ 11:48

Contents

Introduction

The default sampling interval for Resource Types is Realtime, which reports sensor data continuously. In the Resolutions menu you can enable additional intervals ranging from 1 min to 24 h. These Resolutions can be used to obtain Average, Min, Max, and other calculated values.

Resolutions are enabled under specific Smart Object Types. Here is an example with two different Smart Objects that contain the same Min Range Value (5603) Resource Type:

Note the green dot next to Analog Output, indicating that the currently open Resolution has been enabled for at least one of its Resources.

10 min has been enabled for Min Range Value (5603) in Analog Output but not in Analog Input. To summarize:

  • To make a Resolution available, you must enable it for a Resource Type in the specific Smart Object Type being used, regardless of whether that Resolution has been enabled for the same Resource Type elsewhere.

Note: The time interval of a Resolution starts when the new Resolution is saved,  not when the Rule is saved. For example:

  1. The resolution interval is set to 6 h (6 hours) and the Resolution is saved. The 6 hours time interval starts at this point.
  2. At the end of the current 6 hours period, the aggregation calculation is done and the trigger condition is checked by the Rule.

If the Realtime resolution interval is selected, the trigger condition is checked as soon as the data values are received.

Access Resolutions

Navigation: Settings -> Resolutions

The Resolutions page has a list of the Resolutions that have been enabled for at least one Resource under a specific Smart Object.

Create/Edit a Resolution

Navigation: Settings -> Resolutions -> +Create or click a Resolution

  • Timespan: Select an interval.
  • Smart Object: Select a Smart Object to view its Resources. The color circle to the left of Smart Objects is black for Smart Objects that do not use the selected Resolution/Timespan, and green for those that do.
  • Send aggregations to Business Intelligence Database: Turn on to store measurement data in SQL, which allows the data to be synced with OData services. All measurements are stored as text files in the BLOB-storage.
    • Measurement data is sent at the end of each aggregation interval.
    • Meta data (for example, information on devices and locations), is sent every 24 hours to the Business Intelligence database.
      This setting is obligatory to receive data via the Odata API.
  • Resource: Select the Resource for which the Resolution should apply.

Read a Resolution

To read the attributes of a resolution, do the following.

  1. Click the drop-down arrow on the Settings button.
  2. Select Resolutions. The Resolutions page opens.
  3. Click a resolution to view the settings.
  4. Click Expand/Hide All to expand or hide the list sub-items. An indicator to the left of each resource type name indicates if any item within the resource type is in use for the selected resolution.
    • Black – Indicates that the resource type is not in use for the selected resolution.
    • Green – Indicates that the resource type is in use for the selected resolution.
  5. Click > to expand the resource type and view the settings.
  6. Click Cancel to return to the Resolutions page.

Update a Resolution

To update a resolution, do the following.

  1. Click the drop-down arrow on the Settings button.
  2. Select Resolutions. The Resolutions page opens.
  3. Click the name of a resolution to edit. The Resolution setup window opens.
  4. In the Title field, edit the title for the resolution.
  5. Click to turn off or on the button: Persist to SQL (not just BLOB storage).
    Note: Turn on to store measurement data in SQL, which allows the data to be synced with OData services. All measurements are stored as text files in the BLOB-storage. Meta data (for example, info on devices and locations, etc.), is regularly sent to a Business Intelligence database.
    The measurements of this aggregation will also be sent to that BI DB, if the option is selected via the check-box.
  6. In the Resource Types section, click > on the same row as a resource type to expand the settings field. The Resource Type field expands to reveal the resource type settings. Each resource type has unique settings.
  7. In the Type ID column, click the box on the same row as a resolution to select it. Select/deselect as many types as needed.
  8. Click Save.

Delete a Resolution

To delete a resolution, do the following.

  1. Click the drop-down arrow on the Settings button.
  2. Select Resolutions. The Resolutions page opens.
  3. Click the trashcan icon on the same row as a resolution to delete it.
    A pop-up message asks for confirmation. Click Ok.