Variablen verwenden

Vor Anzeige verarbeitete Variablen

Definieren Sie Variablen, welche vor der Anzeige der Aufgabe ermittelt werden, um in Ihren Aufgaben Zufallsparameter zu nutzen. Variablen werden in ONYX für alle Aufgabentypen unterstützt und bieten insbesondere für Berechnungsaufgaben vielfältige Möglichkeiten. Durch Variablen können Aufgabenschablonen erstellt werden, welche automatisch zur Testlaufzeit unbegrenzt viele, unterschiedliche Test- und Prüfungsdurchläufe ermöglichen.

Nach Abgabe verarbeitete Variablen

Definieren Sie Variablen, welche nach Abgabe der Aufgabe ermittelt werden, um adaptive Aufgaben- und Testszenarien zu erstellen. Nach Abgabe verarbeitete Variablen (kurz: Post-Variablen) ermöglichen Ihnen den Zugriff auf die gegebenen Lernerantworten und erreichten Punkte. Sie können nachfolgende Inhalte wie Feedbacktexte oder den Aufgabentext von Folgeversuchen auf dieser Basis anpassen. Darüber hinaus ist es möglich in die Bewertung einzugreifen und diese individuell nachträglich zu ändern.

Definition einer Variable

Klicken Sie im Tab Variablen auf den Button Neue Variable hinzufügen, um eine neue Variable zu definieren. Die neue Variable wird direkt hinzugefügt und in der Übersichtstabelle angezeigt. Unterhalb öffnet sich für die neue Variable ein Bearbeitungsfenster. Die Reihenfolge von Variablen oder Bedingungen innerhalb einer Variablen-Tabelle kann einfach per Drag-and-Drop geändert werden.

Vergeben Sie einen eindeutigen Variablen-Namen für ihre Variable. Der Variablen-Name dient als Identifier und ermöglicht Ihnen die Nutzung der Variable im Aufgabentext. Bitte beachten Sie, dass im Variablen-Namen keine Umlaute, Sonder- und Leerzeichen verwendet werden dürfen. Die Groß- und Kleinschreibung muss beachtet werden. Wird eine Variable mit dem Namen "a" definiert, kann mit dem Platzhalter {a} darauf zugegriffen werden.

Wählen Sie den Variablen-Typ. Folgende Variablen-Typen werden bereitgestellt:

• Numerische Variablen:
  • Ganze Zahl
  • Gleitkommazahl
• Text Variables
• Bild Variablen

Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur Wert-Ermittlung bereit:

• Wert
• Wertebereich
• Zufällige Auswahl
• Berechnung (MAXIMA)

Variablen können auch ohne Wert-Setzung angelegt werden, um den Wert beispielsweise später in Abhängigkeit anderer Variablen zu setzen (vgl. Bedingungen).

Verwendung von Variablen

Definierte Variablen können durch Angabe des Variablen-Namens in die Aufgabenstellung und in Antworttexte eingefügt werden. Ebenfalls ist die direkte Integration in LaTeX-Formeln möglich. Der definierte Variablenname muss in geschweiften Klammern stehen. ONYX erkennt automatisch, ob eine Variablen-Deklaration mit entsprechendem Namen vorliegt. Wird ein Bezeichner verwendet, der nicht definiert ist, wird dieser ignoriert und als Text ausgegeben.

Im Beispiel wurden die Variablen {VAR1}, {VAR2} und {VAR3} deklariert:

Definition einer Bedingung

Im Tab Variablen können Sie zudem Bedingungen verwenden. Eine Bedingung ermöglicht das Setzen eines Variablen-Wertes, abhängig von anderen Variablen-Werten.

Klicken Sie auf den Button Neue Bedingung hinzufügen, um eine neue Bedingung zu definieren. Die neue Bedingung wird direkt hinzugefügt und in der Übersichtstabelle angezeigt. Unterhalb öffnet sich für die Bedingung ein Bearbeitungsfenster. Die Reihenfolge von Variablen oder Bedingungen innerhalb der Variablen-Tabelle kann einfach per Drag-and-Drop geändert werden.

