X4 Adapter

Ausgabe einer Warnung anstelle eines Fehlers, wenn obligatorische Parameter für einen Adapter nicht gesetzt sind

Wenn obligatorische Parameter in einem Adapter fehlen, wird in der Sicht Problems eine Warnung anstelle eines Fehlers ausgegeben.

FTP Connector – Prüfung, ob herunterzuladende Datei vorhanden ist

Der FTP Connector prüft jetzt, ob die herunterzuladende Datei auf dem Server vorhanden ist. Wenn das nicht der Fall ist, wird eine Fehlermeldung ausgegeben.

Die neue Operation Exists mit dem Parameter path wurde zum Adapter hinzugefügt.

Eigenschaften (Properties)

Operation

Exists:
Prüft, ob die im Parameter path angegebenen Dateien oder Ordner vorhanden sind. Gibt eine XML-Datei mit Metadaten als Ergebnis aus.

Parameter

path	Pfad zu einem Ordner oder einer Datei auf dem FTP(S)/SFT-Server. Mögliche Werte: § Beliebige Zeichenkette (z. B. /Folder/Subfolder oder /Folder/Subfolder/File.xml)

FTP Connector (Advanced) – Übergabe aller Dateien aus lokalem Ordner an FTP-Server

Bei Verwendung des FTP Connector können mehrere in einem lokalen Ordner gespeicherte Dateien im Sende- und Empfangsmodus jetzt automatisch an den FTP-Server übertragen werden.

Für die Übertragung aller Dateien aus dem im Parameter localPath definierten Ordner an den im Parameter remotePath definierten Ordner:

Parameter multipleFiles setzen.
Parameter documentname auf NULL setzen.

Loop Adapter – Angabe der Anzahl der Schleifendurchläufe in einem Prozess

Anwender können jetzt den Parameter count setzen, der eindeutig angibt, wie oft die Schleife im Prozess ausgeführt wird.

Der Loop Adapter führt eine angegebene Anzahl Schleifendurchläufe in einem Prozess aus. Sobald die angegebene Anzahl Schleifendurchläufe ausgeführt wurde, gibt der Loop Adapter den Statuswert 1 aus.

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

§ Count: Zählt die Anzahl der Schleifendurchläufe.

Parameter

count

Anzahl der auszuführenden Schleifendurchläufe

Mögliche Werte:

§ Ganzzahl

E-Mail-Adapter IMAP und POP3– Unterstützung von OAuth 2.0

Da Microsoft die Basisauthentifizierung für IMAP, POP3 und andere Legacy-Protokolle abkündigt, unterstützen die E-Mail-Adapter IMAP und POP3 jetzt auch Microsoft Modern Auth (OAuth 2.0).

Parameter

oAuth2

Legt fest, ob das Protokoll OAuth 2.0 für die Anmeldung verwendet wird.

Mögliche Werte:

true: OAuth 2.0 wird für die Anmeldung verwendet.
false: OAuth 2.0 wird nicht für die Anmeldung verwendet.
Wenn das Protokoll OAuth 2.0 verwendet wird, gilt Folgendes:
Die SSL-Verschlüsselung muss für die Verbindung zum IMAP-Server aktiviert werden, indem der Parameter ssl gesetzt wird.
Das Zugriffstoken muss über den Parameter password eingegeben werden.

Adapter Keycloak Management – Abrufen von Daten aus nicht standardmäßigem Realm

Der Adapter Keycloak Management kann Daten aus einem nicht standardmäßigen Realm abrufen, indem der Realm bei der Anmeldung für die Authentifizierung gewählt wird.

Um dies zu unterstützen, wurden die folgenden neuen Parameter zum Adapter hinzugefügt:

Parameter

realm	Realm, der in Keycloak-ReST-API-Aufrufen verwendet werden soll
clientId	Client-ID für die Keycloak-ReST-API-Authentifizierung
clientSecret	Geheimer Client-Schlüssel für die Keycloak-ReST-API-Authentifizierung

LDAP Connector – Ausschalten der Hostnamenvalidierung für eine LDAP-Verbindung

Im LDAP Connector kann die Hostnamenvalidierung für eine LDAP-Verbindung mit dem Parameter acceptAllHostnames ausgeschaltet werden.

Parameter

acceptAllHostnames

Deaktiviert die Sicherheitseinstellungen, indem jeder im Zertifikat enthaltene Hostname akzeptiert wird.

Mögliche Werte:

true: Akzeptiert jeden Hostnamen.
false: Die Sicherheitseinstellungen werden aktiviert (Standard).

User Session Adapter – neuer Adapter zum Speichern von Informationen zur Benutzersitzung aus einem Prozess

In der Kategorie X4 Tools gibt es einen neuen Adapter (User Session Adapter), mit dem Daten in der Benutzersitzung gespeichert werden können. Auf diese Daten kann später zugegriffen werden.

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

Store Content: Schreibt die Daten aus dem Datenstrom in die Benutzersitzung.
Get Content: Gibt den Datensatz aus der im Parameter key angegebenen Benutzersitzung aus.
List Content: Gibt eine Liste der Daten in der Benutzersitzung aus.
Check User Session: Prüft, ob eine Benutzersitzung vorhanden ist, und gibt die ID der Benutzersitzung aus.
Clear Session Data: Löscht die Daten in der Benutzersitzung und macht die Benutzersitzung ungültig.

Parameter

key	Für die Operation Get User Session: Wird als Filter verwendet. Für die Operation Store User Session: Wird als der Name verwendet, mit dem die Daten im Datenstrom in der Benutzersitzung gespeichert werden. Mögliche Werte: Beliebige Zeichenkette

