3.4 Migration Guide

In this document, we will see the major steps to migrate from 3.3 to 3.4.

Please check the change log for detailed list of fixes, changes and improvements introduced in 3.4.

Database migration

Migration scripts are available there.

Breaking Changes

If you have not overridden the code of BI module, you can ignore this section.

Removed service

The service MenuTranslationService and its implementation have been removed.

Removed field

The field fullname has been removed from MetaMenu.

Removed deprecated methods

The following deprecated methods have been removed:

  • LibraryDashboardInstallService.installDashboard(LibraryDashboard, boolean)

  • LibraryDashboardController.updateDashboard

Use LibraryDashboardInstallService.installDashboard(LibraryDashboard) instead, which handles both creation and update.

RLS filter value handling (3.4.1)

The handling of static RLS filter values has changed: spaces and empty values are now preserved. This may break existing RLS filters that relied on spaces being trimmed or empty values being discarded.

Before this fix, these expressions were equivalent:

value1, value2, value3   // spaces were trimmed -> 'value1,value2,value3'
value1,value2, ,,value3  // blank values discarded -> 'value1,value2,value3'

Now each is processed literally:

value1, value2, value3   // -> 'value1',' value2',' value3'
value1,value2, ,,value3  // -> 'value1','value2',' ','','value3'

Review your RLS filter expressions and adjust if necessary.

Permission rename (3.4.3)

The permission perm.bi.dashboard.rw (Read/Write) has been renamed to perm.bi.dashboard.rwd (Read/Write/Delete).

Users previously assigned perm.bi.dashboard.rw must be reassigned the new perm.bi.dashboard.rwd permission to retain dashboard management access.

Upgrade dependencies

The following dependencies have been upgraded:

  • axelor-bi-library to 2.8.0