Konfiguration

Backend

Lizenz

Um requests4Automation starten zu können, werden die Dateien publicKey.r4a und license.r4a benötigt.

Wichtiger Hinweis: Beim Kopieren der Dateien auf den Server ist darauf zu achten, dass die Dateien nicht beschädigt werden. Einfache Kopiervorgänge per Textkopie funktionieren nicht zuverlässig. Die Dateien sollten vorzugsweise mit Tools wie WinSCP übertragen werden.

Die Dateien können in einem beliebigen Pfad auf dem Server abgelegt werden. Wichtig ist, dass die entsprechenden Pfade in der Konfigurationsdatei application.properties korrekt eingetragen werden. Die relevanten Konfigurationsparameter sind:

license.location publicKey.location

Beispielsweise könnte die Einstellung wie folgt aussehen, wenn die Dateien im Projektverzeichnis liegen:

publicKey.location = ./publicKey.r4a

license.location = ./license.r4a

Es muss sichergestellt sein, dass die Pfade korrekt gesetzt sind, um einen reibungslosen Start der Anwendung zu gewährleisten.

Element Templates

Element Templates dienen dazu, Usern im Web-Modeler und im Automic Workflow Manager Bausteine zum Modellieren zur Verfügung zu stellen. Es handelt sich dabei um json-Dateien, die einem bestimmten Camunda-kompatiblen Format entsprechen müssen. Eine Reihe von Templates für beide Module werden bereits mit der initialen Installation ausgeliefert. Weitere Infos finden sich in der offiziellen Camunda Dokumentation: https://docs.camunda.io/docs/components/modeler/desktop-modeler/element-templates/about-templates/

Einstellungen

Die Konfiguration der Anwendung erfolgt über die application.properties-Datei, welche mehrere Parameter definiert. Diese Parameter steuern verschiedene Aspekte der Anwendung, wie Authentifizierung, API-Interaktionen und WebSocket-Kommunikation. Die Datei befindet sich WEB-INF Verzeichnis der Web-Applikation unter dem Ordner classes.

Parameter der Konfigurationsdatei

Die folgenden Konfigurationsparameter sind definiert und sollten angepasst werden:

  • automic.automicExecutionTopic Definiert das Automic-Execution-Topic, bspw. „AeX“. Dieses Topic wird verwendet, um Automic-Workern ihre Aufgaben zu zuweisen.

  • common.camundaApiUser Der Benutzername für den technischen Nutzer der Camunda-API.

  • common.camundaApiPassword Das zugehörige Passwort für den technischen Camunda-API-Benutzer.

  • debug Aktiviert oder deaktiviert den Debug-Modus der Anwendung.

  • ae-execution.automicUsername Benutzername für die Automic-Ausführungsumgebung.

  • ae-execution.automicPassword Passwort für den Automic-Benutzer.

  • websocket.secret Ein geheimer Schlüssel, der für die WebSocket-Kommunikation verwendet wird.

  • b4aapi.username Benutzername für den Zugriff auf die b4A API.

  • b4aapi.password Passwort für den b4A API-Benutzer. Auch dieses sollte sicher verwaltet werden.

  • b4aapi.urlScheme Definiert das Schema (http oder https), das für die Kommunikation mit der b4A API verwendet wird.

  • b4aapi.serverAddress Die Serveradresse, auf die die b4A API zugreifen soll.

  • b4aapi.port Der Port, der für die Kommunikation mit der b4A API verwendet wird.

  • camundaapi.urlScheme Definiert das Schema für die Camunda API.

  • camundaapi.camundaAddress Die IP-Adresse des Camunda-Servers, auf den zugegriffen wird.

  • camundaapi.camundaPort Der Port, der für die Camunda API verwendet wird.

  • auth.corsUrls Eine Liste von URLs, die in der Cross-Origin Resource Sharing (CORS) Richtlinie erlaubt sind. Diese Richtlinie legt fest, welche externen Quellen auf die Anwendung zugreifen dürfen.

Bei allen Änderungen an Konfigurationen muss der Apache Tomcat® neu gestartet werden, damit die Änderungen herangezogen werden.

Auslagern von Verzeichnissen

Über das Setzen von JAVA_OPTS innerhalb der Start-Routine des Tomcats kann auf eine ausgelagerte Konfugrationsdatei verwiesen werden. Alle hier definierten Werte überschreiben den jeweiligen Parameter in der application.properties Datei, welche sich unterhalb des Webapp-Verzeichnisses befindet.

export JAVA_OPTS="-Dspring.config.location=/pfad/zur/Datei"

Frontend