Zum Inhalt springen

JMS Sendeaktivität

Einführung

Eine JMS Aktivität Senden unter Verwendung ihrer JMS -Verbindung, sendet Nachrichten an eine JMS Warteschlange oder ein JMS-Thema und soll als Ziel in einer Operation verwendet werden.

Erstellen einer JMS Sendeaktivität

Eine Instanz einer JMS Aktivität Senden wird aus einer JMS -Verbindung erstellt mithilfe des Aktivitätstyps Senden.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene JMS Aktivität Senden kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer JMS Sendeaktivität

Führen Sie die folgenden Schritte aus, um eine JMS Aktivität Senden zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie die Einstellungen für die gesendeten Nachrichten fest. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

JMS Send-Aktivitätskonfiguration, Schritt 1

Tipp

Felder mit variablem Symbol Unterstützung der Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede JMS -Send-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

  • Zieltyp: Wählen Sie das Ziel der zu sendenden Nachrichten aus, entweder Warteschlange oder Thema.

    • Warteschlange: Wählen Sie aus, um eine Nachricht an eine Warteschlange zu senden.

    • Thema: Wählen Sie aus, um eine Nachricht an ein Thema zu senden.

  • Warteschlangenname / Themenname: Geben Sie je nach Zieltyp den Namen der Warteschlange oder des Themas ein, an das die Nachricht gesendet werden soll.

    Notiz

    Wenn Sie IBM MQ als JMS Anbieter verwenden, muss der Warteschlangenname oder Themenname mit dem Namen einer vorhandenen Warteschlange oder eines vorhandenen Themas in der IBM MQ-Instanz übereinstimmen, andernfalls tritt ein Fehler auf. Wenn Sie Active MQ als JMS Anbieter verwenden, wird eine Warteschlange oder ein Thema erstellt, wenn keine vorhandene Warteschlange oder kein vorhandenes Thema mit einem Namen vorhanden ist, der dem eingegebenen Namen entspricht.

  • Nachrichtentyp: Geben Sie den zu verwendenden Nachrichtentyp an, entweder Text oder Byte.

  • Übermittlungsmodus: Geben Sie den zu verwendenden Übermittlungsmodus an, entweder Persistent oder Nicht persistent. Wenn Persistent ausgewählt ist, werden Nachrichten auf einer Festplatte oder in einer Datenbank gespeichert, sodass sie einen Neustart des Brokers überstehen. Wenn Nicht persistent ausgewählt ist, gehen alle Nachrichten während der Übertragung bei einem Neustart des Brokers verloren.

  • Priorität: Geben Sie die Priorität der Nachricht in ganzen Zahlen ein 0(niedrigste) bis 9(höchste). Der Standardwert ist 4.

  • Lebensdauer (Millisekunden): Geben Sie die Zeit in Millisekunden ein, die die Nachrichten in der Warteschlange oder im Thema verbleiben sollen. Der Standardwert ist 0, was bedeutet, dass die Nachricht auf unbestimmte Zeit in der Warteschlange oder im Thema verbleibt.

  • Speichern und beenden: Klicken Sie, wenn aktiviert, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

JMS Send-Aktivitätskonfiguration, Schritt 2

  • Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

    Notiz

    Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

    Die Anforderungs- und Antwortdatenschemata bestehen aus diesen Knoten und Feldern:

    Schemaknoten/-feld anfordern Beschreibung
    sendMessageRequest Knoten, der die Nachrichtenanforderung darstellt
    messageBody Der Hauptteil der JMS -Nachricht
    replyTo Das Antwortziel
    JMSCorrelationID Die Korrelations-ID (wenn keine Korrelations-ID eingegeben wird, wird zur Laufzeit automatisch eine generiert)
    customMessageProperties Knoten, der die benutzerdefinierten Nachrichteneigenschaften darstellt
    customMessagePropertyString Knoten, der den Inhalt der benutzerdefinierten Nachrichteneigenschaften darstellt, die in Form einer Zeichenfolge vorliegen
    item Knoten, der die Nachricht mit benutzerdefinierten Eigenschaften darstellt
    name Der Name der benutzerdefinierten Eigenschaft
    value Der Wert der benutzerdefinierten Eigenschaft
    customMessagePropertyInteger Knoten, der die benutzerdefinierten Nachrichteneigenschaften im Format einer Ganzzahl darstellt
    item Knoten, der den Inhalt der benutzerdefinierten Nachrichteneigenschaften darstellt
    name Der Name der benutzerdefinierten Eigenschaft
    value Der Wert der benutzerdefinierten Eigenschaft
    customMessagePropertyFloat Knoten, der die benutzerdefinierten Nachrichteneigenschaften in Float-Form darstellt
    item Knoten, der den Inhalt der benutzerdefinierten Nachrichteneigenschaften darstellt
    name Der Name der benutzerdefinierten Eigenschaft
    value Der Wert der benutzerdefinierten Eigenschaft
    customMessagePropertyDouble Knoten, der die benutzerdefinierten Nachrichteneigenschaften darstellt, die in Form eines doppelten vorliegen.
    item Knoten, der den Inhalt der benutzerdefinierten Nachrichteneigenschaften darstellt
    name Der Name der benutzerdefinierten Eigenschaft
    value Der Wert der benutzerdefinierten Eigenschaft
    customMessagePropertyBoolean Knoten, der die benutzerdefinierten Nachrichteneigenschaften darstellt, die in Form eines Booleschen Werts vorliegen
    item Knoten, der den Inhalt der benutzerdefinierten Nachrichteneigenschaften darstellt
    name Der Name der benutzerdefinierten Eigenschaft
    value Der Wert der benutzerdefinierten Eigenschaft
    Antwortschemaknoten/-feld Beschreibung
    sendMessageResponse Knoten, der die Antwort darstellt
    isSent Boolescher Wert, der den Status der Nachricht darstellt mit true zeigt an, dass die Nachricht gesendet wurde
    JMSCorrelationID Zeichenfolge, die die Korrelations-ID enthält
    errorDetails Knoten, der die Fehlerdetails darstellt
    errorCode Zeichenfolge, die alle zutreffenden Fehlercodes enthält
    errorMsg Zeichenfolge, die alle zutreffenden Fehlermeldungen enthält

  • Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol oder das Wort Aktualisieren, um Schemas vom JMS Endpoint neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine JMS Aktivität Senden konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Operationen zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü“ in Connector-Grundlagen.

JMS Send-Aktivitäten können als Ziel mit diesen Operation verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.