Changelog

In aktuellen Karaf Versionen wurden Karaf spezifische Umgebungsvariablen zum setzen des JVM Speichers entfernt und müssen durch eine Alternative ersetzt werden.

Linux

Bitte in der bpc.env.sh

durch

ersetzen und die Werte entsprechend übernehmen.

Windows

Bitte in der bpc.env.cmd

durch

ersetzen und die Werte entsprechend übernehmen.

Siehe auch Zentrale Konfigurationsdatei und Karaf

Im eingeklappten Zustand der Navigationsleiste verschiebt sich das Icon jetzt nicht mehr nach links, wenn es ein Untermenü gibt

In aktuellen Karaf Versionen wurden Karaf spezifische Umgebungsvariablen zum setzen des JVM Speichers entfernt und müssen durch eine Alternative ersetzt werden.

Linux

Bitte in der bpc.env.sh

durch

ersetzen und die Werte entsprechend übernehmen.

Windows

Bitte in der bpc.env.cmd

durch

ersetzen und die Werte entsprechend übernehmen.

Siehe auch Zentrale Konfigurationsdatei und Karaf

Passende Icons neben Titel bei verschiedenen Benachrichtigungstypen hinzugefügt Titel bei Benachrichtigungen abhängig vom Benachrichtigungstyp angepasst

Leere Werte in einer Combobox werden nicht mehr als   angezeigt

Komponenten werden nun automatisch zentriert, wenn sie in die Application Toolbar eingefügt werden. Davon betroffen sind unter anderem HTML Content Plugins, die die Hook Global Application Toolbar left/right benutzen. Dies hat zur Folge, dass Komponenten, die nur einseitig padding und margins definiert haben, nun nicht mehr zentriert sind. Für diese Elemente kann padding und margins nun auf 0 gesetzt werden.

Es ist nun möglich, über GUI oder API, eine SBOM Datei für jedes Modul herunterzuladen.

Für den Button steht eine neue Aktion zur Verfügung. Mit setData kann der Wert einer Variable überschrieben, inkrementiert oder dekrementiert werden.

Beim Upload von Modulen wird nun geprüft, ob ein potentiell betroffenes Modul überhaupt durch einen Upload aktualisiert werden kann. Ist dies nicht der Fall, wird der Download abgelehnt.

Außerdem wird verhindert, dass Module mehrfach parallel deployt werden, wenn man beim Upload unterschiedliche Dateinamen verwendet.

Das BPC Bundle enthält nun weitere Inhalte. Details siehe Download - Virtimo Fileserver

Nur numerische Umgebungsvariablen in der bpc.env.cmd dürfen mit SET /a gesetzt werden. Der Parameter /a wurde in der Vorlage und den Beispielen für nicht numerische Werte entfernt.

Required und readOnly können wie hidden und disabled nun ebenfals an einen Container oder Fieldset gebunden werden. Siehe Beispiele.

curl Beispiele für den Aufruf von OpenSearch um Benutzername und Passwort ergänzt. Siehe auch Migration von BPC 4.0 nach BPC 4.1 und Troubleshooting

Data-Binding innerhalb von Formularen wurde überarbeitet. Die Kombinierung von mehreren Data-Bindings erfordert nun einen Operator wie +. Weitere Informationen: Attribute von Formular-Komponenten binden

Aktualisieren Sie OpenSearch entsprechend der Updateanleitung

Anpassung von über/about icon (von circle nach square)

Es wird empfohlen, angepasste Keystore- und Truststore-Dateien aus den Karaf- und OpenSearch-Ordnern zu verschieben.

Mehr infos unter: core:/admin/configuration/bpc_env.adoc#keystore_truststore

Der BPC Cookie Name kann nun in der [karaf]/etc/de.virtimo.bpc.core.cfg über das Property de.virtimo.bpc.core.cookieName gesetzt werden (auch per bpc.env.sh). Default ist wie zuvor BPC_J_S.

Siehe auch BPC Konfigurationsdatei

BPC Module können nun über Events auf Wiederhergestellte Indices reagieren.

Siehe auch Backup von Indices

Wenn ein managed Index während bzw. kurz vor einem Schreibzugriff gelöscht wurde, dann wurde er automatisch angelegt. Dabei wurde jedoch die allgemeine Index Konfiguration nicht berücksichtigt. Dieses Verhalten wird nun vermieden.

Siehe auch Anlegen von Indices

Data-Binding innerhalb von Formularen wurde überarbeitet. Die Kombinierung von mehreren Data-Bindings erfordert nun einen Operator wie +. Weitere Informationen: Attribute von Formular-Komponenten binden

Durch eine Wechselwirkung mit dem PAX JDBC Feature Installer konnte es vorkommen, dass das BPC nach einem Karaf Update nicht korrekt startete.

Beim Starten eines Karafs, mit Klartextpasswörtern in der users.properties, konnte es zu einem java.lang.IllegalArgumentException: Detected a Non-hex character at 1 or 2 position Fehler kommen.

Siehe Konfiguration des Monitor-Daten-Exports und Konfiguration des Process Monitorings

Siehe auch Anlegen von Indices

Aktualisieren Sie OpenSearch entsprechend der Updateanleitung

Karaf Logs werden nun über einen Monitor bereitgestellt (siehe auch Karaf Log).

