Changelog

Analogous to the import of module settings, we now offer the possibility to import preconfigured OpenSearch indices, see Installation mit vorkonfiguriertem BPC.

The configured limit (max. number of records) for XLSX is now taken into account again during data export in the monitor. For CSV and JSON, a limit can now also be configured in the export mask. There is only an upper limit for XLSX, not for other file formats.
See also Konfiguration des Monitor-Daten-Exports
Export von Prozessen

For GUI modules that offer types, components with types can once again be created. Translations for the designation of a type no longer require a "CORE_" prefix. The schema for the translation keys is "<MODULID>_INSTANCE_TYPE_<VALUE>".

The "Users" section in the documentation page "BPC Administration" is described in more detail. See BPC Administration

Extended description of the process action configuration. See Konfiguration von Prozessaktionen

Detailed documentation of the process status change configuration. See Prozessstatuswechsel

The documentation of formatters in columns and formatters in export has been improved.

The migration guide (Migration von BPC 4.0 nach BPC 4.1) has been updated.

See Chart-Editor

Index cleanups are performed 60 seconds after BPC starts, and then run at the configured interval.

It is now possible to use the value 0 in the valueMap of a custom renderer and to see it as a label in the monitor. Previously, values of 0 were not displayed.

The values of the different options in combo boxes are now no longer generally supplemented with a  . This makes automated testing of the interfaces easier.

The driver provided via pax-jdbc-mssql is no longer delivered.

Please ensure that the MSSQL driver used has at least one of the following versions: 10.2.4, 11.2.4, 12.2.1, 12.6.5, 12.8.2, 12.10.2, 13.2.1

If an older driver is being used, it should be replaced. Remove the old driver by deleting it from the deploy directory or by uninstalling pax-jdbc-mssql or the driver itself. Then install a current driver (without the pax-jdbc-mssql feature). See also: Databases

A bug was fixed where an incorrect process starter was displayed when exactly two process starters were configured, one of which is hidden.

If the configured identity provider is not reachable, it is no longer incorrectly logged that the local Karaf identity provider has been selected as a fallback. Instead, it is indicated that this could be enabled as a fallback.

Buttons that discard local changes now have a better text description.

Ein Fehler wurde behoben, dass der Endpunkt GET /cxf/bpc-core/im/organisations nicht mehr KeyCloak-Gruppen listet, die als Untergruppen definiert sind. Grund war eine Änderung im Verhalten von KeyCloak ab Version > 26.

In the central configuration file (bpc.env.sh), an error in the commented-out option DE_VIRTIMO_BPC_DECANTER_APPENDER_OPENSEARCH_DELETEENTRIESOLDERTHAN was fixed. Previously, activation did not work because the value must be enclosed in quotation marks. The Windows variant was not affected.

A bug was fixed where changing the language in the Keycloak screen had no effect when being redirected from BPC to Keycloak via logout.

The status endpoint returned a faulty response when incorrectly configured loggers were stored.

With this update, the Karaf version is upgraded to 4.4.8. It is necessary to update the modules bpc-be-core, bpc-be-analysis, bpc-be-forms, and bpc-be-monitor.

For BPC module developers

With the updated Karaf, we are delivering CXF 3.6.8 instead of 3.6.7, which provides Jackson in version 2.19.2.

Please update the CXF version (3.6.8) and Jackson version (2.19.2) in your pom.xml. Check whether you have an Import-Package statement for this version. This must be added or adjusted if you use Jackson features such as the ObjectMapper class.

Http calls via an Http-Proxy or Flow connection filter out the BPC Api-Key header (X-APIKey). Attention: This could affect existing BPC configurations, for example if an INUBIT process is triggered that in turn makes calls to the BPC API using the provided API key. (In this case, it would be better to store a fixed BPC API key in the INUBIT process.)

The cells in the dashboard’s table layout make better use of their available space and maintain proper spacing from other cells. Errors no longer occur when enlarging or resetting the size of cells.

The endpoint /cxf/bpc-core/opensearch/indices/compact does not return any OpenSearch internal indices. These are all indices that are named with a . prefix. Accordingly, these are also no longer filtered in index selectors in the frontend.

A new filter type json has been added, which displays filtered structured data in the column header. See Spalten filtern

The tooltips for cron patterns in replication have been supplemented with a reference to the Quartz Scheduler documentation.

For boolean values in the settings tables, a combo box is no longer displayed; instead, only the checkbox with the truth value is shown. The value can be changed by clicking, pressing the space bar, or pressing Enter.

