Zum Inhalt springen

JMS-Connector in Jitterbit Studio

Zusammenfassung

Der JMS-Connector ermöglicht den Zugriff auf JMS-Provider (Java Message Service).

Der JMS-Connector bietet eine Schnittstelle zum Erstellen einer JMS-Verbindung, die Grundlage für die Generierung von JMS-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit JMS-Providern.

Der JMS-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Design-Komponentenpalette aufgerufen (siehe Design-Komponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer JMS-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte JMS-Verbindung und ihre Aktivitäten als JMS-Endpunkt bezeichnet:

JMS-Aktivitätstypen

  • Acknowledge: Sendet eine Massenbestätigung von JMS-Nachrichten und ist als Ziel in einem Vorgang vorgesehen.

  • Get: Ruft alle in einer bestimmten Warteschlange verfügbaren JMS-Nachrichten ab und ist als Quelle in einem Vorgang vorgesehen.

  • Consume: Verarbeitet Nachrichten aus einer JMS-Warteschlange oder einem JMS-Thema und ist als Quelle in einem Vorgang vorgesehen.

  • Send: Sendet Nachrichten an eine JMS-Warteschlange oder ein JMS-Thema und ist als Ziel in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update (Automatische Connector-Aktualisierung deaktivieren) ausgesetzt werden.

Ein privater Jitterbit-Agent ist in folgenden Fällen erforderlich:

  • Bei Verwendung der SSL/TLS-Authentifizierung für eine ActiveMQ-Verbindung.

  • Bei Verwendung von IBM MQ als JMS-Provider. Die IBM MQ-Versionen 9.2, 9.3 und 9.4 werden unterstützt. Andere IBM MQ-Versionen funktionieren möglicherweise auch, wurden aber nicht von Jitterbit getestet.

  • Bei Verwendung eines benutzerdefinierten JMS-Providers.

Der JMS-Connector unterstützt die Java Message Service 1.1-Spezifikation.

Authentifizierung

Der JMS-Connector unterstützt sowohl die Standardauthentifizierung als auch die SSL/TLS-Authentifizierung. Um SSL/TLS zur Authentifizierung der Verbindung zu verwenden, muss der JMS-Client für die Verwendung von SSL/TLS konfiguriert werden, und es muss ein Zertifikat im PKCS #12-Format zum Jitterbit Java KeyStore hinzugefügt werden (siehe Zertifikate zum Keystore für private Agenten hinzufügen).

Hinweis

Sobald die Voraussetzungen erfüllt sind, verwendet eine ActiveMQ-Verbindung automatisch SSL/TLS. Um die Verwendung von SSL/TLS in der Verbindung zu beenden, muss das Zertifikat aus dem Jitterbit Java KeyStore entfernt werden. Eine IBM MQ-Verbindung erfordert zusätzliche Konfiguration in ihrer Verbindung.

Informationen zum Konfigurieren des Message Brokers für die SSL/TLS-Authentifizierung finden Sie in der Dokumentation des JMS-Providers:

Informationen zum Abrufen eines Zertifikats im PKCS #12-Format finden Sie in der Dokumentation des JMS-Anbieters:

Fehlerbehebung

Bei Problemen mit dem JMS-Connector werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update verwendet wird).

  2. Überprüfen Sie die Vorgangsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Vorgänge (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agents können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:

    <logger name="org.jitterbit.connector.sdkjms" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Verbose logging for connectors using Jitterbit private agents.

  5. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Operation troubleshooting.