Documentation Index

Fetch the complete documentation index at: https://docs.lobstersoftware.com/llms.txt

Use this file to discover all available pages before exploring further.

Antwortweg AMQP

Prev Next

Über den Antwortweg AMQP veröffentlichen Sie Nachrichten an einen Broker. Derzeit wird ausschließlich AMQP 1.0 unterstützt.

Klickpfad

Integration > Profile > Phase 6 > Neuer Antwortweg > AMQP > [AMQP] Einstellungen

Einstellungen

Dieser Abschnitt beschreibt die Felder des Antwortwegs AMQP.

Einstellung

Beschreibung

Alias

Auswahl eines AMQP-1.0-Alias (siehe AMQP-1.0-Verbindungen). Pflichtfeld.

Typ

Legt fest, ob als Ziel eine Queue oder ein Topic verwendet wird.

RPC

Ist die Checkbox gesetzt, erfolgt der Aufruf synchron (Request/Response). Andernfalls wird asynchron gesendet. Bei aktiviertem RPC erscheinen zusätzliche Felder (siehe Abschnitt Einstellungen bei aktiviertem RPC).

Queue/Topic

Name der Queue bzw. des Topics, an die/das gesendet wird. Pflichtfeld. Manche Broker verlangen ein zusätzliches Präfix, z. B. queue: oder topic: bei SAP Event Mesh.

Persistent/Durable

Markiert die Message als „durable“; der Broker speichert sie dann nach Möglichkeit dauerhaft. Ob die Nachricht tatsächlich persistiert wird, hängt vom Broker und seinen Einstellungen ab. Gilt nicht für RPC.

Gesamten Job als gescheitert melden, wenn dieser Antwortweg fehlgeschlagen ist

Normalerweise gilt ein Job nicht unbedingt als gescheitert, wenn ein einzelner Antwortweg fehlschlägt (siehe Abschnitt Verhalten im Fehlerfall). Diese Option erzwingt, dass der gesamte Job als gescheitert gilt, wenn dieser Antwortweg fehlschlägt.

Zusätzlicher Text bei Fehler

Optionaler, zusätzlicher Log-Text für den Fehlerfall.

Einstellungen bei aktiviertem RPC

Bei aktiviertem RPC ist ein Folge-Profil erforderlich. Das Folge-Profil nimmt die vom RPC-Aufruf erzeugte Response entgegen.

Einstellung

Beschreibung

RPC Timeout

Gibt an (in Sekunden), wie lange das sendende Profil auf die RPC-Antwortnachricht wartet, die der AMQP-Broker auf der temporären Reply-Queue bereitstellt. Läuft dieser Timer ab, gilt der RPC-Aufruf selbst als fehlgeschlagen. Beispiel einer Fehlermeldung: „Got no response from AMQP 1.0 RPC call within 20000ms“.

Folge-Profil

Das angegebene Profil muss aktiv sein und einen Eingangsagenten des Typs Message haben.

Max. Verarbeit./Aufbw

Gibt die maximale Gesamtzeit (in Sekunden) für die Ausführung des Antwortwegs an, einschließlich Senden, Verarbeitung und etwaiger Wiederholungsversuche (Retries). Das konkrete Verhalten hängt vom Message-Typ ab (siehe Message-Typen). Die minimale Lebenszeit der Message beträgt 12 Stunden (unabhängig vom eingestellten Wert). Mit dem Retry-Mechanismus steuert dieser Wert zugleich das Wiederholungsverhalten aus den Verbindungs-Einstellungen (zulässige Ausführungszeit über alle Wiederholungsversuche hinweg).

Message-Typ

Art der Message. Mögliche Werte: Synchron, Asynchron, Persistent (siehe Abschnitt Message-Typen).

Message-Typen

Eine Message kann drei unterschiedliche Typen haben.

Message-Typ

Verhalten

Synchron

Das Profil sendet die Message und macht erst dann weiter, wenn die Antwort erfolgt ist. Es wartet, bis das Ziel-Profil seine Verarbeitung (erfolgreich oder mit Fehler) beendet hat. Wird dabei die unter Max. Verarbeit./Aufbw eingestellte Zeit überschritten, bricht der Antwortweg mit Fehler ab, obwohl das Ziel-Profil vielleicht später erfolgreich endet.

Asynchron

Das Profil sendet die Message und macht sofort weiter; die Antwort ist für die weitere Profilausführung unerheblich. Das Profil wartet nicht auf das Ziel-Profil, sondern der Antwortweg endet erfolgreich nach Übergabe der Daten. Die unter Max. Verarbeit./Aufbw. eingestellte Zeit ist die maximale Lebenszeit der Message; konnte sie in dieser Zeit nicht vom Ziel-Profil angenommen werden, wird sie gelöscht.

Persistent

Arbeitet analog zu Asynchron. Als Erweiterung wird aber bei fehlender Gegenstelle die Message abgespeichert und versucht alle 50 ms die Message zu senden. Konnte innerhalb der unter Max. Verarbeit./Aufbw. eingestellten Zeit kein Erfolg erreicht werden, geht die Message verloren.

AMQP Message Properties

Bei ausgehenden Verbindungen lassen sich bestimmte Eigenschaften einer Nachricht über Variablen setzen.

Application Properties

Jede AMQP-1.0-Nachricht kann eine beliebige Menge benutzerdefinierter Schlüssel-Wert-Properties tragen. Diese setzen Sie über AMQP_APPLICATION_PROPERTY_<key>. Der Teil <key> ist der Schlüssel der Property (Groß- und Kleinschreibung wird beachtet), der Wert der Variable ist der Wert der Property. In der Legacy-Implementierung wurden diese als „Header“ bezeichnet.

Beispiel: AMQP_APPLICATION_PROPERTY_<key> mit dem Wert 2345 erzeugt eine Property namens <key> mit dem Wert 2345.

Fixed Properties

AMQP-1.0-Nachrichten besitzen außerdem vordefinierte Properties, die Sie über AMQP_FIXED_PROPERTY_* setzen.

Die vollständige Liste der konfigurierbaren Properties und der zugehörigen Variablen finden Sie unter System-Variablen.

Body Type

Der Body Type wird über die Variable AMQP_FIXED_PROPERTY_BODY_TYPE mit den Werten value, data oder sequence gesetzt (Standard, falls nicht gesetzt: value).

Message ID und Correlation ID

Sind Message ID und Correlation ID nicht gesetzt, werden beide als automatisch generierte UUID-Werte erzeugt. Ist die Variable AMQP_SYS_MESSAGE_CORRELATION_ID_FORMAT nicht gesetzt oder enthält einen anderen Wert als string, long oder binary, gilt ebenfalls dieses UUID-Standardformat. Nur bei einem dieser drei Werte wird stattdessen das jeweils angegebene Format verwendet. Wird nur der Typ gesetzt, ohne über eine Variable eine Message ID bzw. Correlation ID anzugeben, wird die jeweilige ID automatisch im entsprechenden Typ generiert.