Verona Editor Plaintext - iqb-berlin/iqb-berlin.github.io GitHub Wiki

ℹ️ Nachfolgende Beschreibungen beziehen sich auf die Version v1.0!

Hier der Link zum GitHub Repository.
Hier finden Sie die letzten aktuellen Versionsstände.

ℹ️ Zu beachten ist: Das Studio und auch der Editor haben noch einmal optische Veränderungen erfahren. Die nachfolgenden Bilder können bzgl. Optik vom aktuellen Stand des Editors und des Studios abweichen. Funktional hat sich aber nichts geändert.

Erstellung der Aufgabenelemente

Vorab: Dieser Editor verwendet eine Scriptsprache zur Erstellung von Elementen. Für die Aufgabengestaltung mit diesem Editor sind also zwingend Kenntnisse bzgl. Aufbau und Struktur dieser Scriptsprache erforderlich.

Bei der Unit-Definition handelt es sich um eine normale Text-Datei. Jede Zeile enthält die Definition eines Eingabeelementes, eines Textes oder eines Elementes zur Strukturierung.

Grundsätzlicher Aufbau einer Zeile

Jede Zeile enthält als Erstes ein Schlüsselwort und kann dahinter weitere Parameter enthalten, jeweils getrennt mit ::.

  • Die erste Zeile MUSS lauten iqb-scripted::1.0.
  • Am Ende einer Definitionszeile kann nach ?? noch weiterer Text angefügt werden, der als Hilfe-/Hinweistext verwendet wird (mouse-over).
  • Eine leere Zeile erzeugt einen Abstand im Formular in der Höhe eines Text-Elementes.
  • Vor dem Schlüsselwort können Leer- oder Tabzeichen eingefügt werden, um die Lesbarkeit des Scriptes zu erhöhen. Sie werden bei der Auswertung ignoriert.

Statische Texte, Linien, Kommentare

Schlüsselwort Bedeutung Parameter
title eine Zeile Text als oberste Gliederungsüberschrift Text des Titels (optional)
header eine Zeile Text als zweite Gliederungsüberschrift Text der Überschrift (optional)
text Standard-Text Text (optional)
html wird genau so in das Formular übernommen; dient der Lösung besonderer Layout-Probleme; Achtung: unsichere Inhalte wie Links werden herausgefiltert Html-Text (optional)
hr stellt eine horizontale Linie dar keine
rem leitet einen Kommentar ein, der bei der Verarbeitung ignoriert wird

Beispiele:

title::na sowas!
html::And now <strong>this text here is bolded</strong>
hr
text::Einfach nur so mal Text, der aber - wenn zu wenig Platz ist - auch mal umgebrochen wird.??Aber nicht vergessen: Ab und zu mit der Maus drüber!
rem::ab hier noch Nummern der Fragen prüfen!!!!!
header::Abschnitt 223

Eingabe von Text oder Zahl

Schlüsselwort Parameter Standardwert
input-text 1. Name der Variablen, in die die Eingabe gespeichert werden soll Angabe ist erforderlich
2. Pflichtfeld: 0=nein, 1=ja 0
3. Text vor dem Eingabefeld (Eingabeaufforderung) kein Text
4. Text nach dem Eingabefeld kein Text
5. Anzahl von Zeilen (>1 bedeutet mehrzeiliges Eingabefeld) 1
6. maximale Anzahl von Zeichen bei der Eingabe unbegrenzt
input-number 1. Name der Variablen, in die die Eingabe gespeichert werden soll Angabe ist erforderlich
2. Pflichtfeld: 0=nein, 1=ja 0
3. Text vor dem Eingabefeld (Eingabeaufforderung) kein Text
4. Text nach dem Eingabefeld kein Text
5. Minimalwert kein
6. Maximalwert kein

Beispiele:

input-number::task12ahmfA::1::Teilaufgabe 1.2a (Analysis)::::0::10
input-text::note::0::Weitere Kommentare zu den Prüfungsaufgaben (optional)::::20??Abschließend haben Sie an dieser Stelle die Möglichkeit, zusätzliche Hinweise und Kommentare zu den Prüfungsaufgaben und Erwartungshorizonten festzuhalten.
input-number::A155f::1::Wieviel wiegt ungefähr eine Kuh?::kg::1::1000

