JMS-Aktivitäten erstellen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer

    • Erstellen Sie eine benutzerdefinierte JMS-Aktivität zum Abrufen oder Senden von Nachrichten an externe Systeme mithilfe des Java Messaging Service.

    Vorbereitungen

    Erforderliche Rolle: activity_creator oder workflow_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Die JMS-Aktivität unterstützt JMS-Drittanbieter, deren JMS-Clientanwendung mit einem typischen Java EE-Muster geschrieben wurde, und kann diese Vorgänge unterstützen:
    • JNDI zum Suchen eines ConnectionFactory-Objekts
    • JNDI zum Suchen eines oder mehrerer Zielobjekte
    • ConnectionFactory zum Erstellen eines JMS-Verbindungsobjekts
    • JMS-Verbindung zum Erstellen eines oder mehrerer JMS-Sitzungsobjekte
    • JMS-Sitzung und die Ziele zum Erstellen der MessageProducer- und MessageConsumer-Objekte
    • Starten der JMS-Verbindung für die Zustellung oder Verwendung von Nachrichten
    Hinweis:
    Der JMS-Aktivitätsdesigner wurde mit den JMS-Anbietern ActiveMQ und Tibco EMS getestet. Informationen zum Herstellen einer Verbindung zu einem JMS-Anbieter finden Sie in der Dokumentation Ihres Drittanbieters.

    Prozedur

    1. Erstellen oder verifizieren Sie Ihren JMS-Anmeldeinformationen .
      Ihre JMS-Anmeldeinformationen müssen über die Berechtigung für die Zieldatenbank und die richtige Konfiguration für die entsprechende JMS-Verbindung verfügen. Anmeldeinformationen müssen eingerichtet werden, bevor Sie eine JMS-Aktivität erstellen können.
    2. Erstellen oder überprüfen Sie Ihre JMS-Verbindung.
      Die JMS-Verbindung muss mit gültigen JMS-Anmeldeinformationen konfiguriert sein, bevor Sie eine JMS-Aktivität erstellen können.
    3. Erstellen Sie eine benutzerdefinierte Aktivität.
      Diese Aktion erstellt eine benutzerdefinierte Aktivität mithilfe einer Vorlage.
    4. Nach dem Einrichten Allgemeine Eigenschaften Und Eingabevariablen werden erstellt , Konfigurieren Sie den JMS-Ausführungsbefehl.
      OptionBezeichnung
      Konfigurieren Sie Ihren Berechtigungsnachweis Füllen Sie die für Ihre Datenbankverbindung erforderlichen Felder aus.
      Connection Factory Name der JMS Connection Factory. Sie sollten Ihre JMS-Verbindung erstellen oder überprüfen. Diese Konfiguration verknüpft den Namen der ursprünglichen Kontext-Werkseinstellung mit der URL des JMS-Anbieters.
      Zieltyp Zieltyp für diese Nachricht:
      • Warteschlange: Die Nachricht wird für die Punkt-zu-Punkt-Kommunikation in die Warteschlange gestellt.
        Hinweis:
        Der GET-Vorgang wird nur für den Zieltyp „Warteschlange“ unterstützt.
      • Thema: Die Nachricht wird für die Veröffentlichungs- und Abonnementkommunikation verwendet.
      Zielname Name der Warteschlange oder des Themenziels, das auf dem JMS-Anbieter konfiguriert ist.
      Nachrichtentyp Der Wert für den JMS-Nachrichtentyp. Es wird nur der Typ Textnachricht unterstützt. Die Warteschlange oder das Themenziel muss so konfiguriert sein, dass nur Textnachrichten empfangen oder gesendet werden. Andere Nachrichtentypen werden gelöscht, da die JMS-Aktivität sie nicht verarbeiten kann.
      Vorgang Der programmgesteuerte Vorgang, der auf dem Ziel ausgeführt werden soll. Die Auswahlmöglichkeiten sind PUT oder GET.
      Zeitüberschreitung (Sek.) Zulässige Zeit in Sekunden, die auf eine Nachricht in der Nachrichtenwarteschlange vor der Zeitüberschreitung gewartet werden kann. Der Standardwert ist 30.
      Benutzerdefinierte Nachrichtenkopfzeilen Die benutzerdefinierten Kopfzeilenwerte im Format „Name-Wert-Paar“, die für das JMS-Ziel verfügbar sind.
      Hinweis:
      Wird nur für den PUT-Vorgang unterstützt.
      Nachrichten-Payload Tatsächlicher Nachrichteninhalt oder tatsächliches Payload, das an das JMS-Ziel gesendet wird.
      Hinweis:
      Wird nur für den PUT-Vorgang unterstützt.
      Anmelde-Tag Ein Tag für einzelne Anmeldeinformationen für eine JMS-Aktivität in einem Orchestration-Workflow.
      Erforderliche MID Server-Fähigkeiten Zu verwendender MID-Server nach Fähigkeiten.

    Nächste Maßnahme

    JMS-Verbindungen für Orchestration-Aktivitäten erstellen

    Konfigurieren Sie Ihr System so, dass Java Messaging Service (JMS) mit einer anwenderdefinierten Orchestration-JMS-Aktivität verwendet wird.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Der MID Server muss über die richtigen JMS Connection Factorys für Ihre Organisation verfügen. Konfigurieren Sie diese Werte in mid.property.jms.command.allowed_factory_namesEigenschaft, gefunden in MID-Server > Eigenschaftenan. Die Standardwerte für diese Eigenschaft können in einen beliebigen Wert oder eine durch Kommas getrennte Liste von Werten geändert werden, die der JMS-Provider eines Drittanbieters bekanntgibt.

    Prozedur

    1. Navigieren zu MID-Server > JAR-Dateienan.
    2. Klicken Sie Auf Neu Und hinzufügen.
      OptionBezeichnung
      Name Ein eindeutiger und beschreibender Name zum Identifizieren der Datei in der Instanz.
      Version Eine Versionsnummer für die Datei, sofern verfügbar.
      Quelle Speicherort der JAR-Datei zu Referenzzwecken. Quellinformationen werden vom System nicht verwendet.
      Beschreibung Kurzbeschreibung der JAR-Datei und ihres Zwecks in der Instanz.
    3. Klicken Sie auf das Büroklammersymbol im Banner, und hängen Sie die JMS-Treiber-JAR-Datei an.
      Die JMS-Treiber-JAR-Datei sollte als Teil der JMS-Anbieterinstallation verfügbar sein. Nur wenige JMS-Anbieter bieten sie als separates Produkt an. In der Dokumentation des JMS-Anbieters finden Sie Informationen dazu, für welche JMS-Client-Treiber-JAR-Dateien die Clientanwendungen eine Verbindung zum JMS-Anbieter herstellen müssen. Wenn Sie beispielsweise versuchen, eine Verbindung zu ActiveMQ V5.10 (JMS-Anbieter) herzustellen, benötigen Sie die Datei activemq-all-5.10.1.jar.
    4. Navigieren zu Orchestration > Anmeldeinformationen und Verbindungen > JMS Connection Factoryan.
    5. Klicken Sie Auf Neu Fügen Sie Folgendes hinzu, und klicken Sie auf Übermitteln .
      OptionBezeichnung
      Name Eindeutiger Name für diese Connection Factory
      Ursprüngliche Kontext-Werkseinstellung Name der JNDI-Klasse, die zum Erstellen des InitialContext verwendet wird.
      Hinweis:
      Um beispielsweise eine Verbindung zu ActiveMQ V5.10 (JMS-Provider) herzustellen, lautet der Wert org.apache.activemq.jndi.ActiveMQInitialContextFactory.
      Provider-URL Speicherort der laufenden JMS-Provider-Installation.
      Hinweis:
      So stellen Sie beispielsweise eine Verbindung zu ActiveMQ V5.1 her: tcp://ipAdresseOderHostname: 61616.
    6. Navigieren zu Orchestration > Anmeldeinformationenan.
    7. Klicken Sie auf Neu, wählen JMS-Anmeldeinformationen aus, und geben Sie den Benutzernamen und das Passwort ein, die der MID für die Kommunikation mit dem JMS-Anbieter verwenden soll.
      Weitere Informationen finden Sie unter JMS-Anmeldeinformationen JMS-Anmeldeinformationen .
    8. Klicken Sie auf Absenden.
      Nun können Sie eine benutzerdefinierte JMS-Aktivität erstellen.

    Ausführungsparameter für JMS-Vorlagen

    Im Formular Vorverarbeitung erstellen Sie das Eingabeprozessskript mit Ausführungsparametern.

    Sie müssen das Präfix executionParam. mit allen Variablen in dieser Tabelle verwenden.
    Tabelle : 1. JDBC-Ausführungsparameter
    Name Variable Typ Verwendung
    Jms ds jms_ds Referenz Ausgewählt JMS-Datenquelle
    Zieltyp destination type Aufzählung
    Zielname destination_name Zeichenfolge
    Nachrichtentyp message_type Aufzählung
    Operation operation Aufzählung
    Time out time_out Ganzzahl Zeit, die auf die Rückgabe von Abfrageergebnissen gewartet wird
    Anwenderdefinierte Header custom_headers Array von JavaScript-Objekten
    Message payload message_payload Zeichenfolge
    Anmelde-Tag credential_tag Zeichenfolge Liste der erforderlichen MID-Server-Fähigkeiten
    MidCapabilities midCapabilities Zeichenfolge (durch Kommas getrennt)
    ValueCapabilities valueCapabilities Hashmap-Array Fähigkeitswerte, die zum Auswählen des MID-Servers verwendet werden. Weitere Informationen finden Sie unter MID Server-Fähigkeiten. Verwenden Sie dieses Beispiel, um die Auswahl des MID-Servers anzupassen, wenn zusätzliche Fähigkeiten nach Wert zugewiesen werden:
    var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

    Nachverarbeitungsparameter für JMS-Vorlagen

    Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen.

    Tabelle : 2. JMS-Nachverarbeitungsparameter
    Name Variable Typ Verwendung
    Status status Zeichenfolge Status des Vorgangs (Put oder Get) auf dem JMS-Ziel
    StandardHeaders standardHeaders Zeichenfolge Alle von JMS angegebenen Standard-Header, die während eines GET-Vorgangs als Teil der JMS-Nachricht abgerufen werden. Dieses Feld betrifft nur Get-Vorgänge.
    CustomHeaders customHeaders Zeichenfolge Alle anwenderdefinierten Header, die von einer Ersteller- oder Herausgeberanwendung hinzugefügt wurden und während eines GET-Vorgangs als Teil der JMS-Nachricht abgerufen werden. Dieses Feld betrifft nur Get-Vorgänge.
    MessagePayload messagePayload Zeichenfolge Nachrichten-Payload, das während einer Get-Operation als Teil der JMS-Nachricht abgerufen wird. Dieses Feld betrifft nur Get-Vorgänge.
    EccSysID eccSysID Zeichenfolge Enthält die Referenz-ID, die der von der Aktivität zurückgegebenen Eingabenachricht der ECC-Warteschlange zugeordnet ist
    ErrorMessages errorMessages Zeichenfolge Enthält alle Fehlernachrichten, die vom JMS-Befehl abgerufen wurden. Dieser Wert ist null, wenn keine Fehlermeldungen vorhanden sind.