Allgemein

Custom Compliance Tests sind Erweiterungen für das b4A Modul pm.Compliance. Sie können genutzt werden, um spezielle, direkt auf die Kundenumgebung abgestimmte, Compliance Tests zu implementieren.

Ausgeliefert werden die Custom Compliance Tests in Form eines ZIP-Archivs, das in dem Unterverzeichnis custom/compliance ausgepackt werden muss. Existiert diese Ordnerstruktur noch nicht, so muss diese zuvor angelegt werden. In dem ZIP-Archiv können sich mehrere Compliance Tests enthalten sein.

Das ZIP-Archiv enthält einen Ordner, der aus einem Namen und einer Versionsnummer besteht, die durch einen Bindestrich getrennt sind. In dem Ordner befinden sich die Implementierungen der Compliance Tests sowie Dateien, die Übersetzungen enthalten. Im Unterordner doc findet sich die Dokumentation zu den enthaltenen Compliance Tests.

Installation

  • In das Basisverzeichnis der b4A-Installation wechseln
  • den Verzeichnis Baum custom/compliance anlegen, wenn dieser noch nicht existiert
  • Entpacken des ZIP-Archivs <name>-<Version>.zip in das Verzeichnis custom/compliance.

Verwendung

Ist das ZIP-Archiv der Custom Compliance Tests richtig installiert, so können die enthaltenen Tests direkt genutzt werden. In der Dokumentation ist zu prüfen, ob gegebenenfalls eine Konfiguration in der Datei compliance.json im Konfigurationsverzeichnis der b4A-Installation notwendig ist.

Projekte

Folgend eine kleine Auswahl an Custom Compliance Tests, die bereits umgesetzt worden sind.

Länge von Keys in statischen Variablen
Der Compliance Tests stellt sicher, dass kein Key länger als 31 Zeichen ist. In der Kundenumgebung werden statische Variablen häufig zusammen mit der AE-Script-Funktion GENERATE_SCRIPT_VARS genutzt. Daher dürfen die Keys nicht länger sein.

Seit b4A Version 5.4.0 ist ein solcher Test in erweiterter Form Teil des Produktes.

Erweiterte Objektnamenprüfung
best4Automic enthält bereits einen Test, der die Objektnamen eines Package überprüft. In einer Kundenumgebungen existieren Sonderregeln für einige Packages und spezielle Regeln für Objektnamen, die auf Basis von einem regulären Ausdruck nicht abgebildet werden können. Diese Sonderregeln wurden in diesem Test umgesetzt, so dass auch diese durch b4A überprüft werden können.
Prüfung auf einfache Rekursion
Der Test stellt sicher, dass ein Workflow im Package sich nicht selbst als Aufgabe enthält. Hiermit sollen unabsichtliche und gegebenenfalls unnötige Rekursionen vermieden werden.