Für das Schreiben der Karaf Logs in den OpenSearch-Index bpc-logs wird die Zusatzkomponente 'Decanter' verwendet. Bei einer neuen Installation des Karafs ist diese Komponente bereits vorinstalliert und es muss nichts gemacht werden. Falls eine vorhandene Karaf-Installation nicht ersetzt werden kann oder soll, dann kann diese auch per Karaf-Konsole nachinstalliert werden (Internet Verbindung notwendig).

Für die Konfiguration der Funktion siehe Karaf Log.

Durch diese Änderung ist der Einsatz von Java 17 nun verpflichtend und der Java 11 Support ist beendet.

Karaf muss mit diesem Update aktualisiert werden.

Unter Download - Virtimo Fileserver wird nun ein "Watchdog" Modul angeboten. Dieses überwacht die Kernanwendung (Core Modul) und versucht es bei Bedarf zu starten. Dies ist nur in Szenarien relevant, in denen es vorkommen kann, dass der Karaf zu einem Zeitpunkt gestartet wird, bei dem noch keine Verbindung zu OpenSearch möglich ist. Das Core-Modul versucht für ca. 90 Sekunden die Verbindung herzustellen und geht dann in einen Fehlerzustand, aus dem es selbst nicht alleine wieder heraus kommt. Der Watchdog sorgt dafür, dass auch nachfolgend regelmäßig ein Start bzw. versucht wird eine OpenSearch Verbindung herzustellen.

Karaf Logs werden nun über einen Monitor bereitgestellt (siehe auch Karaf Log).

Für das Schreiben der Karaf Logs in den OpenSearch-Index bpc-logs wird die Zusatzkomponente 'Decanter' verwendet. Bei einer neuen Installation des Karafs ist diese Komponente bereits vorinstalliert und es muss nichts gemacht werden. Falls eine vorhandene Karaf-Installation nicht ersetzt werden kann oder soll, dann kann diese auch per Karaf-Konsole nachinstalliert werden (Internet Verbindung notwendig).

Für die Konfiguration der Funktion siehe Karaf Log.

Neuer Status-Endpunkt zur Abfrage der Rolle einzelner Knoten im Clusterbetrieb. Über diesen Endpunkt kann nun überprüft werden, ob ein Knoten die "master"-Rolle hat oder nicht. Siehe auch BPC API /cxf/bpc-core/status/clustermaster

Ein neuer Parameter anyMatch ermöglicht es bei Comboboxen Optionen anders zu filtern. Siehe Prozess Starter.

Durch diese Änderung ist der Einsatz von Java 17 nun verpflichtend und der Java 11 Support ist beendet.

Nur relevant für BPC Modulentwickler

BPC Module haben zuvor das ExtJS Framework entweder über unser eigenes NPM-Repository bezogen oder es musste separat bereitgestellt werden. Nun kann ExtJS via npm direkt aus Bitbucket bezogen werden. Dafür muss in der package.json die Dependency "@virtimo/sencha-extjs-sdk": "git+ssh://git@bitbucket.org/virtimo/sencha-extjs-sdk#c728d7e2" gesetzt werden. Dabei ist zu beachten, dass der Teil am Ende #c728d7e2 ` einer GIT Commit ID entspricht. Diese sollte so gewählt werden, dass diese zum aktuellen Branch bzw. BPC Version passt. `c728d7e2 entspricht dem aktuellen BPC 4.1 Branch "support/4.1.x". Man kann alternativ auch den Branch-Namen angeben. Dies wird jedoch nicht empfohlen, da sich zeigt, dass npm in dem Fall keine neueren Commits, bei einem Update, berücksichtigt.

Nach dem Eintragen der Dependency kann der PFad zum ExtJS Framework in der Datei workspace.json wie folgt gesetzt werden:

Ein Verzeichnis oder Symlink "ext" ist nicht mehr nötig.

Die Auswahloptionen im Monitor Export sind nun einheitlich durch Radiogroups umgesetzt und die Bezeichnungen verbessert.

Auf der Statusseite wird nun besser beschrieben, wenn es sich um eine konfigurierte Basis URL handelt.

Filter für Lizenzen in "Über Business Process Center" funktioniert jetzt

Objekte für Werte in Instanz-Einstellungen führen nicht mehr dazu, dass bestehende Instanzen nicht geladen werden können und keine neuen Instanzen eines Moduls erstellt werden können

Die Emojis des Froala Editors wurden entfernt. Es können weiterhin die Emojis der Tastatur bzw. des Betriebssystems genutzt werden.

Karaf muss mit diesem Update aktualisiert werden.

Es ist das Update des OpenSearch Plugins (os-bpc-plugin) nötig.

Im Deployment können nun selektiv Inhalte deployt werden, die von Modulen im Storage Service vorgehalten werden. Dies betrifft zum Beispiel Monitor Ansichten.

Es ist nun möglich innerhalb eines Formulars die Aktion print zu verwenden, die die Druckansicht öffnet und so die Erstellung einer PDF-Datei ermöglicht. Siehe Print - Ausdruck des Formulars in ein pdf.

Siehe Log Service API

Siehe Log Service API

Es ist das Update des OpenSearch Plugins (os-bpc-plugin) nötig.

"null"-Werte in Combobox Listen werden besser dargestellt

Bei bestehenden Installationen kann die Datei bpc-be-dashboard.jar ersatzlos entfallen und aus dem KARAF/deploy Verzeichnis gelöscht werden. Das Dashboard Modul besteht nur noch aus der Datei bpc-fe-dashboard.war.

Siehe empfohlene Dateien

