X4 Adapter

Adapter

Keycloak Management

This adapter has been revised internally with secure libraries and has been added to the X4 adapter database as a new adapter called Keycloak Management 2. The old Keycloak Management adapter is still available so that you can migrate to the new adapter.

Keycloak Token

This adapter has been revised internally with secure libraries and has been added to the X4 adapter database as a new adapter called Keycloak Token 2. The old Keycloak Token adapter is still available so that you can migrate to the new adapter.

Migration

How to add the new adapter

1. In your X4 project, right-click the Adapters folder.

2. Select New > Adapter.

   

3. In the File Creation Wizard dialog, locate the Keycloak Management 2 adapter.

   

4. In the File name field, enter any temporary name.

5. Select Finish.
   => The adapter will be added to your X4 project.

How to migrate the adapter parameters

1. In your project, open both Keycloak Management Adapters and view them side by side.

   

2. Manually transfer all parameters from the old adapter to the new adapter.

3. Save your changes.

4. In the X4 project, right-click the old adapter named Keycoak Management.

   

5. Select Delete.

6. In the X4 project, right-click the new adapter with the temporary name (Keycloak Management 2).

   

7. Select Rename/Refactor.
   => The X4 Rename Repository Resource Wizard dialog opens.

   

8. Rename the adapter to the old adapter name, in this case Keycloak_Management.fa.

9. Select Finish.
   => The migration is complete.

Google Maps

The previous Google Maps adapter is outdated and is internally based on the HTTP adapter.
For new implementations, it is recommended to use the Google Maps SDK for Java.

As part of the development, the adapter has been revised and released as Vversion 2.0.0.

Changes to adapter parameters

Some parameters have been cleaned or adjusted.
The most important current parameters are:

• apiKey (mandatory) – API key used to authenticate to Google Maps

• privateKey (optional, for CreateGoogleURL only) – key used to sign URLs

• outputFormat (xml or json) – the output format of the API response

• timeout (Integer) – maximum time to establish a connection in milliseconds

Changes to authentication

Authentication is now performed via:

• API Key

• OAuth 2.0 (if supported)

The API key is stored in the apiKey parameter.

Available adapter operations

The adapter provides the following operations:

• Geocode — converts addresses to geographic coordinates (longitude/latitude).

• ReverseGeocode — converts coordinates to a readable address.

• GetRoutes — replaces the previous GetDirections operation.
  Calculates routes between two or more locations, taking into account traffic, driving mode, etc.

• CreateGoogleURL — xreates URLs for Google APIs, for example, for static map images.
  Optionally, a signature can be generated using the privateKey parameter.

IBM Websphere MQ Integration

X4 BPMS provides an adapter for communicating with IBM Websphere MQ. For licensing reasons, the required IBM JAR files are not included.

1. Download the com.IBM.mq.allclient artifact and all required dependencies from a Maven repository of your choice:

   XML

   <dependency>
       <groupId>com.ibm.mq</groupId>
       <artifactId>com.ibm.mq.allclient</artifactId>
       <version>9.4.4.1</version>
       <scope>compile</scope>
   </dependency>
   

2. Create the module.xml file as follows:

   XML

   <module xmlns="urn:jboss:module:1.1" name="com.ibm.wmq.allclient">
       <resources>
           <resource-root path="com.ibm.mq.allclient-9.4.1.0.jar"/>
           <!-- weitere JARs hier einfügen -->
       </resources>
       <dependencies>
           <module name="javax.api"/>
           <module name="javax.transaction.api"/>
           <module name="javax.xml.bind.api"/>
           <module name="javax.resource.api"/>
       </dependencies>
   </module>
   

3. In the WildFly modules folder, create the com/ibm/mq/allclient/main folder.

4. Copy all downloaded JAR files and the created module.xml file to this directory.

5. Open the module.xml file in the de/softproject/x4/adapter/ibmMQ/main folder.

6. Add the following line to the <dependencies> section:

   <module name="com.ibm.wmq.allclient"/>
   

7. (Re-)Start the X4 Server.
   => The adapter should now be able to communicate with your MQ server.

PDF to PDF/A Converter

The PDF to PDF/A Converter is not included in the standard X4 BPMS package, but must be installed manually as an external adapter.

PDF Compression

The PDF Compression Adapter is not included in the standard X4 BPMS package, but must be installed manually as an external adapter.