|
Test Case Title |
|
|
Goal |
I can:
|
|
Prerequisites |
A snap4city user registered on the Snap4City portal |
|
Expected successful result |
|
|
Steps |
|
In the following, the necessary steps are illustrated to allow a Snap4City registered user to perform IOT Discovery on the Dashboard Wizard, with the goal for the final user to learn how to search and explore IOT Devices and related data. The final user is able to visualize public IOT Devices/data, as well as those owned by the logged user, as well as those for which the logged user has delegations from other registered owners.
Example 1: Search IOT Devices, visualize them on map, check and monitor healthiness and last data values
- Log in the Snap4City portal and click on the “Dashboards” menu item on the left-side bar:
- You can search and explore IOT Devices on the new version of the Wizard, which is accessible by clicking on the “New Dashboard” yellow button on the top-right side of the screen:
- You can access the new Wizard also by editing a Dashboard you own:
- Once the Dashboard Wizard is opened, choose the “Data and widgets” panel.
5. In the “Data and widgets” panel of the Dashboard Wizard, you can search any kind of data managed by the Snap4City backend architecture, in particular you can search and explore IOT Devices by filtering on the desired column fields, on the basis of the IOT Device main characteristics. For instance, you can filter on High-Level Type (the most generic categorization type), Nature, Subnature (additional, more specific classification levels), Value Type (the kind of metric which is measured/actuated by the device), Value Name (the name of the device or the metric which is measured/actuated by the device), Data Type (the measure unit of the single metric), Healthiness (a status check monitoring if the device is healthy or not, on the basis of specific healthiness criteria computed on the back end) and Ownership (“public” or “private”, which in turn is differentiated in “private (My Own)” or “private (Delegated)” depending on whether the user owns or have delegations to see those data).
6. If you want to search for IOT Devices data, you have several options: for example, you can filter by High-Level Type, first de-selecting all the filter items (by firstly unchecking the “Select-all” item), and then by selecting the “Sensor” and/or “Sensor-Actuator” categories. The former option includes the IOT Devices reading data, the latter includes the IOT Devices actuator data.
7. You can filter also by Nature, first de-selecting all the filter items (by firstly unchecking the “Select-all” item) selecting the following types:
- a. “From Dashboard to IOT Device”, which is a subset of the “Sensor” High-Level Type field above mentioned at step 6, showing IOT Devices reading data;
- b. “From IOT Device to KB”, which is a subset of the “Sensor-Actuator” High-Level Type field above mentioned at step 6.
8. You may also filter by Subnature, first de-selecting all the filter items (by firstly unchecking the “Select-all” item) selecting the following types:
- a. “IoTSensor”, which is a subset of the “From Dashboard to IOT Device” Nature, showing IOT Devices reading data.
- b. “IoTSensor-Actuator”, showing IOT Devices actuators data.
9. It is also possible to filter by Value Type, first de-selecting all the filter items (by firstly unchecking the “Select-all” item) and then selecting the desired types. In this case, many Value Types filter items may be present in the Value Type list, depending on the number of registered IOT Devices and which metrics they are observing (reading) or actuating (writing). However, if you have previously filtered IOT Device data by one of the fields previously mentioned at steps 6,7 and 8 (i.e.: selecting “Sensor” and/or “Sensor-Actuator” as High-Level Type, or “From Dashboard to IOT Device” and/or “From IOT Device to KB” as nature, as well as IoTSensors and/or IoTSensor-Actuators as Subnature), all the other filter boxes related to the other columns (therefore, including the one for the Value Type field) show only the filter items which are available and selectable according to the previously activated filtering options. In this way, the user can easily view all the Value Types related to IOT Devices only.
10. The same approach, adopted for Value Type filtering described in the previous step, can be used for filtering by Data Type (which represents the measure unit of the single metric). Also in this case, many different Data Types items can be available in this menu list. Anyway, you can choose to view Data Types related to IOT Devices only by activating one or more of the filter options previously described in steps 6, 7 and 8.
11. You can also filter by Healthiness, first de-selecting all the filter items (by firstly unchecking the “Select-all” item) and then selecting one of the two (mutually exclusive) provided values: “true” (selecting which only the healthy devices are shown, by displaying a green circle on the Healthiness cell of the corresponding record) or “false” (selecting which only the unhealthy devices are shown, by displaying a red circle on the Healthiness cell of the corresponding record).
12. Finally, you can also filter by Ownership, first de-selecting all the filter items (by firstly unchecking the “Select-all” item) and then selecting one of the two (mutually exclusive) provided values: “public” (selecting which only the public devices are shown) or “private” (selecting which only the private devices are shown, further differentiated between “private (My Own)” and “private (Delegated)” depending on whether the currently logged user owns or have delegations to see those data).
Only users with the highest privileged role, i.e.: RootAdmin, can view private data, belonging to other registered users, which are not under his ownership and for which he/she has not any delegations. In these cases, the only string “private” is shown, without any further details on the owners or delegator users, in order to be compliant with the requested privacy rules and policies, like shown in the next picture:
By the way, if the RootAdmin user has his/her own or delegated devices, he visualizes his/her own/delegated data in the same way above described, i.e. as “private (My Own)” or “private (Delegated)”.
13. Once you have explored your desired IOT Devices, by playing with the different filter boxes and search functionalities, you can select one or multiple rows of the Wizard table, representing one or more IOT Device metrics.
- a) When a row is selected, the corresponding IOT Device position is visualized on the map on the top-left side of the Wizard (if the geographical coordinates of the selected devices are available);
- b) Then, after the selection you can see the selected record which is shown in the “Chosen data sources” table at the bottom of the Wizard.
- c) Then, you can select a desired widget icon (on the top-right of the Wizard), or simply press the “Confirm” button in the bottom-right corner of the Wizard, in order to create instantiate a new widget in your current dashboard (which can be a newly created one or an existing one you are editing, depending on how you have accessed the Wizard, see steps 2 and 3 above described in this Test Case).
14. As a final result, after the selection of the desired IOT Devices and the widget chosen for representing their data (the speedometer in this test case), it is possible to instantiate them in the dashboard you are currently editing, by simply press the “Confirm” button in the bottom-left corner of the Wizard (as illustrated in the next figure).
