Changes for page Best Practices

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -4,5 +4,67 @@
4	4
5	5	= Anlegen eines Alias =
6	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.
7	7
	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	+
8	8	= 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 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}}