Release notes for Red Hat Decision Manager 7.10

Red Hat Decision Manager 7.10

Release Note

概要

This document contains release notes for Red Hat Decision Manager 7.10.

Preface

These release notes list new features, features in technology preview, known issues, and issues fixed in Red Hat Decision Manager 7.10.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

第1章 Product overview

Red Hat Decision Manager is an open-source decision management platform that combines business rules management, complex event processing, Decision Model & Notation (DMN) execution, and Business Optimizer for solving planning problems. It automates business decisions and makes that logic available to the entire business.

Business assets such as rules, decision tables, and DMN models are stored in a central repository. This ensures consistency, transparency, and the ability to audit across the business. Business users can modify business logic without requiring assistance from IT personnel.

Red Hat Decision Manager 7.10 provides increased stability, several fixed issues, and new features.

Red Hat Decision Manager is fully supported on Red Hat OpenShift Container Platform and can be installed on various platforms.

注記

Red Hat Decision Manager requires Java 8 or later.

For information about the support policy for Red Hat Decision Manager, see the Release maintenance plan for Red Hat Decision Manager 7.x and Red Hat Process Automation Manager 7.x.

第2章 Kogito productized features in Red Hat Decision Manager

Red Hat Decision Manager 7.10 provides the following Kogito based applications that you can use to design Business Process Model and Notation (BPMN) process models and Decision Model and Notation (DMN) decision models using graphical modelers:

  • VSCode extension including BPMN, DMN, and test scenario editor
  • Standalone embeddable DMN and BPMN editors
  • Standalone embeddable DMN viewer

Customers who own the Red Hat Decision Manager can access these new applications or extensions without acquiring a new subscription.

2.1. Additional resources

第3章 New features

This section highlights new features in Red Hat Decision Manager 7.10.

3.1. Business Central

3.1.1. Support for DMN 1.1 and 1.3 assets in DMN designer

You can now use the DMN designer in Business Central to open DMN 1.1 and 1.3 assets. Any DMN 1.1 and 1.3 models (do not contain DMN 1.3 features) that you import into Business Central, open in the DMN designer, and save are converted to DMN 1.2 models. For more information, see Designing a decision service using DMN models.

3.1.2. Test scenarios

The test scenarios designer in Business Central is now available with the following new features:

  • You can now perform the undo and redo operations from the Settings panel. Also, a warning pop-up is displayed when you save or discard any changes from the Settings panel.
  • In rule-based test scenarios, you can use the following new java classes as data objects:

    • LocalDateTime
    • LocalTime
    • BigDecimal
    • BigInteger
  • You can use Byte, Character, Float, Long, Short, LocalDateTime, LocalTime, BigDecimal, and BigInteger classes to create and manage the list of data object values.

For more information, see Testing a decision service using test scenarios.

3.1.3. New parameter list for Decision Services

Red Hat Decision Manager 7.10 includes a new Decision Service details section in the DMN editor properties panel containing a read-only list of Input Data, Encapsulated Decisions, and Output Decisions.

For more information, see Getting started with decision services and Designing a decision service using DMN models.

3.2. New standalone BPMN and DMN editors

Red Hat Decision Manager now provides standalone editors for Business Process Model and Notation (BPMN) process models and Decision Model and Notation (DMN) decision models. The standalone editors enable you to view and design BPMN and DMN models embedded in your web applications. The read-only mode for standalone BPMN editor is not supported in Red Hat Decision Manager 7.10.0.

The standalone editors are distributed in a self-contained library that provides an all-in-one JavaScript file for each editor. The JavaScript file uses a comprehensive API to set and control the editor. You can install the standalone editors in two ways:

  • Download each JavaScript file manually
  • Use the NPM package

For more information, see Designing a decision service using DMN models and Designing business processes using BPMN models.

3.3. Support for VSCode extension

Red Hat Decision Manager now provides support for VSCode extension enabling you to view and design BPMN and DMN models in Visual Studio Code (VSCode). The VSCode extension in Red Hat Decision Manager requires VSCode 1.46.0 or later.

You can install the Red Hat Decision Manager VSCode extension using:

  • VSCode user interface

    1. Open Extensions menu option.
    2. Search for and install Red Hat Business Automation Bundle extension.
  • Terminal

    1. Launch VSCode Quick Open.
    2. Enter the following command and press Enter.

      ext install redhat.vscode-extension-red-hat-business-automation-bundle

