Developer-Changelog

Die Werte der verschiedenen Optionen in Comboboxen werden nun nicht mehr pauschalt durch ein   ergänzt. Dies erleichtert das automatisierte Testen der Oberflächen.

An Buttons können nun die Klassen arrow-spacing-sm (small) und arrow-spacing-xs (extra small) genutzt werden, um den Abstand des Pfeils zu reduzieren.

Hat ein BPC-Modul eine abweichende Versionierung zum BPC-Core verwendet, so hat sich das project.version Property auf die Abhängigkeiten im BPC-Core ausgewirkt und zu Problemen geführt. Die Abhängigkeiten innerhalb des BPC-Core werden nun nicht mehr durch das project.version Property im Modul beeinflusst.

Forms übersetzt nun für alle Komponenten die Labels korrekt, so auch im state. Dadurch ist es möglich bindings auf labels zu setzen. Siehe Mehrsprachige Inhalte.

setFormState kann nun auch mit Labels in mehreren Sprachen korrekt umgehen. In diesem Rahmen wurde ein Bug behoben, der bei setFormState dazu geführt hat, dass bindings aufgehoben wurde und so im submit nach setFormState ausschließlich Daten vor setFormState drin standen. Zudem können nun alle Komponenten in Kombination mit setFormState verwendet werden, einschließlich Combobox und Tabelle.

Die reset Funktion hat bisher bindings entfernt. Dadurch konnte nach einem reset nicht mehr der aktuelle Stand submitted werden. Dieses Problem wurde behoben.

Die Komponenten Tabelle und Combobox wurden verbessert und Verhalten sich nun wie die anderen Komponenten.

Siehe BPC Modul entwickeln und Modul und Modulinstanz Einstellungen

Die Dokumentation über die Erstellung und Verwendung von Monitor Deeplinks wurde ergänzt. Monitor Deeplink

Überarbeitete Anleitung. Siehe BPC Modul entwickeln

Die User Session kann um customData ergänzt werden, die vom Additional-Info-Endpunkt der Identity Provider Backend Connection kommt.

Siehe auch User Session um zusätzliche Organisationen/Rollen/Rechte und weitere Daten ergänzen

Über die CSS Variable --font-family kann die aktuell gesetzte Schriftart ausgelesen werden.

Mit diesem Update ist erforderlich den Karaf und die Module bpc-be-core, bpc-be-analysis, bpc-be-forms und bpc-be-monitor zu aktualisieren.

Für BPC Modul-Entwickler:innen

In unseren früheren Karaf-Versionen haben wir CXF Version 3.5.4 verwendet. Diese CXF-Version bietet Jackson in der Version 2.14.3. Jetzt liefern wir Karaf mit CXF 3.6.5 aus, die Jackson in der Version 2.17.2 bereitstellt.

Bitte aktualisieren Sie die CXF-Version (3.6.5) in Ihrer pom.xml. Und noch wichtiger ist, dass Sie auch die verwendete Jackson-Version (2.17.2) aktualisieren. Prüfen Sie dazu, ob Sie eine Import-Package-Anweisung für diese Version haben. Diese muss hinzugefügt oder angepasst werden, wenn Sie Jackson-Funktionen wie die Klasse ObjectMapper verwenden.

Replace

with

Module können nun über ihre Hooks Aktualisierungen an die dort geladenen Plugin schicken. Siehe dazu: BPC Plugins entwickeln

Modul-Entwickler:innen müssen darauf achten, im Bundle-SymbolicName keine zusätzlichen Parameter anzugeben.

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

Richtig: de.virtimo.bpc.module-id

Die falsche Variante war in früheren Templates für BPC Module enthalten.

Wenn die HTTP-Header system.id und instance.id gesetzt sind, werden die Werte in ein neues JSON-Objekt externalReference unter den Feldern iguasuSystemId und iguasuInstanceId geschrieben.

Die Browser Funktion 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] steht nun als ExtJS Format Funktion zur Verfügung.

Damit kann diese an verschiedenen Stellen einfach eingesetzt werden, um JSON in Text zu überführen.

