In this release

Even more collection improvements are introduced, and a new collection subclass: Region.

New functionality

Region

Region – collection sub-class that allows grouping twins of classes RealEstate and Building. New endpoints to manage Regions are introduced:

  • Include twins into region – PUT /json/region//include
  • Exclude twins from region – PUT /json/region//exclude
  • Find region based on filter – GET /json/region
  • Update existing full region – PUT /json/region
  • Register a new region – POST /json/region
  • Find a specific region GET /json/region/
  • Delete a specific region – DELETE /json/region/
  • Patch existing region – PATCH /json/region/
  • Find twins that are included in specified region – GET /json/region//includes

Collections including Twin

It is possible to fetch a list of collections that a specified twin is included in. There are new endpoints to achieve the required result:

  • GET /json/realestate//includedin
  • GET /json/realestatecomponent//includedin
  • GET /json/buildingcomponent//includedin
  • GET /json/room//includedin
  • GET /json/storey//includedin
  • GET /json/asset//includedin
  • GET /json/device//includedin
  • GET /json/sensor//includedin
  • GET /json/actuator//includedin
  • GET /json/actuationinterface//includedin
  • GET /json/twin//includedin

And corresponding json-ld format endpoints:

  • GET /realestate//includedin
  • GET /realestatecomponent//includedin
  • GET /buildingcomponent//includedin
  • GET /room//includedin
  • GET /storey//includedin
  • GET /asset//includedin
  • GET /device//includedin
  • GET /sensor//includedin
  • GET /actuator//includedin
  • GET /actuationinterface//includedin
  • GET /twin//includedin

Twins included in Collection

A new filter based on collections, returning only twins (that meet the other filter criteria) that are included in one or more specified collections. This filter use the query parameter ‘collection_ids’, it accepts comma separated collection ids:

https:///?collection_ids=,,

Affected endpoints:

  • GET /json/realestate
  • GET /json/realestatecomponent
  • GET /json/buildingcomponent
  • GET /json/room
  • GET /json/storey
  • GET /json/asset
  • GET /json/device
  • GET /json/sensor
  • GET /json/actuator
  • GET /json/actuationinterface
  • GET /json/twin

And corresponding json-ld format endpoints:

  • GET /realestate
  • GET /realestatecomponent
  • GET /buildingcomponent
  • GET /room
  • GET /storey
  • GET /asset
  • GET /device
  • GET /sensor
  • GET /actuator
  • GET /actuationinterface
  • GET /twin

Breaking changes

None

Fixes and minor updated

Improved alias based routing of actuation commands.