Wiki-Quellcode von Best Practices
Zuletzt geändert von Jannis Klein am 2025/01/10 08:06
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{aagon.floatingbox/}} | ||
| 2 | |||
| 3 | Auf dieser Seite finden Sie verschiedene Beispiele, wie Sie mit der AESB Shell arbeiten und Ihre Prozesse optimieren und automatisieren können. | ||
| 4 | |||
| 5 | = Anlegen eines Alias = | ||
| 6 | |||
| 7 | Um die Kommunikation über die AESB Shell zu vereinfachen, können Sie Aliasse nutzen. Mit Hilfe des Qualified Name Services (QNS) ist es möglich, einen Alias dauerhaft zu speichern und ihn somit über die Session hinaus in AESB bereitzustellen. | ||
| 8 | |||
| 9 | Zunächst müssen Sie den Alias für Ihre Verbindung mit folgenden Befehlen anlegen: | ||
| 10 | |||
| 11 | {{code language="powershell"}} | ||
| 12 | PS > Add-AESBAlias -Alias MyAlias | ||
| 13 | Message sent successfully | ||
| 14 | PS > Get-AESBAlias -Alias MyAlias | ||
| 15 | |||
| 16 | Name Creator CreationTime RoutingPairList | ||
| 17 | ---- ------- ------------ --------------- | ||
| 18 | MyAlias Operator 26.11.2024 13:50:34 {} | ||
| 19 | {{/code}} | ||
| 20 | |||
| 21 | (% class="wikigeneratedid" %) | ||
| 22 | Der Alias wurde nun angelegt. Im nächsten Schritt müssen Sie nun die Routing-Informationen zum Alias ergänzen. Um die Informationen zu ergänzen, führen Sie die folgenden Befehle aus: | ||
| 23 | |||
| 24 | {{code language="powershell"}} | ||
| 25 | PS > $connectionInfo = Get-AESBConnectionInfo | ||
| 26 | PS > $connectionInfo | ||
| 27 | |||
| 28 | EndPoint VirtualRouter RoutingKey | ||
| 29 | -------- ------------- ---------- | ||
| 30 | wss://localhost:3950 SHELL SICS.Aagon.Shell.local.5b2fcb59-cf15-44d7-8a7c-88fbf0c644e8 | ||
| 31 | |||
| 32 | PS > Add-AESBRoutingToAlias -Alias MyAlias -VirtualRouter $connectionInfo.VirtualRouter -RoutingKey $connectionInfo.RoutingKey | ||
| 33 | Message sent successfully | ||
| 34 | PS > Get-AESBAlias -Alias MyAlias | ||
| 35 | |||
| 36 | Name Creator CreationTime RoutingPairList | ||
| 37 | ---- ------- ------------ --------------- | ||
| 38 | MyAlias Operator 26.11.2024 13:50:34 {(SHELL, SICS.Aagon.Shell.local.5b2fcb59-cf15-44d7-8a7c-88fbf0c644e8)} | ||
| 39 | {{/code}} | ||
| 40 | |||
| 41 | (% class="wikigeneratedid" %) | ||
| 42 | Die Routing-Informationen sind nun ergänzt und der Alias kann genutzt werden. | ||
| 43 | |||
| 44 | = Senden und Empfangen von Objekten = | ||
| 45 | |||
| 46 | Mit der AESB Shell haben Sie die Möglichkeit, Objekte unkompliziert zu versenden und zu empfangen. Dafür werden Objekte vor dem Versenden in ein ICQL-Format konvertiert und nach dem Empfangen zurück konvertiert. Der Ablauf von Senden und Empfangen von Objekten sieht dabei folgendermaßen aus: | ||
| 47 | |||
| 48 | {{code language="powershell"}} | ||
| 49 | PS > $myObject | ||
| 50 | |||
| 51 | Name Age Occupation IsActive | ||
| 52 | ---- --- ---------- -------- | ||
| 53 | John Doe 30 Software Developer True | ||
| 54 | |||
| 55 | PS > $message = ConvertTo-AESBIcql -InputObject $myObject | ||
| 56 | PS > Publish-AESBMessage -Alias MyAlias -Message $message | ||
| 57 | Message sent successfully | ||
| 58 | {{/code}} | ||
| 59 | |||
| 60 | In diesem Schritt wurde das Objekt erfolgreich konvertiert und an den Alias //MyAlias// versendet. Nun kann das Objekt vom Empfänger abgerufen und erneut umgewandelt werden: | ||
| 61 | |||
| 62 | {{code language="powershell"}} | ||
| 63 | PS > $receivedMessage = Receive-AESBMessage | ||
| 64 | PS > $receivedObject = ConvertFrom-AESBIcql -Icql $receivedMessage | ||
| 65 | PS > $receivedObject | ||
| 66 | |||
| 67 | Name Age Occupation IsActive | ||
| 68 | ---- --- ---------- -------- | ||
| 69 | John Doe 30 Software Developer True | ||
| 70 | {{/code}} |