XmlScript-Kurzanleitung

Inhalt → Objekte → Aktionen

• Aktionen definieren | Aktions-Steuerung | Aktions-Bedingung | XML-Skripte | Beispiele | Beispiel 2 Bahnübergang
  • Kurzanleitung

Diese kleine Anleitung wird versuchen Kenntnisse zu vermitteln, wie XmlScript-Aktionen in Rocrail verwendet werden.

• Wissen, wie Aktionen angelegt werden.
• Wissen, wie Aktionen mit Objekten verknüpft werden.
• Kenntnisse einiger XML-Grundlagen.
• Eine Rocrail-Installation mit Revision 10289+.

Dieses Kapitel wird in wenigen Schritten zeigen, wie ein XmlScript verwendet werden kann.

• plan-1.xml.zip

Der Gleisplan ist sehr einfach und enthält nur einen Taster b1 und ein Textfeld t1
Ziel ist, mit dem Taster ein XmlScript auszulösen, das "Hello world!" im Textfeld anzeigt.

1. Erzeugen einer Aktion mit der Kennung script1.
2. In das Befehl-Datei-Feld script1.xml schreiben.
3. Auf die Edit-Schaltfläche klicken.

Nach Klick auf die Edit-Schaltfläche öffnet sich der XmlScript-Editor mit einem XmlScript-Gerüst:

1. Den Cursor im XmlScript-Editor irgendwo zwischen <xmlscript> und </xmlscript> platzieren.
2. In der Anweisung-Box text auswählen.
3. In der Kennung-Box t1 auswählen.
4. In der Befehl-Box format auswählen.
5. In die Parameter-Box Hello world! schreiben.
6. Die Einfügen-Schaltfläche anklicken.
7. Die neue Zeile wird angezeigt.
8. Die Speichern-Schaltfläche anklicken.

Nun muss die Verknüpfung mit dem Taster b1 definiert werden.

1. Registerkarte Eigenschaften des Tasters b1 öffnen.
2. Aktionen…-Schaltfläche anklicken.
3. Aktions-Kennung script1 auswählen.
4. Status on auswählen.
5. Hinzufügen-Schaltfläche anklicken.
6. OK-Schaltfläche anklicken.

Jetzt ist alles für den letzten Test bereit.

1. Taster b1 anklicken.
2. Farbe des Tasters b1 wechselt Grün.

In diesem Kapitel wird eine Entscheidung gefällt, die vom Inhalt des Textfeldes t2 abhängig ist.

• plan-2.xml.zip

Der Gleisplan ist um das Textfeld t2 erweitert.
Der Inhalt dieses neuen Textfeldes wird für die XmlScript-Entscheidung verwendet.
Das Textfeld t2 hat die Eingabefeld-Option, um das Ändern des enthaltenen Textes zu erleichtern.

Das Ziel ist, den neuen Text für das Textfeld t1 vom Inhalt des Textfeldes t2 abhängig zu machen.

1. Aktions-Dialog öffnen, auf die Aktion script1 doppelklicken, um den XmlScript-Editor zu öffen.
2. Das existierende XmlScript wie folgt erweitern:

<?xml version="1.0" encoding="UTF-8"?>
<xmlscript>
  <if condition="$t2 # 4711">
    <then>
      <tx id="t1" format="t2 is 4711 :)"/>
    </then>
    <else>
      <tx id="t1" format="t2 is not 4711 but $t2 :("/>
    </else>
  </if>
</xmlscript>

Mit der <if>-Anweisung kann eine Auswahl durchgeführt werden. Diese Auswahl muss in der condition-Eigenschaft (Bedingung) der <if>-Zeile definiert werden.
In diesem Beispiel ist Bedingung (condition) wie folgt definiert:

Wenn die Bedingung "wahr" ist, werden alle Befehle zwischen <then> und </then> ausgeführt.
Wenn sie "nicht wahr" ist und es einen <else>-Knoten gibt, werden alle Befehle zwischen <else> und </else> ausgeführt.

Weil Textfeld t2 als ein Eingabefeld definiert ist, kann man mit ändern des t2-Inhalts und Taster b1 herumspielen.

• Auf der XmlScript-Seite nachschauen, welche Anweisungen und Befehle verfügbar sind.
• Die Trace-Zeilen verwenden, um zu sehen was im eigenen Script geschieht.