Buttons can now use the classes arrow-spacing-sm (small) and arrow-spacing-xs (extra small) to reduce the spacing of the arrow.

It is now possible to use the value 0 in the valueMap of a custom renderer and to see it as a label in the monitor. Previously, values of 0 were not displayed.

For checkboxes and radio groups, the mouse pointer is now displayed in such a way that it is clear the user can change the state by clicking.

The setting licencedModules can no longer be edited in the frontend. Previously, the setting could be edited, but the value was not applied.

Http calls via an Http-Proxy or Flow connection filter out the BPC Api-Key header (X-APIKey). Attention: This could affect existing BPC configurations, for example if an INUBIT process is triggered that in turn makes calls to the BPC API using the provided API key. (In this case, it would be better to store a fixed BPC API key in the INUBIT process.)

For new backend connections of the type HTTP-Proxy and Flow, the option Filter BPC Session is enabled by default.

It could happen that replication got stuck in a certain time window if this window bordered on the present and no records were found.

Views are correctly marked as changed when the views object contains new values or objects. If there are new columns or added grids in additional tabs, the view is automatically saved for the user, provided the user has permission to save the view. There is a notification indicating whether the save was successful or failed.

See monitor:/admin/process_views.adoc#_gespeicherte_ansicht_ändern

In BPC 5.0.0, unsaved changes occur in views from older versions because the fields in the model have been updated. The views then need to be saved once.

A problem was fixed where errors could occur when creating several new users, roles, or permissions at the same time and Karaf was selected as the identity provider.

The resizing of widgets in the dashboard’s table layout has been improved and susceptibility to errors has been reduced.

For existing Karaf installations, add the following value to KARAF/etc/custom.properties:

When retrieving translations (cxf/bpc-core/i18n/translations or in the frontend), user-defined entries of the fallback language are now also taken into account.

If a BPC module used a different versioning than the BPC core, the project.version property affected the dependencies in the BPC core and caused problems. The dependencies within the BPC core are now no longer influenced by the project.version property in the module.

The readability of large numbers in the number of records has been improved by using thousand separators. The "Remove filter" button now also contains information about the currently applied filters.

The moving and resizing of widgets in the dashboard, with the table layout enabled, has been improved.

The option for grouping settings is now initially enabled. It is recommended to use this view, as the settings are displayed together in a common context.

The output of the HTML component is sanitized by a sanitizer to remove, for example, script content.

The default window size for Process Starter can now be configured.

See Prozess Starter

For the process status change, it is now possible to configure the preselection of a value. The preselection is controlled via the configuration preselectState in the setting function_changeStateConfig.

"preselectState": "_first": Always selects the first available value from the dropdown. "preselectState": "<search value>": Selects the first entry that contains the specified text (case-sensitive). Both raw values and display names (from Custom Renderer) can be used.

If exactly one process is loaded and there are exactly two values to choose from, the status field automatically selects the status that does not correspond to the current status.

Example configuration

Any path specifications are ignored to prevent path traversal attacks.

The ProzessStarter configuration for windowWidth and windowHeight now correctly affects the window.

The order of properties in JSON forms is preserved.

OpenSearch exceptions now also display triggers, if available. A more detailed error message is shown in the monitor grid if full-text search is enabled.

For limitations when filtering, Komplexe Suche has been added.

File downloads are now possible in both parent and child data.

A bug was fixed where newly arriving notifications were incorrectly hidden by the "Show only unread" filter.

If the BPC is operated in a cluster, it was sometimes not possible to deactivate maintenance mode via the GUI.

See also Modul und Modulinstanz Einstellungen

See Core Services and Create-Index relevante BPC Einstellungen

In the HTML editor, "Expired copy of the Froala Editor" was sometimes displayed.

The setting of the ID columns in the log service configuration interface is now done via combo boxes. The configuration can only be saved if at least one ID column is defined. Additionally, it is checked whether all ID columns are included in the field configuration. If this is not the case, the form is marked as invalid and saving is prevented.

The logging configuration has been changed so that session tokens are masked. For new installations of Karaf, this happens automatically. For existing installations, please adjust the configuration file [KARAF]/etc/org.ops4j.pax.logging.cfg. Replace the old line

with the following lines

Since with Keycloak and OIDC the session tokens are UUIDs that are also used elsewhere, we log the first and last four characters here.

The confirmationText of a process action is now displayed if either requireComment or requireConfirmation is true.

If binary files were loaded via INUBIT or another backend system, it could happen that the files were corrupted when downloading or viewing them.

A bug was fixed when switching between states in the monitor that affected the tooltip update, which occurred when multiple grids are disabled.

