Prerequisites

At this point, we assume you have already configured the connection to forward data from the digital twin layer to Bosch IoT Insights, and that your demo device policy explicitly allows the forwarding.

Find the specific data that should be displayed

• Log in to your Bosch IoT Insights project.

• Explore > Data Browser

  • Each event forwarded by the digital twin layer is displayed as one object.

  • By default, the JSON view is displayed.

• Explore > Data Explorer > Add Query Template
  

  The query template can serve as the data source for a widget.
  Refer to the Bosch IoT Insights' documentation of the Data Explorer to find out more about query templates.

1. Set a Name for the template in order to find it again at a later point in time.

2. The description is optional.

3. The label is optional.
   
   
   

   
   

4. In case you have registered multiple devices but want to display only one, you can filter for the thing ID e.g.
   Replace line 4 "my.namespace.example:demo-01" with the ID of your device respectively.

   [

   {

   "$match": {

   "metaData.thingId" : "my.namespace.example:demo-01"

   }

   },

   { "$sort" : { "_id" : -1 }

   },

   { "$limit" : 100 }

   ]

5. Save the changes.

Add a widget to display the values

1. Scroll down to the very end of your Overview page.

2. Click Add widget.
   

   1. From the General view, select the one that you think is closest to your needs.
      In this example, we show the steps for a Signals Widget.

   2. The Signals Widget view highlights the missing default settings.

   3. As a Data Source, you can select:
      

      1. Query Template

      2. Your own query template created in the section above.

      3. Save data source

      4. The Widget Preview - at the right side - shows that some settings are still missing.

   4. For the Signals Settings:

      1. In the X-Axis / Timestamp Field, select [i].payload.timestamp - this is the time when the digital twin layer modified the data.

      2. In the Y-Axis/ Signals Root select [i].payload.value.compass.properties.status - this is the path where the values of the demo device compass sensor belong to.

   1. For Preselected signals, activate the checkboxes for the values you are interested in. In our example, we selected all except the sensorUnits.

   2. Click Add to have this widget rendered on your Overview page.

3. By default, the widget shows up at the end of the page.

4. If you need the size or the title adjusted:
   

   1. Click Activate Editing at the end of your Overview page

   2. Then click the edit icon in the upper right corner of the chart.
      E.g. to adjust the width edit Dashboard settings > Size > Half (2 Columns).

   3. Click Save to close the editing mode.

5. If you want to see the chart at the start of the page:

   1. Click Start sorting at the end of your Overview page.

   2. Drag and drop the widget to the top.

   3. Finish sorting.