Bug behoben, bei dem die Navigation wegen alter Konfiguration nicht mehr angezeigt wird

Wenn der Timestamp eines Datensatz genau auf der Grenze des aktuellen Replikationsfensters liegt, dann konnte es vorkommen, dass dieser nicht repliziert wird. Je nach Genauigkeit, des Timestamp-Feldes und der Größe des Replikationsfensters, ist dies jedoch sehr unwahrscheinlich.

Weiteres Routing-Beispiel mit Card-Layout zur Dokumentation hinzugefügt

Siehe Routing / Deep Links

Wird eine Komponente kopiert, der Plugins direkt zugeordnet sind, dann kann man in einem folge Dialog auswählen, ob man auch der Kopie diese Plugins zuweisen möchte.

Siehe auch: Modulkomponenten kopieren

Replication Status Plugin hinzugefügt

Siehe Replication Status

Siehe auch de.virtimo.bpc.core.opensearch.hosts in BPC Konfigurationsdatei

Siehe auch ´mandatoryRoleToAccessBPC´ in Core Services

Siehe auch IP Pinning

Hinweis über Sitzungsaktualisierung entfernt

BPC Settings vom Typ text können nun über das Attribut disableEncoding steuern, ob im Adminbereich implizit ein HTML Encoding verwendet werden soll.

Wenn nicht anders definiert, wird auf die Werte dieser Settings im Adminbereich ein HTML Encoding angewendet.

Ab dieser Version, werden keine Default-Passwörter mehr mit Karaf ausgeliefert. Beim Starten vom BPC werden für die Default-User zufällige Passwörter generiert.

Siehe auch: Installation

Siehe Modulkomponenten kopieren

Aktualisieren Sie OpenSearch entsprechend der Updateanleitung

Falls in der Zentralen Konfigurationsdatei bpc.env.sh die Umgebungsvariable KARAF_PAX_JDBC_FEATURES_TO_INSTALL verwendet wird, sicherstellen daß das neue Modul PAX JDBC Feature Installer installiert ist.

Verwenden Backend Modul Entwickler den OpenSearch REST High Level Client, dann müssen höchstwahrscheinlich Packages angepasst werden, da OpenSearch hier einige Klassen verschoben hat.

Aktualisieren Sie OpenSearch entsprechend der Updateanleitung

Falls in der Zentralen Konfigurationsdatei bpc.env.sh die Umgebungsvariable KARAF_PAX_JDBC_FEATURES_TO_INSTALL verwendet wird, sicherstellen daß das neue Modul PAX JDBC Feature Installer installiert ist.

Verwenden Backend Modul Entwickler den OpenSearch REST High Level Client, dann müssen höchstwahrscheinlich Packages angepasst werden, da OpenSearch hier einige Klassen verschoben hat.

BpcCommon.Util.sanitizeHtml() prüft den Input. Handelt es sich nicht um eine Zeichenkette, so wird der Input nicht verarbeitet.

Aktualisieren Sie OpenSearch entsprechend der Updateanleitung

Falls in der Zentralen Konfigurationsdatei bpc.env.sh die Umgebungsvariable KARAF_PAX_JDBC_FEATURES_TO_INSTALL verwendet wird, sicherstellen daß das neue Modul PAX JDBC Feature Installer installiert ist.

Verwenden Backend Modul Entwickler den OpenSearch REST High Level Client, dann müssen höchstwahrscheinlich Packages angepasst werden, da OpenSearch hier einige Klassen verschoben hat.

Karaf muss mit diesem Update aktualisiert werden.

Der Login auf die Karaf-Konsole via ssh ist für Benutzer aus der users.properties im Standard nicht mehr erlaubt. Um Benutzern den Login via ssh zu erlauben, fügen Sie die Rolle ssh in der Datei KARAF/etc/users.properties den einzelnen Benutzers hinzu oder fügen Sie die Rolle der admingroup hinzu.

Einträge in der Datei KARAF/etc/keys.properties, die von Ihnen nicht für einen Login mit public/private Key genutzt werden, können entfernt werden.

Funktionalität zur Löschung von Navigationseinträgen beim Löschen von Instanzen

Komponentenspezifische Rechte für Module Monitor, Analysis und Dashboard.

Einträge in der Datei KARAF/etc/keys.properties, die von Ihnen nicht für einen Login mit public/private Key genutzt werden, können entfernt werden.

Wird über den, am IdP Konfigurierten, UserInfoEndpunkt die Rolle bpcadmin gesetzt, so wird dies ignoriert.

BPC_PM_configureBpc - Variable var.csrfToken wird nun inital angelegt. Außerdem Fallunterscheidung beim Anlegen von HttpProxy / BackendConnections abhängig von der Version.

Karaf muss mit diesem Update aktualisiert werden.

Der Login auf die Karaf-Konsole via ssh ist für Benutzer aus der users.properties im Standard nicht mehr erlaubt. Um Benutzern den Login via ssh zu erlauben, fügen Sie die Rolle ssh in der Datei KARAF/etc/users.properties den einzelnen Benutzers hinzu oder fügen Sie die Rolle der admingroup hinzu.

Am Monitor können über die Einstellung Data_ProcessExcludedFields(data_excludedFields) einzelne Felder für die Übermittlung an den Client ausgeschlossen werden. Damit können zum Beispiel nicht verwendete oder sensible Daten unterdrückt werden.

