Manage the search index of a namespace
Each namespace has an individual search index. The search index contains the fields, that should be indexed for your things of this namespace. Thus, search queries can be filtered by these fields.
Indexable fields
- thingId
- policyId
- definition (thing definition)
- attributes and all sub-paths of attributes
- features and all sub-paths of features
_created
_modified
_revision
The fields
thingId
and _created
are the minimal indexed fields and can’t be deleted.
How to edit the search index
The Bosch IoT Things user interface provides various options:
- Minimal: includes
thingId
and_created
- Default: includes
thingId, policyId, definition, attributes
and_created
- Complete: includes all indexable fields
- Comfort: includes
thingId, definition, attributes, features/*/properties/status/agentName, features/*/properties/status/softwareModuleType
and_created
- Custom: includes
thingId
,_created
, and some of fields of your choice.
Example with customized search index
For package subscriptions, e.g. Bosch IoT Suite for Asset Communication and Bosch IoT Suite for Device Management, the user interface to manage namespaces as well as the search index settings per namespace are now available directly in Bosch IoT Suite Console.
The stand-alone Things UI remains available for customers who have booked their instance on the Bosch IoT Cloud.
A field that is wanted to be indexed, can be added via either a path (features/myFeature/properties/myProperty
)
or as a complex expression (features/myFeature(properties/myProperty)
).
Indexing via a complex expression allows for indexing multiple paths in one expression
(features/myFeature/properties(property1,property2)
)
Additionally, the field to be indexed can contain wildcards. The expression features/*/properties/temperature
would thus index all temperature feature properties, independent of the featureId
.
The indexed fields are, like the filter of a search query, case-sensitive.
In case you need to edit the search index via API, see the Solutions resource
PUT /solutions/{solutionId}/namespaces/{namespaceId}.
Find details about the Search RQL filter at
Developer guide > HTTP API > Search resources.