OpenL Tablets

On the Identity Provider side it needs to define:
Single sign-on URL = http://localhost:8080/webstudio/login/saml2/sso/webstudio
Audience URI (Entity ID) = webstudio

Webstudio, Rule Services

Java 8 is not supported any more. Java 11 is supported only!

Due to MSSQL driver upgrade, use encrypt=false;trustServerCertificate=true; in the connection string if your server does not support encryption. For more information, see:
https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/ssl-certificate-rotation-sqlserver.html and
https://docs.microsoft.com/en-us/sql/connect/jdbc/release-notes-for-the-jdbc-driver?view=sql-server-ver15#changes-in-102

Upgrading H2 DB requires migrate according to the migration guide are described in https://www.h2database.com/html/migration-to-v2.html

Starting from OpenL Tablets 5.26.0, Groovy Scripts have an access to all Java types of a project and its dependency projects generated from their Datatype tables. It was the most requested feature after Groovy Scripts support had been introduced. To support the feature we had to change a module compilation algorithm to use the same classloader for each project. Before the change, each module in the project had used its own classloader. The change may break backward compatibility if multiple projects use Datatypes with the same name even if the modules don’t have a relationship, but a relationship between projects exists. To migrate your projects in this case, you should define unique package names there (refer to Ref Guide, Dev Properties - > Dev Properties List section).

5.25.3

Core:

DoubleValue and similar types in the org.openl.meta package are deprecated for usage. It should be replaced by similar types from the Java language, E.g. DoubleValue to Double, BigIntegerValue to BigInteger and so on

SOAP/WSDL services and Aegis converters are deprecated for usage. It should be migrated to REST/OpenAPIv3 services.

5.25.2

Core:

In previouse version there was an issue with matching fields in an unpredictive order, when idntifiers are in the different letter case in the same class. E.g. when java class contained the similar fields and getters/setters (static and non-static), e.g. public static ID field and getId() method. So to prevent unpredictive binding of idntifiers, there was added additional check, which fails if clash is possible.

In the log it seems like:

• Static field 'Id' is not found in type 'MyBean'.
• Metod 'calc(Reference<MyBean>) is not found.

To fix this errors it needs to correct identifiers to prevent clashing. E.g. use myBean.id calc(myBean) instead of MyBean.Id calc(MyBean)

5.24.0

WebStudio

• Project changes history created before migrating to 5.24.0 is not available after migration. The files will remain in the folder but in WebStudio there will be no records in "Local Changes" and no possibility to restore them. A user must save the necessary changes before the migration.
• While migrating from 5.23.x to 5.24.0, all necessary files and properties are moved automatically. To migrate from earlier versions, such as 5.21.16 or 5.22.7, migrate manually to the last minor version of 5.23.x and then to 5.24.0. That is, perform migration step by step, for example, 5.22.7 > 5.23.11 > 5.24.0. More details are in the document Migration from earlier than 5.23.x.
• Default repository folders are changed in 5.24.0. New folder paths are used by default only for a freshly installed 5.24.0. After migration from 5.23.x, old local paths remain, and if adding new repositories in 5.24.0, the path is generated from the old path.
• The administrator user is deleted after migration to 5.24.0. To set a new administrator user, use the "security.administrators" property in the webstudio.properties file.

Rule Services

The following properties were changed

5.23.9

WebStudio

The following properties were changed

Rules Services

5.23.8

Rule Services

The following properties were changed

OpenL Rules

The following API was deprecated

5.23.6

WebStudio & Rule Services

The following properties were changed

5.23.3

WebStudio

The setting "Unlimited numbers of copies" will automatically be set to false after migration to this version, and the setting "The maximum count of saved changes for each project:"=100 will be applied. If there is a need to store unlimited amount of changes, set the setting "Unlimited numbers of copies" = true before opening any project. This setting is changed to prevent uncontrolled consumption of free space on HDD/SDD for 'undo' operations during editing a project.

The following properties were changed

Rules Service

The following properties were changed

5.23.1

WebStudio

The following properties were changed

Rules Services

The following properties were changed

5.23.0

WebStudio

All OpenL WebStudio related properties should be composed into a single file. Merge rules-production.properties , db.properties , system.properties into application.properties or webstudio.properties. It is also recommended to remove default properties from the merged file.

The following location can be used to store properties (the next overrides previous):

• ${ user.dir}\application.properties (RO)
• ${ user.home}\application.properties (RO)
• ${ openl.home}\{ appName}.properties (RW)

Where { appName} - is Spring application name (Servlet context path).

So for the simplest case, when webstudio.war is deployed in Tomcat, the appName is webstudio and file is webstudio.properties.

It allows to separate configs for different OpenL applications under the same server.
Common settings also can be located in application.properties file.

The following properties were changed

Note 1: Supporting of the following Design & Deployment repositories were discontinued:

• Remote RMI
• Remote WebDav
• Local (were replaced with GIT)

Use Migration Tool to convert them into DB or GIT based repositories if needed.

Note 2: secret.key property allows OpenL WebStudio to encode any properties ended with ****.pasword. By default secret.key is empty that means all passwords are stored in the plain view. Decoding of the passwords happens only when two things are: secret.key is set and password is wrapped into ENC( eNcoDedPa$$w0RD ) signature. So there is possibbility to define as encodded password in properties files so and plain view password, when secret.key is set.

To get encoded "plain password" you can use the following comand from the bash console:

Be noted, that "My $eCr3T" value must be changed on your secret value.

Rules Services

The following properties were changed

The following deprecated properties files were deleted:

• rules-production.properties
• openl-ruleservice.properties
• *-ruleservice-ext.properties

The following properties files should be used:

• application.properties
• application-default.properties

OpenL Rules

rules-deploy.xml should contain a correct set of actual publishers or publishers tag should be absent otherwise the project will not be deployed

5.22.2

OpenL Rules

Behavior is changed for nulls for multiplication and division operation. For old behavior use import org.openl.rules.binding.MulDivNullToOneOperators.*

5.22.0.1

OpenL Maven Plugin

Delete deprecated: generateUnitTests, unitTestTemplatePath, overwriteUnitTests in OpenL Maven Plugin

OpenL Rules

• Delete deprecated: org.openl.rules.calculation.result.convertor.* org.openl.rules.calc.result.convertor.*
• Cells calculation order in Spreadsheet type table with non-spreadsheetresult return value is changed. Calculation of such spreadsheets may need to be updated or property "calculateAllCells = false" can be added for backward compatibility.
• Month numbers are from 1 to 12 (January number is 1). Previously it was from 0.

5.21.13

OpenL Rules

CalculationStep.getStepName() returns a value without type definition now. Was: "MyStep:Double". Became: "MyStep"

5.21.11

WebStudio

Old modeshape-based repositories are not supported, and all related libraries were removed from WebStudio

5.21.7

Rules Service

The following properties were changed

OpenL Rules

• Remove any references on useRuleServiceRuntimeContext in rules-deploy.xml files.
• The following properties are removed:Custom1, Custom2 and Transactional.
• Remove coma from lob name for backward compatibility
• Map<String, String> will not be compiled (generic types are not supported by OpenL)
• Generated getters and setters are compatible with JavaBean specs v1.01 now. So for fields like iCoin - getiCoin()/setiCoin() methods will be generated.

5.21.4

OpenL Rules

Test tables don't support business dimensional properties, so replace all definition with _context_ input parameter

Expectations should be defined properly: only one result or error should be set in a test table, not both.

5.21.3

Rule Services

<detail> element was changed in SOAP fault message. <type> and <stackTrace> elements were added with additional description of the fault

OpenL Rules

@VariationsFromRules annotation and VariationDescription class were deprecated. Please, remove reference on this classes, which will be deleted in OpenL Tablets v5.22.0

5.21.2

Rule Services

Because of strict SOAP v1.1 validation, please be attentively that null values are sent like <aField xsi:nil="true" />

OpenL Demo

All examples have been converted to XLSX format

5.21.1

Rule Services

Switched to slf4j adapter in CXF library instead of direct usage of log4j

Deleted deprecated org.openl.rules.ruleservice.publish.WebServicesRuleServicePublisher

5.21.0

Rules Service

The following properties were changed

OpenL Rules

• All rules calculations should be revised. Because of changed type of division operations, please be aware that 7/4 is equal 1.75, not 1. Returned type became Double instead of Integer. Users who still need to use whole number division logic will need to adjust their rules.
• Because of more strict table structures, it is possible that some tables would not be compiled/parsed. In this case, please check neighboring rows/columns. All comments (notes) in cells must be started from '//' (two slashes)

5.20.0

Rules Service

The following properties were changed

Changed behavior of the Deployment Repository because of the performance issue. In exceptional case it can be restored old behavior using version-in-deployment-name=true.

Core

Java 7 is used as minimal supported version (Java 9 is now supported). Added validation of duplicated packages/classes inside OpenL WARs.

OpenL Rules

The implicit casting from Double to Integer was removed as error-prone. So use a correct argument type or use round function.

5.19.6

Core

Removed deprecated IVocabulary class

5.19.5.1

OpenL Rules

Used more accurate conversion from Double to BigDecimal type. Double (1.1) will be converted to BigDecimal(1.1) instead of BigDecimal(1.100000000000000088817841970012523233890533447265625)

5.19.1

Rule Services

Default OpenL properties are initialized in PropertySourcesLoader now. Add the following lines into web.xml:
<context-param>
<description>Load default and application properties to the Spring application
environment.</description>
<param-name>contextInitializerClasses</param-name>
<param-value>org.openl.spring.env.PropertySourcesLoader</param-value>
</context-param> All OpenL-related properties should be in a single file. Merge rules-production.properties , ruleservice-ext.properties , openl-ruleservice.properties into application.properties. It is also recommended to remove default properties from the merged file.

OpenL Maven Plugin

JavaWrapperAntTask was replaced with openl-maven-plugin. Use 'generate' goal to generate Java beans from OpenL datatypes

The following properties were changed

Core

• OpenL does not use JCL loging framework anymore, all dependencies on JCL were removed. Use JSF4J instead.
• RulesEngineFactory(File) was deprecated. Use RulesEngineFactory(URL) or RulesEngineFactory(String) instead
  String xlsxPath = "filepath/or/classpath/to/file.xlsx";

// The argument is a filepath. It is useful for JUnit tests
new RulesEngineFactory(xlsxPath);

//Alternative way, using a classpath
URL xlsxUrl = getClass().getResource(xlsxPath);
new RulesEngineFactory(xlsxUrl);

OpenL Rules

• Add ‘rules.xml’ file to any rules projects which were based on a deprecated Eclipse rules project template
• If the rules relied on ‘autoType’ property being off by default it is advised to check if rules are working correctly and add this property if necessary
• It is also recommended to remove the following imports in 'Environment' table from the rules:
  • import java.utils.Arrays
  • import org.apache.commons.lang
  • import org.dozer.mapping
    OpenL has own 'smart' functions like isEmpty() and addAll()