Der globale Datumsfilter bietet nun einen lokalen Modus. Mit diesem kann nun auch für ein Modul abweichend eine andere Zeitspanne gesetzt werden. Siehe auch Globaler Datumsfilter

Falls gesetzt, die folgenden nicht mehr benötigten os-bpc-plugin spezifischen Settings aus der conf/opensearch.yml entfernen.

Wird dies nicht getan, dann startet OpenSearch nicht und bringt den Fehler "please check that any required plugins are installed, or check the breaking changes documentation for removed settings".

Betrifft nur Modulentwickler Bei der Verwendung des BPC JsonEditors (xtype bpcJsonField bzw. bpcCodeEditorWindow.json) wird das optionale JSON Schema nun via schema und nicht mehr per jsonSchema übergeben.

Der Inhalt der Monitor Sprungspalte wurde bisher beim Filtern im Zielmonitor getrimmt (Entfernung von Leerzeichen am Anfang und Ende). Dies wird nun nicht mehr gemacht, damit man spezifisch auf Werte mit Leerzeichen am Anfang oder Ende filtern kann.
Sollten Sie in Ihrer Monitor Sprungspalte Werte mit zusätzlichen Leerzeichen nutzen (z.B. auch im Zusammenhang mit dem separator), die nicht den Zielwerten im Ziel-Monitor entsprechen, müssen diese ggf. entfernt werden.

Es wird nun ein neuer Typ filefield angeboten. Mit diesem ist es möglich Dateien über das Formular zu versenden. Siehe auch: File Field

Betrifft nur Modulentwickler Bei der Verwendung des BPC JsonEditors (xtype bpcJsonField bzw. bpcCodeEditorWindow.json) wird das optionale JSON Schema nun via schema und nicht mehr per jsonSchema übergeben.

Es besteht jetzt die Möglichkeit, die Darstellung des Menüelements einer Sprungspalte anzupassen. Siehe auch jumpMenuIconCls und jumpMenuText unter Konfigurationsparameter. Außerdem besteht auch die Möglichkeit, die Sprung-Optionsmenü zu deaktivieren. Nach der Deaktivierung ist nur die Sprungoption Im gleichen Tab springen möglich.

Nun ist es möglich, mehrere Binding-Referenzen in einem Bind-String zu verwenden. Siehe dazu auch: Attribute von Formular-Komponenten binden

Einstellungsmöglichkeit für Limitierung von Data/Rows (Monitor_DataCountLimit und Monitor_DataViewLimit) zu Instanz-spezifischen Einstellungen hinzugefügt

Es wurden Anpassungen entfernt, die für die Unterstützung der Browser Firefox 60 ESR und Internet Explorer 11 nötig waren. Diese Browser werden vom BPC nicht mehr unterstützt und sollten nicht mehr eingesetzt werden, da die Hersteller den Support dieser Browser bereits eingestellt haben.

Siehe auch: Systemanforderungen

Tooltip werden nun solange angezeigt, wie sich der Mauszeiger auf dem betroffenen Element befindet. Zuvor wurden Tooltip automatisch nach 5 Sekunden wieder ausgeblendet.

Falls gesetzt, die folgenden nicht mehr benötigten os-bpc-plugin spezifischen Settings aus der conf/opensearch.yml entfernen.

Wird dies nicht getan, dann startet OpenSearch nicht und bringt den Fehler "please check that any required plugins are installed, or check the breaking changes documentation for removed settings".

Der Inhalt der Monitor Sprungspalte wurde bisher beim Filtern im Zielmonitor getrimmt (Entfernung von Leerzeichen am Anfang und Ende). Dies wird nun nicht mehr gemacht, damit man spezifisch auf Werte mit Leerzeichen am Anfang oder Ende filtern kann.
Sollten Sie in Ihrer Monitor Sprungspalte Werte mit zusätzlichen Leerzeichen nutzen (z.B. auch im Zusammenhang mit dem separator), die nicht den Zielwerten im Ziel-Monitor entsprechen, müssen diese ggf. entfernt werden.

Prozess Aktionen können nun auch im Grid der Detail Ansicht (Child Log) verwendet werden.

Die Standardwerte im BPC wurden so angepasst, dass diese direkt zu den Standardwerten des Keycloaks passen. Die Anleitung wurde vereinfacht und es wird nun kein vorkonfigurierter Realm mehr angeboten.

Siehe Keycloak anbinden und einrichten

Nun können mehrere Monitor-Prozesse durch das Kontext-Menü geteilt werden.

Die REST Api /user/info/{accessTokenType}/token greift nun auf die bestehenden UserSessions zurück und versucht dort die zugehörige UserSession zu finden. Nur wenn keine UserSession gefunden wird, wird aus dem Access-Token eine pseudo UserSession erzeugt, was dem alten Verhalten entspricht.

Bug-Fix: Tooltip im Module Header wird jetzt korrekt aktualisiert

Eine Aktualisierung von OpenSearch bzw. des os-bpc-plugin ist erforderlich.

Siehe HTML Sanitizing und die Einstellung sanitzeHTML

Theme wird in Auswahl ausgeblendet, wenn "hidden" in der Plugin-Konfiguration auf true gesetzt wird.

Siehe auch Theme Switcher

Eine Aktualisierung von OpenSearch bzw. des os-bpc-plugin ist erforderlich.

Der Name der Common-Funktion "getInstanceUrl" (eingeführt mit BPC 4.1.0) wird durch "getModuleUrl" ersetzt.

Aktualisieren Sie OpenSearch entsprechend der Updateanleitung

