X4 Adapter

Adapter

Keycloak Management

Dieser Adapter wurde intern mit sicheren Bibliotheken überarbeitet und als neuer Adapter mit der Bezeichnung Keycloak Management 2 in die X4 Adapterdatenbank aufgenommen. Der alte Adapter Keycloak Management steht weiterhin zur Verfügung, damit Sie die Migration auf den neuen Adapter ausführen können.

Keycloak Token

Dieser Adapter wurde intern mit sicheren Bibliotheken überarbeitet und als neuer Adapter mit der Bezeichnung Keycloak Token 2 in die X4 Adapterdatenbank aufgenommen. Der alte Adapter Keycloak Token steht weiterhin zur Verfügung, damit Sie die Migration auf den neuen Adapter ausführen können.

Migration

So fügen Sie den neuen Adapter hinzu

1. Klicken Sie in Ihrem X4 Projekt mit der rechten Maustaste auf den Ordner Adapters.

2. Wählen Sie New > Adapter aus.

   

3. Suchen Sie im Dialogfenster File Creation Wizard nach dem Adapter Keycloak Management 2.

   

4. Geben Sie im Feld File name einen beliebigen temporären Namen ein.

5. Wählen Sie Finish aus.
   => Der Adapter wird Ihrem X4 Projekt hinzugefügt.

So migrieren Sie die Adapter-Parameter

1. Öffnen Sie in Ihrem Projekt beide Keycloak Management Adapter, und zeigen Sie sie nebeneinander an.

   

2. Übertragen Sie alle Parameter manuell vom alten Adapter auf den neuen Adapter.

3. Speichern Sie die Änderungen. 

4. Klicken Sie im X4 Projekt mit der rechten Maustaste auf den alten Adapter mit der Bezeichnung Keycloak Management.

   

5. Wählen Sie Delete aus.

6. Klicken Sie im X4 Projekt mit der rechten Maustaste auf den neuen Adapter mit dem temporären Namen (Keycloak Management 2).

   

7. Wählen Sie Rename/Refactor aus.
   => Das Dialogfenster X4 Rename Repository Resource Wizard wird geöffnet.

   

8. Benennen Sie den Adapter in den alten Adapternamen um, in diesem Fall Keycloak_Management.fa.

9. Wählen Sie Finish aus.
   => Die Migration ist abgeschlossen.

Google Maps

Der bisherige Google Maps Adapter ist veraltet und basiert intern auf dem HTTP-Adapter.
Für neue Implementierungen wird die Verwendung des Google Maps SDK for Java empfohlen.

Im Zuge der Weiterentwicklung wurde der Adapter überarbeitet und als Version 2.0.0 bereitgestellt.

Änderungen an den Adapter-Parametern

Einige Parameter wurden bereinigt oder angepasst.
Die wichtigsten aktuellen Parameter sind:

• apiKey (erforderlich) – API-Schlüssel zur Authentifizierung gegenüber Google Maps

• privateKey (optional, nur für CreateGoogleURL) – Signierung von URLs

• outputFormat (xml oder json) – Ausgabeformat der API-Antwort

• timeout (Integer) – maximale Zeit für den Verbindungsaufbau in Millisekunden

Änderungen an der Authentifizierung

Die Authentifizierung erfolgt jetzt über:

• API Key

• OAuth 2.0 (falls unterstützt)

Der API-Schlüssel wird im Parameter apiKey hinterlegt.

Verfügbare Adapter-Operationen

Der Adapter stellt folgende Operationen bereit:

• Geocode – Wandelt Adressen in geografische Koordinaten (Längengrad/Breitengrad) um.

• ReverseGeocode – Wandelt Koordinaten in eine lesbare Adresse um.

• GetRoutes – Ersetzt die bisherige Operation GetDirections.
  Berechnet Routen zwischen zwei oder mehreren Standorten unter Berücksichtigung von Verkehr, Fahrmodus usw.

• CreateGoogleURL – Erstellt URLs für Google APIs, z. B. für statische Kartenbilder.
  Optional kann eine Signatur über den Parameter privateKey erzeugt werden.

IBM Websphere MQ Integration

X4 BPMS stellt einen Adapter für die Kommunikation mit IBM Websphere MQ bereit. Aus Lizenzgründen werden die benötigten IBM-JAR-Dateien nicht mitgeliefert.

1. Laden Sie das Artefakt com.ibm.mq.allclient und alle erforderlichen Abhängigkeiten von einem Maven-Repository Ihrer Wahl herunter:

   XML

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

2. Erstellen Sie die Datei module.xml wie folgt:

   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. Legen Sie im WildFly-Ordner modules den Ordner com/ibm/mq/allclient/main an.

4. Kopieren Sie alle heruntergeladenen JAR-Dateien und die erstellte Datei module.xml in dieses Verzeichnis.

5. Öffnen Sie die Datei module.xml im Ordner de/softproject/x4/adapter/ibmMQ/main.

6. Fügen Sie im Abschnitt <dependencies> folgende Zeile hinzu:

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

7. Starten Sie den X4 Server (neu).
   => Der Adapter sollte nun mit Ihrem MQ-Server kommunizieren können.

PDF to PDF/A Converter

Der PDF to PDF/A Converter ist nicht im Standardlieferumfang der X4 BPMS enthalten, sondern muss manuell als externer Adapter installiert werden.

PDF Compression

Der PDF Compression Adapter ist nicht im Standardlieferumfang der X4 BPMS enthalten, sondern muss manuell als externer Adapter installiert werden.