In this release

Added support of new objects classes Collections and Zones, and new Quantity Kinds. Additionally the edge interface was updated with improved backward compatibility of edge message versions.

New functionality

Collections

RealEstateCore Collection (https://w3id.org/rec/core/Collection) is a generic grouping of objects of the same or different classes. There are subclasses of Collection, like Apartment which is a collection of rooms, which are not implemented, but will be in a future release. A Collection cannot include other collections.

To get the contents of a collection, there is a /includes endpoint

The content of a collection is operated with an /include operation for addition of one or more objects, and an /exclude operation for subtraction of one or more objects. To get the contents of a collections

Operation to work with collections:

  • GET /json/collection
  • GET /json/collection/{id}
  • GET /json/collection/{id}/includes
  • POST /json/collection
  • PUT /json/collection
  • PUT /json/collection/{id}/include
  • PUT /json/collection/{id}/exclude
  • DELETE /json/collection/{id}
  • GET /collection
  • GET /collection/{id}
  • GET /collection/{id}/includes
  • POST /collection
  • PUT /collection
  • PUT /collection/{id}/include
  • PUT /collection/{id}/exclude
  • DELETE /collection/{id}

Zones

An added subclass of Building Component Zone. A zone is similar to a room in logic. It has local coordinates and is usually some area designated for a specific purpose or tied to some business logic. A Zone can be sub-Building Component to a Room or to a Storey. RealEstateCore 3.3 will include Zone, but in preparation of that release, ProptechOS will have Zones in our extension of RealEstateCore 3.2 (https://w3id.org/rec/core/Zone). The standard BuildingComponents endpoints are used to work with Zones. Specify “class”:”Zone”.

  • GET /json/buildingcomponent (specify buildingcomponent_classes=Zone)
  • GET /json/buildingcomponent/{id}
  • POST /json/buildingcomponent (specify “class”:”Zone”)
  • PUT /json/buildingcomponent
  • DELETE /json/buildingcomponent/{id}
  •  
  • GET /buildingcomponent (specify buildingcomponent_classes=Zone)
  • GET /buildingcomponent/{id}
  • POST /buildingcomponent (specify “class”:”Zone”)
  • PUT /buildingcomponent
  • DELETE /buildingcomponent/{id}
  •  

Version handling and backwards compatibility for Edge messages

Added backward compatibility support of edge message versions. Sensor Observations will be parsed and transformed to the latest representation before they are saved, and for an Actuator, ProptechOS will remember what edge message version the Device is communicating in, and send and receive Actuation Command, Actuation Command Response according to that.

The following edge message versions are fully supported:

  • RealEstateCore v2.3 “rec2.3”
  • RealEstateCore v3.1 “rec3.1”
  • RealEstateCore v3.1.1 “rec3.1.1”

New Quantity Kinds
Added new Quantity Kinds:

  • http://proptechos.com/ontology/extension/SoundAverage
  • http://proptechos.com/ontology/extension/SoundPeak

Breaking changes

–

Fixes and minor updated

Minor stabilization fix for PUT operations.