Ein- und Ausgabe
Der Framework von best4Automic stellt mehrere Techniken bereit, die von den Modulen genutzt werden können. In diesem Kapitel soll es um Techniken gehen, die für komplexere Eingabe- oder Ausgabedaten genutzt werden können. Welches Modul eine dieser Techniken unterstützt ist der jeweiligen Dokumentation zum Modul zu finden.
best4Automic Script
Bei best4Automic Script geht es nicht um eine Skriptsprache in dem eigentlichen Sinne. Vielmehr handelt es sich hier um eine generische Syntax für verschiedene Module, die ein Set von Kommandos unterstützen, die sie entweder aus einem Variable-Objekt oder einer Datei lesen. Dabei kann zu jedem Aufruf das Ergebnis gespeichert werden.
Die Script-Dateien enthalten pro Zeile einen Kommandoaufruf, welcher aus dem Namen einer Funktion und einer Liste von Parametern besteht. Das Format ist wie folgt definiert.
<name>(<arg1>,<arg2>,...)
Nachdem das Modul die Kommandos ausgeführt hat werden die Rückgabewerte in die Datei geschrieben. Anschließend sind die Zeilen wie folgt aufgebaut.
<name>(<arg1>,<arg2>,...) = (OK|FAILED|SKIPPED|NOT_EXECUTED)
Stehen die Kommandos in einem Variable-Objekt, dann werden die Kommandos wie folgt in der VARA eingetragen.
Key |
Wert 1 |
Wert 2 |
Wert 3 |
Wert 4 |
Wert 5 |
|---|---|---|---|---|---|
<no> |
<name> |
arg1,arg2,… |
Nach der Verarbeitung der Kommandos stehen die Rückgabewerte im Wert 3
Key |
Wert 1 |
Wert 2 |
Wert 3 |
Wert 4 |
Wert 5 |
|---|---|---|---|---|---|
<no> |
<name> |
arg1,arg2,… |
OK|FAILED|SKIPPED|NOT_EXECUTED |
best4Automic Datenströme
Ein häufiger Anwendungsfall ist die Verwendung von b4A-Modulen um Daten in der Automation Engine zur Verfügung zustellen, die dann beispielsweise in Automation Engine-Script weiterverarbeitet werden. Hierfür werden die Daten beispielsweise in statische Variablen oder in die strukturierte Dokumentation von Objekten geschrieben. In anderen Fällen erzeugen die b4A-Module CSV-Dateien, die dann beispielsweise mit prep_process_file weiterverarbeitet werden.
Mit den b4A-Datenströmen wird ein weiterer Mechanismus bereitgestellt der es ermöglicht Daten auf eine weitere Art in die Automation Engine zurückzubringen. Die Technik ermöglicht es b4A-Module als Backend für EXEC-Variablen zu nutzen. Dabei erzeugen die Module ein besonderes Format im Bericht, dass in der Automation Engine leicht weiterverarbeitet werden kann.
Um den Datenstrom bei den Modulen zu aktivieren wird das Log-Level DATASTREAM genutzt. Module, die dies unterstützen, erzeugen im Bericht zusätzliche Zeilen, die ein bestimmtes Format haben. Im Folgenden ein Beispiel des Moduls info.Search.
@B4A_STREAM@Objektname§§Ordner
@B4A_STREAM@PCK.BEST4AUTOMIC_BASE.DOCU.@TESTS@§§0010/PACKAGES/PCK.BEST4AUTOMIC_BASE/TEST
@B4A_STREAM@PCK.BEST4AUTOMIC_BPMN.DOCU.@TESTS@§§0010/PACKAGES/PCK.BEST4AUTOMIC_BPMN/TEST
@B4A_STREAM@PCK.BEST4AUTOMIC_INSTALL.DOCU.@TESTS@§§0010/PACKAGES/PCK.BEST4AUTOMIC_INSTALL/TEST
@B4A_STREAM@PCK.BEST4AUTOMIC_PACKAGE.DOCU.@TESTS@§§0010/PACKAGES/PCK.BEST4AUTOMIC_PACKAGE/TEST
@B4A_STREAM@PCK.BEST4AUTOMIC_TA.DOCU.@TESTS@§§0010/PACKAGES/PCK.BEST4AUTOMIC_TA/TEST
@B4A_STREAM@PCK.BEST4AUTOMIC_USER.DOCU.@TESTS@§§0010/PACKAGES/PCK.BEST4AUTOMIC_USER/TEST
@B4A_STREAM@PCK.BEST4AUTOMIC_VCS.DOCU.@TESTS@§§0010/PACKAGES/PCK.BEST4AUTOMIC_VCS/TEST
@B4A_STREAM@B4A.TRAINING.TEST1.DOCU.@TESTS@§§0010/TESTS/B4A.TRAINING.TEST1/CONFIG
Der Anfang jeder Zeile (im Beispiel der Vorgabewert @B4A_STREAM@) kann über die Option log-datastream-prefix geändert werden. Die als Trennzeichen genutzte Zeichenkette kann über die Option log-datastream-separator festgelegt werden.