When calling up a monitor via a deeplink including filters, it could happen that these filters were still displayed in the column header even after being removed.

A bug was fixed where the date filter in the monitor was not displayed correctly.

When replicating MSSQL tables, schema and table names masked with square brackets and quotation marks, such as [kunde-abc].logging or "kunde-abc".[logging], are now also supported.

A bug was fixed that prevented users from editing a monitor view even though they had the bpcMonitor_editMonitorViews permission and the necessary write access.

The missing first or last name of a user is no longer displayed as "null".

See core:/dev/api/log_service.adoc and core:/dev/api/storage.adoc

Dashboard widgets now only display the configuration icon if the user is allowed to edit the dashboard. For this, they need the bpcDashboard_editDashboard permission. Users without this permission can no longer edit dashboard widgets. If editing options (e.g., for custom widgets) should still be offered, the corresponding permission must either be granted or the configuration must be provided through alternative means (e.g., via the widget header).

In the setting moduleHeaderContent, the parameter showSelectionCounter in the metablock can be used to control whether the number of selected records is displayed.

See also Monitor-Schnellfunktionen

Forms now correctly translates the labels for all components, including in the state. This makes it possible to set bindings on labels. See Mehrsprachige Inhalte.

setFormState can now also handle labels in multiple languages correctly. In this context, a bug was fixed that caused bindings to be removed when using setFormState, so that after setFormState, only data from before setFormState was present in the submit. In addition, all components can now be used in combination with setFormState, including Combobox and Table.

The current language is now stored under /language. The date formats are now handled the same way by the date field and the table and are formatted appropriately for the user depending on the language.

Dashboard widgets now only display the configuration icon if the user is allowed to edit the dashboard. For this, they need the bpcDashboard_editDashboard permission. Users without this permission can no longer edit dashboard widgets. If editing options (e.g., for custom widgets) should still be offered, the corresponding permission must either be granted or the configuration must be provided through alternative means (e.g., via the widget header).

The start script no longer waits 30 seconds after starting OpenSearch and Karaf. If problems occur where OpenSearch is not available in time, the Watchdog should be used.

The start script no longer makes any changes to the environment. Directories must be configured according to the installation instructions, and JAVA_HOME must also be configured correctly.

For the period during which the export takes place, a loading animation is now displayed. In addition, error messages are now also shown in the event of an error.

In the navigation settings, the rows are now alternately colored differently to improve readability.

The descriptive texts during upload have been adjusted to accommodate the different contents (modules, license, and DB driver).

The ProzessStarter configuration for windowWidth and windowHeight now correctly affects the window.

The selection of an operator for "number" filters has been restricted to the operator list. The default operator is defined as "=" and, additionally, the default operator can be changed in the filter configuration within the column configuration. See also Konfiguration der Monitor-Spalten

The error message for validating the entries in the ProcessStarter table is no longer being truncated.

The reset function previously removed bindings. As a result, after a reset, the current state could no longer be submitted. This problem has been fixed.

The components Table and Combobox have been improved and now behave like the other components.

The right bpcMonitor_editMonitorViews can be set for specific instances to create and modify views in certain monitors by appending the module ID at the end.

See Anwendungsbeispiele

See OpenSearch Indizes-Ansicht

See BPC Modul entwickeln and Modul und Modulinstanz Einstellungen

There is now a description of the internal model_version of the BPC at Versionierung der internen BPC Konfiguration. It also explains that this can have an impact on a Downgrade of the BPC and on Deployment between different BPCs.

The changelog now indicates when there is an update to the internal configuration.

Additionally, an overview of all versions in which a change to the model_version took place is now displayed in Administrations-Changelog. In this context, an overview of versions with Karaf and OpenSearch updates has also been added.

The documentation on the creation and use of monitor deeplinks has been expanded. Monitor Deeplink

See MinIO als S3 Backup für OpenSearch

In Installation, the installation via bundle file is now described. The included start and stop scripts are now described.

Notes added that usually only read permissions are necessary for database connections.

See Backend Connections, Sicherheit and Documents.

Instructions for downgrading the BPC taking technical specifics into account. See: * Versionierung der internen BPC Konfiguration * Troubleshooting * Downgrade Guide

Revised instructions. See BPC Modul entwickeln

Correction of spelling mistakes and improvement of wording

The Flow module is described on its own documentation page along with its possible applications.

Update OpenSearch according to the update guide

Monitors that have an externalReference field with an IGUASU reference can display a link that allows you to jump to the data source in IGUASU. For this, the renderer flow!_!flowRenderer must be set in the monitor column configuration.

See also: BPC → IGUASU