Der Name der Common-Funktion "getInstanceUrl" (eingeführt mit BPC 4.1.0) wird durch "getModuleUrl" ersetzt.

Im Monitor hat man nun die Möglichkeit, einen Prozess zu teilen. In dem Kontext-Menü des aktuell ausgewählten Prozesses besteht die Option "Prozess teilen". Wählt man diese Option, wird eine URL zu dem aktuellen Monitor erstellt, in welchem den aktuell selektierten Prozess fokussiert wird.

Um die jetty.xml zentral zu konfigurieren, können Sie die zentrale Konfigurationsdatei nutzen.

Product Name in Englisch und Deutsch sowie Widget Name angepasst

Eine neue Instanz vom Modul External Content zeigt standardmäßig zunächst auf die Virtimo Dokumentationen

Aktualisieren Sie OpenSearch entsprechend der Updateanleitung

Um Skripting-Angriffe zu vermeiden, können nun keine Renderer als JavaScript in Textform mehr an den Spalten definiert werden. Eigene Renderer-Funktionen können wie hier beschrieben referenziert werden. Formatierungsfunktionen aus Ext.util.Format können über die Angabe des formatter genutzt werden. Siehe dazu: Spaltenkonfiguration

Für dieses BPC Update ist ein Update des Karaf verpflichtend.

Kunden Themes und eigene BPC Module müssen so angepasst werden, dass der Web-ContextPath und Webapp-Context in der Manifest-Datei zwingend mit einem / beginnen. Um dies zu erreichen, kann in der Regel die Datei build.gradle angepasst werden. Ein Beispiel kann hier eingesehen werden.

In der Konfigurationsdatei [karaf]/etc/org.ops4j.pax.web.cfg wurden Parameter umbenannt:

Wir mussten einige Interfaces/Klassen aus dem Paket de.virtimo.bpc.core in das Paket de.virtimo.bpc.api verschieben.

Wenn Sie Ihren Code für 4.0.8 oder 4.1 kompilieren und Fehler erhalten, dann passen Sie bitte die Java imports an. In den meisten Fällen müssen Sie nur .core. durch .api. ersetzen. Ansonsten löschen Sie den Import und lassen Sie die IDE ihn für Sie finden.

Und bitte stellen Sie sicher, dass Sie keine <Import-Package> Anweisungen in Ihrer pom.xml zu den folgenden Paketen haben:

Falls BPC Core utils Klassen verwendet wurden.

Bitte die Java import Statements anpassen

Un die pom.xml (<Import-Package>)

Falls folgendes verwendet wurde

de.virtimo.bpc.core.utils.BpcTrustStoreUtil.setTo(…​)

dann Bitte ersetzen durch

de.virtimo.bpc.util.BpcTrustStore.getInstance().setTo(…​)

Plugins erhalten beim Aufruf ein context übergeben. Zwei Attribute im Objekt context wurden umbenannt. Aus moduleId wurde baseModuleId und aus instanceId wurde moduleId.

Relevant für BPC Modul Entwickler / Important for BPC Developers

This is only necessary, when you use one of the following annotations in your backend modules/bundles:

If this is the case, then please update your resources/OSGI-INF/blueprint/context.xml

and replace

with

Durch das Karaf Update wird nun ein stärkerer Algorithmus zum hashen der Passwörter verwendet. Dies wirkt sich auf alle JAAS basierten Identity Provider und den Login auf die Karaf-Konsole aus. Alle bestehenden Benutzerpasswörter können anschließend nicht mehr validiert werden und müssen neu angelegt werden!

Sollten Sie die alten Benutzerpasswörter weiter verwenden wollen, müssen Sie weiterhin den alten Algorithmus zum Hashen der Passwörter verwenden. Dies wird im Folgenden beschrieben. Wenn Sie den neuen Algorithmus verwenden wollen, müssen Sie die folgenden Schritte nicht befolgen.

Konfiguration über bpc.env (empfohlen)

Ergänzen Sie die bpc.env um folgende Werte, um den alten Algorithmus beizubehalten.

Konfiguration über Karaf Konfigurationsdateien

Ändern Sie in der Konfigurationsdatei [karaf]/etc/org.apache.karaf.jaas.cfg die folgenden Werte. Dadurch wird wieder die vorherige (schwache) Verschlüsselung verwendet.

Existierendes JAAS JDBC

Die Virtimo JAAS JDBC Implementierung verwendet nun die Passwort-Verschlüsselungseinstellungen der Datei: [karaf]/etc/org.apache.karaf.jaas.cfg. Diese stimmen nicht mit den bisher verwendeten überein.

Falls also bereits JAAS JDBC verwendet wurde und die bestehenden (schwachen) Hashes weiter verwendet werden sollen, dann bitte folgende Datei anlegen: [karaf]/etc/de.virtimo.bpc.core.auth.jaas.jdbc.cfg

Folgender Inhalt setzt die frühere (schwache) Konfiguration:

Um einen sichereren Hash-Algorithmus wie argon2 zu verwenden, müssen alle Passwörter neu erstellt und somit zurückgesetzt werden.

Es wird eine Content Security Policy(CSP) per HTTP Header gesetzt. Dies kann Auswirkungen auf eigene Module, INUBIT WebApps oder integrierte Fremdanwendungen haben. Zum Anpassen der CSP siehe Content Security Policy

