Zum Inhalt springen

JMS Konnektor für Jitterbit Integration Studio

Zusammenfassung

Der JMS Connector stellt den Zugriff auf JMS Anbieter (Java Message Service) her.

Der JMS Connector bietet eine Schnittstelle zum Erstellen einer JMS Verbindung, die die Grundlage für die Generierung von Instanzen von JMS Aktivitäten bildet. Nach der Konfiguration interagieren diese Aktivitäten über die Verbindung mit JMS Anbietern.

Der Zugriff auf den JMS Konnektor erfolgt über die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).

Connector-Übersicht

Dieser Connector wird verwendet, um zunächst eine JMS Verbindung zu konfigurieren. Mit dieser Verbindung verknüpfte Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (zum Bereitstellen von Daten in einer Operation) oder Ziele (zum Verbrauchen von Daten in einer Operation) verwendet werden sollen.

Eine bestimmte JMS -Verbindung und ihre Aktivitäten werden zusammen als JMS Endpoint bezeichnet:

JMS -Aktivitätstypen

  • Bestätigen: Sendet eine Massenbestätigung von JMS Nachrichten und soll als Ziel in einer Operation verwendet werden.

  • Erhalten: Ruft alle in einer bestimmten Warteschlange verfügbaren JMS Nachrichten ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

  • Verbrauchen: Verbraucht Nachrichten aus einer JMS Warteschlange oder einem JMS-Thema und ist zur Verwendung als Quelle in einer Operation vorgesehen.

  • Schicken: Sendet Nachrichten an eine JMS Warteschlange oder ein JMS-Thema und ist zur Verwendung als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Konnektor ist ein Konnektor-SDK-basierter Konnektor, auf den Jitterbit bei der Kommunikation von Änderungen an mit dem Connector SDK erstellten Konnektoren verweisen kann.

Voraussetzungen und unterstützte API Versionen

Der JMS Connector erfordert die Verwendung eines Agenten der Version 10.1 oder höher. Diese Agent-Versionen laden bei Bedarf automatisch die neueste Version des Connectors herunter.

Unter diesen Umständen ist ein privater Jitterbit-Agent erforderlich:

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

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

  • Bei Verwendung eines benutzerdefinierten JMS Anbieters.

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 sein und Sie müssen ein Zertifikat in PKCS #12 hinzufügen-Format in den Jitterbit Java KeyStore (siehe Zertifikate zum Schlüsselspeicher für private Agenten hinzufügen).

Notiz

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

Informationen zum Konfigurieren Ihres Nachrichtenbrokers zur Verwendung der SSL/TLS-Authentifizierung finden Sie in der Dokumentation des JMS Anbieters:

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

Fehlerbehebung

Wenn Probleme mit dem JMS Connector auftreten, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Klicken Sie in der Verbindungskonfiguration auf die Schaltfläche Test um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren).

  2. Überprüfen Sie die Operation für alle Informationen, die während der Ausführung der Operation geschrieben werden.

  3. Aktivieren Sie die debuggen Protokollierung für Operation (für Cloud-Agenten oder für private Vertreter), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung privater Agenten können Sie die ausführliche Protokollierung des Connectors aktivieren für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag zu Ihrem privaten Agenten hinzufügen logback.xml Datei:

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

    Weitere Informationen zur ausführlichen Protokollierung von Konnektoren finden Sie unter Ausführliche Protokollierung für Konnektoren mit privaten Jitterbit-Agenten.

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle überprüfen für weitere Informationen.

  6. Weitere Hinweise zur Fehlerbehebung finden Sie unter Fehlerbehebung im Betrieb.