Variablen können mit anderen Variablen gleichen Typs oder mit festen Werten verglichen werden. Die Vergleichsoperatoren richten sich nach dem Variablentyp. So können Sie beispielsweise prüfen, ob Werte gleich (=) oder ungleich (!=) zu einem anderen Wert sind.

Bitte beachten Sie: Eine Variable die innerhalb einer Bedingung verwendet wird, muss vor der Bedingung initialisiert werden. Die in der Bedingung oder in der Anweisung verwendete Variable muss als einzelne Variable vor der Bedingung hinzugefügt werden. Wird der Wert einer Variablen innerhalb einer oder mehrerer Bedingungen gesetzt, ist eine Wertsetzung für die Variable selbst nicht notwendig. Wählen Sie den leeren Eintrag in der Wert-Auswahlliste.

Verknüpfung der Bedingungen: Haben Sie mehrere Bedingungen für einen IF-Abschnitt erstellt, können Sie konfigurieren wie diese Einträge verknüpft werden. Legen Sie fest, ob alle Bedingungen (UND) oder mindestens eine Bedingung (ODER) erfüllt sein muss, damit die Bedingung ausgeführt wird.

Alternative Bedingungen (ELSE IF):  Sie können beliebig viele alternative Bedingungen (ELSE IF - Zweige) hinzufügen. In den Bedingungen können unterschiedliche Variablen gesetzt werden. Pro Bedingung kann im einfachen Modus nur eine Variable gesetzt werden. Für komplexere Regeln können Sie in den Expertenmodus wechseln. Eine detaillierte Beschreibung erhalten Sie in der Hilfe-Beschreibung zum Expertenmodus.

Expertenmodus (IMS QTI)

Die Variablen-Abbildung in den Test- und Aufgabeninhalten basiert auf dem Prinzip der Template-Declaration und dem Template-Processing der IMS QTI 2.1 Spezifikation. Das Template-Processing von IMS QTI 2.1 bietet weitaus mehr Möglichkeiten zum Setzen von Variablen, insbesondere durch die Verschachtelung logischer Ausdrücke und Bedingungen. Die im Expertenmodus eingegebene Beschreibung wird direkt in das XML der Aufgabe, als einzelner Template-Processing-Ausdruck, übernommen.

Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurückzuwechseln.

Weitere Hinweise zur XML-Definition des Template-Processing erhalten Sie in der IMS QTI 2.1 Spezifikation. Aktuell unterstützt die ONYX Testsuite bereits ein weites Set der IMS QTI Expressions und Möglichkeiten. Bei Nutzung des Expertenmodus empfehlen wir dennoch eine genaue Prüfung zur korrekten Funktionsweise der Aufgabenvorlage.

Variablen-Belegung einsehen

Bei der Erprobung Ihrer Testinhalte können Sie die Variablen-Belegung in der Vorschau jederzeit einsehen. Ebenso stehen dem Betreuer oder Bewerter diese Detailinformationen in den Ergebniseinsichten zu Verfügung. Neben der Variablen-Belegung werden Ihnen auch Informationen zu den MAXIMA-Aufgaben und möglichen Systemfehlern angezeigt.

Detaillierte Informationen finden Sie in den jeweiligen Hilfeabschnitten zur Ergebniseinsicht für den Betreuer:

• Variablen-Belegung einsehen  

• MAXIMA-Ausgaben einsehen
• Anzeige von Systemfehlern

Verarbeitungsreihenfolge von Variablen in der Testdurchführung

Testaufruf bzw. Teststart

Aufgabenaufruf innerhalb des Tests

Abgabe einer Aufgabe

Abgabe eines Tests

Pre-processed variables

Define variables that are determined before the task is displayed in order to use random parameters in your tasks. Variables are supported in ONYX for all types of tasks and offer various possibilities, especially for calculation interactions. With the help of variables, it is possible to create task templates which automatically allow an unlimited number of different test and exam attempts.