We used CXF version 3.5.4 in our previous Karaf releases. This CXF version provides Jackson in version 2.13.4. Now we ship Karaf with CXF 3.5.5, which provides Jackson in the version 2.14.1.

Please update the CXF version (3.5.4 → 3.5.5) in your pom.xml. And more important is to update also the used Jackson version. 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

Dashboard Einstellung Dashboard_Responsive(ID: module_isResponsive) und Dashboard_Layout(ID: layout_config) entfallen. Dashboards sind nun per default "responsive" und nutzen die verfügbare Fläche in ihrer Spalte aus. Widget lassen sich nun vom Benutzer in Höhe und Breite anpassen. Diese Änderungen werden im Browser vorgehalten, können von berechtigten Benutzer aber auch am Dashboard gespeichert werden. Das zurücksetzen von lokalen Änderung ist nicht mehr am Widget möglich, sondern wird über eine Schaltfläche in einer der Toolbars angeboten. Damit die Schaltfläche erscheint, muss in einer der Einstellungen ModuleHeader_Content, Toolbar_LeftContent oder Toolbar_RightContent der Wert "resetUserState" hinzugefügt werden.

Siehe auch Dashboard-Schnellfunktionen

Statusinformationen zur Replikation werden nicht mehr am Monitor angezeigt. Diese Statusinformationen werden in einem zukünftigen Release via Plugin nachgereicht.

Falls Sie Folgendes verwendet haben

de.virtimo.bpc.core.utils.ServiceUtil.unregisterService(bundleContext, ServiceRegistration, Class);

dann verwenden Sie bitte

de.virtimo.bpc.api.BpcService.unregister(bundleContext, ServiceRegistration, Class);

stattdessen.

Für BPC-Modulentwickler

Es gab eine nicht dokumentierte Funktion, die global, an allen Komponenten mit dem Attribut targetModule, auf den Event click, reagiert. Dabei wurde der Wert von targetModule an die Methode BpcCommon.Api.showModule übergeben und hat so eine Navigation zu diesem Modul ausgelöst. Diese Funktion wurde nun entfernt. Wenn Sie das Attribut targetModule, z.B. an Buttons, zur Navigation genutzt haben, müssen Sie dies durch einen eigenen Handler, der nur Ihre Komponenten betrifft, einrichten.

Eine große Bitte, bei einem Karaf Update nicht einfach alle etc-Dateien aus der alten in die neue Installation kopieren. Dadurch sind dann evtl. neue Karaf Optionen nicht gesetzt und im schlimmsten Fall lässt sich der Karaf nicht starten.

Und wenn irgendwie möglich, keine [karaf]/etc Dateien manuell ändern und stattdessen die Anpassungen über die bpc.env.sh (Linux/macOS) bzw. bpc.env.cmd (Windows) vornehmen. Das erleichtert die Karaf Updates ungemein und kann in den BPC Versionen >= 3.4 verwendet werden. Siehe dazu Zentrale Konfigurationsdatei.

Per Werte von etc-Dateien überschreiben können die meisten Anpassungen vorgenommen werden, ohne dass eine etc-Datei editiert werden muss.

Wenn zum Beispiel der Pfad zu den Keystore und Truststore Dateien anders gesetzt werden soll: Die Festlegung der Pfade befinden sich in der Konfigurationsdatei [karaf]/etc/org.ops4j.pax.web.cfg in den Optionen org.ops4j.pax.web.ssl.keystore und org.ops4j.pax.web.ssl.truststore.

Um nun die Pfade der beiden Optionen anders zu setzen, können zwei Umgebungsvariablen in der bpc.env.sh hinzugefügt werden:

Noch ein Beispiel wie in der [karaf]/etc/de.virtimo.bpc.core.cfg die Option de.virtimo.bpc.core.maintenancemode.fileSystemLimitInMB gesetzt werden kann:

Eine Einschränkung wird mit dem nächsten Karaf Update behoben. Das Deployverzeichnis ([karaf]/deploy) kann derzeit wegen eines "Bugs" nicht per Umgebungsvariable gesetzt werden. Das betrifft die Option felix.fileinstall.dir in der Konfigurationsdatei [karaf]/etc/org.apache.felix.fileinstall-deploy.cfg.

Drei Dateien sollten je nach Verwendung kopiert bzw. durch symbolische Links ersetzt werden:

Dies ist natürlich nur notwendig, wenn diese überhaupt angepasst wurden. Die Optionen in den beiden cfg-Dateien könnten zwar auch über Umgebungsvariablen gesetzt werden, da müssten dann aber einige Umgebungsvariablen gesetzt werden.

Ein Update des Karaf wird aus Gründen der Sicherheit dringend empfohlen.

Monitor Ansichten die Mit einer BPC Version < 2.1.6 angelegt wurden, werden nicht mehr unterstützt. Um diese Ansichten zu erhalten müssen diese einmal im "Ansichten Verwalten" Dialog geöffnet und gespeichert werden. Durch diesen Vorgang werden die Ansichten im richtigen Format gespeichert.

Für BPC Modulentwickler

ExtJS Komponenten die das Mixin Ext.form.Labelable und dadurch die Attribute labelWidth und fieldLabel nutzen, können sich mit dem Plugin dynamisch die labelWidth anhand der tatsächlichen Textbreite setzen lassen.

Bei Bedarf kann der zusätzliche Abstand mittels labelOffset am Plugin konfiguriert werden:

Siehe auch Dynamisches Field Label

