Wiki source code of Best Practices

Last modified by Jannis Klein on 2025/01/10 08:06

version	line-number	content
1.1	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
2.1	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.
1.1	8
2.1	9	Zunächst müssen Sie den Alias für Ihre Verbindung mit folgenden Befehlen anlegen:
	10
3.1	11	{{code language="powershell"}}
2.1	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
3.1	24	{{code language="powershell"}}
2.1	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
1.1	44	= Senden und Empfangen von Objekten =
4.1	45
5.1	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:
4.1	47
5.1	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
6.1	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:
5.1	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}}