Eingebettete Programmhilfe
Zusammenfassung zu Routing innerhalb von Erhebungsteilen
Die Reihenfolge von CBA ItemBuilder-Aufgaben kann hier mit Hilfe von Blockly (also einer Form des visuellen Programmierens) definiert werden. Blockly-basierte Ablaufsteuerung ist verfügbar, wenn bei einem Erhebungsteil die Option Routing aktivieren ausgewählt ist. Die Option ist im Abschnitt Info eines Erhebungsteils zu finden. Ist sie aktiviert, enthält der Erhebungsteil den Eintrag Routing.
Übersicht:
Beispiele
Die Grundidee zur Verwendung von Blockly für die Defnition von Abläufen in computerbasierten Assessments soll zunächst mit einigen Beispielen illsturiert werden.
- Beispiel für linearen Ablauf
Basierend auf den einem Erhebungsteil hinzugefügten CBA ItemBuilder Tasks in der Ansicht Items entspricht eine lineare Folge der Tasks der folgenden Blockly-Definition:
Dem Blockly-Element Show Items wird eine Liste der CBA ItemBuilder Tasks übergeben, die mit dem Operator erzeuge Liste mit erstellt wird. Die Liste wird in der dargestellten Reihenfolge abgearbeitet, wobei jeder CBA ItemBuilder Tasks solange dargestellt wird, bis das NEXT_TASK- Command ausgeführt wird.
Eine äquivalente Formulierung einer linearen Sequenz kann auch mit mehreren Show Items-Blöcken erfolgen, wenn keine Zurücknavigation notwendig ist:
- Beispiel für einfache Testhefte
Mit Hilfe einer Variable (hier: Booklet) und einer einfachen falls/mache-Bedingung lässt sich daraus nun ein Ablauf definieren, welcher je nach Wert der Variable unterschiedliche Items administriert:
Die Items für Start und Ende werden immer administriert, die Tasks 1-3 nur, wenn die Variable Booklet den Wert 0 hat, die Tasks 4 und 5, wenn die Variable Booklet einen von 0 verschiedenen Wert hat.
Der identische Ablauf lässt sich alternativ auch unter Verwendung des Blockly-Operators für das Anzeigen von Itemlisten erstellen:
Beide Varianten sind bzgl. der Funktionalität völlig äquivalent, die zweite Vorgehensweise mit Listen erlaubt aber die Verwendung der Option Zurücknavigation innerhalb der booklet-spezifischen Tasks.
- Beispiel für Ablauf mit Zeitbegrenzung
Um mit Hilfe der Blockly-Configuration zeitbegrenzte Abschnitte innerhalb eines Erhebungsteils umzusetzen, kann die folgende Blockly-Komponente verwendet werden:
Jeder Ablauf beginnt mit einem nicht zeitbgrenzten Start-Tasks und endet mit einem ebenfalls nicht zeitbegrenzten End-Tasks. Dazwischen läuft eine Zeitbegrenzung für einen Abschnitt mit der Bezeichnung MyFirstTimer, der eine Zeitbegrenzung für 60 Sekunden hat.
Die Tasks 1, 2 und 3 werden in dem Abschnitt Runtime code mit einer Zeitbegrenzung angezeigt. Tritt ein Timeout auf, d.h. werden die drei Tasks nicht innerhalb der 60 Sekunden bearbeitet, wird (ebenfalls ohne Zeitbegrenzung) der Task 4 angezeigt.
- Beispiel für einfaches Booklet-Design mit Zeitbegrenzung
Bei vielen Items kann die Definition von Booklet Designs, d.h. Taskreihenfolgen mit balancierten Positionen, durch Funktionen bzw. Listen vereinfacht werden.
Wenn keine Zurücknavigation notwendig ist, können Funktionen für die Definition von Clustern verendet werden:
Mit Zurücknavigation können die Funktionen Listen von Tasks zurückgeben:
Weitere Informationen siehe hier.
Hinweise zur Verwendung des Blockly-Editors
Die Defintion von Abläufen erfolgt in dem visuellen Blockly-Editor. Die Ausführung beginnt mit dem Element, welches am weitesten oben ausgerichtet ist. Wenn nötig, kann der Arbeitsbereich mit der Funktion Aufräumen automatisch ausgerichtet werden. Zum Hinzufügen von Blockly-Operatoren können diese per Drag-and-Drop aus der Palette gezogen werden.
Löschen: Zum Löschen von Operatoren können diese auf den Papierkorb gezogen werden. Ausgewählte Blockly-Elemente können auch über die Taste Entf(ernen) gelöscht werden. Alternativ können ausgewählte Blockly-Elemente auch über Kontextmenü gelöscht werden.
Redo-/Undo: Innerhalb des Blockly-Editor können einzelne Aktionen rückgängig gemacht werden. Dafür kann die Tastenkombination Strg + Z verwendet werden. Mit Strg + Y wird eine Aktion wiederholt. Durch einen Klick in einen leeren Bereich des Blockly-Editors ist der Zugriff auf ein Kontextmenü möglich, welches ebenfalls die Optionen für Rückgängig und Wiederholen bereithält:
- Speichern: Anpassungen im Blockly-Editor müssen gespeichert werden. Dafür steht unten rechts das Disketten-Symbol zur Verfügung:
Sollen die Änderung (insgesamt) verworfen werden, kann unten rechts das Verwerfen-Symbol verwendet werden.
- Zoom: Die Ansicht im Arbeitsbereich kann mit den Icons
+ vergrößert und mit - verkleinert werden.
Einige Blockly-Elemente stellen im Kontextmenü auch einen Eintrag Hilfe zur Vefügung, welcher auf allgemein zugängliche Blockly-Dokumente (https://github.com/google/blockly/wiki/) verweist.
Verwendung von Blockly zur Ablaufsteuerung
Die Grundfunktionen für die Nutzung der Blockly-Umgebung zur Steuerung von Assessments finden sich im Abschnitt Session.
Einzelne Items anzeigen
Auf CBA ItemBuilder-Tasks, die in der Ansicht Items für einen Erhebungsteil importiert wurden, kann in der Ablaufsteuerung, wie in den Beispielen oben gezeigt, mit Hilfe des folgende Blockly-Elements für Tasks zugegriffen werden:
Das Element, welches im Abschnitt Session der Palette des Blockly-Editors zu finden ist, kann durch die Auswahlliste konfiguriert werden. Jedes Blockly-Element für Tasks kann auf genau einen konkreten Task verweisen, d.h. in der Regel besteht eine Ablaufdefinition aus mehrerer solcher Elemente.
Blockly-Elemente für Tasks können nicht direkt in den Ablauf eingefügt werden, sondern werden zusammen mit einem Show Item-Element verwendet:
Das Beispiel für einfache Testhefte illustriert, dass Abläufe in der Blockly-Definition häufig durch eine Abfolge von mehreren Show Item-Operatoren definiert werden. Show Item-Operatoren können dabei in Bedingungen und Schleifen, sowohl innerhalb des Hauptablaufs als auch innerhalb von Funktionen eingefügt werden.
Verwendung von Geltungsbereichen (Scopes)
Mit Hilfe der Blocky-basierten Ablaufsteuerung ist es auch möglich, CBA ItemBuilder-Tasks mehrfach innerhalb eines Ablaufs zu administrieren:
Dabei wird beim erneuten Aufruf eines Items der Zustand aus dem letzten Besuch wiederhergestellt, d.h. die Bearbeitung wird fortgesetzt. Sollen Items mehrfach neu, d.h. unbearbeitet vorgelegt werden, kann das automatische wiederherstellen nicht gewünscht sein. Dafür kann optional die Checkbox für die Angabe eines Scopes (Geltungsbereich) aktiviert werden:
Wird nichts weiter angegeben, wird das Item im “Default”-Scope administriert. Alternativ kann ein Text definiert werde, wie in folgendem Beispiel zu sehen:
Beim ersten Besuch wird der Task in dem Scope “Visit1” dargestellt. Danach folgt eine neue, unabhängige Darstellung des Tasks in einem anderen Scope (“Visit2”). Im dritten Aufruf wird der Task wieder mit den Daten dargestellt, die beim ersten Besuch bereits gesammelt wurden (d.h. der Scope “Visit1” wird erneut verwendet).
Anzeigen mehrerer Items (Itemlisten)
Wie im Beispiel für linearen Ablauf zu sehen, können lineare Tests auch über Listen von Tasks dargestellt werden.
Listen können mit dem Blockly-Operator Show Items verwendet werden:
Zurücknavigation: Das Show Items-Element für Listen kann über die Eigenschaft Can navigate back konfiguriert werden. Ist diese Eigenschaft ausgewählt, dann können CBA ItemBuilder-Tasks mit dem Command BACK_TASK eine Navigation zum vorherigen CBA ItemBuilder Tasks anfordern.
Abbrechen von Listen: Die Verwendung von Listen erlaubt auch das Abbrechen von Listen. Listen können über zwei Wege abgebrochen werden:
- Das Command
CANCEL_TASK, welches innerhalb von CBA ItemBuilder Tasks verwendet werden kann, wird aufgerufen.
- Im Testleitermenü, welches für die Studie konfiguriert und ggf. über den Blockly-Operator Testleitermenü bearbeiten angepasst wurde, wird die Funktion Itemliste abbrechen aufgerufen.
Die Administration einer Itemliste wird dadurch abgebrochen, und die Abarbeitung des Blockly-Ablaufs nach dem Show Items-Block fortgesetzt.
Anzeige von Items mit Speicherung der Ergebnisse
Die Operatoren Show Item (für einzelne Items) und Show Items (für Itemlisten) sind auch als Operatoren für Wertzuweisungen verfügbar:
Mit deren Hilfe lassen sich Ergebnisse der Itembearbeitung zu Variablen (String oder Array) zuweisen, und dann für die Ablaufsteuerung auswerten.
Definition von Zeitbegrenzungen
Wie im Beispiel Ablauf mit Zeitbegrenzung bereits illustriert, kann mit dem Blockly-Block Start time with name die Zeitbegrenzte Administration von Items umgesetzt werden.
Das Blockly-Element Start timer with name erlaubt die Definition von Zeitbegrenzungen. Jede Zeitbegrenzung kann einen eigenen Namen haben. Zusätzlich muss die Zeit in Sekunden angegeben werden. Darüber kann definiert werden, welche Art von Zeit verwendet werden soll:
- Realtime: Der Timer läuft in Echtzeit. Wird nicht durch Downtimes des Servers oder einen Sessionneustart beeinflusst.
- Servertime: Der Timer läuft in Serverzeit. Wird nicht durch einen Sessionneustart beeinflusst, berücksichtigt aber keine Downtime des Servers.
- Sessiontime: Der Timer läuft innerhalb einer Session. Wird bei einer Unterbrechung durch Server-Downtime oder einen Session-Neustart unterbrochen.
- Clienttime: Der Timer läuft nur in Clientzeit und wird auch bei Pausen der Session unterbrochen.
Schließlich können zwei Stellen mit weiteren Blockly-Operatoren (wie bspw. ein oder mehrere Show Item-Blöcke zum Anzeigen einzelner Items oder ein oder mehrere Show Items-Blöcke zum Anzeigen von Listen) gefüllt werden:
- Runtime code: Diese Blöcke werden ausgefüllt, bis die definierte Zeit abgelaufen ist.
- Elapsed code: Diese Blöcke werden nur ausgefüllt, wenn der Runtime code nicht innerhalb der Zeit beendet wurde.
Blockly-Operatoren für das Testleitermenü
In der Studiendefinition können Funktionen des Testleitermenüs für eine oder mehrere Rollen angelegt werden. Rollen stellen unterschiedliche Funktionen zusammen, die mit Hilfe des vom Testleiter einzugebenden Passworts unterschieden werden können.
Anpassen von Standardfunktionen: Folgende Standardfunktionen können für eine Studie im Abschnitt Info / Testleitermenü definiert werden:
- Navigation: Aufgabe vor / Aufgabe zurück
- Listen: Itemliste abbrechen
- Beenden: Erhebungsteil beenden und Session beenden
- Lautstärkeregelung: Einstellen der Audiolautstärke während des Assessments
Während der Bearbeitung eines Erhebungsteils kann in der Ablaufsteuerung mit Hilfe des folgenden Blockly-Operators das Testleitermenü kontextspezifisch angepasst werden:
Das Testleitermenüs kann für jede der Standardfunktionen (im Bereich Funktion) für eine Rolle (im Bereich Gruppe) sowohl die Beschriftung der Schaltfläche (im Bereich Label) geändert werden:
- Hinzufügen: Funktion wird im Testleitermenü ergänzt
- Entfernen: Funktion wird aus dem Testleitermenü entfernt
- Deaktivieren: Funktion wird im Testleitermenü deaktiviert
- Aktivieren: Funktion wird im Testleitermenü aktiviert
Der Aufruf dieses Blockly-Operators im Testablauf definiert das Verhalten des Testleitermenüs im weiteren Testablauf. Im Unterschied zu Entfernen bleiben deaktivierte Funktionen im Testleitermenü sichtbar, können aber (bis sie wieder aktiviert werden) nicht ausgeführt werden.
Verwenden von Blockly-Funktionen im Testleitermenü: Der Blockly-Operator für das Bearbeiten des Testleitermenüs enthält im Abschnitt Funktion auch die Option zum Ausführen von Blockly-Code (ExecuteBockly):
Wenn ExecuteBlockly ausgewählt ist, kann in dem Blockly-Element Testleitermenü bearbeiten eine innerhalb des Blockly-Editors definierte Funktion ausgewählt werden. Die in dieser Funktion definierten Blockly-Operatoren werden dann ausgeführt, wenn ein Testleiter die entsprechende Schaltfläche zur Laufzeit im Testleitermenü auswählt.
Fortgeschrittene Blockly-Verwendung
Ablaufsteuerung mit Bedingungen
Der Abschnitt Logic enthält den Blockly-Operator falls/mache, welcher zur Umsetzung von Bedingungen im Ablauf verwendet werden kann. Bedingungen sind logische Ausdrücke, bspw. die Prüfung ob eine Preload-Variable einen bestimmten Wert hat:
Nur wenn die Bedingung (falls) erfüllt ist, werden die Blocky-Operatoren ausgeführt, welche innerhalb des Bedingungsblocks definiert sind (d.h. neben mache). In dem Beispiel wird geprüft, ob eine boolsche Variable den Wert wahr hat.
Die Bedingung wird dabei als separater Block definiert, die mit dem Blockly-Operator falls/mache verbunden ist. Hier die beiden Komponenten separat:
Verwendung logischer Ausdrücke
Logische Ausdtrücke in Bedingungen basieren entweder auf Wertevergleichen oder Rückgaben von Funktionen. Wertevergleiche können mit folgendem Blockly-Element realisiert werden:
Die beiden Slots können mit Werten gefüllt werden. Für boolsche Werte (wahr/falsch) steht ein entsprechendes Blockly-Element im Abschnitt Logic bereit:
Bedingungen sind auch mit Variablen von anderem Datentyp möglich:
Für numerische Werte gibt es ein entsprechendes Blockly-Element im Abschnitt Math, welcher Operatoren für Zahlen und einfache mathematische Operationen enthält:
Mit dessen Hilfe und einer numerischen Variable lässt sich folgende Bedingung formulieren:
Aus technischen Gründen kann es auch notwendig sein zu prüfen, ob eine Variable noch gar keinen Wert hat. Das kann durch Verwendung der Blockly-Komponente null umgesetzt werden:
Kombination von logischen Ausdrücken: Einzelne Bedingungen oder logische Ausdrücke können mit folgendem Blockly-Element aus dem Abschnitt Logik verbunden werden:
Dabei steht eine und sowie eine oder-Verknüpfung der Aussagen zur Auswahl. Die und-Verknüpfung ist wahr, wenn beide Ausdrücke wahr sind, die oder-Verknüpfung ist wahr, wenn mindestens einer von beiden Ausdrücken (oder beide Ausdrücke) wahr sind.
Mehrere logische Ausdrücke können in einander geschachtelt werden:
Hinweis: Für eine übersichtlichere Darstellung ist bei der äußeren und-Verknüpfung die externe Darstellung gewählt.
Mehrere Bedingungen (sonst falls / sonst): Durch Klick auf das kleine Zahnrad-Symbol eines Bedingungsblocks (falls/mache) kann dieser konfiguriert werden:
Durch das Hinzufügen eines Abschnitts sonst falls können kann eine weitere Bedingung hinzugefügt werden. Die in einem sonst falls Abschnitt definierte Bedingung wird geprüft, wenn die vorherigen Bedingungen (falls) nicht erfüllt sind. Ist eine Bedingung erfüllt, werden die definierten Blockly-Operatoren ausgeführt.
Durch das Hinzufügen eines Abschnitts sonst können Blöcke hinzugefügt werden, welche dann ausgeführt werden, wenn keine der Bedingungen erfüllt ist.
Prüfe-Operator: Für Wertzuweisungen in Abhängigkeit von einer Bedingung stellt der Blockly-Editor eine speziellen Operator prüfe-falls wahr-falls falsch zur Verfügung:
Der Operator kombiniert eine Wertzuweisung mit einem logische Ausdruck:
In diesem Beispiel wird der String-Variablen MyStringVariable der Wert Yes zugewiesen, falls die boolsche Variable MyBooleanVariable den Wert wahr hat. Wenn MyBooleanVariable den Wert falsch hat, wird MyStringVariable der Wert No zugewiesen.
Negation: Um einen logischen Ausdruck umzukehren (Negation) steht folgender Blockly-Operator zur Verfügung:
Ablaufsteuerung mit Schleifen
Die mehrfache Ausführung von Blockly-Operatoren (und der damit darstellbaren Aktionen) ist mit Schleifen möglich. Der Abschnitt Loops der Palette enthält die dafür notwendigen Blockly-Elemente.
Wiederhole n-mal: Der folgende Blockly-Operator kann verwendet werden, um die Ausführung von Blöcke n-mal zu wiederholen:
Wiederhole solange: Schleifen können auch solange wiederholt werden bis eine Bedingung zutrifft (oder solange eine Bedingung zutrift):
Beispiel:
Zähle von/bis: Schleife mit Hilfsvariablen:
Für jeden Wert aus Liste: Schleife über alle Werte einer Liste:
Schleifen vorzeitig abbrechen: Folgendes Blockly-Element kann genutzt werden, um eine Schleife (vorzeitig) abzubrechen oder um vorzeitig mit dem nächsten Schleifendurchlauf zu beginnen:
Operatoren für Zahlen und einfache mathematische Funktionen
Der Abschnitt Math der Palette enthält Blockly-Elemente zur Verwendung von Zahlen und einfachen mathematischen Funktionen.
Ausdrücke
- Zahlen: Ganzzahlen / Dezimalzahlen
- Symbole: Spezielle Symbole oder Konstanten:
Basale Funktionen
- Addition, Subtraktion, Multiplikation, Division und Potenzfunktion von zwei Argumenten:
Schachtelung ist möglich, z.B.:
- Ob eine Zahl gerade ist, kann mit diesem Blockly-Element geprüft werden:
- Mit dem folgenden Blockly-Element, kann eine Zahl auf einen Bereich begrenzt werden:
Eingebaute Funktionen
- Trigonometrische Funktionen:
Hinweis: - erlaubt das Negieren numerischer Werte, wie in folgendem Beispiel zu sehen ist:
In dem Beispiel zu sehen ist der Tooltip für die in Blockly verfügbare Hilfe und ein Beispiel, wo die Zahl 5 mit dem --Operator in die Zahl -5 umgewandelt wird. Die äußere Bedingung (Negieren von 5 ergibt -5) ist also wahr.
Erzeugung von Zufallszahlen: Für die Erstellung von Zufallszahlen stehen zwei Blocky-Elemente zur Verfügung:
- Ganzzahlen (in Wertebereich):
- Zufallszahl zwischen 0 und 1:
Numerische Funktionen für Listen: Vordefinierte Funktionen für Listen umfassen:
Hinweise:
Weitere Funktionen lassen sich, wenn benötigt, mit Schleifen für Listen umsetzen.
Bei der Verwendung der Funktionen ist darauf zu achten, dass die Listenfunktion nur für Listen mit numerischen Datentypen anwendbar sind!
Operatoren für Text und einfache String-Operationen
Der Abschnitt Text der Palette enthält Blockly-Elemente zur Verwendung Zeichenketten.
Ausdrücke: Zum Erstellen von Text steht folgender Operator zur Verfügung:
Verketten: Verschiedene Operatoren können verwendet werden, um Text zusammenzufügen und zu Variablen zuzuweisen:
- Einen Text an eine Variable anfügen:
- Texte (und Variablenwerte) verketten und an andere Blockly-Operatoren weitergeben:
- Zusammengefügten Texte eine Variable zuweisen:
Textlänge: Die Länge einer Zeichenkette kann mit folgendem Blockly-Operator ermittelt werden:
Prüfung auf leeren String: Leere String-Variablen können daran erkannt werden, dass die Anzahl der Zeichen 0 ist.
Alternativ kann dafür auch der folgende Blockly-Operator verwendet werden:
Position in String finden: Ein Operator, der im Text (der per Variable oder als Ausdruck übergeben wird) das erste oder letzte Auftreten eines Begriffs sucht, kann wie folgt verwendet werden:
Zurückgegben wird dabei die Position des Begriffs innerhalb der Zeichenkette (d.h. im Text).
Teilzeichenketten bilden: Der folgende Operator nimmt aus der übergebenen Zeichenkette im Text die ersten Buchstaben. Die Anzahl der Buchstaben wird dabei ebenfalls übergeben.
- Beispiel (hier wird, wenn die Option nimm ersten ausgewählt ist der Variable
MyStringVariable der Text ABC, d.h. die ersten drei Buchstaben der Zeichenkette ABCDEFG) zugewiesen:
| nimm |
Ja |
Es werden die ersten N Buchstaben zurückgeliefert |
| nimm von hinten |
Ja |
Es werden die letzten N Buchstaben zurückgeliefert |
| nimm ersten |
Nein |
Es wird der erste Buchstabe zurückgeliefert (entspricht nimm mit N=1) |
| nimm letzten |
Nein |
Es wird der letzte Buchstabe zurückgeliefert (entspricht nimm von hinten mit N=1) |
| nimm zufälligen |
Nein |
Es wird ein zufälliger Buchstabe zurückgeliefert |
Buchstaben aus einer Zeichenkette kann man auch mit folgendem Operator entnehmen, und bspw. einer Variablen zuweisen:
- Beispiel (hier können bspw. die Zeichen 3 bis 5 aus einer Zeichenkette entnommen werden):
Texte Verändern: Vorhandene Texte (entweder als Ausdrücke oder aus Variablen vom Datentyp String) können durch die Anwendung von Operatoren verändert werden.
- Folgender Operator kann verwendet werden, um Text in Grossbuchstaben oder in Kleinbuchstaben umzuwandeln:
Die Option Substantive konvertiert die übergebene Zeichenfolge in eine Folge von Worten mit großem Anfangsbuchstaben (außer Zeichenketten, die vollständig in Großbuchstaben geschrieben sind).
- Führende, abschließende oder führende und abschließende Leerzeichen können durch folgenden Operator entfernt werden:
Operatoren für Zeiten und einfache Zeit-Operationen
Der Abschnitt Date & Time der Palette enthält Blockly-Elemente zur Verwendung von Zeiten innerhalb von Ablaufdefinitionen.
Festhalten von Zeitpunkten: Variablen vom Datentyp DateTime können Zeitstempel zugewiesen werden.
Ermitteln von Zeitdifferenzen: Vollständiges Beispiel: Folgender Blockly-Code misst die Zeit für die Bearbeitung von Task 1 bis 4. Dafür wird zunächst der Startzeitpunkt fegesthalten, und nach der Bearbeitung der Aufgaben wird die Zeitdifferenz ermittelt und in Sekunden umgewandelt:
Umrechnen von Zeitmaßen
Operatoren für Listen
Der Abschnitt Lists der Palette enthält Blockly-Elemente zur Erstellung und Verwendung von Listen.
Liste erstellen: Es stehen verschiedene Optionen zur Verfügung, wie Listen erstellt werden können.
- Listen können aus bestehenden Elementen erstellt werden:
Die Anzahl der Elemente des Operators erzeuge Liste mit kann per Drag-and-Drop konfiguriert werden, nachdem das Zahnrad-Symbol angeklickt wurde:
Bei der Erstellung von Listen ist darauf zu achten, dass der Blockly-Editor keine Prüfung der Datentype vornimmt. Listen mit Werten unterschiedlicher Datentypen können (fälschlicher Weise) erstellt werden, führen aber zu keinem funktionierenden Testablauf.
- Listen können durch Wiederholung eines Elements erstellt werden:
Verbinden von Listen: Bestehende Listen können zusammengeführt werden mit folgendem Operator:
Teillisten: Aus Listen kann mit folgendem Operator eine Teilliste ausgewählt werden:
Weitere Optionen des Operators für bis: bis von hinten und bis letztes.
Eigenschaften von Listen: Folgende Operatoren stehen zur Verfügung um Eigenschaften einer Liste abzufragen:
- Folgender Operator gibt wahr zurück, wenn die verbundene Liste leer ist:
- Folgender Operator gibt die Länge der Liste zurück:
- Folgender Operator gibt die distinkten Elemente einer Liste zurück
Suchen und Ersetzen: Folgende Operatoren stehen zum Suchen und Ersetzen von Elementen in Listen zur Verfügung:
- Folgender Operator findet Elemente in Listen:
- Folgender Operator gibt / entfernt oder ersetzt in einer Liste und gibt das Element zurück:
Weitere Optionen des Operators für das: von hinten das / Erste / Letzte und Zufällig.
- Folgender Operator ersetzt und fügt in einer Liste ein:
Weitere Optionen des Operators für das: von hinten das / Erste / Letzte und Zufällig.
Umwandlung von Listen und Text: Liste und Text können über Trennzeichen umgewandelt werden.
- Folgender Operator erstellt einen Text aus einer Liste oder eine Liste aus einem Text:
Listen Sortieren: Elemente in Listen können auch sortiert werden.
- Folgender Operator gibt die distinkte Elemente einer Liste zurück:
Blockly-Variablen
Der Abschnitt Variables der Palette enthält Blockly-Elemente zur Erstellung und Verwendung von Variablen.
Variable Erstellen: Um eine Blockly-Variable zu erstellen enthält die Palette die Typisierte Variable Erstellen:
- Blockly-Variablen haben immer einen Variablennamen und Datentyp:
Einfache Datentypen und Wertzuweisungen: Folgende basale Datentypen werden unterstützt:
- Number: Datentyp für Zahlenwerte (mit und ohne Dezimalstelle)
- String: Textwerte bzw. Zeichenketten
Für Zeiten werden folgende Datentypen bereitgestellt:
- DateTime: Datum und Uhrzeit
Datentypen für mehrere Werte: Neben den basalen Datentypen werden auch Datentypen für mehrere Werte unterstützt:
Variablenwerte Verwenden: Für die Verwendung von Variablenwerten, können Blockly-Elemente mit Eingängen folgende Komponenten aufnehmen:
- Welche Variable verwendet wird, kann dabei ausgewählt werden. Für definierte Variablen findet sich dafür jeweils auch ein Blockly-Element im Abschnitt Variables der Palette:
- In der Palette findet sich auch ein Blockly-Element vom Typ setze … auf. In diesem kann ebenfalls ausgewählt werden, welchen Wert der Variable es setzt:
Blockly-Funktionen
Der Abschnitt Functions der Palette enthält Blockly-Elemente zur Verwendung von Funktionen innerhalb von Ablaufdefinitionen. Funktionen kombinieren Blocky-Code, so dass dieser nur einmal definiert aber mehrfach verwendet werden kann.
Definieren von Funktionen: Es können zwei verschiede Formen von Funktionen definiert werden.
- Funktionen ohne Rückgabewert:
Funktionen ohne Rückgabewert können, damit sie augerufen werden, im Ablauf einfach mit vorherigen und nachfolgenden Blockly-Elementen verbunden werden (d.h. sie haben eine Verbindung nach oben und unten):
- Funktionen mit Rückgabewert:
Funktionen mit Rückgabewert können in einem Zuweisungs-Block aufgerufen werden (d.h. sie haben eine Verbindung nach links):
Zu welchem Typ eine Zuweisung sinnvoll ist, hängt von dem Typ des Rückgabewerts ab.
Definieren von Rückgabewerten von Funktionen: Funktionen werden durch spezielle Blockly-Elemente definiert, die an einer beliebigen Stelle im Code-Editor eingefügt werden können.
- Rückgabewerte können für Funktionen mit Rückgabewert definiert werden. Der Rückgabewert kann direkt an die Funktionsdefinition neben gib zurück angefügt werden:
Ergänzend stehen die folgenden zwei Blockly-Elemente zur Verfügung, die nur innerhalb einer Funktionsdefintion (mit Rückgabewert) verwendet werden können:
- Der Operator gib zurück erlaubt die Rückgabe eines Wertes. Danach können innerhalb der Funktion keine weiteren Blockly-Elemente in den Ablauf platziert werden (d.h. der gib zurück-Operator hat keine Verbindung nach unten):
- Der Operator falls gib zurück Operator gibt einen Wert nur dann zurück, wenn eine Bedingung erfüllt ist. Ist die Bedingung erfüllt, endet die Abarbeitung des Ablaufs in der Funktion, ist die Bedingung nicht erfüllt, wird die Bearbeitung fortgesetzt (d.h. der falls gib zurück-Operator hat eine Verbindung nach unten):
- Der falls gib zurück Operator ist also identisch mit folgender Kombination von Operatoren:
- Beide Operatoren (falls gib zurück und gib zurück) können nicht außerhalb von Funktionen verwendet werden:
- Die beide Operatoren (falls gib zurück und gib zurück) können innerhalb von Funktionen ohne Rückgabewert verwendet werden, um die Abarbeitung von Funktionen zu beenden (aber nicht zum Rückgeben von Werten):
Beispiel:
- Die folgende Funktion gibt den Wert der Variablen
MyStringVariable (Any value 1) in 50% der Fälle zurück (d.h. wenn eine erste gezogene Zufallsvariable größer 0.5 ist). In den anderen 50% der Fälle, wird eine weitere Zufallsvariable gezogen, und wenn diese größer 0.5 ist, dann wird der Text Any value 2 zurückgegeben. Ist auch dies nicht der Fall, dann wird der Text Default zurückgebeben:
Rückgabewerte sind typisiert. Die Ablaufsteuerung unterstützt auch Funktionen, die …
- … einzelne Tasks zurückgeben:
- … Listen von Tasks zurückgeben:
Definieren von Aufrufparametern von Funktionen: Funktionen können auch Parameter verwenden, die beim Aufruf der Funktion zu übergeben sind (Aufrufparameter). Die Defintion von Aufrufparametern ist nach einem Klick auf das kleine Zahnrad-Symbol eines Funktions-Blocks möglich:
Passend zur Definition der Parameter, erfolgt dann der Aufruf der Funktion durch Übergabe:
- Definition eines Parameters:
- Aufruf der Funktion mit Angabe von Wert:
Beispiel:
- Das folgende Beispiel zeigt eine Funktion mit zwei Parametern, deren Verwendung innerhalb der Funktion am Beispiel von Bedingungen und den Aufruf der Funktion mit festen Werten darstellt:
- Alternativ kann die Funktion natürlich auch mit Variablen aufgerufen werden:
Nutzung von Itemergebnissen in der Ablaufsteuerung
(Dokumentation folgt)
Blockly-Operatoren zum Kodieren fehlender Werte
(Dokumentation folgt)
Blockly-Operatoren zum schreiben von Daten
(Dokumentation folgt)
Log-Daten: Folgender Operator kann genutzt werden, um Informationen direkt in die Log-Daten zu speichern:
Ergebnis-Daten: (Dokumentation folgt)
Monitoring-Daten: (Dokumentation folgt)
Kommentieren von Blockly-Code
Der IRTLib Editor unterstützt zwei verschiedene Optionen zur Kommentierung von Blockly-Code.
Kommentare als Blockly-Elemente
Kommentare, die im Ablauf dauerhaft sichtbar sein sollen, können über die Plaette im Abschnitt Development hinzugefügt werden:
Diese Kommentare können wie Blocky-Operatoren verschoben werden und zeigen einzeiligen Kommentartext.
Ausführliche Kommentare an Blockly-Elementen
Für ausführlichere Kommentare kann über das Kontextmenü jeder Block mit einem Kommentar hinzugefügt (und wenn vorhanden gelöscht) werden:
Diese Kommentare können mehrere Zeilen umfassen und werden dargestellt, wenn auf das kleine ?-Icon eines Blocks geklickt wurde.
Darstellung von Blockly-Code
Entfalten / Zusammenfalten
Große und komplexe Abläufe können im Blockly-Editor unter Umständen unübersichtlich werden. Um für eine Betrachtung nicht benötigte Blockly-Elemente auszublenden, ohne die Funktion der Ablaufdefinition zu verändern, können Blöcke zusammengefaltet werden:
Das wird in folgendem Beispiel illustriert:
- Entfaltete (d.h. vollständige) Darstellung des markierten Blocks:
- Zusammengefaltete Darstellung des Blocks innerhalb der Ablaufdefinition:
Das zusammenfalten / entfalten von Blockly-Elementen ändert nichts an der Funktion einer Ablaufdefinition und dient nur der übersichtlicheren Anordnung von komplexen Ablaufdefinitionen.
Deaktivieren / Aktivieren
Hinweis: Diese Funktion ist gerade noch in Entwicklung.
Der Blockly-Editor bietet die Option, Blockly-Elemente, statt sie zu löschen, nur zu deaktivieren. Deaktivierte Blockly-Elemente bleiben in der Ablaufdefinition enthalten, werden aber nicht ausgeführt.
In folgendem Beispiel ist der Block zum Anzeigen des Tasks 3 deaktiviert, d.h. es werden nur Task 1, 2 und 4 angezeigt:
Aktivieren bzw. Deaktivieren von Blockly-Elementen erfolgt über das Kontextmenü:
Internal / External: Einige Blockly-Elemente mit Eingängen (d.h. Stellen, an denen man weitere Blöcke verbinden kann) erlauben zwischen zwei Darstellungsformen zu wechseln.
- Internal: Die Eingänge sind innerhalb der Blöcke angeordnet.
- Exnternal: Die Eingänge sind an der Seite der Blöcke angeordnet.
Beide Darstellungsformen sind bzgl. der Funktionalität äquivalent.
Aufräumen: Im Kontextmenü des Blockly-Editors, welches durch Klick in einen leeren Bereich geöffnet werden kann, ist die Funktion Bausteine aufräumen enthalten:
Durch Aufruf von Bausteine aufäumen werden alle Blockly-Elemente im Blockly-Editor vertikal untereinander ausgerichtet.