Eine große Bitte, bei einem Karaf Update nicht einfach alle etc-Dateien aus der alten in die neue Installation kopieren. Dadurch sind dann evtl. neue Karaf Optionen nicht gesetzt und im schlimmsten Fall lässt sich der Karaf nicht starten.

Und wenn irgendwie möglich, keine [karaf]/etc Dateien manuell ändern und stattdessen die Anpassungen über die bpc.env.sh (Linux/macOS) bzw. bpc.env.cmd (Windows) vornehmen. Das erleichtert die Karaf Updates ungemein und kann in den BPC Versionen >= 3.4 verwendet werden. Siehe dazu Zentrale Konfigurationsdatei.

Per Werte von etc-Dateien überschreiben können die meisten Anpassungen vorgenommen werden, ohne dass eine etc-Datei editiert werden muss.

Wenn zum Beispiel der Pfad zu den Keystore und Truststore Dateien anders gesetzt werden soll: Die Festlegung der Pfade befinden sich in der Konfigurationsdatei [karaf]/etc/org.ops4j.pax.web.cfg in den Optionen org.ops4j.pax.web.ssl.keystore und org.ops4j.pax.web.ssl.truststore.

Um nun die Pfade der beiden Optionen anders zu setzen, können zwei Umgebungsvariablen in der bpc.env.sh hinzugefügt werden:

Noch ein Beispiel wie in der [karaf]/etc/de.virtimo.bpc.core.cfg die Option de.virtimo.bpc.core.maintenancemode.fileSystemLimitInMB gesetzt werden kann:

Eine Einschränkung wird mit dem nächsten Karaf Update behoben. Das Deployverzeichnis ([karaf]/deploy) kann derzeit wegen eines "Bugs" nicht per Umgebungsvariable gesetzt werden. Das betrifft die Option felix.fileinstall.dir in der Konfigurationsdatei [karaf]/etc/org.apache.felix.fileinstall-deploy.cfg.

Drei Dateien sollten je nach Verwendung kopiert bzw. durch symbolische Links ersetzt werden:

Dies ist natürlich nur notwendig, wenn diese überhaupt angepasst wurden. Die Optionen in den beiden cfg-Dateien könnten zwar auch über Umgebungsvariablen gesetzt werden, da müssten dann aber einige Umgebungsvariablen gesetzt werden.

Wir mussten einige Interfaces/Klassen aus dem Paket de.virtimo.bpc.core in das Paket de.virtimo.bpc.api verschieben.

Wenn Sie Ihren Code für 4.0.8 oder 4.1 kompilieren und Fehler erhalten, dann passen Sie bitte die Java imports an. In den meisten Fällen müssen Sie nur .core. durch .api. ersetzen. Ansonsten löschen Sie den Import und lassen Sie die IDE ihn für Sie finden.

Und bitte stellen Sie sicher, dass Sie keine <Import-Package> Anweisungen in Ihrer pom.xml zu den folgenden Paketen haben:

Falls BPC Core utils Klassen verwendet wurden.

Bitte die Java import Statements anpassen

Un die pom.xml (<Import-Package>)

Falls folgendes verwendet wurde

de.virtimo.bpc.core.utils.BpcTrustStoreUtil.setTo(…​)

dann Bitte ersetzen durch

de.virtimo.bpc.util.BpcTrustStore.getInstance().setTo(…​)

Der Modul-Navigator wird nun als Plugin zur Verfügung gestellt. Der Name des Plugin ist: BPC Module Navigator, Plugin-ID: bpcModuleNavigator. Bestehende Breadcrumbkonfiguration wird automatisch in eine Pluginkonfiguration migriert.

Die Funktion "Status ändern" wurde in das Menu "Aktionen" verschoben.

Plugins erhalten beim Aufruf ein context übergeben. Zwei Attribute im Objekt context wurden umbenannt. Aus moduleId wurde baseModuleId und aus instanceId wurde moduleId.

Dashboard Einstellung Dashboard_Responsive(ID: module_isResponsive) und Dashboard_Layout(ID: layout_config) entfallen. Dashboards sind nun per default "responsive" und nutzen die verfügbare Fläche in ihrer Spalte aus. Widget lassen sich nun vom Benutzer in Höhe und Breite anpassen. Diese Änderungen werden im Browser vorgehalten, können von berechtigten Benutzer aber auch am Dashboard gespeichert werden. Das zurücksetzen von lokalen Änderung ist nicht mehr am Widget möglich, sondern wird über eine Schaltfläche in einer der Toolbars angeboten. Damit die Schaltfläche erscheint, muss in einer der Einstellungen ModuleHeader_Content, Toolbar_LeftContent oder Toolbar_RightContent der Wert "resetUserState" hinzugefügt werden.

Siehe auch Dashboard-Schnellfunktionen

Statusinformationen zur Replikation werden nicht mehr am Monitor angezeigt. Diese Statusinformationen werden in einem zukünftigen Release via Plugin nachgereicht.

Falls Sie Folgendes verwendet haben

de.virtimo.bpc.core.utils.ServiceUtil.unregisterService(bundleContext, ServiceRegistration, Class);

dann verwenden Sie bitte

de.virtimo.bpc.api.BpcService.unregister(bundleContext, ServiceRegistration, Class);

stattdessen.

Um Skripting-Angriffe zu vermeiden, können nun keine Renderer als JavaScript in Textform mehr an den Spalten definiert werden. Eigene Renderer-Funktionen können wie hier beschrieben referenziert werden. Formatierungsfunktionen aus Ext.util.Format können über die Angabe des formatter genutzt werden. Siehe dazu: Spaltenkonfiguration

