Wiki-Quellcode von Skript-Editor

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

version	line-number	content
1.1	1	{{aagon.floatingbox/}}
	2
2.1	3	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.
1.1	4
	5	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.
	6
	7	= Aufbau des Skript-Editors =
	8
3.1	9	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.
1.1	10
3.1	11	[[Aufbau des Skript-Editors>>image:Übersicht_Skript-Editor.png\|\|alt="Aufbau des Skript-Editors"]]
1.1	12
3.1	13	== Ribbonleiste ==
1.1	14
	15	In der Ribbonleiste stehen Ihnen folgende Funktionen zur Verfügung, mit denen Sie den Skript-Editor bedienen können:
	16
3.1	17	\|(% style="width:330px" %)Button\|(% style="width:1109px" %)Funktionen
	18	\|(% style="width:330px" %)Speichern (PowerShell-Skript)\|(% style="width:1109px" %)Speichert das bearbeitete PowerShell-Skript.
	19	\|(% style="width:330px" %)Zeigen (PowerShell-Skript)\|(% style="width:1109px" %)Öffnet das Skript als Gesamtansicht im Lesemodus. In der Gesamtansicht wird der Code der einzelnen Event-Tabs zusammen im Kontext der Ausführungslogik dargestellt.
	20	\|(% style="width:330px" %)Einstellungen (Editor)\|(% style="width:1109px" %)Ö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.
	21	\|(% style="width:330px" %)Hinzufügen (Assistent Konversation)\|(% style="width:1109px" %)Öffnet das Dialogfenster zum Hinzufügen einer Testkonfiguration.
	22	\|(% style="width:330px" %)Löschen (Assistent Konversation)\|(% style="width:1109px" %)Löscht die ausgewählte Testkonfiguration.
	23	\|(% style="width:330px" %)Hinzufügen (Testkonfiguration)\|(% style="width:1109px" %)Öffnet das Dialogfenster zum Hinzufügen einer Testkonfiguration.
	24	\|(% style="width:330px" %)Löschen (Testkonfiguration)\|(% style="width:1109px" %)Löscht die ausgewählte Testkonfiguration.
	25	\|(% style="width:330px" %)Starten (Tests)\|(% style="width:1109px" %)Öffnet ein Dialogfenster zur Auswahl der Testkonfigurationen, die gestartet werden sollen.
	26	\|(% style="width:330px" %)Beenden (Tests)\|(% style="width:1109px" %)Beendet alle laufenden Testkonfigurationen der PowerShell-Vorlage
	27	\|(% style="width:330px" %)Handbuch\|(% style="width:1109px" %)Öffnet die Webseite [[https:~~/~~/doc.aagon.com/bin/view/AESB>>https://doc.aagon.com/bin/view/AESB]] im Standard-Browser.
1.1	28
3.1	29	== Code-Editor ==
1.1	30
6.1	31	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.
3.1	32
4.1	33	{{aagon.infobox}}
	34	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.
	35	{{/aagon.infobox}}
	36
	37	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:
	38
3.1	39	* Global: In diesem Skript werden global verfügbare Funktionen oder Variablen definiert, die auf anderen Tabs des Editors verwendet werden können.
	40	* OnStart: Dieses Skript wird einmalig beim Starten des Microservices ausgeführt, um Initialisierungen oder Setup-Prozesse durchzuführen.
	41	* 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.
	42	* OnStop: Dieses Skript wird einmalig beim Stoppen des Microservices ausgeführt, um Bereinigungsprozesse oder das Abschalten der Logik zu steuern.
	43	* OnMessage: Dieses Skript wird jedes Mal ausgeführt, wenn der Microservice eine Nachricht empfängt, um auf eingehende Daten oder Events zu reagieren.
	44
4.1	45	{{aagon.infobox}}
	46	Mi dem Button //Zeigen //in der Ribbonleiste, können Sie sich das Skript mit allen Events in einer Gesamtansicht (read-only) anzeigen lassen.
	47	{{/aagon.infobox}}
	48
3.1	49	== KI-Assistent ==
	50
4.1	51	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>>doc:AESB.110.Workspaces.Einstellungen.Benutzer-Einstellungen.WebHome]]. In der geöffneten Konversation können Sie direkt Ihre Aufforderung eingeben. Sie können außerdem mehrere Konversations-Tabs nutzen.
	52
	53	{{aagon.warnungsbox}}
	54	Beachten Sie, dass die Nutzung des KI-Assistenten nicht mit einem Free Plan von OpenAI möglich ist.
	55	{{/aagon.warnungsbox}}
	56
	57	[[KI-Assistent im Skript-Editor>>image:Skript Editor_KI-Assistent.png\|\|alt="KI-Assistent im Skript-Editor"]]
	58
3.1	59	== Testkonfiguration ==
	60
4.1	61	Im Bereich //Testen //können Sie das aktuelle PowerShell-Skript mit individuellen Testkonfigurationen lokal ausführen lassen. Dazu müssen Sie im [[Schema-Designer>>doc:AESB.19.Workspaces.Powershell.Schema-Designer.WebHome]] 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.
1.1	62
4.1	63	[[Testkonfiguration mit Zeitplanung im Skript-Editor>>image:Skript Editor_Testkonfiguration.png\|\|alt="Testkonfiguration im Skript-Editor"]]
	64
1.1	65	= Eine Testkonfiguration ausführen =
	66
4.1	67	Für die Durchführung einer Testkonfiguration muss das PowerShell-Skript durch ein Microservice-Schema vom [[Schema-Designer>>doc:AESB.110.Workspaces.Powershell.Schema-Designer.WebHome]] 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.
1.1	68
	69	Sobald eine Testkonfiguration gestartet wurde, läuft diese im Hintergrund auch weiter, wenn Sie den Skript-Editor schließen.
	70
	71	{{aagon.infobox}}
	72	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.
	73	{{/aagon.infobox}}
	74
	75	== Testkonfigurationen speichern ==
	76
	77	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.//
	78
	79	{{aagon.infobox}}
	80	Beim Exportieren einer PowerShell-Vorlage bleiben gespeicherte Testkonfigurationen erhalten und werden mit exportiert.
	81	{{/aagon.infobox}}