Scripts are provided that allow BPC or Karaf and OpenSearch to be started and stopped.

See Download - Virtimo Fileserver

The user session can be supplemented with customData, which comes from the Additional Info endpoint of the Identity Provider Backend Connection.

See also User Session um zusätzliche Organisationen/Rollen/Rechte und weitere Daten ergänzen

The LogService endpoint for opening a monitor now also supports the case where there are multiple monitors for a LogService and displays a selection window with the possible monitors. http://<bpc_host>:<bpc_port>/cxf/bpc-logservice/<logservice-instance-id>/open/monitor

See also API documentation: Log Service API

In the OpenSearch log, there are many logs such as "QueryGroup _id can’t be null, It should be set before accessing it." This is a known bug in OpenSearch that was introduced with version 2.18.0. We have reduced the output as much as we could from our side.

Note: If users already have existing installations of the default instance (BPC Default Reports) in the Analysis Module, it is recommended to set the chart background color to full transparency (RGBA alpha value: 0) under Chart Configuration → Settings → Background Color. This improves visualization when used with the Dark Theme.

Snapshots whose names do not conform to the current naming scheme have blocked the execution of the backups.

If the HTTP proxy used an HTTP/2 connection, the pseudo-header ":status" was forwarded to the client. This leads to an error if interpreted strictly. For example, in this case, nginx reported a 502 Bad Gateway error to the client.

Different loading times of plugins led to a deviating order. Now, regardless of loading time, the order from the configuration is maintained.

If a deployment was carried out from a BPC with existing monitor views to a BPC that did not yet have any views, an error occurred.

This error has been fixed.

A bug was fixed that prevented instance-specific HTML content editing rights from being granted via the role htmlcontent_editor_<MODULE-ID>.

If an element with sub-elements was created in the navigation, short pauses could occur in the application if a sub-element pointed to the same module as the element above it.

Update OpenSearch according to the update guide

For the hardening of the TLS settings, properties were set in custom.java.security.

If you are not yet using a custom.java.security file via Zentrale Konfigurationsdatei, you should do so.

Existing custom.java.security files should be supplemented with the following entry:

The bpc.env files now also set the security.properties for OpenSearch from the custom.java.security file. As a result, changes in the file affect both Karaf and OpenSearch.

When using a bpc.env, it is recommended to update it. If not already present, the file custom.java.security should be added. The following must be added for this purpose.

See also Zentrale Konfigurationsdatei

The "Data Filter Operator" setting can now be used to configure how different data filters (for organizations, roles, permissions, or users) are linked together.

With OR (default), all data that meets any of the filter settings is displayed. With AND, only data that meets all filter settings is displayed.

See also Sichtbarkeit von Monitor-Daten einschränken

The JVM security.properties can now be set (e.g. DNS cache TTL for cloud environments, see link). To do this, the entry in bpc.env.sh/bpc.env.cmd must be entered as follows:

 export EXTRA_JAVA_OPTS="-Djava.security.properties=../custom.java.security"

 SET EXTRA_JAVA_OPTS=-Djava.security.properties=..\custom.java.security

In addition, the custom.java.security file must be downloaded. You can find the file in the download-area Download - Virtimo Fileserver.

More information under: Zentrale Konfigurationsdatei

With the BPC license, settings can now be protected from modification. This will primarily be used in our cloud installations (K8s). For example, we use the core setting 'backupRepository' to define the configuration of OpenSearch backups in an Amazon S3 bucket, and this should not be changeable via the BPC frontend.

To achieve this, the XML can be extended with the list element NON_WRITEABLE_SETTINGS containing the IDs of the non-editable settings when creating the license.

Excerpt from a sample license:

The settings (example: _core_noinstance_backupRepository) are the same as those used in the OpenSearch index 'bpc-configuration'.

The structure is as follows: <ModuleId>_<InstanceId>_<SettingName>

If it is a setting of a module and not of an instance/component, then the value noinstance is to be used for <InstanceId>. You can find the <SettingName> by displaying the "ID" column in the settings grid in the BPC frontend.

Example: _core_noinstance_backupRepository

We have reduced the number of shards in the Core_IndexTemplates setting to 1. This is also the default setting that Elasticsearch/OpenSearch has been using for new indexes for a few years. This only affects newly created indices. Indices that have already been created are not affected.

By optimizing access to the OpenSearch Backup API, fewer accesses to the data storage are performed. This reduces the corresponding costs, for example, when using Amazon S3.

The interface for configuring and creating analysis components has been standardized.

