Bosch IoT Insights

Configuring a device type

You can change the name of a device type, add the German name of a device type, upload a default icon, and define the properties that are clustered in so-called information blocks.

This chapter details the following topics:

Prerequisites

  • You are assigned to the Manager role or higher.

  • You have created a device type and the device type settings are displayed.

    If you have paused the configuration of the created device type, click the Settings iconimages/confluence/download/thumbnails/1298640769/Icon_Settings_2020_05_13.png within the desired device type frame to configure the device type.

Changing the name of a device type

The name of a device type can be changed and, optionally, the German equivalent added.

Proceed as follows

  1. In the Label pane, click the name and make your changes.

  2. In the Label pane, click the EN drop-down list and select Add DE: German to add the German equivalent for the device type.

Setting the visibility of a device type

You can decide to which user roles the device type is visible.

Proceed as follows

  1. Activate/deactivate the Visible for User (always visible for role 'Manager' and higher) checkbox to configure the visibility.

  2. Activate the Devices can be booked in Calendar button to be able to select devices of this device type for a calendar booking.

The device type is grayed out for users that do not have the role Manager or higher if the checkbox was deactivated:

images/confluence/download/attachments/1298640769/2019-11-14_09h23_31.png

Uploading a default icon

You can select a new default icon for your device type. The icon will be applied to all devices linked to this device type.

Proceed as follows

  1. Click the Select Icon button to change the default icon.
    → A list of possible icons is displayed.

  2. Select an icon from the list.
    → The icon is set as the new default icon.

To reset the default icon, click the Reset to Default button.

Adding information blocks

Information blocks cluster the properties of a device type. The following information blocks can be added:

  • Details
    To add more information to the device. Similar to the General information block that is always added by default and cannot be removed.

  • Images
    To add an image of the device.

  • Attachments
    To add files that contain more information on the device, e.g. user manuals.

  • Hyperlinks
    To add website links that may contain important information on the device.

  • Bookings
    To add bookings of a device to be displayed in the calendar.

  • Device links information block
    To link devices to the device type.

  • Notes
    To add information on a device that does not fit into the other information blocks, e.g., advice, warnings, status updates.

  • JSON data information block
    To display generic data from Bosch IoT Things as a JSON data object if the data type is unknown to Bosch IoT Insights.

  • Thing attributes information block
    The attributes of the device that are stored in Bosch IoT Things, refer to the Attributes section in the Bosch IoT Things documentation.

For more information on how to configure these information blocks, refer to the subchapters of Managing information blocks.

These information blocks can be marked as mandatory so that they are added automatically when a device of that device type is created.

images/confluence/download/attachments/1298640769/Devices_Device_Type_Information_Block_2020_05_12.png

By default, the information blocks General and Details are already available.

Proceed as follows

  1. Click the Add Information Block drop-down list.

  2. Select the desired information block.
    → The information block has been added and can be configured.

    To change the order of information blocks, click the Move button, hold it, and drop it to the desired location.

    To remove an information block, click the Remove button.

Configuring information blocks

Every information block can be enhanced with general information.

Proceed as follows

  1. In the line of the desired information block, click the Edit button.

  2. Optionally, change the Technical name of the information block.

  3. Enter a Custom Label that will be displayed when viewing the device.

  4. In the Custom Label pane, click the EN drop-down list and select Add DE: German to add the German equivalent for the device type.

  5. Optionally, activate the Mandatory (initially added to new devices) checkbox so that this information block will be automatically added when the device is created. It cannot be removed.

  6. Optionally, activate the Enable users for editing checkbox so that users with the role User can edit this information block.

  7. Optionally, activate the Enable version history for this information block checkbox to enable device history tracking.
    → The information you have added is saved automatically.

The information blocks General and Details can be enhanced with custom properties. These properties can be of the following types:

  • String

  • Text (Multiline)

  • Number

  • Boolean

  • Date

  • Date time

  • Hyperlink

Properties that are added to the information block General are displayed in the device overview and can be used to filter the devices.

Proceed as follows

  1. Click the Edit button in the line of the General or Details information block.
    → The table containing the predefined properties is empty.

    images/confluence/download/attachments/1298640769/Devices_Device_Type_Information_Block_Properties_2020_05_12.png
  2. Click the Add Property button to add a new property to the information block.
    → The Property dialog is displayed.

    images/confluence/download/attachments/1298640769/Devices_Device_Type_Information_Block_New_Properties_2020_05_12.png
  3. Select a Type in the drop-down list.

  4. Enter a Name for the property.

  5. Optionally, enter a Hint that explains the property.

  6. For the String type, enter a Default value.

  7. For the String type, optionally activate the Provide value selection checkbox to add more options to choose from. Click the Add Option button and enter a Label and a Value.
    Example:

    images/confluence/download/attachments/1298640769/Devices_Device_Type_Information_Block_Properties_String_2020_05_12.png
  8. For the Text (Multiline) type, enter a text to the Default Value.

  9. For the Number type, enter a number to the Default Value.

  10. For the Boolean type, optionally activate the Default Value checkbox.

  11. For the Hyperlink type, enter a Default link.

  12. Click the Save button.
    → The properties have been added to the General or Details information block of the device type.
    Example:
    images/confluence/download/attachments/1298640769/Devices_Device_Type_Information_Block_Properties_Example_2020_05_13.png

    To change the order of properties, click the Move button, hold it, and drop it to the desired location.

    To remove a property, click the Remove button.

  13. In the Track Property column, activate the checkbox in the column header to have all properties tracked in the History or the individual checkboxes for each property.

  14. In the Required Property column, activate the checkbox for a property to be a required input field when creating a device.

  15. Activate the Allow Custom Properties checkbox to allow a user to create own properties in the individual devices.
    → The information block has been configured.

The device type has now been configured. To add devices to the device type, go back to the device type overview, refer to Viewing a device type.