AESB

Last modified by Sabrina V. on 2024/08/23 08:48

Add Connection

Mit diesem Befehl können Sie eine Verbindung zum AESB SICS aufbauen und die Verbindungsdaten in einer ACMP Variablen, zur weiteren Verwendung, speichern.

ProtokollZur Auswahl stehen die Protokolle HTTP und HTTPS
ServerIP-Adresse oder Hostname vom AESB SICS Dienst
PortPort vom AESB SICS (Defaultport ist 3900)
BenutzernameBenutzer zur Verbindung mit dem AESB SICS
PasswortKennwort vom Benutzer
Verbindungs-TimeoutAngabe des Timeouts bei der Verbindung in Sekunden
Unverschlüsselte Verbindung zulassenBei aktiver Checkbox werden unverschlüsselte Verbindungen akzeptiert
Variable speichern unterACMP-Variable in der die Verbindungsdaten gespeichert werden

Consume

Mit diesem Befehl können Nachrichten aus den zuvor gesendeten Publish-Befehl abgerufen werden.

Verbindung

Siehe Befehl Add Connection.

Parameter

IDWird automatisch generiert. Über den Button (id-generieren) kann eine neue ID generiert werden. Freie Eingabe einer ID ist möglich.
Virtual RouterName des Virtual Routers in dem das Target erstellt wird
Name des TargetsName des Targets aus dem die Nachricht abgerufen wird
Auf Nachricht wartenBei aktivierter Einstellung wird auf die Nachricht gewartet
Warte-TimeoutAngabe in Millisekunden wie lange auf die Nachricht gewartet werden soll
Anzahl der Result-NachrichtenAnzahl der Result-Nachrichten auf die gewartet wird
Anzahl Ergebnis-NachrichtenAnzahl der Ergebnis-Nachrichten auf die gewartet wird

Body

Optional

Enthält eine ICQL-Nachricht im XML-Format. Eine ICQL-Nachricht sagt aus, welche Aktion mit welchen Werten auf der Gegenstelle ausgeführt werden soll.

Ergebnisse

Folgende Ergebnisse der Ausführung können in ACMP Variablen zur weiteren Verarbeitung gespeichert werden:

  • Fehlercode
  • Ergebnis
  • ACK Nachrichten
  • Ergebnisnachrichten

Create Target

Mit diesem Befehl können Sie im AESB SICS ein Target erstellen. Ein Target dient dazu, die vom ACMP Server gesendete Antwort vom Request zu speichern. Die Kommunikation zwischen AESB SICS und ACMP funktioniert asynchron, so dass man das Target wie eine Art Queue verstehen kann. Die Antwort beinhaltet dann das Ergebnis der Abfrage oder einen Fehlercode zur Fehlererkennung.

Verbindung

Siehe Befehl Add Connection.

Parameter

IDWird automatisch generiert. Über den Button (id-generieren) kann eine neue ID generiert werden. Freie Eingabe einer ID ist möglich.
Virtual RouterName des Virtual Routers in dem das Target erstellt wird
Name des TargetsName des Targets
Typ des TargetsidR. muss hier Queue eingetragen werden. Dies entspricht einer Warteschlange aus der die Daten bis zu einen SICS Dienstneustart vorgehalten werden.
Routing KeysRouting Key vom Ziel an dem die Nachricht verschickt wird

Body

Optional

Enthält eine ICQL-Nachricht im XML-Format. Eine ICQL-Nachricht sagt aus, welche Aktion mit welchen Werten auf der Gegenstelle ausgeführt werden soll. Nach dem Vorbild von WebService-Protokollen enthalten ICQL-Nachrichten also Steuerbefehle oder Daten oder beides.

Ergebnisse

Folgende Ergebnisse der Ausführung können in ACMP Variablen zur weiteren Verarbeitung gespeichert werden:

  • Fehlercode
  • Ergebnis
  • ACK Nachrichten
  • Ergebnisnachrichten

Publish

Mit diesem Befehl können Nachrichten im AESB SICS abgesetzt werden. Sie können hierüber z.B. die Ausführung eines Client Commands anstoßen. Das ist wie eine Art Remote Procedure Call über ein Internetprotokoll: die Nachricht ruft die Funktion des ACMP auf, die dieser über die Public API veröffentlicht.

Verbindung

Siehe Befehl Add Connection.

Parameter

IDWird automatisch generiert. Über den Button (id-generieren) kann eine neue ID generiert werden. Freie Eingabe einer ID ist möglich.
Virtual RouterName des Virtual Routers in dem das Target erstellt wird. An diesen wird die Nachricht gesendet
Routing Keys

Routing Key vom Ziel, an das die Nachricht verschickt wird.

Für den ACMP Server wäre der Routing Key:

?.Aagon.Components.ACMPServer.*

Exchange Type

ROUTING: Ein oder mehrere Empfänger werden anhand des Routing Keys  ermittel (Unterstützung von Platzhaltern help und Wildcardsstar)

DIRECT: Ein Empfänger wird per Name ermittelt. Die Angabe ist case insensitive.

TagsICQL (derzeit werden nur ICQL Messages versendet)
Callback virtual router (optional)Angabe vom Virtual Router an den die Antwort gesendet wird
Callback routing key (optional)Angabe des Routing Keys an den die Antwort gesendet wird

Body

Enthält eine ICQL-Nachricht im XML-Format. Eine ICQL-Nachricht sagt aus, welche Aktion mit welchen Werten auf der Gegenstelle ausgeführt werden soll.

Beispiel für eine Client Command Ausführung:

hmfile_hash_9fa499dd.png

Beispiel für die Client Command Ausführung

Ergebnisse

Folgende Ergebnisse der Ausführung können in ACMP Variablen zur weiteren Verarbeitung gespeichert werden:

  • Fehlercode
  • Ergebnis
  • ACK Nachrichten
  • Ergebnisnachrichten

Mögliche nächste Schritte: Client Command per Form Editor via AESB statisch an einen Client senden

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community