b4A Packages¶
Mit best4Automic werden Objekte für die Automation Engine ausgeliefert. Die Objekte werden in sogenannten b4A Packages organisiert. Sie dienen der Steuerung von b4A Modulen aus der Automation Engine heraus und bieten hilfreiche Objekte, die den Umgang mit best4Automic in der Automation erleichtern.
Das Format der b4A Packages ähnelt dem Format des Automic Package Managers. An dieser Stelle wird auf das Kapitel Package Management im Benutzerhandbuch verwiesen.
Die nachfolgende Auflistung beschreibt die standardmäßige Ordnerstruktur eines b4A Packages:
Ordner |
Beschreibung |
|---|---|
ACTIONS |
Dieser Ordner enthält generische Objekte, die an verschiedenen Stellen eingebunden werden können. |
CONFIG |
Dieser Ordner enthält die Konfigurationsvariablen, die für den Betrieb des b4A Package notwendig sind und angepasst werden können. |
DOCUMENTATION |
Dieser Ordner enthält allgemeine Dokumentation und die Release Notes des b4A Package. |
SERVICES |
Dieser Ordner enthält vorbereitetete und ausführbare Objekte die Konfigurationen erleichtern oder Funktionen bereitstellen. |
SOURCE |
Dieser Ordner enthält alle Objekte, die bei den Actions und Services verwendet werden. |
Installation¶
Bevor die Automation Engine-Objekte von best4Automic verwendet werden können müssen diese zuvor in einem Mandanten installiert werden. Dafür enthält best4Automic ein Modul pm.Install (siehe Package: Installieren). Zur Installation stehen folgende b4A Package zur Verfügung:
BBC.SHARED : Dieses b4A Package stellt Basisobjekte zur Verfügung. Darunter sind SQLI-Variablen und Include-Objekte, die als Hilfsmittel mehreren anderen b4A Packages genutzt werden.
B4A.BASE : Dieses b4A Package beinhaltet Actions zur Integration von best4Automic in die Automationsprozesse.
B4A.PM : Enthält Beispielprozesse für ein Deploymentverfahren basierend auf dem b4A Package Management
B4A.WEB : Enthält Actions, die für die Integration des b4A Service Portal genutzt werden können
Zur Installation der b4A Packages kann folgender Befehl verwendet werden:
UNIX:
./b4A pm.Install -C <Verbindung> --zip-file ../packages/B4A.BASE.zip
Windows:
./b4A.bat pm.Install -C <Verbindung> --zip-file ../packages/B4A.BASE.zip
Um die Installation im grafischen Modus durchzuführen kann die Option -X zum Aufruf hinzugefügt werden.
Nach der erfolgreichen Installation befinden sich die Objekte der b4A Packages unterhalb des Ordners PACKAGES. Bevor die Workflows der b4A Packages genutzt werden können müssen einige Konfigurationen durchgeführt werden, die im Folgenden beschrieben werden. Da es sich um Beispiele handelt kann es ebenfalls notwendig sein Anpassungen der Objekte durchzuführen, um diese an die Umgebung anzupassen.
Dokumentation¶
Eine detaillierte Beschreibung der Funktionen, die die einzelnen b4A Package bereitstellen, ist unter https://docs.best4automic.de/packages zu finden.