JMS Verbindung

Einführung

Eine JMS -Verbindung, die mit dem JMS -Connector erstellt wurde, stellt den Zugriff auf JMS -Anbieter her. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von JMS -Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Erstellen oder Bearbeiten einer JMS -Verbindung

Eine neue JMS -Verbindung wird mithilfe des JMS -Connectors von einem dieser Standorte aus erstellt:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint erstellen in Globale Verbindungen).

Eine bestehende JMS -Verbindung kann von diesen Orten aus bearbeitet werden:

• Die Tab Endpoints und -konnektoren der Designkomponentenpalette (siehe Komponentenpalette).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).
• Die Seite Globale Verbindungen (siehe Einen globalen Endpoint bearbeiten in Globale Verbindungen).

Konfigurieren einer JMS -Verbindung

Jedes Benutzeroberflächenelement des JMS Verbindungskonfigurationsbildschirms wird unten beschrieben.

Die in der JMS Verbindungskonfiguration verwendete Schnittstelle hängt vom ausgewählten JMS Provider ab:

• Aktives MQ

• IBM MQ

• Brauch

Aktive mq

Wenn Active MQ als JMS -Provider ausgewählt ist, wird diese Schnittstelle angezeigt:

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede JMS -Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte : Dieser Name wird auch zur Identifizierung des JMS Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• JMS Anbieter: Wählen Sie im Menü Active MQ aus.

• JNDI-Initialfabrik: Geben Sie die JNDI-Initialfabrik (Java Naming and Directory Interface) ein.

• Provider-URL: Geben Sie die zu verwendende Verbindungs-URL ein.

• Fabrikname: Geben Sie den Fabriknamen der Verbindung ein.

• Optionale Einstellungen: Klicken Sie, um eine zusätzliche optionale Einstellung zu erweitern:

  • JNDI-Lookup verwenden: Wählen Sie diese Option aus, um nur mit vorhandenen Warteschlangen zu interagieren, die in einer Aktivität angegeben sind. Wenn diese Option ausgewählt ist und die angegebene Warteschlange nicht existiert, gibt die Aktivität einen Fehler zurück. Wenn sie nicht ausgewählt ist (Standard) und die in einer Aktivität angegebene Warteschlange nicht existiert, wird eine neue Warteschlange mit dem angegebenen Namen erstellt.

  • Authentifizierung verwenden: Wählen Sie diese Option aus, um die Verbindung mit der Basisauthentifizierung zu authentifizieren. Wenn diese Option ausgewählt ist, werden die folgenden Felder verfügbar:

    • Benutzername: Geben Sie den Benutzernamen für den JMS Anbieter ein.

    • Passwort: Geben Sie das Passwort für den JMS Anbieter ein.

    Notiz

    Um die SSL/TLS-Authentifizierung mit ActiveMQ zu verwenden, muss SSL für den JMS Client konfiguriert und ein Zertifikat zum Jitterbit Java Schlüsselspeicher hinzugefügt werden (wie in Voraussetzungen beschrieben).). Sobald die Voraussetzungen erfüllt sind, verwendet die Verbindung automatisch die SSL/TLS-Authentifizierung. Um die SSL/TLS-Authentifizierung zu beenden, müssen Sie das Zertifikat aus dem Jitterbit Java Schlüsselspeicher entfernen.

• Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

IBM MQ

Wenn IBM MQ als JMS -Provider ausgewählt ist, wird diese Schnittstelle angezeigt:

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede JMS -Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte : Dieser Name wird auch zur Identifizierung des JMS Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• JMS -Anbieter: Wählen Sie im Menü IBM MQ aus.

• Provider-URL: Geben Sie die zu verwendende Verbindungs-URL ein.

• Warteschlangenmanager: Geben Sie den Namen des Warteschlangenmanagers ein.

• Kanal: Geben Sie den Kanal ein, das mit dem angegebenen Warteschlangenmanager verbunden ist.

