Bosch IoT Rollouts

Target filters view

Table of contents:

Purpose

Custom target filter overview and filter management.

Features explained

  • Custom target filters allow the user to filter targets by a defined custom query.

  • Displays a custom target filter list that can be searched by the user for any particular filter.

  • Create, update and delete operations are supported for target filters.

  • User can auto assign distribution sets to a target filter.

Target Filter Management view at the Management UI (Classic)

The Target Filter Management view displays a list of all created target filters with valuable information organized in columns.

You can search for a specific target filter or create a new one using the icons on the right.

images/confluence/download/attachments/1695526745/target_filter-version-2-modificationdate-1634549593000-api-v2.png

Auto assignment

Every target filter can have an associated distribution set for auto assignment. If auto assignment is enabled for a filter, all matching targets will get the corresponding distribution set automatically assigned. This applies to targets that are currently registered in the system as well as to new registered targets later on.

The list of custom target filters contains the column “Auto assignment”. For a target filter it can display none or name and version of the selected distribution set (in case of forced autoassignment the thunderbolt icon is shown on the left handside, and the download icon in the case of download only assignments).

Clicking on the cell text will show the “Select auto assignment distribution set” window. It allows the user to enable auto assignment, select the action type (Forced, Soft, or Download Only) and one of the valid (having the required software modules assigned and not soft deleted) distribution sets from the dropdown list. In addition, a dropdown list supports filtering in order to facilitate the search of the distribution set for auto-assignment.

If the user consent flow feature has been enabled for the tenant, this window will show an additional checkbox for Confirmation required, activated by default. Find more details about such a scenario here.


images/confluence/download/attachments/1695526745/select_auto_assign_ds_dialog_enabled-version-3-modificationdate-1634549597000-api-v2.png

When the user has enabled auto assignment, chosen a distribution set together with action type and has clicked on save, a confirmation dialog appears, telling the user how many targets are going to be assigned with the selected distribution set.


images/confluence/download/attachments/1695526745/auto_assign_consequences_dialog-version-2-modificationdate-1634549600000-api-v2.png

How auto assignment works

A scheduler is running in the background that checks all target filters that have auto assignment enabled. As soon as a matching target is found which never had the distribution set assigned before, it will retrieve a new assignment to the distribution set defined by the filter.

Be aware: In case multiple target filters with different distribution sets will match the same targets, the order of distribution set assignments is unpredictable. But for sure there will be multiple assignments taking place until all different distribution sets were assigned to the target once. This might result in unexpected target updates. It is not recommended to have multiple target filters with auto assignment that match the same targets.

If the user consent flow feature has been enabled for the tenant, the triggered assignments will become RUNNING only after the end user of the targets has confirmed his or her consent to proceed with the update. Read more here.

Permissions

You need the following permissions to see the Target Filters view in:

  • read-only access mode: READ_TARGET, READ_REPOSITORY

  • full access mode: READ_TARGET, CREATE_TARGET, UPDATE_TARGET, DELETE_TARGET, READ_REPOSITORY, READ_TARGET_SEC_TOKEN

The cloud user has full access by default for all available service plans.

See Authentication and authorization for further information about available roles and their included permissions.

Auto assignment with enabled user consent flow

If the user consent flow feature has been enabled for the tenant, the “Select auto assignment distribution set” window (explained above) will show an additional field called Confirmation required with a check-mark selected by default.

images/confluence/download/attachments/1695526745/enable-auto-assignment-with-confirmation-required-version-2-modificationdate-1670603938000-api-v2.png

In that case, every time a distribution set is auto-assigned to a target matching the target filter, the end user of the device (target) will be asked to confirm that he or she wants to proceed with the update.

Therefore, the corresponding action will be assigned a WAIT_FOR_CONFIRMATION state until such a confirmation is granted. After confirmation is granted, the action will move to a RUNNING state and will proceed according to the default behavior. Find out more in Action state machine.


The Confirmation required check-mark can also be removed for the respective auto-assignment.

In that case the confirmation will still be required and not skipped, as the user consent flow feature is enabled for the whole tenant. However, the action will be treated as directly confirmed by the operator (the current user), and the action will move from WAIT_FOR_CONFIRMATION state to a RUNNING state automatically.

A use case for removing this check-mark could be a test assignment or a confirmation granted remotely to the operator in a phone call with the end user of the respective devices.


When the auto-assignment is enabled and the confirmation required check-mark is selected, there is an additional green user icon to indicate that a confirmation is pending.

When the auto-assignment is enabled and the confirmation required check-mark is removed, there is an additional red user icon to indicate that this is an exception and a confirmation is not required because it is treated as granted by the user who initiated the auto-assignment.

images/confluence/download/attachments/1695526745/auto-assignment-with-confirmation-required-icon-version-2-modificationdate-1670603734000-api-v2.png

Then, the confirmation required or respectively granted by the current user will be reflected in the action history messages for each target.

images/confluence/download/attachments/1695526745/image2022-12-9_18-45-58-version-1-modificationdate-1670604358000-api-v2.png