Bitte achten Sie beim Einsatz eines Proxies an das Setzen des X-Forwarded-For Headers. Dies gilt auch für den Websocket. Siehe auch IP Pinning.

Durch das Karaf Update wird nun ein stärkerer Algorithmus zum hashen der Passwörter verwendet. Dies wirkt sich auf alle JAAS basierten Identity Provider und den Login auf die Karaf-Konsole aus. Alle bestehenden Benutzerpasswörter können anschließend nicht mehr validiert werden und müssen neu angelegt werden!

Sollten Sie die alten Benutzerpasswörter weiter verwenden wollen, müssen Sie weiterhin den alten Algorithmus zum Hashen der Passwörter verwenden. Dies wird im Folgenden beschrieben. Wenn Sie den neuen Algorithmus verwenden wollen, müssen Sie die folgenden Schritte nicht befolgen.

Konfiguration über bpc.env (empfohlen)

Ergänzen Sie die bpc.env um folgende Werte, um den alten Algorithmus beizubehalten.

Konfiguration über Karaf Konfigurationsdateien

Ändern Sie in der Konfigurationsdatei [karaf]/etc/org.apache.karaf.jaas.cfg die folgenden Werte. Dadurch wird wieder die vorherige (schwache) Verschlüsselung verwendet.

Existierendes JAAS JDBC

Die Virtimo JAAS JDBC Implementierung verwendet nun die Passwort-Verschlüsselungseinstellungen der Datei: [karaf]/etc/org.apache.karaf.jaas.cfg. Diese stimmen nicht mit den bisher verwendeten überein.

Falls also bereits JAAS JDBC verwendet wurde und die bestehenden (schwachen) Hashes weiter verwendet werden sollen, dann bitte folgende Datei anlegen: [karaf]/etc/de.virtimo.bpc.core.auth.jaas.jdbc.cfg

Folgender Inhalt setzt die frühere (schwache) Konfiguration:

Um einen sichereren Hash-Algorithmus wie argon2 zu verwenden, müssen alle Passwörter neu erstellt und somit zurückgesetzt werden.

Es wird eine Content Security Policy(CSP) per HTTP Header gesetzt. Dies kann Auswirkungen auf eigene Module, INUBIT WebApps oder integrierte Fremdanwendungen haben. Zum Anpassen der CSP siehe Content Security Policy

Für die BPC Backend Modul Entwickler. Bitte in der src/main/resources/OSGI-INF/blueprint/context.xml (falls verwendet; nicht extra anlegen) sicherstellen, dass der cxf:bus wie folgend gesetzt ist:

Das Deployment von BPC 3 nach BPC 4 geht nur, wenn das Deployment ausgehend vom BPC 4 gesteuert/gestartet wird.

Für BPC-Modulentwickler

Es gab eine nicht dokumentierte Funktion, die global, an allen Komponenten mit dem Attribut targetModule, auf den Event click, reagiert. Dabei wurde der Wert von targetModule an die Methode BpcCommon.Api.showModule übergeben und hat so eine Navigation zu diesem Modul ausgelöst. Diese Funktion wurde nun entfernt. Wenn Sie das Attribut targetModule, z.B. an Buttons, zur Navigation genutzt haben, müssen Sie dies durch einen eigenen Handler, der nur Ihre Komponenten betrifft, einrichten.

Siehe Zentrale Konfigurationsdatei

Siehe Zentrale Konfigurationsdatei

Für dieses BPC Update ist ein Update des Karaf verpflichtend.

Kunden Themes und eigene BPC Module müssen so angepasst werden, dass der Web-ContextPath und Webapp-Context in der Manifest-Datei zwingend mit einem / beginnen. Um dies zu erreichen, kann in der Regel die Datei build.gradle angepasst werden. Ein Beispiel kann hier eingesehen werden.

In der Konfigurationsdatei [karaf]/etc/org.ops4j.pax.web.cfg wurden Parameter umbenannt:

Ein Update des Karaf wird aus Gründen der Sicherheit dringend empfohlen.

Das BPC läuft nun unter Java 17 und Java 11. Es wird empfohlen zeitnah auf Java 17 umzustellen, da der offizielle Support für Java 11 ausläuft.

We used CXF version 3.5.4 in our previous Karaf releases. This CXF version provides Jackson in version 2.13.4. Now we ship Karaf with CXF 3.5.5, which provides Jackson in the version 2.14.1.

Please update the CXF version (3.5.4 → 3.5.5) in your pom.xml. And more important is to update also the used Jackson version. 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

Die Schriftart wurde von "Lato Light" auf "Lato" geändert. Damit ist die Schrift nicht ganz so fein und wird damit bei einer komprimierten Übertragung (z.B: beim Bildschirm teilen in Meeting-Tools oder Verwendung von RDP) besser dargestellt.

Unter Windows kann man die Darstellung von Schrift weiter verbessern. Siehe dazu https://support.google.com/chrome/answer/95290?hl=de

Damit Kundenthemes ebenfalls diese Änderung übernehmen, müssten diese mit "bpc-theme" >= Version 4.1.0 neu gebaut werden.

Relevant für BPC Modul Entwickler / Important for BPC Developers

This is only necessary, when you use one of the following annotations in your backend modules/bundles:

If this is the case, then please update your resources/OSGI-INF/blueprint/context.xml

and replace

with