Skripte

Das Herz der Automatisierung

Skripte bilden das Herzstück Ihrer Automatisierung. Ein Skript besteht aus einer Reihe von Aktionen, die in einen oder mehrere Abschnitte unterteilt sind.

Zur besseren Übersicht empfehlen wir, Ihre Skripte in einer Ordnerstruktur zu organisieren.

Konfiguration

Ein Skript hat die folgenden Konfigurationsoptionen:

Einstellung	Beschreibung
Name	Ein beschreibender Name für das Skript.
Tags	Bezeichnungen zur Kategorisierung und für die zufällige Skriptausführung.
In Steuerung anzeigen	Ob das Skript in der Registerkarte „Automatisieren" der Steuerung erscheint.
Deaktiviert	Ein deaktiviertes Skript kann nicht ausgeführt werden — weder manuell noch durch Ereignisse.
Notizen	Freitextnotizen zur Dokumentation des Skripts.

Wiederholung

Ein Skript kann auf Wiederholung gesetzt werden. Bei aktivierter Wiederholung führt das Skript alle Abschnitte aus und wertet dann die Wiederholungsbedingungen aus:

• Keine Wiederholungsbedingungen — Das Skript wiederholt sich unbegrenzt, bis Sie es manuell stoppen.

• Mit Wiederholungsbedingungen — Das Skript wiederholt sich nur, solange die Bedingungen erfüllt sind. Sie können mehrere Bedingungen mit UND (alle müssen erfüllt sein) oder ODER (eine muss erfüllt sein) kombinieren.

Automatisches Abbrechen

Bei Aktivierung wird das Skript nach einem konfigurierbaren Zeitlimit (in Millisekunden) automatisch abgebrochen. Dies ist ein Sicherheitsnetz, um zu verhindern, dass Skripte bei unerwarteten Situationen endlos laufen.

Benachrichtigung anzeigen

Bei Aktivierung wird eine Systembenachrichtigung angezeigt, wenn das Skript gestartet wird.

Ausführung

Ein Skript kann entweder manuell, durch ein Ereignis oder beides ausgelöst werden.

Manuell ausgelöste Skripte

Manuelle Skripte können über die Registerkarte „Automatisierung" ausgelöst werden.

Manuelle Skripte können über die Registerkarte „Automatisieren" der Steuerung oder innerhalb eines Fahrplans gestartet werden.

Ereignisgesteuerte Skripte

Skripte können durch Ereignisse ausgelöst werden, die aus folgenden Quellen stammen:

• Zubehör — Wenn ein Zubehörteil in einen bestimmten Zustand wechselt.

• Rückmeldesensoren — Wenn ein Sensor aktiv oder inaktiv wird, optional gefiltert nach einem bestimmten Fahrzeug (RailCom). Kann das erkannte Fahrzeug automatisch für das Skript auswählen.

• Fahrzeuge — Wenn sich Geschwindigkeit, Richtung, Funktion oder Profil eines Fahrzeugs ändert.

• Kameras — Wenn eine Kamera ein Fahrzeug an einem Erkennungspunkt erkennt.

• Zeit — Zu einem bestimmten Zeitpunkt (Stunde und/oder Minute). Unterstützt Platzhalter — beispielsweise jede Stunde bei Minute 30.

• Variablen — Wenn eine Variable einen bestimmten Wert erreicht.

• System — Wenn sich die Zentralstation verbindet (Start).

• Skripte — Wenn ein anderes Skript startet, endet oder abgebrochen wird.

Ein Skript kann mehrere Ausführungsereignisse definieren — jedes dieser Ereignisse löst das Skript aus.

Verschiedene Arten von Ausführungsereignissen

Ausführungsbedingungen

Ereignisbasierte Skripte können auch Bedingungen für die Ausführung definieren. Selbst wenn ein Ereignis ausgelöst wird, startet das Skript nur, wenn seine Bedingungen erfüllt sind. Sie können mehrere Bedingungen mit UND (alle müssen erfüllt sein) oder ODER (eine muss erfüllt sein) kombinieren.

Verschiedene Arten von Bedingungen

Bedingungen können für Zubehör, Rückmeldesensoren, Fahrzeugzustand, Funktionsschalter, Variablen oder Kameraerkennung definiert werden.

Abschnitte

Ihr Skript ist in Abschnitte unterteilt. Abschnitte dienen dazu, Ihre Aktionen in logische Gruppen zu ordnen und so den Überblick über die möglicherweise vielen aufeinanderfolgenden Schritte zu behalten. Beispielsweise könnten Sie Abschnitte wie „Abfahrt von Bahnhof A", „Fahrt nach Bahnhof B" und „Ankunft in Bahnhof B" anlegen.

Sie können Abschnitte über die Schaltflächen „Bearbeiten" und „Hinzufügen" in der oberen Leiste erstellen und ordnen.

Ausführungsprotokoll

Wenn ein Skript läuft, wird die Ausführung jeder Aktion protokolliert. Sie können das Protokoll einsehen, um genau zu sehen, was passiert ist, einschließlich Zeiten, Ergebnissen und aufgenommenen Bildern (z.B. von Kameraerkennung oder Fahrwegfindung). Dies ist hilfreich beim Debuggen von Skripten.

Beispiele

Zur Inspiration oder zum besseren Verständnis der Funktionen können Sie sich die Anleitungen oder Beispiele ansehen.