Plugins installieren | X4Documentation

Mit Plugins können Sie die Funktionen der X4 BPMS erweitern. Um ein Plugin zu verwenden, muss die .jar-Datei mit dem Plugin über den WildFly bereitgestellt werden.

Die .zip-Datei senden wir Ihnen auf Anfrage zu. Bitte wenden Sie sich an unseren Support: https://www.softproject.de/de/kundensupport/.

Laden Sie die .zip-Datei mit dem Plugin herunter.
Entpacken Sie die heruntergeladene Datei in den Ordner <Serververzeichnis>\wildfly\modules\softproject\x4\plugins.
Öffnen Sie im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\x4\extensions\main die Datei module.xml.

Fügen Sie in der Datei module.xml folgende Zeile hinzu:

XML

<module name="de.softproject.x4.plugins.<Plugin-Name>" export="true"/>
Beispiele:
<module name="de.softproject.x4.plugins.sql-profiling" export="true"/>
<module name="de.softproject.x4.plugins.globalparameter.sql" export="true"/>

Starten Sie den X4 Server neu.
Nach dem Neustart des X4 Servers steht Ihnen das Plugin zur Verfügung.

Plugins mit einer Oracle-Datenbank verwenden

Wenn Sie ein Plugin mit einer Oracle-Datenbank verwenden möchten, müssen Sie den entsprechenden JDBC-Treiber für die Oracle-Datenbank installieren.

Laden Sie den entsprechenden Treiber unter https://www.oracle.com/database/technologies/appdev/jdbc.html herunter.
Erstellen Sie ein WildFly-Modul für den JDBC-Treiber.
Dazu legen Sie im Verzeichnis X4\Server\wildfly\modules\ zunächst die Verzeichnisstruktur oracle\jdbc\main an.
Entpacken Sie den JDBC-Treiber (z. B. ojdbc.jar) in das oben angelegte Verzeichnis.

Legen Sie die Datei module.xml mit folgendem Inhalt an:

XML

<module xmlns="urn:jboss:module:1.5" name="oracle.jdbc"><!-- Der Namespace urn:jboss:module:1.5 kann sich zwischen den Wildfly Versionen unterscheiden. -->
  <resources>
    <resource-root path="ojdbc.jar"/><!-- Hier den Dateinamen des JDBC Treibers angeben, der verwendet werden soll und sich im Verzeichnis befindet. -->
  </resources>
  <dependencies>
    <module name="javax.api"/>
    <module name="javax.transaction.api"/>
  </dependencies>
</module>

Das Modul oracle.jdbc steht nun zur Verfügung.

Hinterlegen Sie den installierten Treiber in der Datei module.xml im Verzeichnis \wildfly\modules\de\softproject\x4\shared\database\main.
Fügen Sie in der Datei module.xml im Verzeichnis \wildfly\modules\de\softproject\x4\plugins\sql-profiling\main folgenden Eintrag hinzu:
XML
```
<module name="oracle.jdbc" export="true" />
```