Skip to content

Data Table Qwidget

Jump to bottom
tarunigattu1992 edited this page Apr 26, 2019 · 4 revisions

Description

The purpose of this qwidget is to display a tabular listing of values of one or more telemetry data item.

The qwidget layout has three views:

  • Main View (Default view)
  • Delete Menu
  • Settings Menu

Main View

On opening the qwidget, this view is displayed.This viewing window has the following main elements.

  • Data table header
  • Data rows.

Table header The table header consists of column names/titles for the table.There are icons(title is displayed on hover) for number type columns and text labels for the string type columns.Following are the columns(in order) displayed by default in the data table.

Column: ID

Description:

  • This column displays the telemetry data item id.
  • This is a string type column.

Column: Name

Description:

  • This column displays the telemetry data item name.
  • This is a string type column.

Column: Alarm Low Value

Description:

  • This column displays the alarm low value of the telemetry data item if available, otherwise displays 'N/A'.
  • This is a number type column.

Column: Warn Low Value

Description:

  • This column displays the warn low value of the telemetry data item if available, otherwise displays 'N/A'.
  • This is a number type column.

Column: Value

Description:

  • This column displays the value of the telemetry data item if available, otherwise displays 'N/A'.
  • This is a number type column.

Column: Warn High Value

Description:

  • This column displays the warn high value of the telemetry data item if available, otherwise displays 'N/A'.
  • This is a number type column.

Column: Alarm High Value

Description:

  • This column displays the alarm high value of the telemetry data item if available, otherwise displays 'N/A'.
  • This is a number type column.

Column: Units

Description:

  • This column displays the units of the telemetry data item value if available, otherwise displays 'N/A'.
  • This is a string type column.

Column: Notes

Description:

  • This column displays any additional description or notes related to the telemetry data item if available, otherwise displays 'N/A'.
  • This is a string type column.

Data rows

  • There are 40 empty rows in the table by default.

  • Each row has a button(in the first column) on the left which displays the list of operations which can be performed on the row.The operations are divided to data operations and row operations.When a telemetry data item is applied to a row, the Value column’s value updates every second. This value is displayed in the color according to data state colors.

  • The data row button icon color turns to cyan blue on hover, otherwise the row button icon color is gray.

  • The data row button displays a dropdown menu with the following options.

    Option: Select Telemetry Id

    Description:

    • This option is used to select the telemetry data item from the data tree of the data menu. Clicking on the option will open the data menu (left navigation menu) on the dashboard. A telemetry data item can be selected by traversing through the data tree in the data menu (or search using the search bar). The row button icon color turns to cyan blue color when select telemetry id option is selected until data is applied in the row. This option is a data operation.

    Option: Select Group

    Description:

    • This option is used to select a category of telemetry data from the data tree of the data menu.
    • Clicking on the option will open the data menu (left navigation menu) on the dashboard.A telemetry category can be selected by traversing through the data tree in the data menu (or search using the search bar).
    • The row button icon color is in cyan blue color when select group option is selected until data is applied.
    • This option is a data operation.

    Option: Add Row Above

    Description:This option is a row operation and is used to add a row above the selected row.

    Option: Add Row Below

    Description: This option is a row operation and is used to add a row below the selected row.

    Option: Move Row Up

    Description: This option is a row operation and is used to move the selected row(except the first row) above one level.

    Option: Move Row Down

    Description: This option is a row operation and is used to move the selected row(except the last row) below one level.

    Option: Delete Row

    Description:This option is a row operation and is used to delete a row. This option does not delete a row if it is the only row in the table.

    Option: Convert to header

    Description:

    • This option is a row operation and is used to convert a row to header panel(background color or the row:blue, color of the text in the row:white).
    • This header panel is an input field where the user can add the header title. By default the title is empty string. On focus, the input field is editable and on blur, the header is disabled for edit.

Data Selection and apply

This section explains how to add data to the table rows:

  1. Select the button(in the first column) on the row in which the data has to be added.This will open the menu.
  2. Follow Select Telemetry Id and Apply Telemetry Id sections mentioned above in the above table to add a single telemetry data item in the table.
  3. Follow Select Group and Apply Group sections mentioned in the above table to add a category of telemetry data rows in the table.

Delete Menu

This menu can be viewed by clicking the trash icon on the qwidget header.This menu has yes and no buttons.This menu is used to delete the qwidget from the dashboard

Settings Menu

This menu is used to select or unselect the columns to be shown in the data table.

This menu can be viewed by clicking the settings button(cog icon) on the qwidget header.This menu has the following main elements.

  • Select Category dropdown
  • Save and Close buttons

Select Category dropdown

This dropdown displays a list of all column names of the table and checkboxes beside each column name.The user can select/unselect the column name to shown/hidden from the data table.

Save

This is used to save the column selection/unselection. On successful save, the qwidget layout changes from settings menu to main view layout displaying table rows with selected column values shown in the data table.

Close This is used to close the settings menu and view the main layout. Any changes made before close are lost if not saved.

Clone this wiki locally