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

1. New

1.1. Added HTTP REST request method: PATCH

Blueriq now supports sending PATCH requests to other services. Receiving incoming PATCH requests for a Blueriq as a REST Service (BaaRS) is not supported. Additionally, we added the option to specify the direction for which a rest service is used (incoming, outgoing or both). The default to which existing applications will be migrated is 'both'. By specifying 'incoming' or 'outgoing', Blueriq Encore provides the Business Engineer guidance in how to model their REST service, by only showing relevant information and validate in a stricter way so that errors are discovered in an earlier stage.  

1.2. TSL support in Encore

Blueriq Encore is now able to parse Text Substitution Language (TSL).

This means that:

  • You will now receive real time validations on TSL while editing,
  • TSL related validations are now included in the validation report,
  • TSL will be included in the dependencies,
  • Enhancement compared to Studio: renames of elements that are used in TSL will now be updated in TSL.

1.3. Decision table editor improvements in Blueriq Encore

We've increased the readability and usability of decision tables and conditional value lists in Blueriq Encore:

  • We've made some visual changes to recognize the structure (condition vs. action and subject vs. alternative) of a decision table more easily, 
  • We've added autofit of decision table cells. 
  • It's easier to add multiple rows or columns by repeatedly clicking on the +-icon.
  • The first column of the decision table is sticky/frozen when scrolling horizontally as a result of large tables or small screen sizes.

1.4. Copy unit test profile from another unit test in Encore

It is now possible to copy a profile from another unit test into the currently opened unit test. To do so, use the duplicate button () near the "Profiles" header. A dialog will open in which you can choose the unit test you want to copy the profile from. If another unit test with the same target attribute already exists, it will be selected automatically in the dropdown for your convenience. This automatic selection is new compared to Studio. 

1.5.  JSON preview for domain schema's in Encore 

We've added a bottom drawer to the domain schema editor in which a preview of the JSON message is shown. The preview is updated automatically while editing the domain schema so the result of the edit is instantly visible. The JSON preview is the first example of the use of the bottom drawer, which is ideal to provide some additional information while seeing editor content, helping the business engineer to innovate and maintain faster. Be prepared for future use of the bottom drawer in a wide range of use cases in other editors!

1.6. DCM Case Modeling Dashboard Development Toolbar

We have added development toolbar support to the DCM Case Modeling Dashboard application. To enable this feature add the devtools query parameter to the URL of the DCM Dashboard request in the browser. This feature is enabled out of the box using the DCM Development installation. To add support to existing setups visit the upgrade instructions page for this release.

1.7.  JWT Authentication for (Custom) Material Theme

We have added JWT Authentication support for the material theme. This enables external themes to be started from the development dashboard when using JWT authentication as your authentication provider. To add support to custom themes visit the upgrade instructions page for this release.

1.8. Health Check of Blueriq Services

We added an endpoint to the Blueriq Gateway Service, DCM Lists Service , Customer Data Service , Audit Consumer, Dashboard and the DCM Maintenance App which can be used to determine if the service is running.  How to configure and reach these endpoints can be read in the Actuator endpoint topic of each service. 

2.  Enhancements

Enhancement Details
Spring Boot 3.1

Spring Boot has been updated from 3.0 to 3.1.3. Generally, this introduces newer versions of libraries. There are some upgrade instructions.
If your project has custom code that depends on libraries that come with Spring Boot, you may want to check the release notes from Spring.

Increased number of items shown in dropdowns in Encore

Blueriq Encore now shows a maximum of 14 instead of 8 items in an expanded dropdown selector which leads to less scrolling and increased readability.

Added validation in Encore

Blueriq Encore now shows a validation error if multiple elements over multiple configuration modules in the same project have the same name.

Location information in validation report in Encore

Blueriq Encore now shows the location of a validation error or warning within an element in the project validation report.

Convert relation to reusable domain schema in Encore

Relations in the domain schema editor can now be converted to reusable domain schemas in Blueriq Encore.

Navigate to the unit tests of a specific attribute in Encore

In the attribute, decision table and business rule editors, Blueriq Encore now shows an icon to allow navigating to an overview of an attribute's unit tests. An improvement over Blueriq Studio is that the icon indicates whether there all any unit tests for the attribute at all, showing the icon greyed out if there are no tests.

3. Documentation

