Skript-Editor

Zuletzt geändert von Jannis Klein am 2025/02/06 08:46

Im Skript-Editor haben Sie die Möglichkeit, den Code einer bestehenden PowerShell-Vorlage zu bearbeiten und das Skript direkt als Testkonfiguration mit dem Microservice-Schema zu testen. 

Um eine PowerShell-Vorlage im Skript-Editor zu öffnen, wählen Sie die PowerShell-Vorlage aus und klicken Sie in der Ribbonleiste auf den Button Skript. Geben Sie ggf. anschließend in der Passwortabfrage Ihr Passwort als Operator ein, wenn Sie auch die Testkonfigurationen bearbeiten möchten. Ansonsten können Sie das Fenster einfach schließen. Der PowerShell-Editor öffnet den Code der auswählten Vorlage nun in einem neuen Fenster.

Aufbau des Skript-Editors

Der Skript-Editor lässt sich in drei Bereiche unterteilen: die Ribbonleiste, den Code-Editor mit den einzelnen Event-Tabs und den Bereich mit dem KI-Assistenten bzw. mit den Testkonfigurationen.

Aufbau des Skript-Editors

Aufbau des Skript-Editors

Ribbonleiste

In der Ribbonleiste stehen Ihnen folgende Funktionen zur Verfügung, mit denen Sie den Skript-Editor bedienen können:

ButtonFunktionen
Speichern (PowerShell-Skript)Speichert das bearbeitete PowerShell-Skript.
Zeigen (PowerShell-Skript)Öffnet das Skript als Gesamtansicht im Lesemodus. In der Gesamtansicht wird der Code der einzelnen Event-Tabs zusammen im Kontext der Ausführungslogik dargestellt.
Einstellungen (Editor)Öffnet ein Fenster zum Anpassen der Schriftgröße und des Layouts. Außerdem können das Logging-Verhalten und die Console festgelegt werden, in der die Testkonfigurationen ausgeführt werden.
Hinzufügen (Assistent Konversation)Öffnet das Dialogfenster zum Hinzufügen einer Testkonfiguration.
Löschen (Assistent Konversation)Löscht die ausgewählte Testkonfiguration.
Hinzufügen (Testkonfiguration)Öffnet das Dialogfenster zum Hinzufügen einer Testkonfiguration.
Löschen (Testkonfiguration)Löscht die ausgewählte Testkonfiguration.
Starten (Tests)Öffnet ein Dialogfenster zur Auswahl der Testkonfigurationen, die gestartet werden sollen.
Beenden (Tests)Beendet alle laufenden Testkonfigurationen der PowerShell-Vorlage
HandbuchÖffnet die Webseite https://doc.aagon.com/bin/view/AESB im Standard-Browser.

Code-Editor

Im Code-Editor können Sie den Code des PowerShell-Skripts bearbeiten. Dafür stehen Ihnen die Standard-Funktionen wie Ausschneiden, Kopieren, Einfügen und Löschen zur Verfügung. Diese können Sie über die Standard-Shortcuts oder das Kontextmenü nutzen.

Hinweis  Hinweis: 

Der Code-Editor verfügt über eine Auto-Vervollständigung, bei der Sie Vorschläge mit der Tabulator- oder der Enter-Taste bestätigt können. Syntaxfehler werden in der Fehlerliste angezeigt.

Bei den unterschiedlichen Skript-Tabs (Global, OnStart, OnExecute, OnStop, OnMessage) handelt es sich um die verschiedenen Events. Durch diese Aufteilung können Sie die einzelne Aktionen für jedes Event übersichtlich festlegen. Folgende Events sind mit den die Skript-Tabs definierbar:

  • Global: In diesem Skript werden global verfügbare Funktionen oder Variablen definiert, die auf anderen Tabs des Editors verwendet werden können.
  • OnStart: Dieses Skript wird einmalig beim Starten des Microservices ausgeführt, um Initialisierungen oder Setup-Prozesse durchzuführen.
  • OnExecute: Dieses Skript wird nur dann ausgeführt, wenn der Scheduler des Microservices aktiviert und entsprechend konfiguriert ist, um periodische Aufgaben oder Aufgaben nach einem festgelegten Zeitplan zu steuern.
  • OnStop: Dieses Skript wird einmalig beim Stoppen des Microservices ausgeführt, um Bereinigungsprozesse oder das Abschalten der Logik zu steuern.
  • OnMessage: Dieses Skript wird jedes Mal ausgeführt, wenn der Microservice eine Nachricht empfängt, um auf eingehende Daten oder Events zu reagieren.

Hinweis  Hinweis: 

Mi dem Button Zeigen in der Ribbonleiste, können Sie sich das Skript mit allen Events in einer Gesamtansicht (read-only) anzeigen lassen. 

KI-Assistent

Der KI-Assistent kann Sie bei Aufgaben rund um PowerShell-Skripte unterstützen. Damit Sie den KI-Assistenten nutzen können, müssen Sie einen API-Schlüssel in den Benutzer-Einstellungen hinzufügen. In der geöffneten Konversation können Sie direkt Ihre Aufforderung eingeben. Sie können außerdem mehrere Konversations-Tabs nutzen.

Warning  Achtung: 

Beachten Sie, dass die Nutzung des KI-Assistenten nicht mit einem Free Plan von OpenAI möglich ist.

KI-Assistent im Skript-Editor

KI-Assistent im Skript-Editor

Testkonfiguration

Im Bereich Testen können Sie das aktuelle PowerShell-Skript mit individuellen Testkonfigurationen lokal ausführen lassen. Dazu müssen Sie im Schema-Designer mindestens eine Schema-Konfiguration erstellt haben. Sie können mehrere mit den Tabs mehrere Testkonfigurationen anlegen und parallel ausführen. Mit dem Button Bearbeiten können Sie die Testkonfigurationen konfigurieren und mit Hilfe der Zeitplanung auch den Zeitpunkt der Ausführung steuern.

Testkonfiguration im Skript-Editor

Testkonfiguration mit Zeitplanung im Skript-Editor

Eine Testkonfiguration ausführen

Für die Durchführung einer Testkonfiguration muss das PowerShell-Skript durch ein Microservice-Schema vom Schema-Designer mit Testeingaben belegt werden. Die Testeingaben können Sie dann im Bereich Konfiguration mit Werten definieren. Anschließend können Sie die Durchführung der Testkonfiguration mit den Buttons in der Menüleiste starten. Für die Ausgabe der Ergebnisse öffnet sich die Console, die in den Einstellungen des Skript-Editors ausgewählt ist.

Sobald eine Testkonfiguration gestartet wurde, läuft diese im Hintergrund auch weiter, wenn Sie den Skript-Editor schließen.

Hinweis  Hinweis: 

Bevor Sie die AESB Console schließen können, müssen alle laufenden Testkonfigurationen beendet sein. Sollten beim Schließen der Console noch Testkonfigurationen aktiv sein, erhalten Sie eine Information, bevor sich die Console beendet.

Testkonfigurationen speichern

Wenn Sie Ihre Testeingabe für weitere Testkonfigurationen sichern möchten, klicken Sie in der Menüleiste im Bereich der Testkonfiguration auf den Button Speichern.

Hinweis  Hinweis: 

Beim Exportieren einer PowerShell-Vorlage bleiben gespeicherte Testkonfigurationen erhalten und werden mit exportiert.

© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community