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
- Step 2: Configure the dropdown component to list all elements of a specific protocol
- Step 3: Configure a GQI query to display parameters from a specific protocol table and link it to the dropdown feed
Step 1: Create a dashboard and add a dropdown and table component
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.
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
From the data pane, drag the Elements data header onto the data input of the dropdown component.
From the data pane, drag the desired protocol onto the filter input of the dropdown component.
The dropdown component will now list all available elements that match the protocol you selected.
Step 3: Configure a GQI query to display parameters from a specific protocol table and link it to the dropdown feed
In the data pane, open the QUERIES section and click the "+" icon.
Enter a descriptive query name, e.g. Disk Information Table.
Select the Get parameters for elements where data source.
Set Type to "Protocol".
Select a protocol.
Note
This should be the same protocol as the one you used to filter the dropdown component in step 2.
Select a protocol version.
Select the protocol table that contains the data that you want to display in the table component.
Optionally, add a Select operator to control which parameters from the specified protocol table are displayed in the GQI table.
Note
At this point, it is important that Element ID column remains selected to allow linking to the dropdown component.
Add a Filter operator to filter the query results using the element that will be selected in the dropdown feed.
Select the Filter operator.
Set Column to "Element ID".
Set Filter method to "regex".
On the right side of the Value box, click the Link to feed icon to open the Link to feed dialog.
Note
Starting from DataMiner 10.3.0 [CU21]/10.4.0 [CU9]/10.4.12, the icon and dialog are labeled as Link to data instead.
Open the Feed box, and select the dropdown component.
Open the Property box, and select "Element ID".
Click Apply.
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.
Scroll up until you see the header of the query you are editing, and click the pencil icon to save the query.
Drag the query from the data pane onto the table component.
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.