Mehrzeilige Eingabefelder sind mindestens zwei Zeilen hoch, auch wenn sie leer sind. Bei der Eingabe vergrößert sich dann das Eingabefeld nach Bedarf. Die angegebene Obergrenze gilt nur für die Darstellung, nicht für den Inhalt, d. h. sollte mehr eingegeben werden, als in die angegebenen Zeilen passt, wird ein Scrollbalken eingeblendet und die weitere Eingabe ist nicht blockiert.

Ungültige Eingaben (z. B. Grenze des numerischen Feldes überschritten) erzeugen einen roten Hinweistext. Der eingegebene Wert wird nicht gespeichert.

Bei numerischen Eingaben ist als Dezimaltrennzeichen sowohl ein Komma als auch ein Punkt erlaubt. Bei der Auswertung muss beides vorgesehen werden.

Ein Pflichtfeld ist zunächst nicht hervorgehoben. Erst wenn das Eingabefeld besucht und ohne eine Eingabe verlassen wurde, ist ein roter Hinweistext eingeblendet.

Ankreuzen/Auswählen

Bei einer checkbox kreuzt man nur an. Bei multiple-choice werden die Optionen untereinander dargestellt und es kann nur eine Option ausgewählt werden. Bei drop-down werden die Optionen in eine Klappbox gepackt, was Platz spart.

Schlüsselwort Parameter Standardwert
checkbox 1. Name der Variablen, in die die Eingabe gespeichert werden soll Angabe ist erforderlich
2. Pflichtfeld: 0=nein, 1=ja 0
Achtung: Pflichtfeld bedeutet hier, dass die Checkbox ausgewählt/angekreuzt sein muss (z. B. Zustimmung zu Datenschutzfragen).
3. Text vor dem Eingabefeld (Eingabeaufforderung) kein Text
4. Text nach dem Eingabefeld kein Text
Achtung: Als Wert der Variablen wird 'true' oder 'false' gespeichert. Der Wert der Variable ist im Ausgangszustand immer 'false'.
multiple-choice oder drop-down 1. Name der Variablen, in die die Eingabe gespeichert werden soll Angabe ist erforderlich
2. Pflichtfeld: 0=nein, 1=ja 0
3. Text vor Optionsliste (Eingabeaufforderung) kein Text
4. Liste der Optionen, jeweils getrennt durch ## keine
Achtung: Als Wert der Variablen wird die Position der gewählten Option gespeichert, beginnend mit 1.

Beispiele:

checkbox::task162ahmfF::0::Sie fühlen sich beunruhigt
multiple-choice::task3wtrtimeS::1::Ich fühle mich heute großartig::trifft gar nicht zu##trifft eher nicht zu##trifft eher zu##trifft voll zu
drop-down::ta33S::1::Ich fühlte mich gestern großartig::##trifft gar nicht zu##trifft eher nicht zu##trifft eher zu##trifft voll zu

Likert-Skala

Mit dem likert Element kann eine Liste von Fragen mit einer einheitlichen Antwortskala definiert werden. Sie funktioniert ähnlich wie eine Liste von exklusiven Checkboxen mit dem Unterschied, dass Antworten-Optionen nur einmal im Tabellenkopf definiert werden müssen. Diese Form ist sehr platzsparend und kann schnell beantwortet werden.

Schlüsselwort Parameter Standardwert
likert-start 1. Liste der Antwortoptionen jeweils getrennt durch ## Angabe erforderlich
likert 1. Name der Variable, in die die Eingabe gespeichert werden soll 2. (Frage)Text mindestens eine Angabe erforderlich
likert-end 1.keine Angabe ist erforderlich
html wird genau so in das Formular übernommen; dient der Lösung besonderer Layout-Probleme; Achtung: unsichere Inhalte wie Links werden herausgefiltert Html-Text (optional)
hr stellt eine horizontale Linie dar keine
rem leitet einen Kommentar ein, der bei der Verarbeitung ignoriert wird

Beispiele:

likert-start::sehr hilfreich##eher hilfreich##teilweise hilfreich##eher nicht hilfreich##nicht hilfreich
    likert::task2useA::Abschnitt 1: Einleitung
    likert::task2useB::Abschnitt 2: Starten der Computer
    likert::task2useC::Abschnitt 3: Anmeldung
    likert::task2useD::Abschnitt 4: Steuerung über Testleitungskonsole
    likert::task2useE::Abschnitt 5: Speichern/Beenden
likert-end

Schleifen

repeat-start und repeat-end markieren einen Block von Elementen, der während der Beantwortung dynamisch mehrfach erzeugt wird. Dazu muss die befragte Person eine Zahl eingeben, die die Anzahl der Wiederholungen steuert. Alle Variablennamen der im Block befindlichen Eingabeelemente erhalten für den jeweiligen Blockdurchlauf einen Suffix: _ + laufende Nummer des aktuellen Blockdurchlaufes, beginnend mit _1.

Innerhalb des Blocks ist es möglich Ein- und Ausblendungen vorzunehmen (s. u.). Hierbei ist möglich sich auf Variablen innerhalb des Blocks oder Variablen auf höchster Ebene zu beziehen. Bei Verschachtelung mehrerer Schleifen kann man sich nicht auf Variablen anderer Schachtelungsebenen beziehen.

Schlüsselwort Parameter Standardwert
repeat-start 1. Name der Variablen, in die die Eingabe (Anzahl) gespeichert werden soll Angabe erforderlich
2. Text vor dem Eingabefeld (Eingabeaufforderung) kein Text
3. Text für die Überschrift zu Beginn jeden Blockes (Blocknummer wird jeweils dynamisch dahinter gesetzt) `Block`
4. Maximalwert für die Anzahl der Blöcke 10
repeat-end keine

Beispiel:

rem::Schleife für alle Prüflinge
repeat-start::examineecount::Wie viele Prüflinge gibt es?::Angaben zu Prüfling::20??Sie können Angaben zu maximal 20 Prüflingen eintragen. Sollten sich im Kurs mehr als 20 Prüflinge befinden, ist eine Auswahl vorzunehmen. Diese Auswahl sollte so erfolgen, dass ein möglichst breites Leistungsspektrum abgebildet wird. Vermieden werden sollte eine selektive Berücksichtigung bzw. Nichtberücksichtigung bestimmter Gruppen (z. B. besonders leistungsschwache oder leistungsstarke Prüflinge, Schülerinnen und Schüler mit nichtdeutscher Herkunftssprache).
    input-number::task1::1::Teilaufgabe 1::::0::10
    input-number::task2::1::Teilaufgabe 2::::0::10
    input-number::task3::1::Teilaufgabe 3::::0::10
repeat-end

führt z. B. zu folgenden Daten:


examineecount;3
task1_1;3
task2_1;4
task3_1;5
task1_2;3
task2_2;1
task3_2;5
task1_3;1
task2_3;4
task3_3;6

Ausblenden/Einblenden

if-start und if-end markieren einen Block von Elementen, der in Abhängigkeit des Wertes einer Variablen gezeigt oder ausgeblendet wird. Dabei wird der eingegebene Wert mit einem Sollwert verglichen. Mit if-else können Elemente ein-/ausgeblendet werden, wenn der Wert nicht mit dem Sollwert übereinstimmt.

Schlüsselwort Parameter
if-start 1. Name der Variablen, der Wert geprüft werden soll
2. Wert
if-else keine
if-end keine

Navigation

nav-button-group ermöglicht das Einfügen von Navigationselementen. Art und Reihenfolge können gewählt werden. Mögliche Bedienelemente sind: next, previous, first, last und end.

Schlüsselwort Parameter
nav-button-group 1. Liste der Optionen, jeweils getrennt durch ##

Beispiel:

nav-button-group::previous##next##first##last##end
nav-button-group::next

Wiedergabe der Inhalte

Die mit diesem Editor erstellten Aufgabenelemente können sowohl in einer Vorschau, als auch im finalen System zur Testdurchführung wiedergegeben werden. Damit die Inhalte dargestellt werden können, bedarf es eines bestimmten Players. Dieser muss zwingend zu diesem Editor passen. Für den PlainText-Editor muss zwingend der Player Verona Abi-Player verwendet werden. Detailierte Informationen zu diesem Player finden Sie im gleichnamigen Einzeldokument.

⚠️ **GitHub.com Fallback** ⚠️