Documentation on the new features and improvements of this release is linked in the respective topics.

4. Upgrade Instructions

There are no specific upgrade instructions for this release.

As a best practice

  • backup your repository
  • backup your database before running scripts
  • backup your spring.config.additional-location directory ([Blueriq installation directory]\Runtime)
  • backup any config files you have altered under [Blueriq installation directory]\Services

before you start the upgrade.

5. Artifacts

 The Blueriq artifacts are available under name: 16.4.0.1619

This release includes these versions of Blueriq components with a separate life cycle:

Component

Version

Customer Data Service 4.3.2
DCM Lists Service 3.0.7
Material Theme 1.2.2
Development tools frontend 1.5.6
DCM Maintenance App 3.0.6
Audit Consumer 0.3.0
DCM Dashboard Service 0.2.7
Gateway Service 0.2.1
Document Renderer 1.1.2

6. Blueriq Libraries

There are no specific Library updates for this release.

7. Libraries

In this release, the set of third party libraries that is used by Blueriq was updated. When your installation of Blueriq includes custom components (artifacts that do not ship with Blueriq, such as proprietary plugins), those components should be tested for compatibility with these changes.


ArtifactId

GroupId

License

Version in 16.3.1

Version in 16.4

amqp-client

com.rabbitmq

Apache License 2.0

5.16.1

5.17.1

brave

io.zipkin.brave

Apache License 2.0

5.14.1

5.15.1

brave-context-slf4j

io.zipkin.brave

Apache License 2.0

5.14.1

5.15.1

brave-instrumentation-http

io.zipkin.brave

Apache License 2.0

5.14.1

5.15.1

brave-instrumentation-httpclient

io.zipkin.brave

Apache License 2.0

5.14.1

5.15.1

brave-instrumentation-spring-web

io.zipkin.brave

Apache License 2.0

5.14.1

5.15.1

bson

org.mongodb

Apache License 2.0

4.8.2

4.9.1

bson-record-codec

org.mongodb

Apache License 2.0

4.8.2

4.9.1

byte-buddy

net.bytebuddy

Apache License 2.0

1.12.23

1.14.6

hibernate-core

org.hibernate.orm

LGPL 2.1

6.2.3.Final

6.2.7.Final

httpclient5

org.apache.httpcomponents.client5

Apache License 2.0

5.1.4

5.2.1

httpcore5

org.apache.httpcomponents.core5

Apache License 2.0

5.1.5

5.2.2

httpcore5-h2

org.apache.httpcomponents.core5

Apache License 2.0

5.1.5

5.2.2

jackson-annotations

com.fasterxml.jackson.core

Apache License 2.0

2.14.3

2.15.2

jackson-core

com.fasterxml.jackson.core

Apache License 2.0

2.14.3

2.15.2

jackson-databind

com.fasterxml.jackson.core

Apache License 2.0

2.14.3

2.15.2

jackson-dataformat-xml

com.fasterxml.jackson.dataformat

Apache License 2.0

2.14.3

2.15.2

jackson-dataformat-yaml

com.fasterxml.jackson.dataformat

Apache License 2.0

2.14.3

2.15.2

jackson-datatype-jsr310

com.fasterxml.jackson.datatype

Apache License 2.0

2.14.3

2.15.2

json-path

com.jayway.jsonpath

Apache License 2.0

2.7.0

2.8.0

log4j-to-slf4j

org.apache.logging.log4j

Apache License 2.0

2.19.0

2.20.0

micrometer-commons

io.micrometer

Apache License 2.0

1.10.10

1.11.3

micrometer-core

io.micrometer

Apache License 2.0

1.10.10

1.11.3

micrometer-observation

io.micrometer

Apache License 2.0

1.10.10

1.11.3

micrometer-tracing

io.micrometer

Apache License 2.0

1.0.9

1.1.4

micrometer-tracing-bridge-brave

io.micrometer

Apache License 2.0

1.0.9

1.1.4

mongodb-driver-core

org.mongodb

Apache License 2.0

4.8.2

4.9.1

mongodb-driver-sync

org.mongodb

Apache License 2.0

4.8.2

4.9.1

netty-buffer

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-codec

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-codec-dns

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-codec-http

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-codec-http2

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-codec-socks

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-common

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-handler

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-handler-proxy

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-resolver

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-resolver-dns

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-resolver-dns-classes-macos

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-resolver-dns-native-macos

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-transport

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-transport-classes-epoll

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-transport-native-epoll

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

