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.