When saving JSON settings, attributes within objects were automatically sorted. This behavior has been disabled. This makes it possible to arrange the order according to your own criteria.

The currently set font can be read out via the CSS variable --font-family.

The bpc.env files now also set the security.properties for OpenSearch from the custom.java.security file. As a result, changes in the file affect both Karaf and OpenSearch.

When using a bpc.env, it is recommended to update it. If not already present, the file custom.java.security should be added. The following must be added for this purpose.

See also Zentrale Konfigurationsdatei

The file name of the license can now also be license.xml.virtimo. Previously, it had to be license.xml.bpc. This makes it possible to use a license that is also a valid INUBIT license file at the same time.

The loading of the BPC configuration in the client is accelerated by the change.

For the hardening of the TLS settings, properties were set in custom.java.security.

If you are not yet using a custom.java.security file via Zentrale Konfigurationsdatei, you should do so.

Existing custom.java.security files should be supplemented with the following entry:

The placeholder #user.loginName# is now correctly replaced in the Data_Filter when the dynamic filter # is used.

If the client sends multiple session cookies because several BPCs may be installed on the server, the appropriate session cookie is now taken into account.

In cases with frequent changes to the data, errors could occur in the monitor when displaying detail views. As a result, the entire rendering of the application was disrupted and the page had to be manually reloaded.

Filters at the column header of the monitor are now displayed correctly again.

Uploaded files are no longer kept entirely in memory. This reduces memory usage and prevents "OutOfMemoryException".

The page BPC Modul entwickeln has been translated into German.

See BPC Cluster

The documentation Chart-Editor has been updated to provide clarity regarding the necessary configuration of data types on the axes and data series.

See Data Management Installation und Update

We used CXF version 3.5.4 in our previous Karaf releases. This CXF version provides Jackson in version 2.14.3. Now we ship Karaf with CXF 3.6.5, which provides Jackson in the version 2.17.2.

Please update the CXF version (3.6.5) in your pom.xml. And more important is to update also the used Jackson version (2.17.2). For this check if you have an Import-Package statement for it. This must be added or adjusted when you use Jackson functionality like the ObjectMapper class.

Replace

with

Update OpenSearch according to the update guide

New data in the "Frontend Log Monitor" monitor is now displayed directly or loaded subsequently.

The log level for the BPC plugin in OpenSearch has been reduced from trace to info. This setting can be found in the file opensearch/config/log4j2.properties.

Modules can now send updates to the plugins loaded there via their hooks. See also: BPC Plugins entwickeln

The LogService API for generating deep links to monitors can now handle various query parameters to set appropriate filters in the monitor.

A deeplink to the audit log monitor can be retrieved via the Auditlog API.

In the bundle info, which can be accessed via the Karaf console, the time of the last change to the underlying source code is now displayed instead of the build time.

Forms in the detail view now receive changed data when the monitor reloads. To suppress this behavior—because the changes to the data may not be relevant for the form—the option ignoreUpdates can be set on the form in the detail configuration. See also: Konfiguration der Monitor-Detailansichten

AuditLog and LogService API documentation supplemented. See: BPC API

The possible query parameters for the AuditLog and LogService API for opening a monitor via deeplink have been added to the documentation.

See BPC API

Update OpenSearch according to the update guide

From IGUASU version 3.0.6, it is possible to jump directly from the BPC Flow Processor overview to the IGUASU processor. “Frontend URL” and “System ID” are now available in the Flow Manager. “URL” has been renamed to “Service URL.” Username and password are no longer required. Long descriptions of the processors are displayed in a shortened form, with the full text shown in the tooltip.

For some chart types, it is now possible to enable an export function.

See Chart-Editor

Module developers must ensure that no additional parameters are specified in the Bundle-SymbolicName.

Incorrect: de.virtimo.bpc.module-id;blueprint.aries.xml-validation:=false

Correct: de.virtimo.bpc.module-id

The incorrect variant was included in earlier templates for BPC modules.

The behavior of validateOnChange has been adjusted so that validation is now only triggered when the user shifts focus elsewhere.

If the available disk space falls below defined thresholds, shards are redistributed to other nodes. It can also happen that indices are set to read-only to prevent the disk from filling up.

The value of cluster.routing.allocation.disk.threshold_enabled is now true. This corresponds to the OpenSearch default value.

If the HTTP headers system.id and instance.id are set, the values are written into a new JSON object externalReference under the fields iguasuSystemId and iguasuInstanceId.

The function setProperty - Setzen des Wertes einer Variable is now available.

Fields that contain nested JSON objects receive "formatter": "jsonStringify" in the initial column configuration. This converts the contents into text and displays them in the monitor.

