Release notes – version 5.6.7

In this release

New application(client credentials) scopes for edge management and telemetry jobs API’s can be fetched using the GET /json/application/scopes endpoint. Сlearer actuation and statetroupe cluster-communication responses. We added the support of CSV file processing in POST /import. Two new edge connectors come online — Schneider EBO (EWS) and Göteborg Energi — alongside actuation support for Iconics and improvements to the Mestro connector.

API

Application scopes for edge management and telemetry jobs. 

New application scopes have been added for the edge management and telemetry jobs APIs, allowing access to these endpoints to be granted independently.

{
    "type": "EdgeManagementApplication",
    "value": "https://proptechos.onmicrosoft.com/{env}/api/.default"
  },
  {
    "type": "TelemetryApplication",
    "value": "https://proptechos.onmicrosoft.com/{env}/api/.default"
  }

Clearer actuation rejections.

actuationAccepted: false responses now include a reason field explaining why the actuation was not accepted. If the actuation was accepted and reason is null it is not included in the response

Example:

{
  "actuationObservedBy": null,
  "generatedCommandResponse": "1e0effa4-d7ae-4904-9f8c-5514006e4d34",
  "id": "12b2a0e8-d9a6-4bd9-b7e1-f0ee087bf83f",
  "requestAccepted": false,
  "reason": "Actuation interface validation failed: 0 is not within the defined range."
}

Cluster communication errors 

Now on the observation/edge statuses requests. When API client cannot reach the statetroupe cluster,  API now returns a descriptive custom error identifying the communication issue instead of 404

Telemetry API

CSV telemetry import. 

The telemetry import now accepts CSV as an input format in addition to the existing formats. 

Edge Connectors

New edge connectors:

• Schneider EBO (EWS). ebo-ews-connector reads data from the Schneider EBO supervisor’s Enterprise Web Services SOAP API 
• Göteborg Energi

Connector improvements:

• Mestro connector. The connector no longer drops low-coverage observations. It accepts coverage ≥ 0.95 on both the initial poll and retries, publishes matured values, and publishes the best-available value once a period ages out (4 weeks) instead of dropping it. 
• Iconics connector. Now supports actuations.  

Breaking changes

None

Fixes and minor improvements

• PLAT-5034: Swedish translation of placement context ExhaustAir corrected to “Avluft”.
• PLAT-5146: Wrong label for VirtualBuildingComponent, RoofInner, and RoofOuter classes.
• PLAT-4526: Unable to review geometry on the list-components-by-filter endpoint.
• PLAT-5293: PATCH does not escape special characters (e.g. apostrophes in values caused a 500).
• PLAT-5393: switch-market correctRetrievedPredictions ignored sensorId, inflating baseline and flexibility offers.
• PLAT-5439: Agent could remain incomplete when edits happened close together.
• PLAT-5444: Couldn’t regenerate or delete a deactivated secret.
• PLAT-5475: Issue with updating a room’s area.
• PLAT-5476: Issue with updating space collections (lost building association).
• PLAT-5502: Telemetry API Sensor write-class permission requirement clarified (allowWriteTwinClasses: [“Sensor”] is required in addition to the telemetry scope).
• PLAT-5364: Enabled S-Bus (SAIA) actuation