Ü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. |
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 Wert2345erzeugt eine Property namens<key>mit dem Wert2345.
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.