The browser function https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify][JSON.stringify] is now available as an ExtJS format function.

This allows it to be easily used in various places to convert JSON into text.

The print dialog can now be triggered externally.

A bug was fixed that caused individual replication jobs not to be correctly distributed across all available nodes when changes were made to the nodes in the BPC cluster.

Both URL configurations must be filled in to enable the jump to the processor (e.g., in IGUASU)

Although the OpenSearch connection was configured with http, an attempt was made to establish the TLS context based on the configuration. However, if this configuration was incorrect, an error occurred.

The configuration is now ignored, as it is not relevant for http connections.

Nevertheless, it is recommended to use secure connections at this point.

An application area can now only be switched if it is not empty and the user has permission to view the contents of the application area.

It is now possible again to use value to set the content of the HTML components.

A dedicated prefix is now used for the values in LocalStorage. As a result, the contents of other applications are not deleted.

There were various problems when the time zone of the "last update column" in the database table is set to UTC: - The tail sync did not always delete all records. - Instead, it updated all records on each run. - The interaction with replication also became confused.

If several deployment files were placed in karaf/deploy, not all of them were sometimes processed. The cause was the automatic backup of the existing configuration. The names of the backups are now unique to the millisecond.

The error in the ExtJS framework was fixed by an override.

At Sencha, the issue is tracked under EXTJS-29685.

Changes to the valid value range have a direct impact on the validation of the default value.

The documentation for configuring secure network connections has been revised.

See in particular Sichere Verbindung (TLS/HTTPS)

See Vom BPC bereitgestellte Button-Typen entwickeln

Update OpenSearch according to the update guide

The mode for notifications about feedback from process starters and actions can be set in the “Function_ProcessNotificationDisplayMode” (“function_processNotificationDisplayMode”) setting: Toast: Short overlay PopUp: Window that must be confirmed Silent: No visual notification (notification appears in the list when you click on the bell at the top right) See also: Konfiguration des Process Monitorings

The setting applies to all processes (process starters and actions), but not to status changes. In “Function_ProcessStarterConfig”, the notificationDisplayMode can be changed for individual processes (toast, popup, or silent). (Case sensitivity does not matter) See also: Prozess Starter

A dark theme is available for the BPC. It can be downloaded from the download page.

To switch between installed themes, you can use, for example, the plugin Theme Switcher.

The dynamicList filter with "queryMode": "remote" is now case-insensitive

Via the context menu in the monitor, it is now possible to change the sorting of the grouping.

The HTTP status codes for responses to the REST API have been documented in greater detail. See: BPC API

The core now automatically searches for a configuration for indices that are to be created and managed.

See also Anlegen von Indices

Plugins in the monitor module header were partially displayed with an incorrect colored background.

Paths in themes should now always be specified as absolute.

Correct: $CompanyIcon: "/bpc-theme-customer/resources/images/favicon.png"

Incorrect: $CompanyIcon: "../resources/images/favicon.png"

See also: BPC Theme entwickeln

When impersonating other users, the language can no longer be changed in the Keycloak profile of the impersonated user. For this to work, Keycloak must be correctly configured so that impersonator information is passed along via an active scope.

The configuration grid_showHeader is obsolete as it causes errors. The behavior of the header has been controlled for quite a while using the parameter moduleHeader_enabled.

See Netzwerk

See also:

See Anlegen von Indices

Karaf access via SSH is described in more detail and useful notes have been added.

The following documentation pages have been changed.

See OpenSearch

The dashboard documentation has been expanded to include the layout (columns and table).

See Konfiguration des Process Dashboards and Dashboard-Ansicht anpassen.

It has been documented how to create your own specific loggers.

The following documentation pages have been changed: Logging

See Karaf-Konsolen-Befehle Cheat Sheet

See BPC Theme entwickeln

Update OpenSearch according to the update guide

While loading the BPC, the version number of the Core Common Package (Fe-Core) is determined and stored in the local storage. If this version number differs from the one stored during the previous load, the local storage is cleared.

An endpoint for sending events has been provided See also: Event API

It is now possible to specify references to external resources when writing audit information. For example, it is possible to refer to the IGUASU instance that created the entry.

Date format setting added. See also Monitor-Widgets für das Dashboard

The large number of subpages has now mostly been divided under "Processes" and "Data View."

See BPC Theme entwickeln

