JMS-Aktivitäten erstellen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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-Client-Anwendung mit einem typischen Java-EE-Muster geschrieben ist und Folgendes unterstützen kann:
    • 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 überprüfen Sie Ihre 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 allgemeiner Eigenschaften und dem Erstellen von Eingabevariablenkonfigurieren 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.
      Operation 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 individuelle 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 für die Verwendung von Java Messaging Service (JMS) mit einer benutzerdefinierten Orchestration-JMS-Aktivität.

    Vorbereitungen

    Erforderliche Rolle: admin

    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 der Eigenschaft mid.property.jms.command.allowed_factory_names 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 fügen Sie hinzu.
      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 Absenden.
      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 > Akadem. Gradean.
    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
    Benutzerdefinierte 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 zur Auswahl des MID Servers. 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 Standardheader, die während einer Get-Operation als Teil der JMS-Nachricht abgerufen werden. Dieses Feld betrifft nur Get-Vorgänge.
    CustomHeaders customHeaders Zeichenfolge Alle benutzerdefinierten Header, die von einer Produzenten- oder Herausgeberanwendung hinzugefügt wurden und als Teil der JMS-Nachricht während eines Abrufvorgangs 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.