Bosch IoT Device Management

Manage device features

To follow this page, your entry point is Bosch IoT Manager Console (Dashboard) > Device Management perspective.


When you have selected a device on the list, the top right view will be called Features and Task Executions Info, and its Features section will be expanded by default.

There you can:

  • create, edit and delete features

  • copy feature scripts (convenient for including in mass management scripts)

  • search and filter features

  • view feature information

  • execute feature operations (actions), if such have been defined in the Vorto model of the feature

  • set feature properties


images/confluence/download/attachments/2111257269/Features-Filtering.png

Create, edit and delete features

A device may be provisioned with predefined features, which will appear on the dashboard.

However, you can also Create new features, and Edit and Delete existing features, using the following buttons respectively:


images/confluence/download/thumbnails/2111257269/Manage-Features.png

Create

Clicking Create Feature will open a wizard where you need to fill in an arbitrary Feature ID and add a Vorto model ID in the definitions section (see screenshot). The Vorto model ID should follow the standard convention for Vorto models, in particular namespace:name:version. It should be the ID of an existing model or one that is expected to be created, in order to benefit from the capabilities defined in it. Check the Vorto GitHub repository for any models that may be suitable for you.

In addition, you may configure access to your private Vorto repository and use your private Vorto models stored in it. Check how to do that here.

When searching for Vorto models in the repository, you have to select the Functionblock option in the TYPES combobox.

images/confluence/download/thumbnails/2111257269/Functionblock.png

For example, try with the Geolocation model that you see on the screenshot.

You may also optionally define any additional properties with their values and categories (property types) in the properties section below. The property type can be either status or configuration, and is also not mandatory even if you add a property and its value.

Confirm with Create.

images/confluence/download/attachments/2111257269/Create-a-Feature.png

Edit

Clicking Edit Feature will open a wizard with the same information, where you can add, remove and change definitions and properties.

You may also edit a feature directly from the Features Info Properties view of a selected feature (see bottom of the page),

Delete

Clicking Delete Feature will ask for your confirmation before deleting the feature completely.


Copy feature script

When you hover over a feature on the list of features, you will see its corresponding script.

To Copy this script, right click on the feature of interest from the list of features and select the Copy script button from the menu.

images/confluence/download/thumbnails/2111257269/dm_di_feature_right_click_menu.png


This will open a dialogue with the feature script in a format which allows you to copy it.

images/confluence/download/thumbnails/2111257269/dm_di_copy_feature_script_dialogue.png

You may include such scripts in the definition of actions for mass management tasks and rules.

Search and filter features

All features of the selected device will be listed in the Features section.

Features having at least one Vorto model are marked with images/confluence/download/thumbnails/2111257269/dm_di_vorto_feature.png , whereas features without any Vorto model - with images/confluence/download/thumbnails/2111257269/dm_di_non_vorto_feature.png .


To find a particular feature more easily, you may use the available filtering options - Filter by Vorto model or Filter by ID.

  • Filter by ID - type in the ID of the feature you are looking for. This search is not case sensitive.

  • Filter by Vorto model - provides a combobox which displays a list of all the Vorto models of all the features defined for the respective device.
    When you select a Vorto model from it, the list of features that appears will be filtered so as to show only those features which have the selected Vorto model.

images/confluence/download/attachments/2111257269/Features-Filtering.png

Make sure you are viewing the feature through the perspective of the most relevant Vorto model. Go to the Filter by Vorto model combobox and select the model whose properties you are going to set for this feature. Then select the feature itself.

As each feature may have zero, one or several Vorto models with different levels of detail, the system loads the most detailed model by default. However, if for some reason this model cannot be found, the system will move to the next one available for this feature.


View feature information

When you select a particular feature, the console will open the Features Info Properties view below, where you can see all properties already defined for this feature. By default, the Features Info Properties view opens in table view. In it, all feature properties are represented according to their format - simple key-value properties, JSON or map.

You can switch between table view and tree view with the button images/confluence/download/thumbnails/2114640013/Tree-Mode.png .

images/confluence/download/attachments/2111257269/Features-Info-Properties.png