In this release
New twin sorting functionality is introduced.
New functionality
Sorting
Since this release it is possible to retrieve sorted paged data. By default all paged data is provided as an unsorted collection. In order to obtain paged and sorted data, a new query parameter ‘sort’ is introduced. The new parameter accepts a list of comma separated properties to sort the result by. Parameters could be sorted in either ascending (‘asc’) or descending (‘desc’) order.
Ascending order will be taken by default
All parameters could be provided with sorting order in the format ‘parameter.order’ (e.g. ‘class.desc,littera.asc’), just ‘parameter’ (e.g. ‘class,littera’) or a combination (e.g. ‘class.desc,littera’).
The following parameters are allowed to be sorted by:
For all endpoints:
- id
- class
- littera
- status
- popularName
- createdTime
- updatedTime
For Device endpoints:
- hasDeviceFunctionType
(applicable to ‘/device’, ‘/json/device’ endpoints); - deviceQuantityKind
(applicable to ‘/device’, ‘/json/device’, ‘/actuator’, ‘/json/actuator’, ‘/sensor’, ‘/json/sensor’ endpoints); - devicePlacementContext
(applicable to ‘/device’, ‘/json/device’, ‘/actuator’, ‘/json/actuator’, ‘/sensor’, ‘/json/sensor’ endpoints); - deviceMeasurementUnit
(applicable to ‘/device’, ‘/json/device’, ‘/actuator’, ‘/json/actuator’, ‘/sensor’, ‘/json/sensor’ endpoints);
For BuildingComponent and Room endpoints:
- roomType
(applicable to ‘/room’, ‘/json/room’ endpoints);
For Agent endpoints:
- username
(applicable to ‘/person’, ‘/json/person’ endpoints);
Twin status: Test
- In addition to Valid, Incomplete, Incorrect and SuspectedInvalid, which covers the lifecycle of a production twin, we introduce the Test status, so that non-production twins can be handled separately from production twins.
Breaking changes
None
Fixes and minor updated (internal links are added only for reference)
Minor defects and bugs are fixed and small performance improvements.
Fixed defects: