Release Notes¶
Die Releases zu den Major- und Minor-Releases zeigen die Highlights und inkompatiblen Änderungen auf. Vollständige Listen aller Änderungen sind auf https://docs.best4automic.de zu finden.
Version 5.4.0¶
Highlights¶
Allgemein
Verbesserungen und Korrekturen
Aktualisierung von Bibliotheken
JGit 5.13.2
OpenJFX 19.0.2.1
Spring Boot 2.7.16
Der b4A Server kann jetzt eine globale Verbindung für alle Modulaufrufe nutzen
Erweiterungen der Groovy-Schnittstelle in b4A Expressions
Package Management
Unterstützung für kundenspezifische Compliance Tests
Neues Modul zum Erzeugen von Index-Dokumentationen
Unterstützung von Kalender-Objekten als Laufzeit-Objekten
Unterstützung für einen globalen Package-Index
Unterstützung von XML-Ergebnisvariablen für mehrere Module
Compliance Check
Erweiterung des Tests metadata
Neuer Test zum Prüfen auf Verknüpfungen
Neuer Test zur Überprüfung der Konfigurationsobjekte
RESTful API
Korrekturen und Verbesserungen
Auflösen von Systemvariablen in PromptSet-Vorgabewerten
Unterstützung von Uhrzeit- und Zeitstempeleingabefeldern
Abteilung optional bei der Anmeldung
Optimierung der Service-Überwachung durch Reduzierung der Anfragen an die Automation Engine
Informationen
Neues Modul zum Durchführen von Verwendungssuchen
Massenänderungen
Neues Modul zum Bearbeiten von Privilegien von Benutzergruppen
Inkompatible Änderungen¶
Massenänderungen
mc.UserPrivilegeEdit: Das veraltete Privileg Runbook-Mode wurde entfernt
mc.Delete: Es muss aus Sicherheitsgründen mindestens ein Ordner angegeben werden
Package Management
In der pm.conf gibt es weitere Konfigurationseinstellungen für den neuen globale Package-Index. Bei einem Update müssen diese geprüft bzw- ergänzt werden
Version 5.3.0¶
Highlights¶
Allgemein
Verbesserungen und Korrekturen
Aktualisierung von Bibliotheken
Json Path 2.8.0
Spring Boot 2.7.12
Springdoc OpenAPI 1.7.0
SpringFramework Security Test 5.7.8
SQLite JDBC 3.42.0.0
JSONWebToken 0.11.5
Automic Application Interface 21.0.6
RESTful API
Endpunkte für die Administration des Service Portals
Konfiguration der automatischen Wiederherstellung der b4A Verbindung
Optionale Startzeit für das Starten von Services
Neuer Endpunkt zum Ermitteln des Status zu einer Aufgabe
Neuer Endpunkt zum Setzen des Status ‚inaktiv‘ für Aufgaben
Neuer Endpunkt zum Aufheben einer Blockierung
Senden einer Message im Falle einer fehlgeschlagenen Aktivierung eines Services
Per Scheduler gestartete Services dynamisch in die Liste der Ausführung aufnehmen
Unterstützung von Eingabedateien als Optionswerte, die keine CSV-Dateien sind
Package Management
Unterstützung für XML-Variablen als Laufzeitvariablen
Neuer Compliance-Test zur Überprüfung von Keys in statischen Variablen
Inkompatible Änderungen¶
Framework
Der Name der Option cvs-file wurde korrigiert zu csv-file. Existierende Aufrufe von b4A Modulen mit dieser Option müssen angepasst werden.
Version 5.2.0¶
Highlights¶
Allgemein
Verbesserungen und Korrekturen
Unterstützung von b4A Groovy Distributions
Aktualisierung von Bibliotheken
Groovy 4.0.9
Apache HTTP Client 5.1.4
Spring Boot 2.6.14
Gson 2.8.9
ControlsFX 11.1.2
RESTful API
Es werden Benutzergruppen als Empfänger bei CALL-Objekten unterstützt
In der Service-Konfiguration kann pro Service festgelegt werden, dass alle Ausführungen zurückgegeben werden (auch über Schedule gestartete)
Unterstützung von ForEach- und If-Workflows als Service
Performance-Verbesserungen
Der Endpunkt zum Leeren der Caches setzt nun auch den Authentisierungscache zurück
Package Management
Das Modul pm.DocBuilder kann nun SLO-Objekte dokumentieren und unterstützt zusätzliche PromptSet-Details
Es gibt zwei neue Compliance Tests: SLO-Objekte prüfen und eindeutige Objekttitel prüfen.
Der Compliance Test ‚documentation‘ kann auch die Attribute in einer strukturierten Dokumentation prüfen
Massenänderungen
Es gibt ein Modul zum Bearbeiten von SLO-Objekten
Analyse
Das Modul ana.ReferencesInProcesses unterstützt nun b4A Datenströme
Werkzeuge
Das Modul util.Mail unterstützt CC- und BCC-Empfänger
Das Modul util.Web unterstützt die HTTP-Methode PUT
Inkompatible Änderungen¶
Package Management
pm.DependencyDefinitionVerify: Werden Abhängigkeiten zu einem Package mehrfach angegeben, dann können diese zwar analysiert werden, aber werden in der statischen Variablen nicht angezeigt. Pro Package gibt es jeweils nur eine Zeile. Die vollständigen Details der Auswertung sind ausschließlich in der XML-Variable zu finden.
Version 5.1.0¶
Highlights¶
Allgemein
Verbesserungen und Korrekturen
Aktualisierung von Bibliotheken
OpenJFX 18.0.2
ControlsFX 11.1.1
Groovy 4.0.2
JGit 5.13.1
Automic Application Interface 21.0.4
Spring Boot 2.6.10
Erweiterung der (internen) b4A Groovy Schnittstelle
Verbesserung des Skript-Analyzer: Es werden weitere Referenzen auf Objekte erkannt. Davon profitieren Module aus den Kategorien Analyse und Package Management
Package Management
Beim Modul pm.DocBuilder können jetzt die zu dokumentierenden Objekte mittels Objektnamensmuster und Unterordnern eingeschränkt werden.
Das Modul pm.Init prüft jetzt, ob der angegebene Package-Name gültig ist
Objekte eines Packages müssen nicht mehr unbedingt nach dem Package-Namensschema benannt werden. Dafür gibt es eine Option um die Erkennung der Package-Zugehörigkeit auf Basis des Ordners zu erkennen.
Der Compliance-Test agent erkennt jetzt alle Agententypen
Test Automation
Erweiterung der Dokumentation für Testschritte um Beispiele
Neuer Test-Schritt um Meldungen zu durchsuchen
Inkompatible Änderungen¶
Analyse
Die Parameter des Moduls ana.Compare haben sich geändert. Um das alte Verhalten wieder zu bekommen muss zusätzlich die Option input-mode auf den Wert file gesetzt werden.
Test Automation
Das Modul ta.Execute kann die Testergebnisse in eine XML-Variable und in die strukturierte Dokumentation eines Objektes schreiben. Wird jetzt eine XML-Variable angegeben und es soll gleichzeitig in die strukturierte DOkumentation eines Objektes geschrieben werden, dann muss dies explizit angegeben werden. Dies gilt, wenn die Quelle für die Testspezifikation ein Dokumentation-Objekt ist.
Git Integration
Der Kurzbezeichner n für die Option package wurde entfernt, da dieser nicht dem Standard aller anderen Package Management Module entspricht
Version 5.0.0¶
Highlights¶
Allgemein
Die Funktion XML2ATTR aus den b4A Expressions unterstützt jetzt eine Option PREFIX um die erzeugten Attribute unterhalb dieser Präfix anzuordnen
Korrekturen und Verbesserungen
Package Management
Der Test ‚task-alias‘ des Moduls pm.Compliance kann als weiteren Filter zum Objekttyp auch auf benutzerdefinierte Attribute an den Aufgaben prüfen
Die Beispielvorlagen im BPMN-Format für den Documentation Builder wurden verbessert
Werkzeuge
Das Modul util.Web unterstützt zusätzlich die HTTP Methode PUT und die Kodierung des Nachrichtenrumpf kann mehr Option gesetzt werden
Die Beispielvorlage für das Versenden von Testberichten für das Modul util.Mail wurde verbessert
RESTful API
Die Gruppe rest.auth.groups.execute wurde durch rest.auth.groups.module abgelöst. Diese Gruppe ist nicht mehr für die Delete-Anfragen berechtigt.
Die Gruppe rest.auth.groups.read wurde durch rest.auth.groups.info abgelöst.
Die Konfigurationen rest.auth.connection und rest.service.connection wurden in ersterem zusammengefasst.
Der Endpunkt /connections gibt nun nicht direkt eine Liste von Verbindungen zurück, sondern ein JSON-Objekt, welches die Liste der Verbindungen enthält.
Die Möglichkeit, die RESTful API ohne Authentisierung zu nutzen wurde entfernt.
Aufgrund von strukturellen Änderungen in der Datenbank ist es bei einem Update von v1 auf v2 notwendig die Datenbank zu löschen. Beim Start der b4A RESTful API wird sie neu angelegt.
Git Integration
Das Modul vcs.Pull fragt nicht mehr nach, wenn es laufende Aufgaben findet, sondern bricht direkt ab, wenn die Option force nicht gesetzt ist.
Werkzeuge
Der Vorgabewert für die Option variable vom Modul util.ConnectionsSaveTo wurde auf B4A.BASE.VARA.CONNECTIONS geändert
Der Vorgabewert für die Option variable vom Modul util.ModulesSaveTo wurde auf B4A.BASE.VARA.MODULES geändert
Inkompatible Änderungen¶
Allgemein
Die 5. Generation von best4Automic kann nicht für ältere Versionen der Automic Automation als Version 21 eingesetzt werden
Version 4.9.0¶
Highlights¶
## Highlights
Allgemein
Verbesserungen und Korrekturen
RESTful API
Die Version v2 wurde zurückportiert. Somit kann das b4A Service Portal nun mit der Automic Automation 12.3 genutzt werden
Es werden Benutzergruppen als Empfänger bei CALL-Objekten unterstützt (put_att)
In der Service-Konfiguration kann pro Service festgelegt werden, dass alle Ausführungen zurückgegeben werden (auch über Schedule gestartete)
Unterstützung von ForEach- und If-Workflows als Service
Performance-Verbesserungen
Package Management
Das Modul pm.DocBuilder kann nun SLO-Objekte dokumentieren
Es gibt zwei neue Compliance Tests: SLO-Objekte prüfen und eindeutige Objekttitel prüfen.
Der Compliance Test ‚documentation‘ kann auch die Attribute in einer strukturierten Dokumentation prüfen
Massenänderungen
Es gibt ein Modul zum Bearbeiten von SLO-Objekten
Werkzeuge
Das Modul util.Mail unterstützt CC und BCC Empfänger
Das Modul util.Web unterstützt die HTTP-Methode PUT
Version 4.8.0¶
Highlights¶
Allgemein
Verbesserungen und Korrekturen
Aktualisierung von Bibliotheken
OpenJFX 18.0.1
ControlsFX 11.1.1
Groovy 4.0.2
Automic Application Interface 12.3.9
Erweiterung der (internen) b4A Groovy Schnittstelle
Verbesserung des Skript-Analyzer: Es werden weitere Referenzen auf Objekte erkannt. Davon profitieren Module aus den Kategorien Analyse und Package Management
Dokumentation
Für jeden Testschritt wurden mehrere Beispiele ergänzt
Analyse
Das Modul ana.Compare unterstützt jetzt nicht nur b4A Objektlisten, sondern auch alle anderen Objektsuchmethoden aus dem b4A Framework
Package Management
Das Modul pm.StorageCredentialAdd unterstützt jetzt Benutzernamen, die aus weniger als 3 Zeichen bestehen
Beim Modul pm.DocBuilder können jetzt die zu dokumentierenden Objekte mittels Objektnamesmuster und Unterordnern eingeschränkt werden.
Test Automation
Ein neuer Schritt für die Then-Phase wurde ergänzt mit dem die globalen Meldungen nach Nummern und Textmustern durchsucht werden können
Inkompatible Änderungen¶
Analyse
Die Parameter des Moduls ana.Compare haben sich geändert. Um das alte Verhalten wieder zu bekommen muss zusätzlich die Option input-mode auf den Wert file gesetzt werden.
Test Automation
Das Modul ta.Execute kann das Testergebnisse in eine XML-Variable und in die strukturierte Dokumentation eines Objektes schreiben. Wird jetzt eine XML-Variable angegeben und es soll gleichzeitig in die strukturierte DOkumentation eines Objektes geschrieben werden, dann muss dieses explizit angegeben werden. Dies gilt, wenn die Quelle für die Testspezifikation ein Dokumentation-Objekt ist.
Version 4.7.0¶
Highlights¶
Allgemein
Verbesserungen und Korrekturen
Test Automation
Eine neue Option erlaubt es Szenarien aus einem Feature von der Durchführung auszuschließen
Version 4.6.0¶
Highlights¶
Allgemein
Verbesserungen und Korrekturen
Package Management
Objekte eines Package müssen nicht mehr mit dem Package-Namen anfangen. Dieser kann irgendwo im Objektnamen enthalten sein.
Werkzeuge
Das Modul util.Mail kann jetzt auch Mail über Verbindungen ohne Verschlüsselung senden
Neues Modul util.Web zum Versenden von HTTP(S) POST Requests mit Token Authentisierung- Das Token kann in verschlüsselter Form übergeben werden.
Inkompatible Änderungen¶
Package Management
Die Einstellung pm-packagename-regex aus der Konfigurationsdatei pm.conf wurde durch die zwei Einstellungen pm-package-name-regex und pm-object-name-regex ersetzt. Die Details dazu sind dem Kapitel Package Management zu entnehmen.
Version 4.5.0¶
Highlights¶
Allgemein
Es gibt neue Symbole für die Modul-Kategorien
Das Automic Application Interface wurde auf Version 12.3.5 aktualisiert
best4Automic wird jetzt als Core Edition und als Rest Edition veröffentlicht
Die Core Edition entspricht dem zuvor bekannten Release Format
Die Rest Edition enthält die neue RESTful API der best4Automic Solution
b4A Expressions wurden um neue Funktionen zum Einbindung von XML-Datenstrukturen und Groovy-Skripten erweitert
Das temporäre Verzeichnis, welches von verschiedenen Modulen genutzt wird, kann jetzt per Java System-Eigenschaft festgelegt werden
Dokumentation
Beschreibungen der neuen Bundles und Lizenztypen wurde in der Dokumentation ergänzt
b4A Expressions, Scripte und Datenströme wurden in eigene Kapitel ausgelagert
Massenänderungen
Das Modul mc.ObjectVariableEdit besitzt jetzt eine neue Funktion zum Setzen von Werten
Werkzeuge
Das neue Modul util.Mail verschickt Mails und kann dabei SSL und TLS Verschlüsselung nutzen. Der Inhalt wird aus drei Vorlagen zusammengesetzt, die b4A Expressions nutzen können. An die Mail können beliebig viele Dateien angehängt werden oder auch die Reports zu einer RunId.
Test Automation
Der Schritt then-variable-contains kann nun optional in einer anderen Verbindung die Variable überprüfen
Package Management
Documentation Builder
Neue Vorlagen im BPMNv2-Format
Unterstützung für die neue b4A Expressions Funktion XML2ATTR
Der Titel der Objekten steht jetzt für die Index-Vorlage zur Verfügung
Neue Option zum Setzen von benutzerdefinierten Attributen direkt per Optionswert
Bei If- und ForEach-Workflows steht ein neues Attribute zur Verfügung, das alle Aufgaben enthält
Das Modul pm.Install markiert Agentengruppen nun nach einem separaten Schema
Das Modul pm.RequiredBy kann jetzt den Package-Index nutzen falls dieser verfügbar ist
Bei den Modulen pm.Install und pm.Build können optional weitere Metadaten übergeben werden, die in der Metadaten-Variable des Package ergänzt werden
Git Integration
Modul vcs.Diff
Es können nun auch ein Zweig oder eine Marke mit der Version in einem Mandant der Automation Engine verglichen werden
Das Ergebnis kann in einer XML-Variable ausgegeben werden
Inkompatible Änderungen¶
Modul pm.DocBuilder
Die Option custom-attributes ist umbenannt in custom-attributes-file. Die Option custom-attributes gibt es weiterhin, aber bekommt keine Datei sondern die Liste der benutzerdefinierten Attribute übergeben
Version 4.4.0¶
Highlights¶
Allgemein
Die grafische Benutzungsoberfläche wurde überarbeitet und an das Corporate Design von best-blu consulting with energy GmbH angepasst
Erweiterungen der Dokumentation: Bei vielen Modulen wurde die Beschreibung der Formate von Ausgabedateien ergänzt
Information
Das Modul info.VersionManagement hat jetzt eine Ausgabe in eine XML-Variable, die sich an einem Standard für b4A Module orientiert
Das Modul info.UserRead gibt jetzt als weitere Spalte den Titel des Benutzer-Objektes mit aus
Massenänderungen
Neues Modul zum Bearbeiten der Optionen zur maximalen Laufzeit von Objekten wurde hinzugefügt
Werkzeuge
Das Modul util.PasswordCrypt kann das entschlüsselte Passwort jetzt auch im Bericht ausgeben, wenn eine entsprechende Option gesetzt ist
Test Automation
Bei Test-Schritten, die im Satz einen Objektnamen enthalten, können jetzt auch Agenten- und Benutzer-Objekte angegeben werden
Package Management
Mehrere Module wurden an Standards angepasst, der durch die anderen Module bereits eingehalten werden
Die Erkennung von Fehlern bei der Verarbeitung, sowie die Protokollierung dieser, wurde verbessert
Der Package-Index kann jetzt zusätzlich auch einen Eintrag aller gültigen Basisordner für Packages enthalten
Die Module pm.ReportInstallation und pm.ReportModifications haben jetzt eine Ausgabe in eine XML-Variable, die sich an einem Standard für b4A Module orientiert
Die SVG-Vorlage für den Documentation Builder wurde um verbesserte Verbindungsstriche zwischen den Aufgaben und Symbole, die den Typ der Aufgabe darstellen, erweitert
Eine neue Vorlage für den Documentation Builder im Format BPMNv2 wurde hinzugefügt
Inkompatible Änderungen¶
Das Format der Ausgabe in eine XML-Variable hat sich für das Modul pm.ReportInstallation geändert. Diese wurde auf den neuen Standard angepasst
Die Option gui-connections aus der defaults.conf wurde entfernt
Das Modul info.UserRead enthält jetzt am Ende eine weitere Spalte mit dem Titel des Benutzer-Objektes
Das Modul pm.ImportBPMN benötigt jetzt ein bereits existierendes gültiges Package
Beim Modul pm.ImportBPMN wurde die Option ‚base-folder‘ entfernt
Das Modul pm.Build gibt jetzt einen Exit-Code 2 anstatt 99 zurück, wenn das Package nicht gefunden wurde oder ungültig ist
Version 4.3.0¶
Highlights¶
Allgemein
Verbesserungen in b4A Setup
Erweiterung der Dokumentation um Beschreibungen der CSV-Dateien bei vielen Modulen
der b4A Server erlaubt das Starten von Modulen über einen zentralen Java-Prozess
Classic Module
Neues Modul zum Löschen von Objekten
mc.WorkflowTaskAdd: Neue Option um den Zweig bei IF-Workflows anzugeben
Verbesserungen und Korrekturen
Test Automation
Diverse Verbesserungen und Korrekturen des Test-Schritts given-workflow
Aktualisierung der Test-Szenarien in den Beispielen und der Dokumentation
Package Management
Ein neuer flexibler Compliance-Check speziell für Packages mit 8 Compliance-Test, die alle konfigurierbar sind
b4A Documentation Builder
Neue Vorlagen für Markdown
Verbesserung der HTML-Vorlagen
Neue Option um den Namen der Index-Datei festzulegen
Version 4.2.0¶
Highlights¶
Allgemein
Die Dokumentation wurde überarbeitet und neu strukturiert. Zusätzlich wurde die Suchfunktion verbessert.
Korrekturen und Verbesserungen
Classic Module
util.Activate kann jetzt einen Alias setzen für die Ausführung.
te.WorkflowMonitorEdit bietet zwei neue Funktionen um Aufgaben sofort zu starten.
Test Automation
Ein neuer Test-Schritt wurde hinzugefügt um die XML-Exporte von Objekten durchsuchen zu können.
ta.Execute können zusätzliche benutzerdefinierte Attribute übergeben werden, die in den Vorlagen genutzt werden können.
pm.DependencyDefinitionCreate hat einen neuen Modus um existierenden Abhängigkeitsdefinitionen zu erweitern.
pm.Install bietet jetzt die Möglichkeit Connection-Objekte zu überschreiben auch wenn sie bereits existieren.
Package Management
Der neue Package-Index kann optional genutzt werden um sämtliche Metadaten aller installierten Packages in einer XML-Variable zu speichern.
Verbesserungen in der Fehlerbehandlung
Abhängigkeitsdefinitionen können jetzt nicht nur durch Semikolon sondern auch durch Komma getrennt werden.
pm.Init kann jetzt optional ein Package-Titel übergeben werden, der als Titel des Package-Ordner gesetzt wird.
Inkompatible Änderungen¶
Lizenz
Ab der Version 4.2.0 wird eine Lizenz für die Nutzung von best4Automic benötigt. Diese kann vom best4Automic Vertrieb bezogen werden.
Version 4.1.0¶
Highlights¶
Allgemein
Aktualisierung des Automic Application Interface auf Version 12.3.2
Test Automation
Der Test-Schritt then-check-report kann jetzt auch die Reports von Workflows lesen, die mit FAULT_OTHER beendet wurden
In allen Test-Schritten, die Tabellen unterstützen, können jetzt b4A Expressions genutzt werden
Mit einem neuen Test-Schritt (when-create-temp-file) können jetzt temporäre Dateien erzeugt werden deren Inhalt in einer Tabelle definiert wird.
Für alle Test-Schritte stehen jetzt eine Reihe von vordefinierten b4A Expression Attributen zur Verfügung. Darunter befindet sich die aktuell genutzte b4A Verbindung
weitere kleine Verbesserungen
Package Management
Die b4A Module zum Auflisten der Zweige und Marken können jetzt mit einer Option die Liste filtern
Der DocBuilder besitzt jetzt eine weitere Option um die Zeichenkodierung der Ausgabe festzulegen
Version 4.0.0¶
Highlights¶
Allgemein
Java wurde auf die Version 11 und höher aktualisiert. Es werden sowohl Oracle Java als auch OpenJDK unterstützt.
Ab dieser Version muss die Automic Automation® mindestens in Version 12.3 installiert sein.
Zum Starten von b4A Modulen unter Windows steht jetzt auch ein Powershell-Skript zur Verfügung
Korrekturen und Verbesserungen
Package Management
pm.Install: Die Behandlung von Connection- und Login-Objekten während der Installation wurde so angepasst, dass existierende Objekte dieser Typen nur angepasst werden, wenn Zugangsdaten zur Verfügung stehen.
b4A Packages
PCK.BEST4AUTOMIC_BASE
Umstellung auf den neuen Startmechanismus für b4A Module
Inkompatible Änderungen¶
Framework
Java muss mindestens in der Version 11 installiert sein. Ältere Versionen werden nicht mehr unterstützt
Die Einstellungen java.executable.unix und java.executable.windows werden nicht mehr unterstützt
Die Konfigurationsdatei Dashboard.conf wurde umbenannt in modules.conf und inhaltlich verändert.
Massenänderungen
mc.Rename: Das Modul benennt nun auch Ordner um. Ist dies nicht gewünscht, so muss der Objekttyp Ordner explizit ausgeschlossen werden
b4A Packages
Ausschließlich das b4A Package PCK.BEST4AUTOMIC_BASE wird noch mit dem Release ausgeliefert (separate Datei).
Die Einstellungen JAVA_BINARY und JAVA_OPTIONS aus der Variable PCK.BEST4AUTOMIC_BASE.VARA.SETTINGS sind veraltet und werden nicht mehr genutzt
Die Einstellung START_SCRIPT in der Variable PCK.BEST4AUTOMIC_BASE.VARA.SETTINGS ist neu und muss gesetzt werden
Distribution
Das Basisverzeichnis enthält jetzt den Namen der Betriebssystemfamilie (bspw. best4automic-4.0.0-unix oder best4automic-4.0.0-win)