Table of Contents

Creating a parameter table connected to an element feed

In this tutorial, you will learn how to craft a GQI query to display parameters from a specific protocol table in a dashboard. You will also learn how to link the query to an element feed to control which element's data is shown in the table.

Expected duration: 10 min.

Note

The content and screenshots for this tutorial have been created with the DataMiner Web Apps version 10.4.3.

Prerequisites

  • DataMiner Web Apps version 10.3.5 or higher
Note

The parameters queried in the example originate from elements using the Microsoft Platform protocol. However, this process will work for elements utilizing any protocol that features table-based parameters.

Overview

Step 1: Create a dashboard and add a dropdown and table component

  1. Create a new dashboard.

  2. Drag and drop the dropdown visualization from the pane on the left to the dashboard.

    This will add a dropdown component, where users will be able to select an element in order to filter the GQI results.

  3. Drag and drop the table visualization from the pane on the left to the dashboard.

    This will add a table component, where the output of the GQI query will be shown.

Step 2: Configure the dropdown component to list all elements of a specific protocol

  1. From the data pane, drag the Elements data header onto the data input of the dropdown component.

    Dragging the Elements data header onto the data input of the component

  2. From the data pane, drag the desired protocol onto the filter input of the dropdown component.

    Dragging a protocol onto the filter input of the component

The dropdown component will now list all available elements that match the protocol you selected.

  1. In the data pane, open the QUERIES section and click the "+" icon.

    Adding a query

  2. Enter a descriptive query name, e.g. Disk Information Table.

  3. Select the Get parameters for elements where data source.

  4. Set Type to "Protocol".

  5. Select a protocol.

    Note

    This should be the same protocol as the one you used to filter the dropdown component in step 2.

  6. Select a protocol version.

  7. Select the protocol table that contains the data that you want to display in the table component.

    Selecting the protocol table

  8. Optionally, add a Select operator to control which parameters from the specified protocol table are displayed in the GQI table.

    Adding a Select operator

    Note

    At this point, it is important that Element ID column remains selected to allow linking to the dropdown component.

  9. Add a Filter operator to filter the query results using the element that will be selected in the dropdown feed.

    1. Select the Filter operator.

    2. Set Column to "Element ID".

    3. Set Filter method to "regex".

    4. On the right side of the Value box, click the Link to feed icon to open the Link to feed dialog.

      1. Open the Feed box, and select the dropdown component.

      2. Open the Property box, and select "Element ID".

      3. Click Apply.

    Adding a Filter operator

  10. Optionally, if you do not want the element ID to be displayed in the table, add another Select operator where "Element ID" is no longer selected.

    Omitting the element ID

  11. Scroll up until you see the header of the query you are editing, and click the pencil icon to save the query.

    Saving the query

  12. Drag the query from the data pane onto the table component.

    Dragging the query onto the table component

  13. Click Stop editing to exit the edit mode.

The table component should now display the parameters specified during query creation, and their values should change depending on the element selected in the dropdown feed.

Result

Propose changes