For more information, see Designing a decision service using DMN models and Designing business processes using BPMN models.

3.4. New wrapper modules

Red Hat Decision Manager 7.10 now includes wrapper modules that you can use to reduce overhead and improve the maintenance of Drools engine. There is an ongoing effort to refactor Drools engine by identifying and descoping optional features that are unrelated to the internal algorithm of the engine. Drools engine uses MVEL for DRL parsing, constraints evaluation, and templates generation. Usages of MVEL are isolated in a new drools-mvel module. Drools engine implements KieSessions serialization with protobuf to ensure better backward compatibility. This serialization feature is isolated in the drools-serialization-protobuf module.

You can add drools-mvel and drools-serialization-protobuf modules to your project classpath.

Red Hat Decision Manager now provides the following new wrapper modules:

  • drools-engine: Contains drools-core, drools-compiler, and drools-model-compiler dependencies
  • drools-engine-classic: Contains drools-core, drools-compiler, and drools-mvel dependencies

To use the Drools engine with the executable model, you must include the drools-engine wrapper module in your project dependencies. To use the Drools engine without the executable model, you must import your dependencies to the drools-engine-classic wrapper module.

3.5. Integration

3.5.1. Support for client roles in Red Hat Single Sign-On

When integrating Red Hat Decision Manager with Red Hat Single Sign-On, you can enable support for client roles. By default, only realm roles are supported.

For more information about integration with Red Hat Single Sign-On, see Integrating Red Hat Decision Manager with Red Hat Single Sign-On.

3.6. Red Hat OpenShift Container Platform

3.6.1. Support for Red Hat OpenShift Container Platform version 4.7

Red Hat Decision Manager now supports Red Hat OpenShift Container Platform version 4.7 and Red Hat OpenShift Container Platform version 4.6 EUS.

For more information, see Red Hat OpenShift Container Platform Life Cycle Policy and Red Hat OpenShift Extended Update Support (EUS) Overview.

3.6.2. Support for LDAP login module stacking

Red Hat Decision Manager now supports LDAP login module stacking. You can set the AUTH_LDAP_LOGIN_MODULE environment variable to optional for LdapExtended login module images.

3.6.3. Configurable persistent volume sizes for Business Central

Red Hat Decision Manager now supports configurable persistent volume sizes for Business Central. The default is 1Gi for Business Central and 64Mb for Business Central Monitoring.

第4章 Support and compatibility

This section highlights supported version updates in Red Hat Decision Manager 7.10.

4.1. Red Hat Fuse integration

Integration with Red Hat Fuse 7.8 on Red Hat JBoss EAP is supported.

Integration with Red Hat Fuse on Apache Karaf is not supported in the current version. Use Red Hat Decision Manager 7.9 with Red Hat Fuse 7.7 if you want to integrate with Red Hat Fuse on Apache Karaf.

第5章 Deprecated and removed components

5.1. Deprecated components

The components listed in this section have been deprecated.

5.1.1. Legacy kie-pmml dependency

The legacy kie-pmml dependency is deprecated with Red Hat Decision Manager 7.10.0 and will be replaced in a future Red Hat Decision Manager release. For more information, see Designing a decision service using PMML models.

5.1.2. Support for OSGi framework integration

Support for integration with the OSGi framework is deprecated in Red Hat Decision Manager. It does not receive any new enhancements or features and will be removed in a future release. The decision and process engine integration with the OSGi framework is currently incompatible in Fuse version 7.8. If you intend to use the OSGi framework, stay on the previous Red Hat Decision Manager version 7.9 release with Fuse version 7.7 until the new Fuse version 7.9 is available and certified.

5.1.3. Support for RuleUnit API

An existing RuleUnit API is now deprecated due to incompatibility with the Kogito RuleUnit API.

5.1.4. Legacy Test Scenarios tool

The legacy Test Scenarios tool is deprecated from Red Hat Decision Manager version 7.3.0. It will be removed in a future Red Hat Decision Manager release. Use the new Test Scenarios designer instead.

5.1.5. Support for Red Hat OpenShift Container Platform 3.x

From Red Hat Decision Manager version 7.5, images and templates for Red Hat OpenShift Container Platform 3.x are deprecated. The deprecated images and templates are not supported with new features but remain available until the end of Red Hat OpenShift Container Platform version 3.x support. For more information about the full support lifecycle phase for Red Hat OpenShift Container Platform version 3.x, see Red Hat OpenShift Container Platform Life Cycle Policy (non-current versions).

