WebSocket-Kanal

Die externe Aktion "WebSocket-Kanal" empfängt Nachrichten und stellt sie über TCP an WebSocket-unterstützte Clients zu, die mit dem FME Flow WebSocket Server oder einer anderen Ziel-URL verbunden sind. Zu den unterstützten Clients gehören:

  • Mit WebSocketReceiver-Transformern konfigurierte FME Form-Workspaces.
  • HTML5-basierte Webbrowser wie:
    • Internet Explorer 10+
    • Firefox 11+
    • Chrome 16+
    • Safari 6+
    • Opera 12.10+

Die externe Aktion "WebSocket-Kanal" verfügt über zwei Ausgabe-Ports. Der Success-Port (✔) kann eine Nachricht senden, wenn der WebSocket-Kanal erfolgreich benachrichtigt wurde. Der Failure-Port (x) kann eine Nachricht senden, wenn die Benachrichtigung fehlschlägt.

Hinweis  Wenn die Einstellungen zum Wiederholen konfiguriert sind, wird der Failure-Port mit einem Symbol "Wiederholen konfiguriert" (⟳) dargestellt.

Client-Anforderungen

Um Daten von der externen Aktion zu erhalten, müssen die Clients die folgende Präambel senden:

{

"ws_op" : "open",

"ws_stream_ids" : ["<stream_id1>", "<stream_id2>", "<stream_id3>", ...]

}

Weitere Informationen finden Sie unter WebSocket Server Nachrichtenprotokoll.

WebSocket-Kommunikationskanäle

Der WebSocket Server befindet sich auf dem FME Flow Core. Standardmäßig verwendet FME Flow die folgenden Kanäle für die WebSocket-Kommunikation:

  • Port: 7078
  • URI: ws://<hostname>:7078/websocket

Informationen zum Konfigurieren des WebSocket-Servers für die SSL-Kommunikation finden Sie unter Konfigurieren für HTTPS.

Parameters

Hinweis  Siehe auch Arbeiten mit Parametern in Automatisierungs-Workflows.
Tipp  Um zu testen, ob Ihre Parameter wie erwartet funktionieren, klicken Sie auf Validieren.
  • Ziel-URL: In dieses Feld wird die URL des WebSocket-Servers auf dem FME Flow Core (in Ihrer FME Flow-Installation enthalten) eingetragen. Sie können jedoch auch eine Verbindung zu einem anderen WebSocket-Server herstellen.
  • Stream-ID: Geben Sie eine Stream-ID für den Subscriber an. Mit der Stream-ID kann der WebSocket-Server Nachrichtenströme eindeutig identifizieren und mit den richtigen anfragenden Anwendungen verbinden.
  • Nachricht: Geben Sie die zu sendende Nachricht an. Wenn angegeben, ersetzt diese Nachricht die eingehende Nachricht.

Attribute der Ausgabe

Siehe auch

Tipp  Um die Ausgabeattribute der vorgelagerten Komponenten anzuzeigen, klicken Sie auf Vorgelagerte Attribute anzeigen.
Attribut Beschreibung
time Ereigniszeit
source Ereignistyp
error.type

(nur Failure-Port) Fehlertyp:

  • InvalidMessage: Beim Konfigurieren dieser Komponente ist ein Fehler aufgetreten, z. B. fehlende oder fehlerhafte Werte.
  • DeadLetter: Bei der Verbindung mit einer externen Ressource ist ein Fehler aufgetreten. Beispiele können Verbindungsprobleme, ungültige Anmeldeinformationen oder allgemeine Ausnahmen für externe Ressourcen sein.
error.message (nur Failure-Port) Fehlermeldung

Wiederholen

  • Wiederholen bei einem Fehler: Wenn dieses Kontrollkästchen aktiviert ist, versucht die Automatisierung, die Aktion erneut auszuführen, wenn der erste Versuch, eine Verbindung zur angegebenen externen Ressource für die Nachrichtenzustellung herzustellen, fehlschlägt. Die Art und Weise, wie diese Wiederholungen durchgeführt werden, hängt von den übrigen Einstellungen ab.
  • Benutzerdefinierte Wiederholungseinstellungen verwenden: Wenn diese Option aktiviert ist, sind die übrigen Wiederholungseinstellungen konfigurierbar. Wenn dieses Kontrollkästchen nicht aktiviert ist, werden sie auf die Standardwerte von FME Flow gesetzt.
  • Anzahl der Versuche: Maximale Anzahl von Wiederholungsversuchen, wenn die Aktion weiterhin fehlschlägt.
  • Wartezeit zwischen den Versuchen: Zeit, die zwischen den Wiederholungsversuchen gewartet wird. In Verbindung mit dem Backoff-Multiplikator (unten) ist der angegebene Wert die Wartezeit für den ersten Wiederholungsversuch.
  • Backoff-Multiplikator: Faktor, um den die Wartezeit zwischen den Versuchen bei aufeinanderfolgenden Wiederholungen erhöht werden soll. Zum Beispiel verdoppelt ein Wert von 2.0 die Wartezeit für den nächsten Wiederholungsversuch.
  • Randomisierungsfaktor: Prozentsatz, um den die Zufälligkeit in die Wartezeit zwischen den Versuchen eingeführt werden soll. Wenn beispielsweise die Wartezeit zwischen den Versuchen 100 Sekunden und der Randomisierungsfaktor 25 ist, wird die Wartezeit für jeden Wiederholungsversuch zufällig zwischen 75 und 125 Sekunden gewählt.
  • Maximale Wartezeit zwischen den Versuchen: Maximale Wartezeit zwischen den Wiederholungsversuchen. In Verbindung mit dem Backoff-Multiplikator ist der angegebene Wert die Obergrenze für die Wartezeit.

Siehe auch