Post-processed variables

Define variables that are determined after the submission of the task in order to create adaptive task and test scenarios. Post-processed variables (in short: post-variables) allow you to access the learners' answers and points achieved. You can use this information to enhance following content such as feedback or task descriptions of follow-up attempts. In addition, it is possible to intervene in the assessment and make subsequent changes to it.

Definition of a variable

Click on Add new variable in the tab Variables to define a new variable. The new variable is immediately added and displayed in the overview table. Below the table, an edit window opens for the new variable. The order of the variables and conditions within the variables table can be easily changed using drag-and-drop.

Assign a unique variable name for your variable. The variable name serves as an identifier and allows you to use the variable in the task text. Please make sure that the variable name does not contain any umlauts, special characters, and spaces. The input is case sensitive. If a variable is defined with the name "a", it can be accessed via the placeholder {a}.

Select the variable type. The following variable types are available:

• Numerical variables:
  • Integer
  • Floating-point number
• Text variables
• Image variables

Depending on the selected variable type, you have various options for the determination of the value:

• Value
• Value range
• Random selection
• Calculation (MAXIMA)

Variables can also be created without immediately setting a value. If the value is set at a later point in time, it can for example be set in dependence of other variables (cf. conditions).

Use of variables

Defined variables can be inserted into task and answer text by specifying the variable name. Direct integration into LaTeX-formulas is also possible. The defined variable name must be enclosed in braces. ONYX automatically detects if there is a variable declaration with the appropriate name. If an identifier is used which is not defined, it will be ignored and output as text.

In the example, the variables {VAR1}, {VAR2}, and {VAR3} were declared:

Definition of a condition

In the tab Variables, you can also use conditions. A condition allows you to set the value of a variable, depending on other variable values.

Click on Add new condition to define a new condition. The new condition is immediately added and displayed in the overview table. Below the table, an edit window opens for the new condition. The order of the variables and conditions within the variables table can be easily changed using drag-and-drop.

Variables can be compared with other variables of the same type or with fixed values. The comparison operators depend on the type of the variable. You can, for example, check whether values are equal to (=) or not equal to (!=) another value.

Please note: A variable that is used within a condition must be initialised before the condition. The variable which is used in the condition or statement must be added as a single variable before the condition can be added. If the value of a variable is set within one or more conditions, it will be unnecessary to set a value for the variable itself. Select the empty entry from the value selection list.

Link conditions: If you have created several conditions for an IF section, you can configure how these entries will be linked. Determine whether all conditions (AND) or at least one condition (OR) must be met for the condition to be executed. 

Alternative conditions (ELSE IF): You can add any number of alternative conditions (ELSE IF branches). Different variables can be set in the conditions. In the simple mode, only one variable can be set per condition. For more complex rules, you can switch to the expert mode. A more detailed description can be found in the help pages for the expert mode.

Expert mode (IMS QTI)

The variable representation in the test and task content is based on the principle of template declaration and the template processing of the IMS QTI 2.1 specification. The template processing of IMS QTI 2.1 offers far more possibilities for setting variables, in particular by the nesting of logical expressions and conditions. The description entered in the expert mode is directly transferred into the XML of the task as a single template processing expression.

Please note that after changing the description in the expert mode, there is no way to return to the simple mode.

For further information on the XML definition of the template processing, please refer to the section IMS QTI 2.1 specification. The ONYX Testsuite already supports a wide set of IMS QTI expressions and possibilities. A detailed check to ensure correct functioning of the task template is nevertheless recommended when using the expert mode.

View variable assignment

When testing your test content, you can view the variable assignment in the preview at any time. These details are also available to the supervisor or assessor in the results views. In addition to the variable assignment, information on the MAXIMA tasks as well as possible system errors are displayed.

For more detailed information, please refer to the following help sections:

• View variable assignment
• View MAXIMA output
• Display of system errors