Consider deploying Red Hat Decision Manager using the operator on Red Hat OpenShift Container Platform 4.x.

5.1.6. Legacy process designer

The legacy process designer in Business Central was deprecated in Red Hat Decision Manager since 7.6.0. The legacy process designer does not receive any new enhancements or features. If you intend to use the new process designer, start migrating your processes to the new designer, and create new processes in the new process designer. For information about migrating projects to the new designer, see Managing projects in Business Central.

5.2. Removed components

The component listed in this section are removed.

5.2.1. Integration with Red Hat CodeReady Studio

Support for integration with Red Hat CodeReady Studio is removed in Red Hat Decision Manager 7.10. The support for the authoring tools based on JBoss Developer Studio (JBDS) Eclipse plugin is also removed. The feature references and documentation is not be available from the 7.10 release.

第6章 Technology preview

This section lists features that are in Technology Preview in Red Hat Decision Manager 7.10. Business Central includes an experimental features administration page that is disabled by default. To enable this page, set the value of the appformer.experimental.features property to true.

重要

These features are for Technology Preview only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs), might not be functionally complete, and Red Hat does not recommend to use them for production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

For more information on Red Hat Technology Preview features, see Technology Preview Features Scope.

6.1. Deploying a high-availability authoring environment on Red Hat OpenShift Container Platform 4.x

You can deploy a high-availability Red Hat Decision Manager authoring environment on Red Hat OpenShift Container Platform 4.x using the operator.

6.2. OpenShift operator installer wizard

An installer wizard is provided in the OpenShift operator for Red Hat Decision Manager. You can use the wizard to deploy a Red Hat Decision Manager environment on Red Hat OpenShift Container Platform with the operator.

6.3. Authoring perspective customization

You can customize the Business Central authoring perspective using the following features:

  • Ability to open a Business Central project directly using an URL path parameter, without going through a list of spaces and projects
  • Ability to hide or show the project toolbar, Metrics tab, and Change Request tab as per your requirements
  • Ability to enhance the pagination
  • Ability to customize the number of assets present on the project screen

第7章 Known issues in Red Hat Decision Manager 7.10.0

This section lists known issues with Red Hat Decision Manager 7.10.

7.1. Business Central

When you manage a list of structures in the test scenario editor, it throws an exception [RHDM-1590]

Issue: In the test scenario editor, when you delete an item from a list of nested structures, you receive an exception with an inappropriate message.

Steps to reproduce:

  1. Import the project attached in the RHDM-1590 issue.
  2. Open the Test Math Functions test scenario.
  3. In the GIVEN column, double-click the List(3) in the first row under the numbers value.
  4. Click the bin icon to delete the first item in the list.
  5. Click Save.

    You receive Uncaught exception: Exception caught: (TypeError) : Cannot read property 'Tc' of undefined Caused by: (TypeError) : Cannot read property 'Tc' of undefined exception.

Workaround: None.

Settings panel is not updated when you make the changes in the DMN model field [RHDM-1589]

Issue: In an existing DMN test scenario file, when you change the DMN model field, the related DMN name and DMN namespace read-only fields are not updated. The content of the Settings panel is not synchronized.

Steps to reproduce:

  1. Open any existing test Scenario for DMN model.
  2. Open the Settings panel.
  3. Change the value of DMN model field.
  4. Verify the values of DMN name and DMN namespace fields.

Workaround: Close and reopen the asset.

7.2. DMN designer

Undo operations are not visible in standalone DMN editor [RHDM-1561]

Issue: In the standalone DMN editor, when you change any value in the Properties panel and click Undo without collapsing the Properties panel, the changed value is not reflected.

Workaround: To reflect the changes, you can collapse and expand the Properties panel again.

Standalone DMN editor is missing isDirty indication on data types or included models [RHDM-1560]

Issue: The subscribeToContentChanges API method fails to reflect the changes that are made in a data type or included models. As a result, save, discard,undo, and redo operations are not available.

Workaround: None.

7.3. Red Hat OpenShift Container Platform

Deployment failures due to invalid labels [RHPAM-3471]

Issue: A bug in the operator causes the operator to use an image name as a label for deployments. This can cause deployments to fail if the image name contains a special character.

Workaround: A fix has been released to update this bug in the operator. If you are encountering this issue, update to the latest operator.

注記