For instance types, labels can be defined using language keys. The language key is composed as follows: "<MODULE_ID>_INSTANCE_TYPE_<INSTANCE_TYPE>" The language key for core modules is composed as follows: "CORE_<MODULE_ID>_INSTANCE_TYPE_<INSTANCE_TYPE>" or, for example: "CORE_BACKENDCONNECTION_INSTANCE_TYPE_HTTP_PROXY": "HTTP Proxy"

It is now possible to replace the "User Account Menu" with an avatar. This is a circular display of the user’s initials or, if configured correctly, an image stored with the identity provider. See also User Account Menu

See System Monitoring (Metriken für Prometheus)

For the HTML Content module, instance-specific roles can now be assigned for editing: htmlcontent_editor_<MODUL_ID> See also: HTML Content Modul (Benutzerdefinierte Inhalte)

See Submit - Formularversand

Documentation adjusted under Monitor-Widgets für das Dashboard.

JSESSIONID cookie has been deactivated

Fixed: An error where the list of available filters was displayed as empty even though a selection should have been available.

The documentation has been updated to include information about the dependency on "theme-triton" for custom CSS in custom frontend modules.

BPC Modul entwickeln

On the page Konfiguration des Process Monitorings, the settings function_gridMultipleViews and function_gridMultipleViewsConfig are now correctly referenced to Konfiguration mehrerer Grids/Sichten.

Update OpenSearch according to the update guide

The Process Dashboard has a new layout setting that allows you to switch between a column and table layout.

If an IP pinning error occurs, you can now log in normally in the browser after reloading the page. The error will not be displayed again (unless the IP changes again).

Split View in Process Monitoring can now be displayed automatically when opened by setting DetailView_EastInitialShow to true. (DetailView_East must also be true) Konfiguration des Process Monitorings

When switching organizations, you can now configure that the user lands on their homepage instead of staying on the current page.

See also Wechseln der aktiven Organisation

The Storage API now returns an empty result set when requesting content for stores that have not yet been created.

See also: Storage API

In the selection list for organization change, it is now possible to set that already active organizations are displayed as deactivated elements.

See also Wechseln der aktiven Organisation

Corrected names of configuration parameters in Log Service.

In current Karaf versions, Karaf-specific environment variables for setting JVM memory have been removed and must be replaced with an alternative.

Linux

Please replace in bpc.env.sh

with

and adopt the values accordingly.

Windows

Please replace in bpc.env.cmd

with

and adopt the values accordingly.

See also Zentrale Konfigurationsdatei and Karaf

When the navigation bar is collapsed, the icon no longer shifts to the left if there is a submenu.

In current Karaf versions, Karaf-specific environment variables for setting JVM memory have been removed and must be replaced with an alternative.

Linux

Please replace in bpc.env.sh

with

and adopt the values accordingly.

Windows

Please replace in bpc.env.cmd

with

and adopt the values accordingly.

See also Zentrale Konfigurationsdatei and Karaf

Empty values in a combobox are no longer displayed as  

Components are now automatically centered when inserted into the Application Toolbar. This affects, among others, HTML Content Plugins that use the Hook Global Application Toolbar left/right. As a result, components that have padding and margins defined only on one side are no longer centered. For these elements, padding and margins can now be set to 0.

It is now possible, via GUI or API, to download an SBOM file for each module.

When uploading modules, it is now checked whether a potentially affected module can actually be updated by an upload. If this is not the case, the download is rejected.

Additionally, it is prevented that modules are deployed multiple times in parallel when different file names are used during upload.

The BPC Bundle now contains additional content. For details, see Download - Virtimo Fileserver

Only numeric environment variables in bpc.env.cmd may be set using SET /a. The /a parameter has been removed from the template and the examples for non-numeric values.

Like hidden and disabled, required and readOnly can now also be bound to a container or fieldset. See Beispiele.

curl examples for calling OpenSearch supplemented with username and password. See also Migration von BPC 4.0 nach BPC 4.1 and Troubleshooting

Data binding within forms has been revised. The combination of several data bindings now requires an operator such as +. Further information: Attribute von Formular-Komponenten binden

Update OpenSearch according to the update guide

Adjust the über/about icon (from round to square)

It is recommended to move customized keystore and truststore files from the Karaf and OpenSearch folders.

More info under: core:/admin/configuration/bpc_env.adoc#keystore_truststore

The BPC cookie name can now be set in [karaf]/etc/de.virtimo.bpc.core.cfg via the property de.virtimo.bpc.core.cookieName (also via bpc.env.sh). The default, as before, is BPC_J_S.

See also BPC Konfigurationsdatei

BPC modules can now react to restored indices via events.

See also Backup von Indices

If a managed index was deleted during or shortly before a write access, it was automatically recreated. However, the general index configuration was not taken into account in this process. This behavior is now avoided.