Es wird nun ein dedizierter Prefix für die Werte im LocalStorage genutzt. Dadurch werden Inhalte anderer Anwendungen nicht gelöscht.

Siehe Vom BPC bereitgestellte Button-Typen entwickeln

Die HTTP Status Codes bei Antworten an der REST API wurden umfangreicher dokumentiert. Siehe: BPC API

Der Core sucht nun automatisch nach einer Konfiguration für Indices, die angelegt und verwaltet werden soll.

Siehe auch Anlegen von Indices

Pfade in Themes sollten nun immer absolut angegeben werden.

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

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

Siehe auch: BPC Theme entwickeln

Siehe BPC Theme entwickeln

Es wurde ein Endpunkt zum Versenden von Events bereitgestellt Siehe auch: Event API

Es ist nun möglich beim Schreiben von Audit-Informationen Referenzen auf externe Ressourcen anzugeben. So kann zum Beispiel auf die IGUASU-Instanz verwiesen werden, die den Eintrag erzeugt hat.

Für Instanztypen können Labels mittels Language Keys festgelegt werden. Der Language Key setzt sich folgendermaßen zusammen: "<MODULE_ID>_INSTANCE_TYPE_<INSTANCE_TYPE>" Der Language Key für Core-Module setzt sich so zusammen: "CORE_<MODULE_ID>_INSTANCE_TYPE_<INSTANCE_TYPE>" oder beispielsweise: "CORE_BACKENDCONNECTION_INSTANCE_TYPE_HTTP_PROXY": "HTTP Proxy"

In der Dokumentation wurde die Information über die Abhängigkeit zu "theme-triton" für benutzerdefiniertes CSS in benutzerdefinierten Frontend Modulen ergänzt.

BPC Modul entwickeln

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

Siehe auch Anlegen von Indices

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

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 [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.

Am de.virtimo.bpc.module.monitor.api.service.MonitorService ist es nun möglich über isAcccessible(…​) zu prüfen, ob ein Benutzer auf bestimmte Monitorfunktionen zugreifen darf.

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.

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.

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.

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.

Siehe HTML Sanitizing und die Einstellung sanitzeHTML

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 https://bitbucket.org/virtimo/bpc-theme-template/commits/469a13171aa82655b6f0475b38a561d2ebceee52 [https://bitbucket.org/virtimo/bpc-theme-template/commits/469a13171aa82655b6f0475b38a561d2ebceee52][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

 <bean id="bpcJAXRSInvoker" class="de.virtimo.bpc.jaxrs.BpcJAXRSInvoker"/>

with

 <bean id="bpcJAXRSInvoker" class="de.virtimo.bpc.jaxrs.BpcJAXRSInvoker" init-method="onStartup" destroy-method="onShutdown">     <argument ref="blueprintBundleContext"/>  </bean>

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

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.

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

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.

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.

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:

 <!-- BPC-6587 [/browse/BPC-6587] - org.apache.cxf.BusException: No DestinationFactory was found for the namespace http://cxf.apache.org/transports/http [http://cxf.apache.org/transports/http] -→  <!-- It seems that when set it waits for CXF first. -→  <!-- To get rid of the CXF loggings …​ Karaf-Konsole: log:set ERROR org.apache.cxf -→  <cxf:bus>    <cxf:features>      <cxf:logging />    </cxf:features>  </cxf:bus>

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.

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 https://bitbucket.org/virtimo/bpc-theme-template/commits/469a13171aa82655b6f0475b38a561d2ebceee52 [https://bitbucket.org/virtimo/bpc-theme-template/commits/469a13171aa82655b6f0475b38a561d2ebceee52][hier] eingesehen werden.

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

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

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

 <bean id="bpcJAXRSInvoker" class="de.virtimo.bpc.jaxrs.BpcJAXRSInvoker"/>

with

 <bean id="bpcJAXRSInvoker" class="de.virtimo.bpc.jaxrs.BpcJAXRSInvoker" init-method="onStartup" destroy-method="onShutdown">     <argument ref="blueprintBundleContext"/>  </bean>