Wiki-Quellcode von Variablen verwenden

Version 501.1 von Carina Enke am 20.12.2023

Verstecke letzte Bearbeiter
Carina Enke 496.1 1
Carina Enke 165.1 2 {{layout}}
3 {{layout-section ac:type="single"}}
Carina Enke 495.1 4 {{layout-cell}}
5 \\
6 {{/layout-cell}}
Carina Enke 165.1 7 {{/layout-section}}
8
9 {{layout-section ac:type="two_right_sidebar"}}
10 {{layout-cell}}
Carina Enke 495.1 11 Der Einsatz von Variablen ermöglicht die Erstellung von dynamischen Aufgabentexten. Der Aufgabeninhalt kann dabei zufällig oder angepasst an den Nutzer, seine bisherigen Antworten und Bewertungen generiert werden. Zur Umsetzung werden zwei verschiedene Typen von Variablen im gleichnamigen Tab angeboten:
Carina Enke 165.1 12
Carina Enke 495.1 13 * **Vor Anzeige verarbeitete Variablen**
14 Die Pre-Variablen werden vor Anzeige der Aufgabe belegt und ermöglichen somit den Aufgabentext sowie die vorgegebenen und korrekten Antworten dynamisch anzupassen. Auf diese Weise können mithilfe von Platzhaltern Aufgabenschablonen definiert werden. Die Platzhalter werden pro Testdurchlauf auf Basis definierter Intervalle, Wertauswahllisten oder Berechnungsvorschriften durch konkrete Zufallswerte ersetzt. Für unterschiedliche Teilnehmer und Testdurchläufe entstehen somit verschiedene aber gleichartige Testaufgaben.
15 * **{{id name="PostVariablen"/}}Nach Abgabe verarbeitete Variablen**
16 Die Post-Variablen werden nach Beantwortung, Abgabe und automatischer Bewertung der Aufgabe belegt und ermöglichen somit Zugriff auf antwortspezifische Werte wie die Lernerantwort oder Punkteinformationen. Auf diese Weise können adaptive Feedbackinhalte, Folgeversuche und Aufgabenserien erreicht werden. Mithilfe von Bedingungen und MAXIMA-Anweisungen können Lernerantworten analysiert und typische Fehler identifiziert werden. Auf diese kann durch entsprechendes Feedback oder angepasste Übungsaufgaben in Folge reagiert werden.
17 \\
Carina Enke 165.1 18
Carina Enke 495.1 19 [[image:attach:Editor - Tab Variablen_de.png]]
Carina Enke 165.1 20 {{/layout-cell}}
21
22 {{layout-cell}}
Carina Enke 499.1 23
Carina Enke 495.1 24 {{panel borderColor="#ddd" borderStyle="solid" title="Inhalt"}}
Carina Enke 165.1 25
26
27 {{toc/}}
Carina Enke 495.1 28 {{/panel}}
Carina Enke 165.1 29
Carina Enke 495.1 30 {{panel borderColor="#ddd" borderStyle="solid" title="Anwendungsbeispiele"}}
31 * [[doc:Beispiel Transport - Einsatz von Zufallsparametern]]
32 * [[doc:Beispiel Transport - Adaptives Aufgabenfeedback]]
33 * [[doc:Beispiel Transport - Punktabzug pro Loesungsversuch]]
34 * [[doc:Beispiel Transport - Wertung der maximal erreichten Punktzahl]]
35 {{/panel}}
Katharina Schönefeld (Admin) 485.1 36
Carina Enke 495.1 37 {{panel borderColor="#ddd" borderStyle="solid" title="Verwandte Themen"}}
Carina Enke 165.1 38 * [[doc:Berechnungsaufgabe]]
39 * [[doc:Formelvergleich]]
Carina Enke 495.1 40 * [[doc:Expertenbewertung]]
Carina Enke 483.1 41 {{/panel}}
Carina Enke 495.1 42
43 {{panel borderColor="#ddd" borderStyle="solid" title="Weiterführende Informationen"}}
44 * [[MAXIMA Manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]]
45 * [[MAXIMA Good-Practice-Beispiele>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]]
46 * [[MAXIMA Systeminformationen>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]]
47 {{/panel}}
Carina Enke 165.1 48
Carina Enke 500.1 49
Carina Enke 495.1 50 \\
Carina Enke 165.1 51
Carina Enke 495.1 52 \\
Carina Enke 165.1 53 {{/layout-cell}}
54 {{/layout-section}}
55
56 {{layout-section ac:type="single"}}
57 {{layout-cell}}
58 (% class="help-heading" %)
Carina Enke 495.1 59 == Vor Anzeige verarbeitete Variablen ==
Carina Enke 483.1 60
Carina Enke 495.1 61 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.
Carina Enke 483.1 62
Carina Enke 495.1 63 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
Carina Enke 483.1 64
Carina Enke 495.1 65 {{info}}
66 Ein typisches Anwendungsbeispiel zum Einsatz von Variablen als Zufallsparameter wird im [[doc:Beispiel Transport - Einsatz von Zufallsparametern]] vorgestellt.
67 {{/info}}
68 {{/layout-cell}}
69 {{/layout-section}}
Carina Enke 483.1 70
Carina Enke 495.1 71 {{layout-section ac:type="single"}}
72 {{layout-cell}}
73 == Nach Abgabe verarbeitete Variablen ==
Carina Enke 483.1 74
Carina Enke 495.1 75 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.
Katharina Schönefeld (Admin) 485.1 76
Carina Enke 495.1 77 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Nutzerlösung einer Beispielaufgabe_de.png]][[image:attach:Testrun - Post-Variable im Feedback_de.png]][[image:attach:Testrun - Post-Variable Lösungshinweis_de.png]]
Katharina Schönefeld (Admin) 485.1 78
Carina Enke 495.1 79 {{info}}
80 Folgende Beispiele zum Einsatz der Nach-Abgabe-verarbeiteten-Variablen zeigen mögliche Anwendungsszenarien:
Katharina Schönefeld (Admin) 485.1 81
Carina Enke 495.1 82 * [[doc:Beispiel Transport - Adaptives Aufgabenfeedback]]
83 * [[Beispiel Transport - Punktabzug pro Lösungsversuch>>doc:Beispiel Transport - Punktabzug pro Loesungsversuch]]
84 * [[doc:Beispiel Transport - Wertung der maximal erreichten Punktzahl]]
85 * [[doc:Expertenbewertung]]
86 {{/info}}
87 {{/layout-cell}}
88 {{/layout-section}}
Katharina Schönefeld (Admin) 485.1 89
Carina Enke 495.1 90 {{layout-section ac:type="single"}}
91 {{layout-cell}}
92 (% class="help-heading" %)
93 == Definition einer Variable ==
Carina Enke 483.1 94
Carina Enke 495.1 95 Klicken Sie im Tab//** **//**Variablen**// //auf den Button (% class="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.
Carina Enke 483.1 96
Carina Enke 495.1 97 [[image:attach:Editor - Definition einer Variable_de.png]]
Carina Enke 483.1 98
Carina Enke 495.1 99 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.
Carina Enke 483.1 100
Carina Enke 495.1 101 Wählen Sie den **Variablen-Typ**. Folgende Variablen-Typen werden bereitgestellt:
Carina Enke 483.1 102
Carina Enke 495.1 103 * [[doc:Numerische Variablen]]:
104 ** Ganze Zahl
105 ** Gleitkommazahl
106 * [[doc:Text Variables]]
107 * [[doc:Bild Variablen]]
Carina Enke 483.1 108
Carina Enke 495.1 109 Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur **Wert-Ermittlung** bereit:
Carina Enke 483.1 110
Carina Enke 495.1 111 * Wert
112 * Wertebereich
113 * Zufällige Auswahl
114 * Berechnung (MAXIMA)
Carina Enke 483.1 115
Carina Enke 495.1 116 Variablen können auch **ohne Wert-Setzung** angelegt werden, um den Wert beispielsweise später in Abhängigkeit anderer Variablen zu setzen (vgl. Bedingungen).
117 {{/layout-cell}}
118 {{/layout-section}}
Carina Enke 483.1 119
Carina Enke 495.1 120 {{layout-section ac:type="single"}}
121 {{layout-cell}}
122 == Verwendung von Variablen ==
Carina Enke 165.1 123
Carina Enke 495.1 124 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.
Carina Enke 165.1 125
Carina Enke 495.1 126 Im Beispiel wurden die Variablen {VAR1}, {VAR2} und {VAR3} deklariert:
Carina Enke 165.1 127
Carina Enke 495.1 128 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]]
129 {{/layout-cell}}
130 {{/layout-section}}
Carina Enke 165.1 131
Carina Enke 495.1 132 {{layout-section ac:type="single"}}
133 {{layout-cell}}
Katharina Schönefeld (Admin) 485.1 134 == Definition einer Bedingung ==
Carina Enke 165.1 135
Carina Enke 495.1 136 Im Tab//** **//**Variablen**// //können Sie zudem Bedingungen verwenden. Eine Bedingung ermöglicht **das Setzen eines Variablen-Wertes, abhängig von anderen Variablen-Werten**.
Carina Enke 165.1 137
Carina Enke 495.1 138 Klicken Sie auf den Button (% class="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.
Carina Enke 165.1 139
Carina Enke 495.1 140 [[image:attach:Editor - Neue Bedinung anlegen_de.png]]
Carina Enke 165.1 141
Carina Enke 495.1 142 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.
Katharina Schönefeld (Admin) 493.1 143
Carina Enke 495.1 144 [[image:attach:Editor - Vergleichsoperatoren_de.png]]
Carina Enke 165.1 145
Carina Enke 495.1 146 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.
Carina Enke 165.1 147
Carina Enke 495.1 148 **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.
Carina Enke 165.1 149
Carina Enke 495.1 150 [[image:attach:Editor - Verknüpfung von Bedingungen_de.png]]
Carina Enke 165.1 151
Carina Enke 495.1 152 **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.
153 {{/layout-cell}}
154 {{/layout-section}}
Carina Enke 165.1 155
Carina Enke 495.1 156 {{layout-section ac:type="single"}}
157 {{layout-cell}}
158 == Expertenmodus (IMS QTI) ==
Carina Enke 165.1 159
Carina Enke 495.1 160 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>>url:http://www.imsglobal.org/question/||title="Zur IMS Homepage" rel="nofollow" shape="rect" class="external-link"]]. 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.
Carina Enke 165.1 161
Carina Enke 495.1 162 [[image:attach:Editor - Variable im Expertenmodus_de.jpg]]
Carina Enke 165.1 163
Carina Enke 495.1 164 Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurückzuwechseln.
Carina Enke 165.1 165
Carina Enke 495.1 166 Weitere Hinweise zur XML-Definition des Template-Processing erhalten Sie in der [[IMS QTI 2.1 Spezifikation>>url:http://www.imsglobal.org/question/||title="Zur IMS Homepage" rel="nofollow" shape="rect" class="external-link"]]. 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.
Carina Enke 165.1 167
Carina Enke 495.1 168 \\
169 {{/layout-cell}}
170 {{/layout-section}}
Carina Enke 165.1 171
Carina Enke 495.1 172 {{layout-section ac:type="single"}}
173 {{layout-cell}}
Carina Enke 165.1 174 == Variablen-Belegung einsehen ==
175
176 Bei der Erprobung Ihrer Testinhalte können Sie die Variablen-Belegung in der [[Vorschau >>doc:Inhalte ansehen]]jederzeit einsehen. Ebenso stehen dem Betreuer oder Bewerter diese Detailinformationen in den [[Ergebniseinsichten >>doc:Ergebniseinsicht]]zu Verfügung. Neben der Variablen-Belegung werden Ihnen auch Informationen zu den MAXIMA-Aufgaben und möglichen Systemfehlern angezeigt.
177
178 Detaillierte Informationen finden Sie in den jeweiligen Hilfeabschnitten zur Ergebniseinsicht für den Betreuer:
179
Carina Enke 495.1 180 * (% class="toc-item-body confluence-link" %)[[Variablen-Belegung einsehen>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-Variablen-BelegungeinsehenVariablen-Belegung||shape="rect"]] (% class="toc-item-body" %)
Carina Enke 165.1 181
182 * (% class="toc-item-body" %)[[MAXIMA-Ausgaben einsehen>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]]
183 * (% class="toc-item-body" %)[[Anzeige von Systemfehlern>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]]
184 {{/layout-cell}}
185 {{/layout-section}}
Carina Enke 495.1 186
187 {{layout-section ac:type="single"}}
188 {{layout-cell}}
189 \\
190 {{/layout-cell}}
191 {{/layout-section}}
192
193 {{layout-section ac:type="single"}}
194 {{layout-cell}}
195 == (% class="toc-item-body" %)Verarbeitungsreihenfolge von Variablen in der Testdurchführung
196 (%%) ==
197 {{/layout-cell}}
198 {{/layout-section}}
199
200 {{layout-section ac:type="two_right_sidebar"}}
201 {{layout-cell}}
202 Die Verarbeitung der durch den Autor definiert(% style="color: rgb(0,0,0);" %)en(%%) Einträge der Abschnitte **Vor Anzeige verarbeitete Variablen **und **Nach Abgabe verarbeitete Variablen **ordnet sich in eine definierte Reihenfolge ein. Das bedeutet, alle vom Autor festgelegten Befehle (Variablensetzung, Bedingung) werden in diese(% style="color: rgb(0,0,0);" %)n(%%) Ablauf integriert. Die Reihenfolge wird immer schrittweise im nachfolgen(% style="color: rgb(0,0,0);" %)d(%%)en Ablaufschema, von "oben nach unten" abgearbeitet. Schritte, die im Text mit grauer Schriftfarbe erscheinen, können vom Autor nicht beeinflusst werden.
203 {{/layout-cell}}
204
205 {{layout-cell}}
206 [[image:attach:Variablenauswertung2.png]]
207 {{/layout-cell}}
208 {{/layout-section}}
209
210 {{layout-section ac:type="single"}}
211 {{layout-cell}}
212 === Testaufruf bzw. Teststart ===
213 {{/layout-cell}}
214 {{/layout-section}}
215
216 {{layout-section ac:type="two_equal"}}
217 {{layout-cell}}
218 * Vor Anzeige aller Aufgaben erfolgt das Pre-Processing der Testvariablen.
219 {{/layout-cell}}
220
221 {{layout-cell}}
222 [[image:attach:image-2023-11-3_14-25-6.png]]
223 {{/layout-cell}}
224 {{/layout-section}}
225
226 {{layout-section ac:type="single"}}
227 {{layout-cell}}
228 === Aufgabenaufruf innerhalb des Tests ===
229 {{/layout-cell}}
230 {{/layout-section}}
231
232 {{layout-section ac:type="two_equal"}}
233 {{layout-cell}}
234 * Existieren Verknüpfungen von Test- oder Aufgabenvariablen, mit dieser Aufgabe, werden sie als erstes ausgewertet und die entsprechenden Werte an die Aufgabe übergeben.
235 * Wird die Aufgabe zum ersten Mal aufgerufen, erfolgt vor Anzeige der Aufgabe das Pre-Processing der Aufgabenvariablen. Bei weiteren Aufgabenversuchen, kann der Autor mit einer optionalen [[ Testeinstellung >>doc:Test-Optionen festlegen]]selbst entscheiden, ob bei Start eines neuen Lösungsversuchs eine erneute Durchführung des Pre-Processings erfolgen soll.
236 * (% style="color: rgb(122,134,154);" %)Wird eine korrekte Antwort dynamisch erzeugt (bspw. bei Formelvergleichs- oder Berechnungsaufgaben), erfolgt nun die Generierung der konkreten Antwort.
237 {{/layout-cell}}
238
239 {{layout-cell}}
240 [[image:attach:image-2023-11-3_14-25-52.png]][[image:attach:image-2023-11-3_14-41-6.png]]
241
242 [[image:attach:image-2023-11-3_14-42-52.png]]
243 {{/layout-cell}}
244 {{/layout-section}}
245
246 {{layout-section ac:type="single"}}
247 {{layout-cell}}
248 === Abgabe einer Aufgabe ===
249 {{/layout-cell}}
250 {{/layout-section}}
251
252 {{layout-section ac:type="two_equal"}}
253 {{layout-cell}}
254 Eine Aufgabe gilt als abgegeben, wenn der Nutzer den Button **Antwort abgeben** an einer Aufgabe klickt oder im linearen Testverlauf auf den Button **Weiter **klickt, um zur nächsten Aufgabe zu navigieren oder wenn der Test beendet wird.
255 {{/layout-cell}}
256
257 {{layout-cell}}
258 [[image:attach:image-2023-11-3_15-15-2.png]]
259 {{/layout-cell}}
260 {{/layout-section}}
261
262 {{layout-section ac:type="two_equal"}}
263 {{layout-cell}}
264 * Mit Abgabe einer Aufgabenantwort erfolgt erst das **Aufgaben-Post-Processing**, anschließend das **Test-Post-Processing**, bevor der Zyklus mit dem Öffnen der nächsten Aufgabe erneut durchlaufen wird oder mit Testabgabe endet.
265
266 (% style="margin-left: 40.0px;" %)
267 ==== Reihenfolge Aufgaben Post-Processing: ====
268
269 *
270 ** (% style="color: rgb(122,134,154);" %)Auswertung der Einzelantworten (setzen von SCORE_GAP_ID)
271 ** (% style="color: rgb(122,134,154);" %)Auswertung der Gesamtaufgabe (setzen von SCORE)
272 ** Variablen Post-Processing durchführen (Autor)
273 ** (% style="color: rgb(122,134,154);" %)Setzen der MINSCORE / MAXSCORE Grenzen
274 ** (% style="color: rgb(122,134,154);" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC)
275 ** (% style="color: rgb(0,0,0);" %)Setzen der individuellen Feedback-Bedingungen
276
277 (% style="margin-left: 40.0px;" %)
278 ==== Reihenfolge Test Post-Processing: ====
279
280 *
281 ** (% style="color: rgb(122,134,154);" %)Auswertung der Sektionen (setzen von SCORE_SECTION_ID)
282 ** (% style="color: rgb(122,134,154);" %)Auswertung des Tests (setzen von SCORE)
283 ** (% style="color: rgb(122,134,154);" %)Auswertung des Tests (setzen von PASS)
284 ** Variablen Post-Processing
285 ** (% style="color: rgb(122,134,154);" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC)
286 ** Setzen der individuellen Feedback-Bedingungen
287 {{/layout-cell}}
288
289 {{layout-cell}}
290 [[image:attach:image-2023-11-3_14-46-47.png]][[image:attach:image-2023-11-3_14-54-46.png]]
291 {{/layout-cell}}
292 {{/layout-section}}
293
294 {{layout-section ac:type="single"}}
295 {{layout-cell}}
296 === Abgabe eines Tests ===
297 {{/layout-cell}}
298 {{/layout-section}}
299
300 {{layout-section ac:type="two_equal"}}
301 {{layout-cell}}
302 * Mit Abgabe Tests erfolgt das beschriebene Test Post-Processing ein letztes Mal.
303 {{/layout-cell}}
304
305 {{layout-cell}}
306 \\
307 {{/layout-cell}}
308 {{/layout-section}}
Carina Enke 165.1 309 {{/layout}}
Carina Enke 495.1 310
Carina Enke 497.1 311
Carina Enke 498.1 312
Carina Enke 495.1 313 {{layout}}
314 {{layout-section ac:type="two_right_sidebar"}}
315 {{layout-cell}}
316 The use of variables allows the creation of dynamic task text. Task content can be generated randomly or adapted to the user, previously given answers, or assessments. For implementation, two different types of variables are provided in the tab of the same name:
317
318 * **Pre-processed variables**
319 Pre-variables are assigned before the task is displayed and therefore make it possible to adapt the task text as well as the predefined and correct answers dynamically. In this way, task templates can be defined with the help of placeholders. These are replaced by specific random values per test run on the basis of defined intervals, value drop-down lists, or calculation rules. As a result, test tasks will be different but similar for each participant and test run.
320 * **{{id name="PostVariablen_en"/}}Post-processed variables**
321 Post-variables are only assigned after the task has been answered, submitted, and automatically assessed, thus allowing access to response-specific values such as the learner's response or the points for correct answers. In this way, adaptive feedback content, follow-up tests, and task series can be enabled. The use of conditions and MAXIMA statements allows responses from learners to be analysed and typical errors identified. Based on these insights, teachers will then be able to provide appropriate feedback or customised exercises.
322
323 [[image:attach:Editor - Tab Variablen_de.png]]
324 {{/layout-cell}}
325
326 {{layout-cell}}
Carina Enke 499.1 327
Carina Enke 495.1 328 {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}}
329
330
331 {{toc/}}
332 {{/panel}}
333
334 {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Related topics"}}
335 * [[Calculation interaction>>doc:Berechnungsaufgabe]]
336 * [[Formula comparison>>doc:Formelvergleich]]
337 * [[doc:Expertenbewertung]]
338 {{/panel}}
339
340 {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Further information"}}
341 * [[MAXIMA manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]]
342 * [[MAXIMA good practice examples>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]]
343 * [[MAXIMA system information>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]]
344 {{/panel}}
Carina Enke 500.1 345
Carina Enke 495.1 346 {{/layout-cell}}
347 {{/layout-section}}
348
349 {{layout-section ac:type="single"}}
350 {{layout-cell}}
351 (% class="help-heading" %)
352 == Pre-processed variables ==
353
354 (% class="help-heading" %)
355 Define variables that are determined before the task is displayed in order to use (% style="background-color: rgb(255,255,255);font-size: 14.0px;" %)**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 (% style="background-color: rgb(255,255,255);font-size: 14.0px;" %)**an unlimited number of different test and exam attempts**(%%).
356
357 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
358
359 {{info}}
360 For a typical application example for the use of variables as random parameters, see [[Example "Transport" - Use of random parameters>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]].
361 {{/info}}
362
363 == (% style="background-color: rgb(220,231,239);font-size: 20.0px;" %)Post-processed variables(%%) ==
364
365 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.
366
367 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Nutzerlösung einer Beispielaufgabe_de.png]][[image:attach:Testrun - Post-Variable im Feedback_de.png]][[image:attach:Testrun - Post-Variable Lösungshinweis_de.png]]
368
369 \\
370
371 {{info}}
372 The following examples for the use of post-processed variables show possible application scenarios:
373
374 * [[Example "Transport" - Adaptive task feedback>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]]
375 * [[Example "Transport" - Points deduction per attempt>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]]
376 * [[Example "Transport" - Assessment of the maximum score>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]]
377 * [[doc:Expertenbewertung]]
378 {{/info}}
379
380 == Definition of a variable ==
381
382 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.
383
384 [[image:attach:Editor - Definition einer Variable_de.png]]
385
386 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}.
387
388 Select the **variable type**. The following variable types are available:
389
390 * [[Numerical variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]:
391 ** Integer
392 ** Floating-point number
393 * [[Text variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]]
394 * [[Image variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Bild+Variablen+v1.11||shape="rect"]]
395
396 Depending on the selected variable type, you have various options for the **determination of the value**:
397
398 * Value
399 * Value range
400 * Random selection
401 * Calculation (MAXIMA)
402
403 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).
404
405 == Use of variables ==
406
407 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.
408
409 In the example, the variables {VAR1}, {VAR2}, and {VAR3} were declared:
410
411 [[image:attach:Beispiel zur Verwendung von Variablen_de.png]]
412
413 == Definition of a condition ==
414
415 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**.
416
417 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.
418
419 [[image:attach:Editor - Neue Bedinung anlegen_de.png]]
420
421 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.
422
423 [[image:attach:Editor - Vergleichsoperatoren_de.png]]
424
425 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.
426
427 **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.
428
429 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" style="color: rgb(255,102,0);" %)[[image:attach:Editor - Verknüpfung von Bedingungen_de.png]]
430
431 (% style="color: rgb(51,51,51);" %)**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.
432
433 == Expert mode (IMS QTI) ==
434
435 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>>url:http://www.imsglobal.org/question/||shape="rect"]]. 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.
436
437 [[image:attach:Editor - Variable im Expertenmodus_de.jpg]]
438
439 Please note that after changing the description in the expert mode, there is no way to return to the simple mode.
440
441 For further information on the XML definition of the template processing, please refer to the section [[IMS QTI 2.1>>url:http://www.imsglobal.org/question/||shape="rect"]] [[specification>>url:http://www.imsglobal.org/question/||shape="rect"]]. 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.
442
443 == View variable assignment ==
444
445 When testing your test content, you can view the variable assignment in the [[preview>>url:https://www.bps-system.de/help/display/ONYXintern/.Inhalte+ansehen+v1.11||shape="rect"]] at any time. These details are also available to the supervisor or assessor in the [[results views>>url:https://www.bps-system.de/help/display/ONYXintern/.Ergebniseinsicht+v1.11||shape="rect"]]. In addition to the variable assignment, information on the MAXIMA tasks as well as possible system errors are displayed.
446
447 For more detailed information, please refer to the following help sections:
448
449 * [[View variable assignment>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-Variablen-BelegungeinsehenVariablen-Belegung||shape="rect"]]
450 * [[View MAXIMA output>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]]
451 * [[Display of system errors>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]]
452 {{/layout-cell}}
453 {{/layout-section}}
454 {{/layout}}
Carina Enke 497.1 455