JMS-Verbindung

Einführung

Eine JMS-Verbindung, die mit dem JMS-Connector erstellt wurde, ermöglicht den Zugriff auf JMS-Anbieter. Sobald eine Verbindung konfiguriert ist, können Instanzen von JMS-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer JMS-Verbindung

Eine neue JMS-Verbindung wird mit dem JMS-Connector aus einem dieser Standorte erstellt:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Eine vorhandene JMS-Verbindung kann von diesen Standorten bearbeitet werden:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Registerkarte Komponenten im Projektbereich (siehe Aktionenmenü für Komponenten in Projektbereich Komponentenregister).
• Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer JMS-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die JMS-Verbindung wird im Folgenden beschrieben.

Die in der JMS-Verbindungs-Konfiguration verwendete Schnittstelle hängt vom ausgewählten JMS-Anbieter ab:

• Active MQ

• IBM MQ

• Custom

Active mq

Wenn Active MQ als JMS-Anbieter ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede JMS-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den JMS-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

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

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

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

• Fabrikname: Geben Sie den Namen der Verbindungsfabrik ein.

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

  • JNDI-Lookup verwenden: Wählen Sie diese Option, um nur mit vorhandenen Warteschlangen und Themen zu interagieren, die in einer Aktivität angegeben sind. Wenn diese Option ausgewählt ist und die angegebene Warteschlange oder das Thema nicht existiert, wird von der Aktivität ein Fehler zurückgegeben. Optional können Sie, wenn diese Einstellung aktiviert ist, die Ziel erstellen, wenn Lookup fehlschlägt in der Send-Aktivität aktivieren, um eine neue Warteschlange oder ein neues Thema mit dem angegebenen Namen zu erstellen, wenn eines nicht existiert.

    Wenn nicht ausgewählt (Standard), überprüft die Aktivität nicht die Existenz einer Warteschlange oder eines Themas und wird unabhängig davon erfolgreich abgeschlossen, ob die Nachricht erfolgreich an die angegebene Warteschlange oder das angegebene Thema gesendet wurde.

  • Authentifizierung verwenden: Wählen Sie aus, um die Verbindung mit grundlegender Authentifizierung zu authentifizieren. Wenn ausgewählt, werden diese 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.

    Hinweis

    Um SSL/TLS-Authentifizierung mit ActiveMQ zu verwenden, muss SSL für den JMS-Client konfiguriert werden, und ein Zertifikat muss dem Jitterbit Java-Keystore 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 abzubrechen, müssen Sie das Zertifikat aus dem Jitterbit Java-Keystore entfernen.

• Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

IBM MQ

Wenn IBM MQ als JMS-Anbieter ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede JMS-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den JMS-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

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

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

• Warteschlangenmanager: Geben Sie den Namen des Warteschlangenmanagers ein.

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

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

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

  • JNDI-Suche verwenden: Wählen Sie diese Option, um nur mit vorhandenen Warteschlangen und Themen zu interagieren, die in einer Aktivität angegeben sind. Wenn diese Option ausgewählt ist und die angegebene Warteschlange oder das Thema nicht existiert, wird von der Aktivität ein Fehler zurückgegeben. Optional können Sie, wenn diese Einstellung aktiviert ist, die Ziel erstellen, wenn die Suche fehlschlägt in der Send-Aktivität aktivieren, um eine neue Warteschlange oder ein neues Thema mit dem angegebenen Namen zu erstellen, wenn eines nicht existiert.

    Wenn nicht ausgewählt (Standard), überprüft die Aktivität nicht die Existenz einer Warteschlange oder eines Themas und wird unabhängig davon erfolgreich abgeschlossen, ob die Nachricht erfolgreich an die angegebene Warteschlange oder das angegebene Thema gesendet wurde.

• Authentifizierung verwenden: Wählen Sie aus, um die Verbindung mit grundlegender Authentifizierung zu authentifizieren. Wenn ausgewählt, werden diese 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 aus, um die Verbindung mit dem Client Secure Sockets Layer (SSL) zu authentifizieren. Wenn ausgewählt, werden die folgenden Felder angezeigt.

  Wichtig

  Bei Verwendung dieser Option muss SSL für den JMS-Client konfiguriert werden, und ein Zertifikat muss dem Jitterbit Java-Keystore hinzugefügt werden (wie in den Voraussetzungen beschrieben).

  • SSL-Verschlüsselung: 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, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Custom

Wenn Custom (Nur privater Agent) als JMS-Anbieter ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede JMS-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den JMS-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

• JMS-Anbieter: Wählen Sie im Menü Custom (Nur privater Agent) aus.

  Hinweis

  Diese Option wurde bestätigt, dass sie mit den JMS-Anbietern JBoss EAP, Oracle WebLogic und GlassFish funktioniert. Andere JMS-Anbieter sollten ebenfalls funktionieren, wurden jedoch von Jitterbit nicht getestet.

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

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

• Fabrikname: Geben Sie den Namen der Verbindungsfabrik ein.

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

  • Hinzufügen: Fügt eine Zeile zur Tabelle hinzu. Geben Sie ein Schlüssel-Wert-Paar für jede Eigenschaft ein.
  • Einreichen: Speichert das Schlüssel-Wert-Paar in der Tabelle. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
  • Verwerfen: Verwirft eine neue Zeile oder alle Änderungen an einer bestehenden Zeile. Sichtbar, wenn Sie mit der Maus über eine Zeile im Bearbeitungsmodus fahren.
  • Bearbeiten: Ermöglicht das Bearbeiten eines bestehenden Schlüssel-Wert-Paares. Sichtbar, wenn Sie mit der Maus über eine bestehende Zeile fahren.
  • Löschen: Löscht die Zeile aus der Tabelle. Sichtbar, wenn Sie mit der Maus über eine bestehende Zeile fahren.
  • Alle löschen: Löscht alle Zeilen aus der Tabelle.

  Wichtig

  Felder in der Zusätzliche Konfiguration des Anbieters-Tabelle zeigen das Symbol für Variablen nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit befüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

  Felder in der Zusätzliche Konfiguration des Anbieters-Tabelle unterstützen nicht die Verwendung von Variablen, um rohes JSON zu übergeben. Wenn Ihr Anwendungsfall nicht unterstützt, rohes JSON direkt in den Feldern zu definieren, entkommen Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Zum Beispiel wird das Entkommen von {"success": "true"}; zu {\"success\": \"true\"};.

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

  • Authentifizierung verwenden: Wählen Sie aus, um die Verbindung mit grundlegender Authentifizierung zu authentifizieren. Wenn ausgewählt, werden diese 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, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agent(en) in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Automatische Connector-Aktualisierung deaktivieren Organisationsrichtlinie.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine JMS-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Bestätigen: Sendet eine Sammelbestätigung von JMS-Nachrichten und ist als Ziel in einem Vorgang vorgesehen.

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

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

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