Skripte

Skripte bilden das Herzstück Ihrer Automatisierung. Ein Skript besteht aus einer Liste von Aktionen. Sie können Aktionen in Gruppen bündeln und mit Bedingungen je nach Zustand Ihrer Anlage unterschiedliche Aktionen ausführen.

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

Konfiguration

Ein Skript hat die folgenden Konfigurationsoptionen:

Konfiguration	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 Aktionen 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.
• Uhr — Wenn die Modelluhr eine bestimmte Zeit erreicht (Stunde und/oder Minute). Unterstützt Platzhalter — beispielsweise jede Stunde bei Minute 30. Setzt voraus, dass die Uhr läuft.
• 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 eine Bedingung für die Ausführung definieren. Selbst wenn ein Ereignis ausgelöst wird, startet das Skript nur, wenn die Bedingung erfüllt ist.

Verschiedene Arten von
Bedingungen

Siehe Bedingungen für die vollständige Liste der Regeltypen, die Sie kombinieren können.

Aktionen, Gruppen und Bedingungen

Ein Skript ist eine Liste von Aktionen, die von oben nach unten ausgeführt werden. Tippen Sie auf „+", um eine Aktion hinzuzufügen, und ziehen Sie Aktionen, um sie neu anzuordnen.

Um bei vielen Schritten den Überblick zu behalten, bündeln Sie Aktionen in Gruppen — zum Beispiel „Abfahrt von Bahnhof A", „Fahrt nach Bahnhof B" und „Ankunft in Bahnhof B". Eine Gruppe lässt sich einklappen, deaktivieren und wiederholen.

Um auf den Zustand Ihrer Anlage zu reagieren, verwenden Sie eine Bedingung: wenn ein Signal auf Rot steht, dann den Zug anhalten, sonst weiterfahren.

TIP

Skripte aus früheren Versionen waren in Abschnitte unterteilt. Diese werden automatisch in Gruppen umgewandelt.

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.