You are viewing the documentation for Blueriq 17. Documentation for other versions is available in our documentation directory.
1. New
1.1. Start versioned DCM Dashboard dashboard projects using the DCM Dashboard Frontend
It is now possible to directly start a dcm dashboard from Encore in Material Theme. With the introduction of the loading dashboard projects from encore we have added a new API to DCM Dashboard service, which deprecates the old API. To take full advantage of this new feature it is mandatory to use the DCM Dashboard Service v2.2.1 and update your Material Theme version to 1.5.0 or update you @blueriq packages to 0.18.9 in you custom frontend project.
It is not only possible to start dcm dashboard from Encore, but we now also support multiple version of the same dashboard projects when running from exports. More information on how to connect the DCM Dashboard Service to Encore can be found here: Blueriq DCM Dashboard Service.
Please visit the upgrade instructions on how to connect the new DCM Dashboard Service API in your own custom theme.
1.1.1. DCM Dashboard Frontend Updates
To enable loading versioned DCM Dashboard project we have needed to update the URLs in the DCM Dashboard Frontend to start your dashboards. These are some example urls that should work when using the DCM Installation package:
- http://localhost:30000/dashboard/export-<project>/<branch>/<dashboard>/<page>
- http://localhost:30000/dashboard/export-Foundation/Trunk/Foundation/MainDashboard
When connecting the DCM Dashboard Service to Encore you also gain to ability to directly load your projects without exporting them manually, this is only available when the development-tools profile is active
- http://localhost:30000/dashboard/studio-<repository>-<project>/<branch>/<dashboard>/<page>
- http://localhost:30000/dashboard/studio-DCMFoundation-Foundation/Trunk/Foundation/MainDashboard
1.1.2. DCM Dashboard Shortcuts
Not only did we enable you to start versioned dashboard projects, but you can now also start them via a shortcut. Both the DCM Dashboard Service and Material Theme have been updated to configure and start you own shortcuts. More information on how configure the your shortcuts can be found here: Blueriq DCM Dashboard Service.
With the loading shortcuts we have also added a new entypoint in the DCM Dashboard Frontend, this is an example that should work when using the DCM Installation package:
- http://localhost:30000/dashboard/shortcut/<name>
- http://localhost:30000/dashboard/shortcut/foundation
- http://localhost:30000/dashboard/export-Foundation/Trunk/Foundation/MainDashboard
1.2. Configurable null value allowance in REST connectivity
As a Business Engineer, you can now control if the value of an item in the interface for REST connectivity (a domain schema) can be null or not. This feature enhances data validation by letting the Business Engineer specify which fields must contain data, ensuring better data integrity. This setting affects both incoming and outgoing messages and can simply be toggled for each item (attribute or relation) and is included in the OpenAPI feed and import as well.
2. Enhancements
| Enhancement | Details |
|---|---|
|
DCM Dashboard Service behind a context path |
By the default the DCM Dashboard Service now runs behind the /dcm-dashboard context path, meaning that every request to the DCM Dashboard Service should start with /dcm-dashboard. Please visit the upgrade instructions to determine the impact. |
|
Blueriq Runtime Development Dashboard: Runtime Configuration Sanitization |
In the Blueriq Runtime Development Dashboard, OS Environment Variables and Java System Properties will now be sanitized. The values for keys that might be might contain sensitive data will be replaced by a placeholder (******). Keys that should be sanitized are configurable through Development Properties. |
| Display task name on action button in worklist |
In a worklist it is possible to add an action button to start a task. Besides a button with a fixed name, there is now an option to use the display name of the task as well. When this option is toggled in encore, the display name of the task is used as button caption in the worklist. |
| Added Reply-To parameter to AQ_MailService |
The optional |
| FlowType "ExecuteTask" |
FlowType "ExecuteTask" has been renamed to "AutomaticTask". For more information Flow type: Automatic Task |
| TAB to select an item from a dropdown in Encore |
When tabbing away from a dropdown in Encore, the highlighted value will now be selected. |
| Import options in the navigation menu in Encore |
The import of a WSDL, XSD, OpenAPI file, or .docx document in Encore can now also be initiated via the navigation menu of the corresponding output element where this was previously only possible using the context menu of the branch.
|
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 has been updated.
Changes are:
- Added support for RabbitMQ 4.0
- Added support for MongoDB 8.0
- Removed support for RabbitMQ 3.12
- Removed support for MongoDB 6.0
5. Upgrade Instructions
See Release 17.7 Upgrade Instructions for the upgrade instructions for this release.
As a best practice
- backup your repository
- backup your database before running scripts
- backup your
spring.config.additional-locationdirectory ([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.7.0.246
This release includes these versions of Blueriq components with a separate life cycle:
|
Component |
Version |
|---|---|
| Customer Data Service | 5.1.2 |
| DCM Lists Service | 4.1.3 |
| Material Theme | 1.5.0 |
| Development tools frontend | 2.0.2 |
| DCM Maintenance App | 5.1.1 |
| Audit Consumer | 1.2.1 |
| DCM Dashboard Service | 2.2.1 |
| Gateway Service | 1.2.0 |
| Document Renderer | 2.3.0 |
7. Blueriq Libraries
For this release, the BlueriqBasicModelling Library 1.4.0 has been updated. Please upgrade to the latest BlueriqCompleteLibraries Package.
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 17.6 |
Version in 17.7 |
|---|---|---|---|---|
|
org.codehaus.groovy |
2.4.21 |
|
||
|
com.sun.mail |
2.0.1 |
|
||
|
io.zipkin.contrib.brave-propagation-w3c |
|
0.2.0 |
||
|
org.apache.groovy |
|
4.0.23 |
||
|
jakarta.mail |
|
2.1.3 |
||
|
net.minidev |
2.5.0 |
2.5.1 |
||
|
com.rabbitmq |
5.19.0 |
5.21.0 |
||
|
org.jfrog.artifactory.client |
2.17.0 |
2.19.1 |
||
|
org.jfrog.artifactory.client |
2.17.0 |
2.19.1 |
||
|
org.jfrog.artifactory.client |
2.17.0 |
2.19.1 |
||
|
org.bouncycastle |
1.78 |
1.78.1 |
||
|
io.zipkin.brave |
5.16.0 |
6.0.3 |
||
|
io.zipkin.brave |
5.16.0 |
6.0.3 |
||
|
io.zipkin.brave |
5.16.0 |
6.0.3 |
||
|
io.zipkin.brave |
5.16.0 |
6.0.3 |
||
|
io.zipkin.brave |
5.16.0 |
6.0.3 |
||
|
io.zipkin.aws |
0.23.5 |
1.2.5 |
||
|
org.mongodb |
4.11.1 |
5.0.1 |
||
|
org.mongodb |
4.11.1 |
5.0.1 |
||
|
net.bytebuddy |
1.14.12 |
1.14.19 |
||
|
com.fasterxml |
1.6.0 |
1.7.0 |
||
|
org.apache.commons |
2.10.0 |
2.12.0 |
||
|
commons-io |
2.15.1 |
2.17.0 |
||
|
io.micrometer |
1.1.1 |
1.1.2 |
||
|
org.owasp.esapi |
2.5.3.1 |
2.5.5.0 |
||
|
org.gwtproject |
2.10.0 |
2.11.0 |
||
|
org.hdrhistogram |
2.1.12 |
2.2.2 |
||
|
org.hibernate.orm |
6.4.4.Final |
6.5.3.Final |
||
|
com.zaxxer |
5.0.1 |
5.1.0 |
||
|
org.apache.httpcomponents.client5 |
5.2.3 |
5.3.1 |
||
|
org.apache.httpcomponents.core5 |
5.2.4 |
5.2.5 |
||
|
org.apache.httpcomponents.core5 |
5.2.4 |
5.2.5 |
||
|
com.fasterxml.jackson.core |
2.17.0 |
2.17.2 |
||
|
com.fasterxml.jackson.core |
2.17.0 |
2.17.2 |
||
|
com.fasterxml.jackson.core |
2.17.0 |
2.17.2 |
||
|
com.fasterxml.jackson.dataformat |
2.17.0 |
2.17.2 |
||
|
com.fasterxml.jackson.dataformat |
2.17.0 |
2.17.2 |
||
|
com.fasterxml.jackson.datatype |
2.17.0 |
2.17.2 |
||
|
jakarta.xml.soap |
3.0.1 |
3.0.2 |
||
|
jakarta.xml.ws |
4.0.1 |
4.0.2 |
||
|
net.minidev |
2.5.0 |
2.5.1 |
||
|
org.jsoup |
1.17.2 |
1.18.1 |
||
|
org.slf4j |
2.0.12 |
2.0.16 |
||
|
org.apache.logging.log4j |
2.21.1 |
2.23.1 |
||
|
org.apache.logging.log4j |
2.21.1 |
2.23.1 |
||
|
ch.qos.logback |
1.4.14 |
1.5.11 |
||
|
ch.qos.logback |
1.4.14 |
1.5.11 |
||
|
io.micrometer |
1.12.10 |
1.13.6 |
||
|
io.micrometer |
1.12.10 |
1.13.6 |
||
|
io.micrometer |
1.12.10 |
1.13.6 |
||
|
io.micrometer |
1.12.10 |
1.13.6 |
||
|
io.micrometer |
1.2.4 |
1.3.5 |
||
|
io.micrometer |
1.2.4 |
1.3.5 |
||
|
org.mongodb |
4.11.1 |
5.0.1 |
||
|
org.mongodb |
4.11.1 |
5.0.1 |
||
|
io.netty |
4.1.112.Final |
4.1.114.Final |
||
|
io.netty |
4.1.112.Final |
4.1.114.Final |
||
|
io.netty |
4.1.112.Final |
4.1.114.Final |
||
|
io.netty |
4.1.112.Final |
4.1.114.Final |
||
|
io.netty |
4.1.112.Final |
4.1.114.Final |
||
|
io.netty |
4.1.112.Final |
4.1.114.Final |
||
|
io.netty |
4.1.112.Final |
4.1.114.Final |
||
|
com.nimbusds |
9.43.3 |
9.43.4 |
||
|
io.projectreactor |
3.6.4 |
3.6.11 |
||
|
com.sun.xml.messaging.saaj |
3.0.3 |
3.0.4 |
||
|
net.sf.saxon |
12.4 |
12.5 |
||
|
org.slf4j |
2.0.12 |
2.0.16 |
||
|
org.springframework.amqp |
3.1.3 |
3.1.7 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.boot |
3.2.4 |
3.3.5 |
||
|
org.springframework.cloud |
4.1.0 |
4.1.4 |
||
|
org.springframework.cloud |
4.1.0 |
4.1.3 |
||
|
org.springframework.cloud |
4.1.0 |
4.1.3 |
||
|
org.springframework.cloud |
4.1.0 |
4.1.4 |
||
|
org.springframework.cloud |
4.1.0 |
4.1.4 |
||
|
org.springframework.cloud |
4.1.0 |
4.1.4 |
||
|
org.springframework.cloud |
4.1.0 |
4.1.3 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework.data |
3.2.4 |
3.3.5 |
||
|
org.springframework.data |
3.2.4 |
3.3.5 |
||
|
org.springframework.data |
3.2.4 |
3.3.5 |
||
|
org.springframework.data |
4.2.4 |
4.3.5 |
||
|
org.springframework.data |
3.2.4 |
3.3.5 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework.hateoas |
2.2.1 |
2.3.3 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework.ldap |
3.2.2 |
3.2.7 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework.amqp |
3.1.3 |
3.1.7 |
||
|
org.springframework.retry |
2.0.5 |
2.0.10 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.security |
1.1.1 |
1.1.3 |
||
|
org.springframework.security |
6.2.3 |
6.3.4 |
||
|
org.springframework.session |
3.2.2 |
3.3.3 |
||
|
org.springframework.session |
3.2.2 |
3.3.3 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework |
6.1.13 |
6.1.14 |
||
|
org.springframework.ws |
4.0.10 |
4.0.11 |
||
|
org.springframework.ws |
4.0.10 |
4.0.11 |
||
|
org.springframework.ws |
4.0.10 |
4.0.11 |
||
|
org.springdoc |
2.4.0 |
2.6.0 |
||
|
org.springdoc |
2.4.0 |
2.6.0 |
||
|
org.apache.sshd |
2.12.1 |
2.14.0 |
||
|
org.apache.sshd |
2.12.1 |
2.14.0 |
||
|
io.swagger.core.v3 |
2.2.21 |
2.2.23 |
||
|
io.swagger.core.v3 |
2.2.21 |
2.2.23 |
||
|
io.swagger.core.v3 |
2.2.21 |
2.2.23 |
||
|
org.simplejavamail |
3.1.0 |
3.2.0 |
||
|
com.fasterxml.woodstox |
6.6.2 |
6.7.0 |
9. Retirement announcement
There are no specific retirement announcements.
For a full list of deprecated features, go to Deprecated features.
10. Bug fixes
|
Identifier |
Component |
Issue |
Solution |
|---|---|---|---|
|
BQ-24170 |
Encore |
The entity editor would not restore the scroll position of the attribute and relation lists when switching between views. |
The scroll position is now restored as expected. |
|
CSD-5706 |
Encore |
Various dropdowns could be inadvertently clipped, preventing the ability to scroll. |
Some dropdowns have been updated to be positioned in front of their container, avoiding the clipping issue. |
|
BQ-24155 |
|
The default error exchange for the DCM Lists Service RabbitMQ connection had the wrong value. |
It now references the right exchange. |
|
BQ-24138 |
Encore |
It was possible to model service and function calls in contract modules in Encore even though this is not allowed |
Removed the ability to model service and function calls from contract modules in Encore |
|
BQ-24084 |
Studio |
An error could occur when importing certain Word documents. |
The error has been addressed. |
|
BQ-24079 |
|
When a retry event node is taken, the task lock is also removed. |
The task lock is now kept so the retry can happen using the same task lock and happens immediately. |
|
CSD-5650 |
Studio |
The Studio server could incorrectly detect a cycle in process type restrictions, even if the structure of process types was not actually cyclic. |
The cycle detection has been improved to avoid the false positive. |
|
BQ-24064 |
Java Runtime |
In some setups, the AQ_MailService service call would always fail when trying to send an email because of missing runtime dependencies due to changes in third party libraries. |
The AQ_MailService has been fixed by providing the right dependencies. |
|
BQ-24056 |
Studio Backup Tool |
CVE-2024-47554 was reported on a dependency (commons-io) of the Studio Backup Tool |
The dependency has been updated to the latest version, which contains a fix for the CVE |
|
CSD-5608 |
Encore |
Various process validations were missing in Encore:
|
All of these aspects are now validated in Encore, enabling feedback during modelling for situations that would be reported as error in the runtime |
|
BQ-23739 |
Java Runtime |
When using external flows the target runtime didn't get any notification upon closing the host session. This meant that when a session on the host runtime is closed, the target runtime external sessions weren't closed |
Implemented a Listener which sends a notification to the target runtime when a host sessions gets closed |
11. Known issues
For an overview of known issue please refer to: Known issues
Overview
Content Tools