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

1. Highlights

Our goal is to swiftly introduce new features, prioritizing speed over waiting for major releases unless absolutely necessary. This approach ensures a gradual impact and shortens time to market. Unlike minor updates, major releases may involve breaking changes like removing outdated features or upgrading technology.

Highlights of release 17.0:

  • Technology upgrades (JDK 21, OpenAPI 3.1, Keycloak 24.0, .NET 8) keeping Blueriq secure and stable.
  • Removal of deprecated features, toggles, and properties marking the end of a transition period.
  • Improved flexibility for secured REST connections using OAuth2
  • Improved readability of logging

2. Enhancements

EnhancementDetails
OAuth2 clients a la Spring Security

We changed the way you configure an OAuth2 client on REST connections. Now you can define OAuth2 clients separately and reference them from multiple connection if desired. 


See Release 17.0 Upgrade Instructions for more details.

Default HTTP timeouts

The default read timeout for AQ_RestServiceCall and AQ_SoapServiceCall has been changed to 5 seconds (was 15 seconds). The advantage is that a request will now fail faster if it takes long, so that the user doesn't have to wait so long. If you have service calls that take longer than 5 seconds, you can override the timeout per connection. See Connections Properties for more information.

Timeouts for CMIS

We introduced properties to set the connection timeout and the read timeout for CMIS. Both default to 5 seconds. See CMIS Properties on how to change them.

Improved readability of logging

Logging for flows, processes, and certain service calls throughout Blueriq applications has been improved by improving the consistency of log levels and actual log statements.

3. Documentation

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

4. Changes Platform Support

Our Platform support is updated.

Changes are:

  • Blueriq Java components now require Java 21 to run.
  • Oracle 21C (Innovation Release)

4.1.  Discontinued

  •  Java 17 support is stopped, from Blueriq 17 onwards Java 21 or higher is mandatory.

5. Upgrade Instructions

OAuth2 token support on REST connections

In order to use your REST connections that use a OAuth2 token to authenticate correctly, after the upgrade you will need to migrate all the properties to the new structure as described in the "OAuth2 clients a la Spring Security" enhancement.

Please review the Release 17.0 Upgrade Instructions.

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.

6. Artifacts

 The Blueriq artifacts are available under name: 17.0.0.33

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

Component

Version

Customer Data Service5.0.1
DCM Lists Service4.0.0
Material Theme1.3.3
Development tools frontend2.0.0
DCM Maintenance App5.0.1
Audit Consumer1.0.1
DCM Dashboard Service2.0.1
Gateway Service1.0.1
Document Renderer2.2.0

7. Blueriq Libraries

There are no specific Library updates for this release.

8. 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.11

Version in 17.0

jakarta.el

org.glassfish

Eclipse Public License - v 2.0

4.0.2

(error)

netty-codec-dns

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-codec-http

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-codec-http2

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-codec-socks

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-handler-proxy

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-incubator-codec-classes-quic

io.netty.incubator

Apache License 2.0

0.0.62.Final

(error)

netty-incubator-codec-native-quic

io.netty.incubator

Apache License 2.0

0.0.62.Final

(error)

netty-resolver-dns

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-resolver-dns-classes-macos

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-resolver-dns-native-macos

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-transport-classes-epoll

io.netty

Apache License 2.0

4.1.108.Final

(error)

netty-transport-native-epoll

io.netty

Apache License 2.0

4.1.108.Final

(error)

reactor-netty

io.projectreactor.netty

Apache License 2.0

1.1.18

(error)

reactor-netty-core

io.projectreactor.netty

Apache License 2.0

1.1.18

(error)

reactor-netty-http

io.projectreactor.netty

Apache License 2.0

1.1.18

(error)

reactor-netty-incubator-quic

io.projectreactor.netty.incubator

Apache License 2.0

0.1.18

(error)

spring-webflux

org.springframework

Apache License 2.0

6.1.6

(error)

aalto-xml

com.fasterxml

Apache License 2.0

1.3.1

1.3.2

artifactory-java-client-api

org.jfrog.artifactory.client

Apache License 2.0

2.13.1

2.17.0

artifactory-java-client-httpClient

org.jfrog.artifactory.client

Apache License 2.0

2.13.1

2.17.0

artifactory-java-client-services

org.jfrog.artifactory.client

Apache License 2.0

2.13.1

2.17.0

commons-lang3

org.apache.commons

Apache License 2.0

3.13.0

3.14.0

core

com.google.zxing

Apache License 2.0

3.5.1

3.5.3

cxf-core

org.apache.cxf

Apache License 2.0

3.5.8

4.0.4

jackson-annotations

com.fasterxml.jackson.core

Apache License 2.0

2.15.4

2.17.0

jackson-core

com.fasterxml.jackson.core

Apache License 2.0

2.15.4

2.17.0

jackson-databind

com.fasterxml.jackson.core

Apache License 2.0

2.15.4

2.17.0

jackson-dataformat-xml

com.fasterxml.jackson.dataformat

Apache License 2.0

2.15.4

2.17.0

jackson-dataformat-yaml

com.fasterxml.jackson.dataformat

Apache License 2.0

2.15.4

2.17.0

jackson-datatype-jsr310

com.fasterxml.jackson.datatype

Apache License 2.0

2.15.4

2.17.0

javase

com.google.zxing

Apache License 2.0

3.5.1

3.5.3

jose4j

org.bitbucket.b_c

Apache License 2.0

0.9.4

0.9.6

jsoup

org.jsoup

MIT License

1.16.1

1.17.2

odata-client-api

org.apache.olingo

Apache License 2.0

4.9.0

5.0.0

odata-client-core

org.apache.olingo

Apache License 2.0

4.9.0

5.0.0

odata-commons-api

org.apache.olingo

Apache License 2.0

4.9.0

5.0.0

odata-commons-core

org.apache.olingo

Apache License 2.0

4.9.0

5.0.0

reactor-core

io.projectreactor

Apache License 2.0

3.6.5

3.6.4

Saxon-HE

net.sf.saxon

Mozilla Public License Version 2.0

11.6

12.4

springdoc-openapi-starter-common

org.springdoc

Apache License 2.0

2.1.0

2.4.0

springdoc-openapi-starter-webmvc-api

org.springdoc

Apache License 2.0

2.1.0

2.4.0

stax2-api

org.codehaus.woodstox

BSD License

4.2.1

4.2.2

swagger-annotations-jakarta

io.swagger.core.v3

Apache License 2.0

2.2.9

2.2.21

swagger-core-jakarta

io.swagger.core.v3

Apache License 2.0

2.2.9

2.2.21

swagger-models-jakarta

io.swagger.core.v3

Apache License 2.0

2.2.9

2.2.21

woodstox-core

com.fasterxml.woodstox

Apache License 2.0

6.5.1

6.6.1

xmlresolver

org.xmlresolver

Apache License 2.0

5.2.1

5.2.2

9. Retirement announcement

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

Removed legacy properties can be found in the Release 17.0 Upgrade Instructions.

10. Bug fixes

Identifier

Component

Issue

Solution

BQ-22611

 

In Blueriq 16.9 the date/time handling was performance optimized. As an unexpected side effect, the handling of historical dates (before the Gregorian calendar was in existence) could be incorrect because Julian and Gregorian date handling was sometimes mixed up

Starting in Blueriq 17.0, historic dates (before 15-10-1582 Gregorian) are interpreted and formatted using the (proleptic) Gregorian calendar rules instead of the Julian calendar rules.

11. Known issues

The AQ_DocumentLink container does not work in this version. We're aware of the issue and working on a solution.


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