As a result of this fix, the deployments will no longer have the correct subcomponent label that is used by the metering operator. The results from the metering operator may no longer provide the expected results for Red Hat Decision Manager products.

第8章 Fixed issues in Red Hat Decision Manager 7.10.0

Red Hat Decision Manager 7.10.0 provides increased stability and fixed issues listed in this section.

8.1. Business Central

  • Package list fails to populate default package for imported projects [RHPAM-3209]
  • Collection editor is not opening for DRL based test scenarios [RHDM-1464]
  • REST endpoints are accessible to all the logged in users, even when the correct roles are not assigned to the users [RHPAM-3284]
  • In test scenarios coverage report, rule name column size is increased and the numbers are aligned to the right side [RHPAM-3271]
  • In a guided decision table, an exception error pop-up returns an inappropriate error message [RHPAM-3201]
  • The number of assets listed on the project page of Business Central does not match with the count displayed for pagination [RHPAM-2859]

8.2. KIE Server

  • REST endpoint authentication fails, if the authorization header contains == in an encoded key in the REST work item handler [RHPAM-3259]

8.3. DMN designer

  • DMN editor does not detect the changes from the Decision Navigator view [RHDM-1482]

8.4. Decision engine

  • testDoubleNaN fails after jitting on TypeCoercionTest [RHDM-1470]
  • When you use the same variable name to different declarations, you receive a false accumulate functions conflict [RHPAM-3216]
  • In an executable model, a new line character between the last parameter and ); in a call method throws a build error [RHDM-1550]
  • In an executable model, when you use a compound assignment operation such as BigDecimal_type_property += BigDecimal_value, you receive a compilation error [RHDM-1528]
  • In an executable model, when you use a compound assignment operation such as BigDecimal_type_property += Numeric_value, you receive compilation errors [RHDM-1527]
  • When you use an expression such as BigDecimal_type_property = BigDecimal_type_property.divide(BigDecimal_value) in an executable model, you receive a build failure error [RHDM-1521]
  • When you use a BigDecimal type values in an executable model, you receive a build failure error [RHDM-1520]
  • In MVEL dialect mode in an executable model, when you use the four basic binary operators (+, -, *, /) for BigDecimal type values, you receive a compilation error [RHDM-1519]
  • In MVEL dialect mode in an executable model, when you use an assignment statement for BigDecimal type values, you receive compilation errors [RHDM-1518]
  • When an AccumulateDescr does not contain a constraint, the DrlDumper generates an incorrect DRL, which does not allow you to build the generated DRL [RHDM-1517]
  • The DrlDumper is unable to generate the accumulate import [RHDM-1516]
  • When you try to bind an enum value, you receive an error in an executable model generation [RHDM-1514]
  • In MVEL dialect mode in an executable model, when you use an enhanced for (foreach) statement, you receive a compilation error [RHDM-1513]
  • In MVEL dialect mode in an executable model, when you use the space characters between ( and LocalVariableType in an enhanced for (foreach) statement, you receive a compilation error [RHDM-1505]
  • When you use the standard Java serialization mechanism, the ByteArrayResource is declared twice [RHDM-1502]
  • When you are unable to call a reset method in the PriorityMap and call the method inside org.kie.api.internal.utils.ServiceDiscoveryImpl, you receive an exception [RHDM-1501]
  • When you have two or more different implementations of service on the classpath, the service discovery or wiring mechanism randomly chooses the services that come first in the classpath. You can explicitly configure a priority among these services [RHDM-1500]
  • You cannot use AgendaFilter method when the rules are combined with a ruleflow and fired using KieSession.startProcess method [RHDM-1461]

8.5. Red Hat OpenShift Container Platform

  • Business Central pod fails to start when known_host file is missing from the Git hook secret [RHPAM-3056]

第9章 Known issues in Red Hat Decision Manager 7.10.1

This section lists known issues with Red Hat Decision Manager 7.10.1.

9.1. Business Central

Data Object editor removes imports when saving [RHPAM-3544]

Issue: In the data object editor, you cannot add an import using a Source tab. The added import is removed automatically when you save the changes.

Steps to reproduce:

  1. Open Business Central.
  2. Open or create any project.
  3. Create a data object.
  4. In the Source tab of a data object, add import java.util.Date data object.
  5. Click Save.

    You can see that the added import is not present in the data object editor.

Expected result: In the the Source tab a data object, added import is not removed.

Actual result: In the the Source tab a data object, added import is removed.

Workaround: None.

Guided decision tables does not open when you migrate from Red Hat JBoss BPM Suite 6.4 to Red Hat Decision Manager 7.7 [RHPAM-3217]

Issue: When you migrate from Red Hat JBoss BPM Suite 6.4 to Red Hat Decision Manager 7.7, guided decision tables fails to open.

Workaround: Do not use the name starting with ruletable for the column description.

第10章 Fixed issues in Red Hat Decision Manager 7.10.1

Red Hat Decision Manager 7.10.1 provides increased stability and fixed issues listed in this section.

10.1. Business Central

  • Business Central REST API is allowing container creation with empty container id [RHPAM-3362]
  • When you migrate from Red Hat JBoss BPM Suite 6.4 to Red Hat Decision Manager 7.3.1, some guided decision tables throws Cannot assign field values of types other than ActionFieldFunction error [RHPAM-3308]
  • project.repositories upload function is not working in Business Central [RHPAM-3277]
  • A system error occurs when you add a deployment unit [RHPAM-3111]
  • In test scenario editor, the LocaldateTime guided rule does not render correctly [RHPAM-2961]
  • When you migrate from Red Hat Decision Manager 7.8 to Red Hat Decision Manager 7.9.1, most of the DMN nodes are misplaced [RHDM-1604]
  • When you manage a list of structures in the test scenario editor, it throws an exception [RHDM-1590]
  • Settings panel is not updated when you make the changes in the DMN model field [RHDM-1589]
  • Unable to use a space with quotes in a guided decision table [RHDM-1578]
  • Running tests affects incremental build [RHDM-1508]
  • Improved the error message of a guided decision table error [RHDM-1426]
  • When you open a guided decision table, you receive TypeError: b is undefined uncaught exception [RHDM-1425]

10.2. Decision engine

  • Numeric coercion breaks beta indexing [RHPAM-3456]
  • In an executable model, an error is parsing for the single apex which is delimited by an empty string [RHDM-1625]
  • An experimental alpha network compiler is removed from kie-maven-plugin build process [RHDM-1624]
  • In an executable model, the behavior of binding of a boolean unary expression is different as compared to the plain DRL file [RHDM-1612]
  • In an executable model, you cannot build a project by inserting and updating a fact of same rule [RHDM-1606]
  • You receive a null pointer exception while updating the KIE container [RHDM-1596]
  • Use MVEL version 2.4.12 or above in Red Hat Decision Manager 7.10.1 [RHDM-1574]
  • In an executable model, incorrect parameter is passed to accumulate function [RHDM-1572]
  • In an executable model, and exists used in the source pattern of an accumulate function statement matches multiple times instead it should match only once [RHDM-1571]
  • Type coercion does not work for bound variables in an executable model [RHDM-1564]
  • In an executable model, you receive a null pointer exception at ConstraintEvaluator.findPatternAndRequiredDeclaration() in an accumulate function [RHDM-1556]
  • In an executable model, @watch annotation containing !* does not work as expected [RHDM-1553]
  • Property reactivity for properties is not modified in modify block and the rule is executes repeatedly [RHDM-1552]
  • In an executable model, the order of parameters passed to the method is unexpectedly changed and the parameters are not passed correctly in action() accumulate function [RHDM-1551]
  • In an executable model, when you use the AND operator in the source pattern of an accumulate function, you receive a compilation error [RHDM-1549]
  • In an executable model, when you use an operation such as BigDecimal_variable % Numeric_value, you receive a compilation error [RHDM-1545]
  • Variable binding of a map element throws compilation errors in an executable model [RHDM-1543]
  • In an executable model, when you bind a list written in MVEL expression, you receive a build error [RHDM-1542]
  • forall rule pattern does not work as expected [RHDM-1541]
  • In MVEL dialect mode in an executable model, when you use a compound assignment operation such as BigDecimal_type_property <op> Numeric/BigDecimal_value, you receive an unexpected error [RHDM-1538]

10.3. Red Hat OpenShift Container Platform

  • When AUTH_LDAP_BASE_FILTER contains the | value, you receive LDAP sync issues [RHDM-1567]
  • In the KIE Server launch script, pulling of the dependencies and KJAR validation is skipped to speedup the start time [RHPAM-3494]

付録A Versioning information

Documentation last updated on Tuesday, March 8, 2022.

付録B Contact information

Red Hat Decision Manager documentation team: brms-docs@redhat.com