You are viewing the documentation for Blueriq 16. Documentation for other versions is available in our documentation directory.

Before you upgrade make sure to read the General Upgrade instructions as well as the Upgrade instructions for previous versions.

The changes are color coded. Orange elements have been changed, Green elements have been added and Red elements have been removed compared to the 16.x release.

Table of contents

DCM case data properties

The property for removing aggregates when a case gets closed has been changed.

old
blueriq.case.engine.data.remove-aggregates-on-case-close = false
new
blueriq.case.engine.data.general.remove-aggregates-on-case-close = false

JsonPath expressions for mapping JWT claims

With this release, we introduced JsonPath expressions for expressing paths to JWT claims to allow our customers more flexibility. The JsonPath expressions replace the old, comma-separated list of path elements. To move from the old format to a JsonPath expression, one would typically prepend the legacy expression with $. and replace all commas with dots. For example, the legacy expression realm_access,roles should be replaced by $.realm_access.roles, and the legacy expression preferred_username should be replaced by $.preferred_username.

The following properties should be migrated to the new JsonPath format:

Runtime:

  • blueriq.security.jwt-claims.username-path
  • blueriq.security.jwt-claims.roles-path
  • blueriq.security.jwt-claims.teams-path
  • blueriq.security.jwt-claims.claim-mapping.*

Please note that for the Runtime, we introduced a legacy toggle to enable the old comma-separated expression format. Please refer to Legacy Properties for more information.

DCM Maintenance App:

  • blueriq.jwt.roles-path
  • blueriq.jwt.username-path

DCM Dashboard Service:

  • blueriq.jwt.roles-path
  • blueriq.jwt.username-path

DCM Dashboard Service exports

With the release of the DCM Dashboard modelling in Encore we have removed the JSON export format from the 1.0.0 of the DCM Dashboard Service. The JSON format can still be used in the 0.4.0 version which will be latest version that contains both exports formats to allow a transition period from between JSON exports and modelled exports. See DCM Dashboard overview on how to create a dashboard in Encore.

Customer data service event publisher properties

To be able to publish event messages, the event channel needs to be configured in blueriq-customerdata-odata-service-v1-entity-event-publisher-amqp.yml. This file can be found at <Blueriq installation folder>\Services\blueriq-customerdata\conf. The properties to configure the event publisher have been changed.

old
# RabbitMQ configuration
spring:
  rabbitmq:
    host: localhost
    port: 5672
    virtualHost: /
    username: guest
    password: guest
    dynamic: false
    ssl:
      enabled: false

# Aggregate event channel configuration
blueriq:
  customerdata:
    aggregate-event:
      channel:
        amqp:
          exchangeName: CustomerDataService

new
blueriq:
  customerdata:
    aggregate-event:
      channel:
        amqp:
          rabbitmq:
            host: localhost
            port: 5672
            virtualHost: /
            username: guest
            password: guest
            ssl:
              enabled: false
            exchangeName: customerDataService
 

Known issues

For an overview of known issue please refer to: Known issues.