Filtering on digital twins
Digital Twin filtering enables more precise searches beyond simply identifying business objects (BOs) with a digital twin. You can now refine your search based on specific conditions, such as temperature, humidity, and other datapoints.
This functionality works by translating your filter settings in the Planon application into an API query that runs in Planon IoT. Once the relevant data is retrieved, the results are seamlessly displayed in the Planon application, providing deeper insights and more targeted search capabilities.
Preconditions
• Planon IoT is enabled.
If Planon IoT is not enabled, IoT filtering can’t be used.
• The use cases are Active.
System use cases are always Active, but if a use case App is installed, make sure that it is also Active.
• At least 1 digital twin is linked to the definition. This allows the system to create the Group template and allows filtering.
• The Reference date is not set.
Procedure
Let's assume you want to filter on a specific condition: "I want to have an overview of all the spaces where the temperature exceeds 25°C.
1. Go to Space & workspaces.
2. At the top of the elements list, click on Add filter.
3. Select the Digital Twin definition.
 | The Planon IoT filter always works in combination with Planon filtering, forming an AND condition. IoT filtering is automatically activated when you select a definition. If you do not explicitly want to filter on Planon data, you can use the condition Code contains a value as an alternative. |
4. If you only want to filter on the definition, you can proceed by clicking OK. Otherwise, go to the next step.
5. Choose the datapoint on which you want to filter (e.g. Temperature).
6. Set the condition (temperature > 25°C).
7. Click OK.
Only spaces that match the specified condition are now displayed.
Saving and reusing filter
IoT filters cannot be applied to TSI filters and authorization filters.
When creating a filter, you can save it so that you can apply it later.
Filter behavior
The following points outline how filters dynamically adjust when datapoints or definitions are added or removed in the system. These behaviors ensure that filtering options stay up to date while providing appropriate notifications when references become unavailable.
Dynamic updates to filters
• If a new datapoint is added to a digital twin definition, it will automatically appear as a filtering option.
• If a datapoint is removed, the system will display a 'Datapoint reference not found' error when attempting to use the filter that has this datapoint configured
• Adding a new definition manually to the Group template in Planon IoT is not part of the filtering (future feature).
Removing definitions and datapoints
• If a definition or datapoint is removed, the system will continue to operate normally, but the filter will no longer apply.
• When viewing or editing the filter, a 'Reference not found' message will be displayed.