Installing Adapters and Plugins Manually

Adapters that are not included as standard, as well as adapters or plugins that you have created yourself, can be installed manually in X4 BPMS.

How to install adapters manually

1. Unzip the adapter's ZIP folder.

2. Copy the adapter folder into the <server_directory>\wildfly\modules\de\softproject\x4\adapter folder.

3. Make sure the <resource-root path="" /> paths in the <resources> element in the module.xml file in the <server_directory>\wildfly\modules\de\softproject\x4\adapter\<name of the adapter>\main folder match the names of the *.jar files.
   Example using the BAM Log adapter:

   1. Names of *.jar files:

      

   2. Contents of the module.xml file:

      

4. Add the name of the adapter to the module.xml file in the <server_directory>\wildfly\modules\de\softproject\plugins\main folder:

   1. Open the module.xml file in the <server_directory>\wildfly\modules\de\softproject\plugins\main folder.

   2. Copy the plugin name into the <dependencies> tag:

      <module name="de.softproject.x4.adapter.<name of the adapter>" export="true"/>

c. Save the module.xml file.

5. Launch Keycloak, the X4 Server, and the X4 Designer.

The adapter can now be selected and used in the X4 Designer.

Note about the subfolders in <Serververzeichnis>\wildfly\modules\en\softproject