Im letzten Tutorial (XXX) haben wir aufgezeigt, wie ein Modul mit einer Zeitsteuerung versehen werden kann. In der Konfiguration des Modules ist es somit möglich einen Zeitraum zu definieren, welcher im Modul abgeprüft wird. Oft reicht es jedoch nicht nur einen Zeitraum anzugeben, sondern es sollen in einer Konfiguration mehrere Zeiträume verarbeitet werden können. Hierfür bietet das Modulsystem die Möglichkeit mit Listen zu arbeiten. Die passenden Komponenten hierzu finden sich in der GUI als Eingabeelemente (z.B TextList oder NumberList) und im Development-Bereich bei den Komponenten (z.B. CreateList, Add oder auch foreach).

Bevor wir nun unsere Zeitsteuerung mit Listenfunktionen erweitern, behandeln wir erst einmal den grundlegenden Aufbau und die Möglichkeiten von Listen im Allgemeinen.

Beschreibung der Listen Komponenten

Listen sind Sammlungen von einzelnen Elementen, welche in einer indizierten Liste gespeichert werden. Man kann sich dies wie eine zweispaltige Tabelle vorstellen, die in der ersten Spalte die Zeilennummer und in der zweiten Spalte die Daten enthält.

Exemplarische Aufbau einer TextList:

Bearbeitungsmöglichkeiten von Listen

Zum Erstellen, Bearbeiten und Auslesen einer Liste, stellt der Module Designer mehrere Komponenten bereit.

Erstellen:

• CreateList - Erstellt on-the-fly eine leere Liste

• TextList - Ermöglicht eine Liste von Texten in der GUI des Moduls

• NumberList - Ermöglicht eine Liste von Nummern in der GUI des Moduls

Bearbeiten:

• Add - Fügt einen neuen Eintrag am Ende der Liste hinzu

• Remove - Entfernt einen bestimmten Eintrag in einer Liste

• Sort - Sortiert eine Liste neu

• Reverse - Kehrt alle Elemente einer Liste um

Auslesen:

• Get - Auslesen eines Elementes, welches sich an einer bestimmten Position der Liste befindet

• Size - Gibt die Anzahl der Elemente (Zeilen) einer Liste zurück

• Contains - Prüft, ob die Liste einen bestimmten Wert enthält

Durchlaufen von Listen mit einer Programmschleife

Bei der Verwendung von Listen besteht schnell der Bedarf, dass mehrere Elemente einer Liste mit den immer gleichen Komponenten bearbeitet, ausgelesen oder verglichen werden sollen. Für diesen Fall existiert im Module Designer die Komponente foreach (List). Dieser Komponente kann eine Liste übergeben werden welche dann Zeile für Zeile ausgelesen wird und jeder Eintrag mit individuellen Komponenten verarbeitet werden kann. Die gewünschten Komponenten müssen hierzu unter dieser Komponente eingerückt platziert werden. Falls in der foreach-Schleife eine Überprüfung stattfindet, welche weitere Durchläufe unnötig macht, kann sie mit break beendet werden. Innerhalb der Einrückung stehen automatisch die Variablen foreach_index und foreach_entry zur Verfügung, welche den aktuellen Index (Zeile) und den Wert dieser Zeile enthalten.