The guide below will teach you how to present each OSGi configurations you want to control with dedicated features of the Edge Services configurations thing. A filter configuration property is provided to allow registration as functional items and then as features only for those configurations, matching the LDAP filter value.

When Things Agent is started no configuration functional items are registered by default. Respectively, no configuration features are presented for configurations thing in Bosch IoT Thing service. Both the ConfigurationFactory functional item and feature provide the configuration property filter. The values of the filter are interpreted as follows:

• null or empty string – this is the default value and no configuration functional item will be registered.
• an asterisk value ("*") – this is a special value which means all OSGi configurations will be registered as functional items and will be represented as configuration features of the Edge Services configurations thing.
• any other value – this should be an LDAP filter that is matched against the configuration properties and only the matching OSGi configurations will be represented as functional items and features of the Edge Services configurations thing.

Cloud connection

To include OSGi configurations as features in Edge Services configurations thing the value of the property filter should be set to be different from null or empty. Go to Command and Control guide to learn how to set the functional item property.

The following example demonstrates how to include all installed OSGi configurations in Edge Services runtime as features of the <namespace>:<gatewayId>:edge:services:configurations thing. By default no configuration functional items are represented as features:

Set the ConfigurationFactory property filter to *.

POST /things/<namespace>:<gatewayId>:edge:services:configurations/features/ConfigurationFactory/inbox/messages/$set.configuration/filter

with payload:

"*"

As a result all OSGi configurations are represented as features of the Edge Services configurations thing.

Local connection

Set with LDAP filter the ConfigurationFactory property filter to register as functional items the OSGi configurations, matching that value.

The implementation of the BundleFactory and its property filter is bound to an OSGi configuration named Things Agent Bundle Factory with com.prosyst.mbs.things.agent.items.osgi.bundle.pid.

A change of the filter property value through its setter method reflects the filter property of the OSGi configuration; and vice versa – a change in filter property of the OSGi configuration affects the filter property of the BundleFactory functional item.