Handbuch

STS Handbuch

Stellwerksim Handbuch

Webseiten-Werkzeuge


Seitenleiste



JavaScript ist deaktiviert!

stellwerksim:erbauer:themascripte

ThemaScripte

Mit ThemaScripten können die Werte sowie das Verhalten eines Zuges angepasst werden. Dies kann pro Anlage, Zugtemplate und/oder Thema erfolgen.

Jeder ThemaScript-Block besitzt einen Blockkopf sowie den auszuführenden Befehlen. Die Befehle stehen dabei in Klammern direkt hinter dem Blockkopf.

Blockkopf(Befehle);
Nach jedem Block muss ein Semikolon gesetzt werden.

Der Befehl kann folgende Elemente enthalten:

Alle Befehle werden nach der Umgekehrt polnischen Notation (UPN) geschrieben.

Zum besseren Verständnis gibt es eine Liste von Beispielen. Ansonsten kann im Forum das ThemaScript-Team unterstützen.

ThemaScript-Liste

Alle ThemaScripte sind über die ThemaScript-Liste verfügbar. Grundsätzlich darf jeder Erbauer alle ThemaScripte ansehen.

Die meisten ThemaScripte sind, ähnlich wie Zugtemplates, einer Region zugeordnet. Die T-Designer dieser Region können neue ThemaScripte anlegen und bestehende Scripte der Region verändern und umbenennen. Der R-Admin kann zusätzlich ThemaScripte löschen sowie in Regionen, in denen er mindestens T-Designer ist, verschieben. Admins können alle ThemaScripte anlegen, bearbeiten und löschen.

Zum Anlegen neuer ThemaScripte gibt es rechts über der Liste eine Auswahl der Region sowie ein Eingabefeld für den Namen. Anschließen wird auf den ThemaScript-Editor weitergeleitet.

Der Name eines ThemaScripts muss innerhalb der Region eindeutig sein. Darüber hinaus gibt es besondere Namensregeln für Hooks

Filter

Die Liste erlaubt das Filtern nach allen Spalten. In der Spalte für die Region kann sowohl der Name als auch das Kürzel der Regio eingegeben werden.

Über der Liste gibt es drei weitere Filter:

  • Nach ThemaScripten, die bearbeitet werden können
  • Nach Regions- und Zughooks
  • Nach ThemaScripten, die eine Zeile mit einer bestimmten Zugtemplate-ID (TID) im Blockkopf enthalten (z.B. für Sonderbehandlung bei Länge oder Themamarker)

ThemaScript-Editor

Der Editor erlaubt alle weiteren Aktionen rund um das ThemaScript.

In der Titelleiste lassen sich (passende Rechte vorausgesetzt) Region und Name des ThemaScripts durch das Bearbeiten-Icon ändern.

In der Zeile darunter steht die aktuelle Version. Über den Knopf „wechseln…“ kann die Liste der vergangenen Versionen einschließlich der Änderungskommentare eingesehen werden - ein Klick auf eine andere Version öffnet den alten Stand im Nur-Lesen-Modus.

Wird ein anderes ThemaScript per Befehl sub eingebunden, wird dieses ThemaScript bei „Aufgerufene Themascripte“ aufgelistet und verlinkt.

Auf der rechten Seite kann per Knopfdruck die Liste von ThemaScripten und Zugtemplates aufgelistet werden, die das aktuelle ThemaScript verwenden (bei ThemaScripten als sub, bei Zugtemplates oder deren Zügen in den Werten).

Darunter sind die Knöpfe zum Öffnen des ThemaScript-Testers sowie dessen Ergebnis.

Solange keine Änderung am Script vorgenommen wurde ist der Speichern-Knopf ausgegraut. Das Speichern ist aber trotzdem möglich.

Zum Speichern oder Löschen des ThemaScripts muss ein Änderungskommentar eingegeben werden, der zum späteren Auffinden der Version wichtig ist. Außerdem bekommen die R-Admins der Region, der das ThemaScript zugewiesen ist, eine ComSys-Meldung über die Änderung.

stellwerksim/erbauer/themascripte.txt · Zuletzt geändert: 2021/04/14 15:57 von DevonFrosch