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/{id}/include
  • Exclude twins from region – PUT /json/region/{id}/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/{id}
  • Delete a specific region – DELETE /json/region/{id}
  • Patch existing region – PATCH /json/region/{id}
  • Find twins that are included in specified region – GET /json/region/{id}/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/{id}/includedin
  • GET /json/realestatecomponent/{id}/includedin
  • GET /json/buildingcomponent/{id}/includedin
  • GET /json/room/{id}/includedin
  • GET /json/storey/{id}/includedin
  • GET /json/asset/{id}/includedin
  • GET /json/device/{id}/includedin
  • GET /json/sensor/{id}/includedin
  • GET /json/actuator/{id}/includedin
  • GET /json/actuationinterface/{id}/includedin
  • GET /json/twin/{id}/includedin

And corresponding json-ld format endpoints:

  • GET /realestate/{id}/includedin
  • GET /realestatecomponent/{id}/includedin
  • GET /buildingcomponent/{id}/includedin
  • GET /room/{id}/includedin
  • GET /storey/{id}/includedin
  • GET /asset/{id}/includedin
  • GET /device/{id}/includedin
  • GET /sensor/{id}/includedin
  • GET /actuator/{id}/includedin
  • GET /actuationinterface/{id}/includedin
  • GET /twin/{id}/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://<host>/<class>?collection_ids=<uuid1>,<uuid2>,<uuid3>

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.