• Port: Geben Sie den Port ein, mit dem der Kanal verbunden ist.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

  • JNDI-Lookup verwenden: Wählen Sie diese Option aus, um nur mit vorhandenen Warteschlangen zu interagieren, die in einer Aktivität angegeben sind. Wenn diese Option ausgewählt ist und die angegebene Warteschlange nicht existiert, gibt die Aktivität einen Fehler zurück. Wenn sie nicht ausgewählt ist (Standard) und die in einer Aktivität angegebene Warteschlange nicht existiert, wird eine neue Warteschlange mit dem angegebenen Namen erstellt.

  • Authentifizierung verwenden: Wählen Sie diese Option aus, um die Verbindung mit der Basisauthentifizierung zu authentifizieren. Wenn diese Option ausgewählt ist, werden die folgenden Felder verfügbar:

    • Benutzername: Geben Sie den Benutzernamen für den JMS Anbieter ein.

    • Passwort: Geben Sie das Passwort für den JMS Anbieter ein.

  • SSL verwenden: Wählen Sie diese Option aus, um die Verbindung mit Secure Sockets Layer (SSL) des Clients zu authentifizieren. Wenn diese Option ausgewählt ist, werden diese Felder verfügbar:

    Wichtig

    Wenn Sie diese Option verwenden, muss SSL für den JMS Client konfiguriert und ein Zertifikat zum Jitterbit Java Schlüsselspeicher hinzugefügt werden (wie in Voraussetzungen beschrieben).).

    • SSL-Chiffre: Geben Sie die SSL-CipherSpec ein. Weitere Informationen zu IBM MQ CipherSpecs finden Sie in der IBM MQ-Dokumentation.

    • Sicherheitsprotokoll: Wählen Sie aus dem Menü das zu verwendende Sicherheitsprotokoll aus, eines von TLS, TLSv1.0, TLSv1.1 oder TLSv1.2. Weitere Informationen finden Sie in der IBM MQ-Dokumentation.

• Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Brauch

Wenn Benutzerdefiniert (nur Privater Agent ) als JMS Anbieter ausgewählt ist, wird diese Schnittstelle angezeigt:

• Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede JMS -Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte : Dieser Name wird auch zur Identifizierung des JMS Endpoint verwendet, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

• JMS -Anbieter: Wählen Sie im Menü Benutzerdefiniert (nur Privater Agent ) aus.

  Hinweis

  Es wurde bestätigt, dass diese Option mit JBoss EAP funktioniert, Oracle WebLogic und GlassFish JMS Anbieter. Andere JMS Anbieter funktionieren voraussichtlich, wurden aber von Jitterbit nicht getestet.

• JNDI-Initialfabrik: Geben Sie die JNDI-Initialfabrik (Java Naming and Directory Interface) ein.

• Provider-URL: Geben Sie die zu verwendende Verbindungs-URL ein.

• Fabrikname: Geben Sie den Fabriknamen der Verbindung ein.

• Nur Privater Agent: Wenn ausgewählt, wird die Tabelle Zusätzliche Anbieterkonfiguration angezeigt, die verwendet wird, um zusätzliche Konfigurationseigenschaften als Schlüssel-Wert-Paare hinzuzufügen, die mit jeder Aktivitätsanforderung gesendet werden sollen:

  • Hinzufügen: Fügt der Tabelle eine Zeile hinzu. Geben Sie für jede Eigenschaft ein Key-Value Paar ein.
  • Senden: Speichert das Key-Value Paar in der Tabelle. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
  • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer vorhandenen Zeile. Sichtbar, wenn Sie im Bearbeitungsmodus mit der Maus über eine Zeile fahren.
  • Bearbeiten: Ermöglicht Ihnen, ein vorhandenes Key-Value Paar zu bearbeiten. Sichtbar, wenn Sie mit der Maus über eine vorhandene Zeile fahren.
  • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn der Mauszeiger über eine vorhandene Zeile fährt.
  • Alles löschen: Löscht alle Zeilen aus der Tabelle.

  Wichtig

  Felder in der Tabelle Anbieter-Zusatzkonfiguration zeigen die Variablensymbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein..

• Optionale Einstellungen: Klicken Sie, um eine zusätzliche optionale Einstellung zu erweitern:

  • Authentifizierung verwenden: Wählen Sie diese Option aus, um die Verbindung mit der Basisauthentifizierung zu authentifizieren. Wenn diese Option ausgewählt ist, werden die folgenden Felder verfügbar:

    • Benutzername: Geben Sie den Benutzernamen für den JMS Anbieter ein.

    • Passwort: Geben Sie das Passwort für den JMS Anbieter ein.

• Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine JMS -Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• 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 soll als Quelle in einem Operation verwendet werden.

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

• Schicken: Sendet Nachrichten an eine JMS -Warteschlange oder ein JMS-Thema und soll als Ziel in einer Operation verwendet werden.