AppIoT 201820 Release Notes

Release Notes Ericsson Application Platform for IoT

Main end user improvements

  • Queue Mode

Queue Mode allows for messages to be queued when devices are offline/unreachable. AppIoT implements one queue per device.

Queue Mode has an impact on all message requests sent from AppIoT to a device. Message requests sent to the gateway are not affected.

  • Device online/offline notifications
  • Duplicate message detection
  • Intermediate queue on gateway (requires gateway changes)
  • Send requests synchronously or asynchronously
  • Configure message queuing via SettingCategory “Device Message Queue”
  • For more information: http://docs.appiot.io/?page_id=47274

 

  • Add grouped Activity Logs
    • Collapsible parent-child entries with more log details.
  • Add Tenant Setting Categories and new inheritance model
    • New inheritance model for Setting Categories where setting values can be inherited on all levels: tenant, device network, device/gateway template, and device/gateway instance.
  • Publish Orleans metrics to LogAnalytics
  • Mass Delete Devices
    • New API call (preview version, to be improved)

 

 

  • Fixed support issues:
    • AIOTSUP-861 Security issue: information disclosure due to overly verbose error messages
      • Removed overly verbose error messages that caused disclosure of backend URL/directory structure for API calls.
    • AIOTSUP-1329 Unassigning role from DN doesn’t remove user access grant to the DN
      • User access model cache is now invalidated after role update, and .
      • All users are removed from the group in the AD.
    • AIOTSUP-1081 DataCollectorTemplate can be changed to one that is not of the correct DataCollectorType
      • Validation added.
    • AIOTSUP-1085 Warning popup when opening a gateway overview page in the GUI
      • Warning popup about changing device template now removed.
    • AIOTSUP-1567 Implement new HTTP headers to increase security and not leak server information
      • HTTP Strict Transport Security
      • X-Content-Type-Options
      • X-Frame-Options
      • X-XSS-Protection
    • AIOTSUP-1341 api/v3/devices/getByFilterSmall with IncludeChildLocations set to false still returns devices from child locations
      • Fixed to act on IncludeChildLocations flag.
    • AIOTSUP-1350 api/v3/devices/getByFilterSmall with non-GUID in LocationIds returns all devices under the root location
      • Fixed to handle non-GUIDs correctly.
    • AIOTSUP-1439 Show SmartObjectType number when creating template
      • TypeId for SmartObjectTypes and ResourceTypes now displayed when creating SmartObjectTemplate.
    • AIOTSUP-1458 ResourceTypes of all access types do not show up in Actuator filter
      • Now sets access types correctly so that correct resources are shown for ResourceCollection with cherry-picked resources.
    • AIOTSUP-1461 Can’t save rule with empty trigger conditions
      • Added checkbox to disable trigger conditions instead of removing value.
    • AIOTSUP-1562 Frontend header has the wrong height using IE11
        • Made svg icons being displayed properly in IE.
    • AIOTSUP-1978 Performance issues when retrieving measurements for a resource based on device
      • Created API call devices/{id}/smartobjects to handle performance issues when retrieving measurements for a resource based on device.
    • AIOTSUP-2035 Can’t delete “” value in the resource template
      • Added checkbox to disable template value instead of removing value.

 

Web API changes

  • api/v3/devices/{deviceId}/queueitems GET added
  • api/v3/devices/{deviceId}/queueitems/{correlationId} GET, DELETE added
  • api/v3/devices/{id}/smartobjects GET added
  • api/v3/devices/multiple/delete POST added
  • api/v3/dataCollectors/{id}/settingvalues PUT added
  • api/v3/devices/{id}/settingvalues PUT added
  • api/v3/dataCollectorTemplates/{id}/settingvalues PUT added
  • api/v3/devicetemplates/{id}/settingvalues PUT added
  • api/v3/resources/{id}/write PUT modified, added possibility to set SendRequestSynchronously in request body
  • api/v3/resources/{id}/observe PUT modified, added possibility to set SendRequestSynchronously in request body
  • api/v3/resources/{id}/cancelobserve PUT modified, added optional request body with possibility to set SendRequestSynchronously
  • api/v3/resources/{id}/read PUT added with possibility to set SendRequestSynchronously in request body
  • api/v3/resources/{id}/execute PUT added with possibility to set SendRequestSynchronously in request body
  • api/v3/smartobjects/{id}/resources/read PUT added with possibility to set SendRequestSynchronously in request body
  • ActivityLogEntry: Added IsParent, ParentId, Status:Aborted, EntityType:DeviceNetwork
  • Resolution: Added PersistToSql
  • DefaultSettingResponse: Added SettingCategoryId
  • SettingResponse: Added SettingCategoryId, InheritedValue
  • TenantSettingCategory: Added IsHardwareSettings, IsSecuritySettings, added CreatedTenantSettings, UpdatedTenantSettings, DeletedTenantSettings in request
  • DeviceFilterBase: Made IncludeChildLocations not read-only
  • ResourceResponse: Added SmartObjectName, SendRequestsSynchronouslyByDefault
  • api/v3/dataCollectors/register added description for existing response 404
  • api/v3/devices/{id}/settingcategories/{settingCategoryId}/settings POST now deprecated, replaced by api/v3/devices/{id}/settingvalues PUT
  • api/v3/datacollectors/{id}/settingcategories/{settingCategoryId}/settings POST now deprecated, replaced by api/v3/datacollectors/{id}/settingvalues PUT
  • api/v3/defaultsettings/{id} DELETE now deprecated, replaced by api/v3/settingscategories PUT
  • api/v3/tenantsettings POST now deprecated, replaced by api/v3/tenantsettingcategories POST and api/v3/tenantsettingcategories/{id} PUT
  • api/v3/tenantsettings/{id} PUT and DELETE now deprecated, replaced by api/v3/tenantsettingcategories/{id} PUT
  • api/v3/tenants/{id}/settingcategories/{settingCategoryId} POST now deprecated, handled in api/v3/tenantsettingcategories POST
  • api/v3/tenants/{id}/settingcategories/{settingCategoryId} DELETE now deprecated, handled in api/v3/tenantsettingcategories/{id} DELETE
  • api/v3/tenants/{id}/addsettingcategory POST now deprecated, handled in api/v3/tenantsettingcategories POST
  • api/v3/tenants/{id}/removesettingcategory/{settingCategoryId} DELETE now deprecated, handled in api/v3/tenantsettingcategories/{id} DELETE
  • LastSeen in DeviceResponse and DeviceListResponse now deprecated, replaced by online/offline notifications through SignalR
  • DefaultSettings in api/v3/settingcategories POST and api/v3/settingcategories/{id} PUT is now deprecated, replaced by CreatedDefaultSettings, UpdatedDefaultSettings, DeletedDefaultSettings

Known issues

There is a known GUI bug in this release. Devices will now have a proper state (Online, NeverActivated etc.) which AppIoT is taking into consideration with the Queue Modee functionality. The issue is that new devices gets the green icon and status Online after creation. The correct status would be “NeverActivated”. In Queue Mode it should get the state Online after AppIoT receives a measurement or AppIoT receives any communication from device.