Wiki-Quellcode von AESB
Zuletzt geändert von Jannis Klein am 2024/03/19 17:56
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{aagon.priorisierung}} | ||
| 2 | 20 | ||
| 3 | {{/aagon.priorisierung}} | ||
| 4 | |||
| 5 | {{aagon.floatingbox/}} | ||
| 6 | |||
| 7 | = Add Connection = | ||
| 8 | |||
| 9 | Mit diesem Befehl können Sie eine Verbindung zum AESB SICS aufbauen und die Verbindungsdaten in einer ACMP Variablen, zur weiteren Verwendung, speichern. | ||
| 10 | |||
| 11 | |(% style="width:341px" %)Protokoll|(% style="width:861px" %)Zur Auswahl stehen die Protokolle HTTP und HTTPS | ||
| 12 | |(% style="width:341px" %)Server|(% style="width:861px" %)IP-Adresse oder Hostname vom AESB SICS Dienst | ||
| 13 | |(% style="width:341px" %)Port|(% style="width:861px" %)Port vom AESB SICS (Defaultport ist 3900) | ||
| 14 | |(% style="width:341px" %)Benutzername|(% style="width:861px" %)Benutzer zur Verbindung mit dem AESB SICS | ||
| 15 | |(% style="width:341px" %)Passwort|(% style="width:861px" %)Kennwort vom Benutzer | ||
| 16 | |(% style="width:341px" %)Verbindungs-Timeout|(% style="width:861px" %)Angabe des Timeouts bei der Verbindung in Sekunden | ||
| 17 | |(% style="width:341px" %)Unverschlüsselte Verbindung zulassen|(% style="width:861px" %)Bei aktiver Checkbox werden unverschlüsselte Verbindungen akzeptiert | ||
| 18 | |(% style="width:341px" %)Variable speichern unter|(% style="width:861px" %)ACMP-Variable in der die Verbindungsdaten gespeichert werden | ||
| 19 | |||
| 20 | = Consume = | ||
| 21 | |||
| 22 | Mit diesem Befehl können Nachrichten aus den zuvor gesendeten Publish-Befehl abgerufen werden. | ||
| 23 | |||
| 24 | |||
| 25 | **Verbindung** | ||
| 26 | |||
| 27 | Siehe Befehl [[Add Connection>>doc:||anchor="HAddConnection"]]. | ||
| 28 | |||
| 29 | **Parameter** | ||
| 30 | |||
| 31 | |ID|Wird automatisch generiert. Über den Button ([[image:https://manual.aagon.com/acmp/de/61/id-generieren_zoom80.png||alt="id-generieren" height="23" width="20"]]) kann eine neue ID generiert werden. Freie Eingabe einer ID ist möglich. | ||
| 32 | |Virtual Router|Name des Virtual Routers in dem das Target erstellt wird | ||
| 33 | |Name des Targets|Name des Targets aus dem die Nachricht abgerufen wird | ||
| 34 | |Auf Nachricht warten|Bei aktivierter Einstellung wird auf die Nachricht gewartet | ||
| 35 | |Warte-Timeout|Angabe in Millisekunden wie lange auf die Nachricht gewartet werden soll | ||
| 36 | |Anzahl der Result-Nachrichten|Anzahl der Result-Nachrichten auf die gewartet wird | ||
| 37 | |Anzahl Ergebnis-Nachrichten|Anzahl der Ergebnis-Nachrichten auf die gewartet wird | ||
| 38 | |||
| 39 | **Body** | ||
| 40 | |||
| 41 | Optional | ||
| 42 | |||
| 43 | 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. | ||
| 44 | |||
| 45 | **Ergebnisse** | ||
| 46 | |||
| 47 | Folgende Ergebnisse der Ausführung können in ACMP Variablen zur weiteren Verarbeitung gespeichert werden: | ||
| 48 | |||
| 49 | * Fehlercode | ||
| 50 | * Ergebnis | ||
| 51 | * ACK Nachrichten | ||
| 52 | * Ergebnisnachrichten | ||
| 53 | |||
| 54 | = Create Target = | ||
| 55 | |||
| 56 | 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. | ||
| 57 | |||
| 58 | **Verbindung** | ||
| 59 | |||
| 60 | Siehe Befehl [[Add Connection>>doc:||anchor="HAddConnection"]]. | ||
| 61 | |||
| 62 | **Parameter** | ||
| 63 | |||
| 64 | |ID|Wird automatisch generiert. Über den Button ([[image:https://manual.aagon.com/acmp/de/61/id-generieren_zoom80.png||alt="id-generieren" height="23" width="20"]]) kann eine neue ID generiert werden. Freie Eingabe einer ID ist möglich. | ||
| 65 | |Virtual Router|Name des Virtual Routers in dem das Target erstellt wird | ||
| 66 | |Name des Targets|Name des Targets | ||
| 67 | |Typ des Targets|idR. muss hier Queue eingetragen werden. Dies entspricht einer Warteschlange aus der die Daten bis zu einen SICS Dienstneustart vorgehalten werden. | ||
| 68 | |Routing Keys|Routing Key vom Ziel an dem die Nachricht verschickt wird | ||
| 69 | |||
| 70 | **Body** | ||
| 71 | |||
| 72 | Optional | ||
| 73 | |||
| 74 | 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. | ||
| 75 | |||
| 76 | **Ergebnisse** | ||
| 77 | |||
| 78 | Folgende Ergebnisse der Ausführung können in ACMP Variablen zur weiteren Verarbeitung gespeichert werden: | ||
| 79 | |||
| 80 | * Fehlercode | ||
| 81 | * Ergebnis | ||
| 82 | * ACK Nachrichten | ||
| 83 | * Ergebnisnachrichten | ||
| 84 | |||
| 85 | = Publish = | ||
| 86 | |||
| 87 | 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. | ||
| 88 | |||
| 89 | **Verbindung** | ||
| 90 | |||
| 91 | Siehe Befehl [[Add Connection>>doc:||anchor="HAddConnection"]]. | ||
| 92 | |||
| 93 | **Parameter** | ||
| 94 | |||
| 95 | |ID|Wird automatisch generiert. Über den Button ([[image:https://manual.aagon.com/acmp/de/61/id-generieren_zoom80.png||alt="id-generieren" height="23" width="20"]]) kann eine neue ID generiert werden. Freie Eingabe einer ID ist möglich. | ||
| 96 | |Virtual Router|Name des Virtual Routers in dem das Target erstellt wird. An diesen wird die Nachricht gesendet | ||
| 97 | |Routing Keys|((( | ||
| 98 | Routing Key vom Ziel, an das die Nachricht verschickt wird. | ||
| 99 | |||
| 100 | Für den ACMP Server wäre der Routing Key: | ||
| 101 | |||
| 102 | ?.Aagon.Components.ACMPServer.* | ||
| 103 | ))) | ||
| 104 | |Exchange Type|((( | ||
| 105 | ROUTING: Ein oder mehrere Empfänger werden anhand des Routing Keys ermittel (Unterstützung von Platzhaltern (?) und Wildcards(*)) | ||
| 106 | |||
| 107 | DIRECT: Ein Empfänger wird per Name ermittelt. Die Angabe ist case insensitive. | ||
| 108 | ))) | ||
| 109 | |Tags|ICQL (derzeit werden nur ICQL Messages versendet) | ||
| 110 | |Callback virtual router (optional)|Angabe vom Virtual Router an den die Antwort gesendet wird | ||
| 111 | |Callback routing key (optional)|Angabe des Routing Keys an den die Antwort gesendet wird | ||
| 112 | |||
| 113 | **Body** | ||
| 114 | |||
| 115 | 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. | ||
| 116 | |||
| 117 | Beispiel für eine Client Command Ausführung: | ||
| 118 | |||
| 119 | {{figure}} | ||
| 120 | (% style="text-align:center" %) | ||
| 121 | [[image:hmfile_hash_9fa499dd.png]] | ||
| 122 | |||
| 123 | {{figureCaption}} | ||
| 124 | Beispiel für die Client Command Ausführung | ||
| 125 | {{/figureCaption}} | ||
| 126 | {{/figure}} | ||
| 127 | |||
| 128 | **Ergebnisse** | ||
| 129 | |||
| 130 | Folgende Ergebnisse der Ausführung können in ACMP Variablen zur weiteren Verarbeitung gespeichert werden: | ||
| 131 | |||
| 132 | * Fehlercode | ||
| 133 | * Ergebnis | ||
| 134 | * ACK Nachrichten | ||
| 135 | * Ergebnisnachrichten | ||
| 136 | |||
| 137 | Mögliche nächste Schritte: [[Client Command per Form Editor via AESB statisch an einen Client senden>>doc:ACMP.64.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.AESB.Client Command per Form Editor via AESB statisch an einen Client senden.WebHome]] |