Adapter System Status/Schedule Management – API zur Überwachung des Systemstatus, z. B. zum Erkennen von Performanceproblemen

Um den Systemstatus zu prüfen oder Performanceprobleme zu erkennen, werden hilfreiche Laufzeitinformationen über den X4 Server und die Prozesse benötigt. Die Adapter System Status und Schedule Management wurden erweitert und stellen die erforderlichen Informationen jetzt bereit.

Der Adapter System Status gibt Statusinformationen über den X4 Server aus. Der Adapter Schedule Management übernimmt die Aktualisierung oder Auflistung von Schedulern, die im X4 Repository oder in einem Projekt enthalten sind.

Adapter „System Status“

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

Threads Information: Gibt Informationen über alle auf dem X4 Server laufenden Threads aus.
JVM Parameters: Gibt alle Parameter der Java Virtual Machine aus.
Processes Running: Gibt Informationen über alle auf dem X4 Server laufenden Prozesse aus.
User Sessions Memory: Gibt Informationen zum Speicherverbrauch der Benutzersitzungen aus.
Apps Status: Gibt Informationen zu den fehlgeschlagenen und bereitgestellten X4 Apps aus.

Die Operation Threads Information gibt Informationen über alle auf dem X4 Server laufenden Threads aus. Folgende Elemente können im Output enthalten sein:

Element	Beschreibung	Mögliche Werte
Name	Name des Threads	Beliebiger String
Id	ID des Threads	Ganzzahl
State	Status des Threads	NEW RUNNABLE BLOCKED WAITING TIMED_WAITING TERMINATED
Priority	Priorität des Threads	Ganzzahl zwischen 1 und 10
Daemon	Angabe, ob der Thread ein Hintergrunddienst ist	true false
CpuTime	Für die Ausführung des aktuellen Threads benötigte Zeit in Sekunden	Ganzzahl

Adapter „Schedule Management“

Der Adapter Schedule Management hat eine neue Operation: Jobs Information.

Die Operation Jobs Information zeigt Informationen über zeitgesteuerte Prozesse aus allen Schedule-Dateien im X4 Repository an.

Folgende Elemente können im Output enthalten sein:

Element	Beschreibung	Mögliche Werte
Id	UUID der Ausführung	UUID
Name	Name der Ausführung	Beliebiger String
Process	Pfad zum Prozess, der ausgeführt werden soll	Beliebiger gültiger Pfad zum X4-Prozess im X4 Repository
Active	Status der Ausführung	true false
JobsExecuted	Anzahl der bisherigen Ausführungen	Ganzzahl
StartTime	Startdatum der Ausführung	Datumsangabe
PreviousTime	Datum der letzten Ausführung	Datumsangabe
NextTime	Datum der nächsten Ausführung	Datumsangabe
EndTime	Enddatum der Ausführung	Datumsangabe

Adapter System Configuration – Anzeige der Konfigurationsparameter

Es gibt einen neuen Adapter für die Anzeige der Konfigurationsparameter der X4 Instanzen. Der Adapter System Configuration ist in der Kategorie X4 Tools enthalten.

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

List Configurations: Alle Konfigurationen des Systems auflisten
Get Configuration by configurationName: Konfiguration mit dem angegebenen Namen ausgeben

Adapter File System – verbesserte Information für targetPath

In einigen Fällen verwechseln Anwender die Parameter path und targetPath im Adapter File System. Daher wurde ein Kommentar zum Parameter targetPath hinzugefügt:

targetPath

Zusätzlicher Pfad zu einer Datei oder einem Ordner im Dateisystem des X4 Servers oder zu einem verbundenen Windows- oder Samba-Netzlaufwerk. Hierzu benötigt der X4 Server entsprechende Berechtigungen auf den Ordner.

Dieser Parameter wird nur bei der Operation Move und Copy verwendet.

Mögliche Werte:

Beliebige Zeichenkette, ggf. inklusive Platzhaltern und Dateiendung, z. B. %USER_COLLECTION%/Data/Input.xml
c:/: Auf die Windows-Systempartition C:\ zugreifen
Beliebige UNC-Netzlaufwerksangabe nach dem Schema \\\\Server\\Freigabe\\Ordner\\ mit beliebigen Leer- und Sonderzeichen, z. B. \\\\SP-PM-01\\share\\Öffentlicher Ordner\\

Adapter Deployments – ReST-API zum Aktualisieren der Inhalte der X4DB

Nach dem Ändern von Ressourcen auf dem Dateisystem können diese mit einem ReST-Service in der X4 Datenbank geändert werden. Der ReST-Service wurde von Deployed Processes in Deployments umbenannt und ist in der Kategorie X4 Adapters > X4 Tools verfügbar.

Deployments: Listet die auf dem Server bereitgestellten Prozesse und Ressourcen im X4 Repository auf. Die Auflistung beinhaltet auch die mithilfe von X4 Apps bereitgestellten Prozesse.

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

List: Alle bereitgestellten Prozesse und Ressourcen in einem XML-Dokument auflisten
Get Image: Gibt ein Bild aus.
Get Image Metadata: Gibt die Metadaten eines Bildes aus.
Reload Repository: Gibt eine Liste aller Projekte und den Repository-Typ für jedes Element aus.
Reload Project: Gibt das Projekt und den Typ des zugehörigen Repositorys für jedes Element aus.

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Möglicher Wert: de.softproject.x4.adapter.deployed.app.DeployedAppAdapter (default)
repository	Repository-Name
project	Projektname
processPath	Prozesspfad und -name