Erstellen Sie eine JMS-Aktivität

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 5 Minuten Lesedauer

    • Erstellen Sie eine anwenderdefinierte JMS-Aktivität, um Nachrichten mit dem Java Messaging Service abzurufen oder an externe Systeme zu senden.

    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 diese Vorgänge unterstützen kann:
    • Verwenden von JNDI, um ein ConnectionFactory-Objekt zu finden.
    • Verwenden von JNDI, um ein oder mehrere Zielobjekte zu finden.
    • Verwenden der ConnectionFactory zum Erstellen eines JMS-Verbindungsobjekts.
    • Verwenden der JMS-Verbindung, um ein oder mehrere JMS-Sitzungsobjekte zu erstellen.
    • Mithilfe einer JMS-Sitzung und der Ziele zum Erstellen der MessageProducer- und MessageConsumer-Objekte.
    • JMS-Verbindung wird gestartet, um die Zustellung oder den Verbrauch von Nachrichten zu aktivieren.
    Hinweis:
    Der JMS-Aktivitätendesigner wurde mit den JMS-Providern ActiveMQ und Tibco EMS getestet. Informationen zum Herstellen einer Verbindung mit einem JMS-Anbieter finden Sie in der Anwenderdokumentation Ihrer Drittpartei.

    Prozedur

    1. Erstellen oder verifizieren Sie 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 verifizieren Sie JMS-Verbindung .
      Ihre JMS-Verbindung muss mit gültigen JMS-Anmeldeinformationen konfiguriert werden, bevor Sie eine JMS-Aktivität erstellen können.
    3. Erstellen Sie ein Anwenderdefinierte Aktivität .
      Mit dieser Aktion wird eine anwenderdefinierte Aktivität mithilfe einer Vorlage erstellt.
    4. Nach dem Einrichten Allgemeine Eigenschaften Und Eingabevariablen werden erstellt , Konfigurieren Sie den JMS-Ausführungsbefehl.
      OptionBezeichnung
      Konfigurieren Sie Ihre Anmeldeinformationen Füllen Sie die für Ihre Datenbankverbindung erforderlichen Felder aus.
      Connection Factory Name der JMS-Verbindungsfabrik. Sie sollten Ihre JMS-Verbindung erstellen oder überprüfen. Diese Konfiguration verknüpft den Namen der anfänglichen Kontext-Factory mit der URL des JMS-Providers.
      Zieltyp Typ des für diese Nachricht verwendeten Ziels:
      • Warteschlange : Nachricht wird für Punkt-zu-Punkt-Kommunikation in die Warteschlange gestellt.
        Hinweis:
        Die ABRUFEN Vorgang wird nur für den Zieltyp der Warteschlange unterstützt.
      • Thema : Nachricht wird zum Veröffentlichen und Abonnieren der Kommunikation verwendet.
      Zielname Name der Warteschlange oder des Themenziels, die auf dem JMS-Provider konfiguriert ist.
      Nachrichtentyp Der Wert des JMS-Nachrichtentyps. Nur die Textnachricht Typ wird unterstützt. Die Warteschlange oder das Themenziel muss so konfiguriert sein, dass nur Textnachrichten empfangen oder gesendet werden. Andere Nachrichtentypen werden verworfen, da sie von der JMS-Aktivität nicht verarbeitet werden können.
      Vorgang Der programmatische Vorgang, der für das Ziel ausgeführt werden soll. Die Auswahlmöglichkeiten sind PLATZIEREN Oder ABRUFEN .
      Zeitüberschreitung (Sekunden) Zulässige Wartezeit in Sekunden für eine Nachricht in der Nachrichtenwarteschlange, bevor eine Zeitüberschreitung auftritt. Der Standardwert ist 30 .
      Anwenderdefinierte Nachrichten-Header Die anwenderdefinierten Headerwerte in einem Name/Wert-Paarformat, das im JMS-Ziel verfügbar ist.
      Hinweis:
      Dies wird nur für unterstützt PLATZIEREN Vorgang.
      Nachrichtennutzlast Tatsächlicher Nachrichteninhalt oder Nutzlast, der an das JMS-Ziel gesendet wird.
      Hinweis:
      Dies wird nur für unterstützt PLATZIEREN Vorgang.
      Anmeldeinformations-Tag Ein Tag für einzelne Anmeldeinformationen für eine JMS-Aktivität in einem Orchestration-Workflow.
      Erforderliche MID-Serverfähigkeiten Zu verwendender MID-Server nach Fähigkeiten.

    Nächste Maßnahme

    Erstellen Sie eine JMS-Verbindung für Orchestration Aktivität

    Konfigurieren Sie Ihr System für die Verwendung des Java Messaging Service (JMS) mit einer anwenderdefinierten Orchestration-JMS-Aktivität.

    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 Drittpartei-JMS-Anbieter veröffentlicht.

    Prozedur

    1. Navigieren zu MID-Server > JAR-Dateienan.
    2. Klicken Sie Auf Neu Und hinzufügen.
      OptionBezeichnung
      Name Ein eindeutiger und beschreibender Name zur Identifizierung der Datei in der Instanz.
      Version Eine Versionsnummer für die Datei, falls eine verfügbar ist.
      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üroklammer-Symbol im Banner, und hängen Sie die JMS-Treiber-JAR-Datei an.
      Die JMS-Treiber-JAR-Datei muss als Teil der JMS-Anbieterinstallation verfügbar sein. Wenige JMS-Lieferanten stellen sie als separates Produkt zur Verfügung. In der JMS-Anbieterdokumentation finden Sie, welche JMS-Client-Treiber-JAR-Dateien erfordern, dass die Client-Anwendungen eine Verbindung zum JMS-Anbieter herstellen. Wenn Sie beispielsweise versuchen, eine Verbindung zu ActiveMQ V5.10 (JMS-Anbieter) herzustellen, benötigen Sie activemq-all-5.10.1.jar Datei.
    4. Navigieren zu Orchestration > Anmeldeinformationen Und Verbindungen > JMS-Verbindungsfabrikan.
    5. Klicken Sie Auf Neu Fügen Sie Folgendes hinzu, und klicken Sie auf Übermitteln .
      OptionBezeichnung
      Name Eindeutiger Name dieser Connection Factory.
      Anfängliche Kontext-Factory Name der JNDI-Klasse, die zum Erstellen des InitialContext verwendet wird.
      Hinweis:
      Um beispielsweise eine Verbindung mit ActiveMQ V5.10 (JMS-Anbieter) herzustellen, ist der Wert Org.apache.activemq.jndi.ActiveMQInitialKontextFactory .
      URL de Anbieters Speicherort der laufenden JMS-Anbieterinstallation.
      Hinweis:
      So stellen Sie beispielsweise eine Verbindung zu ActiveMQ V5.1 her: tcp://ipAddressOrHostName:61616 .
    6. Navigieren zu Orchestration > Anmeldeinformationenan.
    7. Klicken Sie Auf Neu , Auswählen JMS-Anmeldeinformationen , Und geben Sie den Anwendernamen und das Passwort an, 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.
      Sie sind bereit, eine anwenderdefinierte JMS-Aktivität zu erstellen.

    Ausführungsparameter der JMS-Vorlage

    Sie verwenden Ausführungsparameter, um das Eingabeprozessskript in zu erstellen Vorverarbeitung Formular.

    Sie müssen verwenden ExecutionParameter. Präfix mit allen Variablen in dieser Tabelle.
    Tabelle : 1. JDBC-Ausführungsparameter
    Name Variable Typ Monatlich
    JMS-ds jms_ds Referenz Ausgewählte JMS-Datenquelle.
    Zieltyp Target_type Aufgezählt
    Zielname Ziel_Name Zeichenfolge
    Nachrichtentyp message_type Aufgezählt
    Vorgang operation Aufgezählt
    Zeitüberschreitung time_out Ganzzahl Wartezeit, bis die Abfrage Ergebnisse zurückgibt.
    Anwenderdefinierte Header Anwenderdefinierte_Header Array von JavaScript-Objekten
    Nachrichtennutzlast Message_Payload Zeichenfolge
    Anmeldeinformations-Tag Credential_Tag Zeichenfolge Liste der erforderlichen MID-Serverfähigkeiten.
    MidCapabilities MidCapabilities Zeichenfolge (kommagetrennt)
    Wertfähigkeiten Wertfähigkeiten Array von Hashmap Fähigkeitswerte, die zum Auswählen des MID-Servers verwendet werden. Weitere Informationen finden Sie unter MID-Serverfähigkeiten . Wenn zusätzliche Fähigkeiten vorhanden sind, die nach Wert zugewiesen werden, verwenden Sie dieses Beispiel, um die MID-Serverauswahl anzupassen:
    var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

    Nachverarbeitungsparameter der JMS-Vorlage

    Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen.

    Tabelle : 2. JMS-Nachverarbeitungsparameter
    Name Variable Typ Monatlich
    Status Status Zeichenfolge Status des Vorgangs (PUT oder GET) für das JMS-Ziel.
    Standardheader Standard-Header Zeichenfolge Alle Standard-Header, wie von JMS angegeben, die als Teil der JMS-Nachricht während eines GET-Vorgangs abgerufen werden. Dieses Feld gilt nur für GET-Vorgänge.
    Anwenderdefinierte Header Anwenderdefinierte Header 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 gilt nur für GET-Vorgänge.
    Nachrichtennutzlast MessagePayload Zeichenfolge Nachrichtennutzlast, die als Teil der JMS-Nachricht während eines Abrufvorgangs abgerufen wird. Dieses Feld gilt nur für GET-Vorgänge.
    EccSysID EccSysID Zeichenfolge Enthält die Referenz-ID, die der von der Aktivität zurückgegebenen ECC-Warteschlangeneingabenachricht zugeordnet ist.
    Fehlernachrichten errorMessages Zeichenfolge Enthält alle Fehlermeldungen, die vom JMS-Befehl abgerufen wurden. Dieser Wert ist Null Wenn keine Fehlermeldungen vorhanden sind.