Last modified by jklein on 2025/02/13 13:15
From version 17.1
edited by jklein
on 2025/02/06 12:02
Change comment: There is no comment for this version
To version 21.1
edited by jklein
on 2025/02/06 13:26
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -24,7 +24,7 @@
24 24  1. Legen Sie einen neuen Ordner mit dem Namen //ISSACMPConnector// im Datei-Explorer an.
25 25  1. Klicken Sie mit einem Rechtsklick auf den neuen Ordner, um das Kontextmenü zu öffnen.
26 26  1. Wählen Sie im Kontextmenü den Eintrag //Mit Code öffnen //aus, damit direkt das richtige Verzeichnis geöffnet wird.
27 -1. Erstellen Sie eine neue Datei mit der Endung **//.psm1 //**(z.B. Microservice.psm1). Bei dieser Datei handelt es sich um ein PowerShell-Modul, in dem nun die Businesslogik implementiert werden kann.{{aagon.infobox}}Das Erstellen dieser Datei ist notwendig, damit eine PowerShell-Session mit dem Terminal in Visual Studio Code geöffnet wird.{{/aagon.infobox}}
27 +1. Erstellen Sie eine neue Datei mit der Endung **//.psm1 //**(z.B. Modul.psm1). Bei dieser Datei handelt es sich um ein PowerShell-Modul, in dem nun die Businesslogik implementiert werden kann.{{aagon.infobox}}Das Erstellen dieser Datei ist notwendig, damit eine PowerShell-Session mit dem Terminal in Visual Studio Code geöffnet wird.{{/aagon.infobox}}
28 28  1. Geben Sie im Terminal den Befehl //{{code language="PowerShell"}}code $profile{{/code}} //ein und bestätigen Sie mit der Eingabetaste. Nun öffnet sich die Datei //Microsoft.VSCode_profile.ps1//,// //mit der Sie das verwendete PowerShell-Profil anpassen können.
29 29  1. Fügen Sie den nachfolgenden Code in die Datei //Microsoft.VSCode_profile.ps1// ein. Beachten Sie, dass der angegebene Pfad für die AESB Shell korrekt ist.
30 30  1. Drücken Sie Strg + S, um die Datei zu speichern.
... ... @@ -124,7 +124,7 @@
124 124  1. Klicken Sie mit einem Rechtsklick auf den Ordner //ISS_ACMP_Connector//, um das Kontextmenü zu öffnen.
125 125  1. Wählen Sie im Kontextmenü den Eintrag //Mit Code öffnen //aus, damit direkt das richtige Verzeichnis geöffnet wird.
126 126  1. Erstellen Sie einen neuen Unterordner mit dem Namen //Modules.//
127 -1. Erstellen Sie im Unterordner //Modules //eine neue Datei mit dem Namen //ISSRestConnector.psm1//. Alternativ können Sie auch die anfangs erstellte, leere Datei //Microservice.psm1// umbenennen und in den Ordner verschieben.
127 +1. Erstellen Sie im Unterordner //Modules //eine neue Datei mit dem Namen //ISSRestConnector.psm1//. Alternativ können Sie auch die anfangs erstellte, leere Datei //Modul.psm1// umbenennen und in den Ordner verschieben.
128 128  1. Fügen Sie den nachfolgenden Code in die Datei ein.
129 129  1. Drücken Sie Strg + S, um die Datei zu speichern.
130 130  
... ... @@ -290,7 +290,7 @@
290 290  Die Funktionalität des erstellten Moduls können Sie mithilfe von Pester (dem Standard-Framework für Unit-Testing in PowerShell) oder eines dedizierten PowerShell Scripts verifizieren. So stellen Sie sicher, dass die Logik fehlerfrei und robust ist. In diesem Beispiel wird das Modul //ISSRestConnector.psm1// mit Pester 5.5.0 getestet.
291 291  
292 292  {{aagon.infobox}}
293 -Beachten Sie, dass Sie Pester für diesen Test ggf. vorher installieren oder updaten müssen. Weitere Informationen dazu finden Sie in der __[[Dokumentation von Pester>>https://pester.dev/docs/introduction/installation||rel=" noopener noreferrer" target="_blank"]]__.
293 +Beachten Sie, dass Sie Pester für diesen Test ggf. vorher installieren oder updaten müssen. Weitere Informationen dazu finden Sie in der __[[Dokumentation von Pester>>https://pester.dev/docs/introduction/installation||rel="noopener noreferrer" target="_blank"]]__.
294 294  {{/aagon.infobox}}
295 295  
296 296  Sie können das PowerShell-Modul folgendermaßen testen:
... ... @@ -371,7 +371,7 @@
371 371  (% class="wikigeneratedid" %)
372 372  [[image:Output_Pester Testing.png||alt="Ergebnis des Modul-Tests mit Pester" data-xwiki-image-style-alignment="center"]]
373 373  
374 -== PowerShell-Microservices in AESB erstellen ==
374 +== PowerShell-Microservices erstellen ==
375 375  
376 376  Da die benötigten PowerShell-Module nun erstellt und getestet sind, kann mit der Erstellung der Microservices begonnen werden.
377 377  
... ... @@ -378,15 +378,35 @@
378 378  1. Öffnen Sie die AESB Console und navigieren Sie zum Workspace //Creator - PowerShell//.
379 379  1. Klicken Sie in der Ribbonleiste im Bereich //Ordner //auf den Button //Hinzufügen// und erstellen Sie den Ordner// ISS ACMP Connector.//
380 380  1. Wählen Sie den Ordner aus und klicken Sie in der Ribbonleiste im Bereich //PowerShell-Vorlagen //auf den Button //Hinzufügen.//
381 -1. Erstellen Sie eine Vorlage// ISSRestConnector. //Klicken Sie in der Ribbonleiste auf den Button //Speichern.//
381 +1. Erstellen Sie die Vorlage// ISSRestConnector. //Klicken Sie in der Ribbonleiste auf den Button //Speichern.//
382 382  1. Wiederholen Sie Schritt 3 und Schritt 4 für die Erstellung der Vorlage //ISSAssetImporter//.
383 383  
384 -== PowerShell-Module in die PowerShell-Microservices integrieren ==
384 +== PowerShell-Module implementieren ==
385 385  
386 +Die Implementierung der Module in die PowerShell-Microservices erfolgt an zwei Stellen: In der Modul-Verwaltung und im Skript-Editor.
387 +
388 +=== PowerShell-Module in der Modul-Verwaltung hochladen ===
389 +
390 +Zunächst müssen Sie den einzelnen PowerShell-Vorlagen die jeweiligen Module zuweisen:
391 +
392 +1. Wählen Sie die PowerShell-Vorlage //ISSRestConnector //aus und klicken Sie in der Ribbonleiste auf den Button //Module//.
393 +1. Klicken Sie auf //DLL-/PSM1-/Public API-Module hinzufügen //und geben Sie bei //Dateipfad //den Pfad der Modul-Datei //ISSRestConnector.psm1// an, indem Sie die Datei im Datei-Explorer öffnen.{{aagon.infobox}}Bei korrekter Ordnerstruktur, sollte der Pfad 0000 angegeben werden.{{/aagon.infobox}}
394 +1. Klicken Sie auf den Button //Hinzufügen//, um das Modul hochzuladen und klicken Sie in der Modul-Verwaltung auf //OK//, um die Modul-Verwaltung zu schließen.
395 +1. Wiederholen Sie die Schritte für den Microservice ISSAssetImporter mit dem entsprechenden Modul //ISSAssetImporter.psm1//.
396 +
397 +-> Bild einfügen
398 +
399 +=== PowerShell-Module im Microservice-Skript aufrufen ===
400 +
401 +Die PowerShell-Module sind nun in der Modul-Verwaltung hochgeladen und können aus Microservice-Skripten heraus aufgerufen werden. Dafür werden nun die Skripte im Skript-Editor angepasst.
402 +
386 386  {{aagon.warnungsbox}}
387 -In diesem Beispiel werden nur die
404 +In diesem Beispiel werden nur die Event-Skripte angepasst, bei denen für dieses Beispiel eine Anpassung notwendig ist. Die nicht erwähnten Event-Skripte bleiben unverändert.
388 388  {{/aagon.warnungsbox}}
389 389  
407 +(% class="wikigeneratedid" %)
408 +
409 +
390 390  = Fehlerbehandlung =
391 391  
392 392  = Orchestrierung =
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community