JMS-Nachricht
Die externe Aktion "JMS-Nachricht" empfängt Nachrichten und leitet sie an JMS-kompatible Nachrichtenbroker (z. B. IBM WebSphere MQ) weiter.
Die externe Aktion "JMS-Nachricht" verfügt über zwei Ausgabe-Ports. Der Success-Port (✔) kann eine Nachricht senden, wenn der Nachrichtenbroker 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.
Einrichten eines JMS-Nachrichtenbrokers mit FME Flow
Bevor Sie eine externe Aktion "JMS-Nachricht" konfigurieren, müssen Sie einen JMS-Broker für die Arbeit mit FME Flow einrichten. Die Schritte hängen von dem von Ihnen verwendeten Broker ab und werden im folgenden Abschnitt erläutert:
Parameters
- Provider-Typ oder Kontext: Der Nachrichtenbroker, zu dem eine Verbindung hergestellt werden soll, oder die anfängliche Kontext-Factory, wenn der Broker nicht aufgeführt ist.
- Provider-URL: Die URL des Verzeichnisses, das Verbindungsdetails für den JMS-Provider enthält.
- Zusätzliche Provider-Eigenschaften: Alle zusätzlichen anbieterspezifischen Eigenschaften in der Form Schlüssel=Wert. Beispiel: randomize=false. Geben Sie mehrere Paare in separaten Zeilen an.
- Verbindungsfactory: Der Name des Verbindungsfactory-Objekts.
- Benutzername: Ein authentifizierender Benutzername.
- Kennwort: Ein authentifizierendes Kennwort.
- Ziel(e): Der Name des Zielobjekts bzw. der Zielobjekte. Diese entsprechen Warteschlangen und / oder Themen. Mehrere Ziele können durch Kommas getrennt angegeben werden.
- Permanente Zustellung: Wenn der Parameter auf Ja eingestellt ist, werden Nachrichten vom JMS-Broker gespeichert, bis die Nachricht an ein Ziel zugestellt wird, wobei Nachrichten bei einem Neustart des Brokers wiederhergestellt werden können. Wenn der Parameter auf Nein eingestellt ist, können Nachrichten verloren gehen, wenn ein Broker während der Zustellung neu gestartet wird. Die permanente Zustellung ist langsamer als die nicht permanente Zustellung, insbesondere wenn große Nachrichtenmengen gesendet werden.
- Vorlage für den Inhalt der Benachrichtigung: Der Nachrichten-Body.
In den meisten Fällen wird dieses Feld nicht benötigt. Die von Safe getesteten JMS-Broker, einschließlich Apache ActiveMQ, IBM Websphere MQ und Oracle WebLogic JMS, benötigen zum Herstellen einer Verbindung keine zusätzlichen Eigenschaften.
Beispielkonfigurationen
Aufklappen zum Anzeigen der Beispielkonfigurationen
Apache ActiveMQ Beispielkonfiguration
| Java-Klassenpfad |
Keine Änderung notwendig (Apache ActiveMQ 5.6.0-Bibliotheken sind im Lieferumfang von FME Flow enthalten.) |
| Provider-Typ oder Kontext | ACTIVEMQ |
| Provider-URL | tcp://server:61616 |
| Zusätzliche Provider-Eigenschaften | -- |
| Verbindungsfactory | ConnectionFactory |
| Benutzername |
-- |
| Kennwort |
-- |
| Ziel(e) | dynamicQueues/MyQueue |
IBM WebSphere 7 Beispielkonfiguration
| Java-Klassenpfad | ... -FMESERVER_CLASSPATH "...;C:/Programme (x86)/IBM/WebSphere MQ/java/lib/*" ... |
| Provider-Typ oder Kontext | WEBSPHERE70 |
| Provider-URL | file:/C:/jndi/ |
| Zusätzliche Provider-Eigenschaften | -- |
| Verbindungsfactory | cf1 |
| Benutzername | admin |
| Kennwort | admin |
| Ziel(e) | q1,t1 |
Oracle Weblogic Beispielkonfiguration
| Provider-Typ oder Kontext | weblogic.jndi.WLInitialContextFactory |
| Provider-URL | t3://bq-w2008:7001 |
| Zusätzliche Provider-Eigenschaften | -- |
| Verbindungsfactory | jms/TestConnectionFactory |
| Benutzername |
-- |
| Kennwort |
-- |
| Ziel(e) | jms/TestJMSQueue |
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:
|
| 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.