netty-transport-native-unix-common

io.netty

Apache License 2.0

4.1.96.Final

4.1.97.Final

nimbus-jose-jwt

com.nimbusds

Apache License 2.0

9.24.4

9.31

org.eclipse.jgit

org.eclipse.jgit

EDL

6.6.0.202305301015-r

6.6.1.202309021850-r

org.eclipse.jgit.http.apache

org.eclipse.jgit

EDL

6.6.0.202305301015-r

6.6.1.202309021850-r

org.eclipse.jgit.ssh.apache

org.eclipse.jgit

EDL

6.6.0.202305301015-r

6.6.1.202309021850-r

spring-boot

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-actuator

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-actuator-autoconfigure

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-autoconfigure

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-configuration-processor

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-starter

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-starter-actuator

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-starter-logging

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-boot-starter-validation

org.springframework.boot

Apache License 2.0

3.0.10

3.1.3

spring-data-commons

org.springframework.data

Apache License 2.0

3.0.9

3.1.3

spring-data-jpa

org.springframework.data

Apache License 2.0

3.0.9

3.1.3

spring-data-keyvalue

org.springframework.data

Apache License 2.0

3.0.9

3.1.3

spring-data-mongodb

org.springframework.data

Apache License 2.0

4.0.9

4.1.3

spring-data-redis

org.springframework.data

Apache License 2.0

3.0.9

3.1.3

spring-hateoas

org.springframework.hateoas

Apache License 2.0

2.0.6

2.1.2

spring-ldap-core

org.springframework.ldap

Apache License 2.0

3.0.5

3.1.1

spring-security-config

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-core

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-crypto

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-ldap

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-oauth2-client

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-oauth2-core

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-oauth2-jose

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-oauth2-resource-server

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-security-web

org.springframework.security

Apache License 2.0

6.0.6

6.1.4

spring-session-core

org.springframework.session

Apache License 2.0

3.0.3

3.1.2

spring-session-data-redis

org.springframework.session

Apache License 2.0

3.0.3

3.1.2

8. Retirement announcement

There are no specific retirement announcements.

For a full list of deprecated features, go to Deprecated features.

9. Bug fixes

Identifier

Component

Issue

Solution

BQ-21121

DCM Dashboard

The DCM Dashboard war fails to startup throwing a stack trace about security configuration

The DCM Dashboard actuator security endpoint configuration was inconclusive resulting into a stack trace when running the DCM Dashboard inside an application server. This is fixed.

BQ-21078

Runtime

CVE-2023-34042 has been detected for spring-security-config 6.1.3 and 5.7.10.

Fixed by updating spring-security-config to version 6.1.4 and 5.7.11

BQ-21064

Audit Consumer, Runtime

CVE-2023-4759 was detected for Eclipse JGit lower than 6.6.1.

Fixed by updating Eclipse JGit to version 6.6.1

BQ-20873

Encore, Studio

A project validation would be reported when exporting a project when a global field type had presentation styles and was used in a container or on a page.

Using presentation styles in a global field that is used on a page or in a container will no longer result in a failed project export.

BQ-20743

Encore

The aggregate editor in Encore could incorrectly show relations as invalid, or may cause the browser to hang when removing relations.

The editor has been completely revamped to address these issues, as well as improving how relations are shown in the editor.

CSD-4860

Studio

Deleting elements that are part of merge conflicts would not properly update those conflicts

The Studio Server now properly updates relevant merge conflicts when elements are removed

CSD-4842

Runtime



BQ-20080

Runtime

Debug logging is polluted with unrecognizable stack traces which cannot related to the an actual failure for the AbstractSessionAwareFilter

Additional logging was added to determine whether exceptions that occurred during the logic of the AbstractSessionAwareFilter were recoverable and relatable to actually errors. It seem that they were not and therefore the logging is removed.

CSD-4499

Runtime

When defining the following property connection.restservice.http.header.auth-header in a application.properties file and in a second property file which is activated by a profile. The property from the application.properties was picked up instead the one declared in the profile properties file.

Reading certain properties, for instance header properties for http connections, did not follow the property overloading mechanism which was expected.
We have fixed this behavior and properties are now loaded in their ordered precedence.

10. Known issues

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