See also Anlegen von Indices

Data binding within forms has been revised. The combination of several data bindings now requires an operator such as +. Further information: Attribute von Formular-Komponenten binden

Due to an interaction with the PAX JDBC Feature Installer, it could happen that the BPC did not start correctly after a Karaf update.

When starting a Karaf with plaintext passwords in the users.properties, a java.lang.IllegalArgumentException: Detected a Non-hex character at 1 or 2 position error could occur.

See Konfiguration des Monitor-Daten-Exports and Konfiguration des Process Monitorings

See also Anlegen von Indices

Update OpenSearch according to the update guide

The additional component of Karaf called 'Decanter' is used to write the Karaf logs to the OpenSearch index 'bpc-logs'. With a new installation of Karaf, this component is already pre-installed and nothing needs to be done. If an existing Karaf installation cannot or should not be replaced, it can also be installed using the Karaf console (Internet connection required).

Due to this change, the use of Java 17 is now mandatory and support for Java 11 has ended.

Karaf must be updated with this update.

At Download - Virtimo Fileserver, a "Watchdog" module is now offered. This monitors the core application (Core module) and attempts to start it if necessary. This is only relevant in scenarios where it may happen that Karaf is started at a time when no connection to OpenSearch is yet possible. The core module tries to establish the connection for about 90 seconds and then enters an error state from which it cannot recover on its own. The watchdog ensures that even afterwards, a start is regularly attempted or an attempt is made to establish an OpenSearch connection.

The additional component of Karaf called 'Decanter' is used to write the Karaf logs to the OpenSearch index 'bpc-logs'. With a new installation of Karaf, this component is already pre-installed and nothing needs to be done. If an existing Karaf installation cannot or should not be replaced, it can also be installed using the Karaf console (Internet connection required).

New status endpoint for querying the role of individual nodes in cluster operation. This endpoint can now be used to check whether a node has the "master" role or not. See also BPC API /cxf/bpc-core/status/clustermaster

A new parameter anyMatch makes it possible to filter options differently for combo boxes. See Prozess Starter.

Due to this change, the use of Java 17 is now mandatory and support for Java 11 has ended.

Only relevant for BPC module developers

BPC modules previously obtained the ExtJS framework either via our own NPM repository or it had to be provided separately. Now, ExtJS can be obtained directly from Bitbucket via npm. For this, the dependency "@virtimo/sencha-extjs-sdk": "git+ssh://git@bitbucket.org/virtimo/sencha-extjs-sdk#c728d7e2 [git+ssh://git@bitbucket.org/virtimo/sencha-extjs-sdk#c728d7e2]" must be set in the package.json. It should be noted that the part at the end #c728d7e2 corresponds to a GIT commit ID. This should be chosen so that it matches the current branch or BPC version. c728d7e2 corresponds to the current BPC 4.1 branch "support/4.1.x". Alternatively, you can also specify the branch name. However, this is not recommended, as it has been shown that npm does not consider newer commits in this case when updating.

After entering the dependency, the path to the ExtJS framework in the workspace.json file can be set as follows:

A directory or symlink "ext" is no longer necessary.

Implemented the Radiogroup

The status page now provides a better description when it is a configured base URL.

Filter for licenses in "About Business Process Center" now works

Objects for values in instance settings no longer cause existing instances to be unable to load and prevent new instances of a module from being created.

The emojis of the Froala Editor have been removed. You can still use the emojis from your keyboard or operating system.

Karaf must be updated with this update.

An update of the OpenSearch plugin (os-bpc-plugin) is necessary.

In deployment, it is now possible to selectively deploy content that is provided by modules in the Storage Service. This applies, for example, to monitor views.

It is now possible to use the print action within a form, which opens the print view and thus enables the creation of a PDF. See Print - Ausdruck des Formulars in ein pdf.

See Log Service API

See Log Service API

An update of the OpenSearch plugin (os-bpc-plugin) is necessary.

"null" values in combobox lists are displayed better

For existing installations, the file bpc-be-dashboard.jar can be removed without replacement and deleted from the KARAF/deploy directory. The dashboard module now consists only of the file bpc-fe-dashboard.war.

At de.virtimo.bpc.module.monitor.api.service.MonitorService, it is now possible to check via isAcccessible(…​) whether a user is allowed to access certain monitor functions.

Bug fixed where navigation was no longer displayed due to old configuration

If the timestamp of a record lies exactly on the boundary of the current replication window, it may happen that it is not replicated. Depending on the precision of the timestamp field and the size of the replication window, however, this is very unlikely.