Änderungen von Dokument 07 Variablen verwenden
Zuletzt geändert von Carina Enke am 25.07.2024
Von Version 502.1
bearbeitet von Hendrik Zschocke
am 11.01.2024
am 11.01.2024
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Auf Version 501.2
bearbeitet von Carina Enke
am 20.12.2023
am 20.12.2023
Änderungskommentar:
Updated the relative links.
Zusammenfassung
-
Seiteneigenschaften (3 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Übergeordnete Seite
-
... ... @@ -1,1 +1,1 @@ 1 -ONYX. Erstellungvon Testinhalten.Aufgaben.WebHome1 +ONYX.ONYX Editor.Aufgaben.WebHome - Dokument-Autor
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. hendrik1 +XWiki.carina - Inhalt
-
... ... @@ -1,7 +1,7 @@ 1 1 {{layout}} 2 2 {{layout-section ac:type="single"}} 3 3 {{layout-cell}} 4 - 4 +\\ 5 5 {{/layout-cell}} 6 6 {{/layout-section}} 7 7 ... ... @@ -9,11 +9,11 @@ 9 9 {{layout-cell}} 10 10 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: 11 11 12 -* **Vor Anzeige verarbeitete Variablen** 12 +* **Vor Anzeige verarbeitete Variablen** 13 13 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. 14 -* **{{id name="PostVariablen"/}}Nach Abgabe verarbeitete Variablen** 14 +* **{{id name="PostVariablen"/}}Nach Abgabe verarbeitete Variablen** 15 15 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. 16 - 16 +\\ 17 17 18 18 [[image:attach:Editor - Tab Variablen_de.png]] 19 19 {{/layout-cell}} ... ... @@ -20,6 +20,8 @@ 20 20 21 21 {{layout-cell}} 22 22 {{panel borderColor="#ddd" borderStyle="solid" title="Inhalt"}} 23 + 24 + 23 23 {{toc/}} 24 24 {{/panel}} 25 25 ... ... @@ -43,19 +43,20 @@ 43 43 {{/panel}} 44 44 45 45 48 +\\ 46 46 47 - 50 +\\ 48 48 {{/layout-cell}} 49 49 {{/layout-section}} 50 50 51 51 {{layout-section ac:type="single"}} 52 52 {{layout-cell}} 53 -(% id="HVorAnzeigeverarbeiteteVariablen"class="help-heading" %)56 +(% class="help-heading" %) 54 54 == Vor Anzeige verarbeitete Variablen == 55 55 56 56 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. 57 57 58 -(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]61 +(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]] 59 59 60 60 {{info}} 61 61 Ein typisches Anwendungsbeispiel zum Einsatz von Variablen als Zufallsparameter wird im [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Einsatz von Zufallsparametern]] vorgestellt. ... ... @@ -69,7 +69,7 @@ 69 69 70 70 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. 71 71 72 -(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[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]]75 +(% 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]] 73 73 74 74 {{info}} 75 75 Folgende Beispiele zum Einsatz der Nach-Abgabe-verarbeiteten-Variablen zeigen mögliche Anwendungsszenarien: ... ... @@ -84,7 +84,7 @@ 84 84 85 85 {{layout-section ac:type="single"}} 86 86 {{layout-cell}} 87 -(% id="HDefinitioneinerVariable"class="help-heading" %)90 +(% class="help-heading" %) 88 88 == Definition einer Variable == 89 89 90 90 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. ... ... @@ -120,7 +120,7 @@ 120 120 121 121 Im Beispiel wurden die Variablen {VAR1}, {VAR2} und {VAR3} deklariert: 122 122 123 -(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]]126 +(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]] 124 124 {{/layout-cell}} 125 125 {{/layout-section}} 126 126 ... ... @@ -152,15 +152,15 @@ 152 152 {{layout-cell}} 153 153 == Expertenmodus (IMS QTI) == 154 154 155 -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/||rel="nofollow" shape="rect" title="Zur IMS Homepage"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.158 +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. 156 156 157 157 [[image:attach:Editor - Variable im Expertenmodus_de.jpg]] 158 158 159 159 Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurückzuwechseln. 160 160 161 -Weitere Hinweise zur XML-Definition des Template-Processing erhalten Sie in der [[IMS QTI 2.1 Spezifikation>>url:http://www.imsglobal.org/question/||rel="nofollow" shape="rect" title="Zur IMS Homepage"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.164 +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. 162 162 163 - 166 +\\ 164 164 {{/layout-cell}} 165 165 {{/layout-section}} 166 166 ... ... @@ -168,11 +168,11 @@ 168 168 {{layout-cell}} 169 169 == Variablen-Belegung einsehen == 170 170 171 -Bei der Erprobung Ihrer Testinhalte können Sie die Variablen-Belegung in der [[Vorschau >>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Inhalte ansehen]]jederzeit einsehen. Ebenso stehen dem Betreuer oder Bewerter diese Detailinformationen in den [[Ergebniseinsichten>>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Ergebniseinsicht]]zu Verfügung. Neben der Variablen-Belegung werden Ihnen auch Informationen zu den MAXIMA-Aufgaben und möglichen Systemfehlern angezeigt.174 +Bei der Erprobung Ihrer Testinhalte können Sie die Variablen-Belegung in der [[Vorschau >>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Inhalte ansehen]]jederzeit einsehen. Ebenso stehen dem Betreuer oder Bewerter diese Detailinformationen in den [[Ergebniseinsichten >>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Ergebniseinsicht]]zu Verfügung. Neben der Variablen-Belegung werden Ihnen auch Informationen zu den MAXIMA-Aufgaben und möglichen Systemfehlern angezeigt. 172 172 173 173 Detaillierte Informationen finden Sie in den jeweiligen Hilfeabschnitten zur Ergebniseinsicht für den Betreuer: 174 174 175 -* (% class="confluence-link toc-item-body" %)[[Variablen-Belegung einsehen>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-Variablen-BelegungeinsehenVariablen-Belegung||shape="rect"]] (% class="toc-item-body" %)178 +* (% 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" %) 176 176 177 177 * (% class="toc-item-body" %)[[MAXIMA-Ausgaben einsehen>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]] 178 178 * (% class="toc-item-body" %)[[Anzeige von Systemfehlern>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]] ... ... @@ -181,19 +181,20 @@ 181 181 182 182 {{layout-section ac:type="single"}} 183 183 {{layout-cell}} 184 - 187 +\\ 185 185 {{/layout-cell}} 186 186 {{/layout-section}} 187 187 188 188 {{layout-section ac:type="single"}} 189 189 {{layout-cell}} 190 -== (% class="toc-item-body" %)Verarbeitungsreihenfolge von Variablen in der Testdurchführung(%%) == 193 +== (% class="toc-item-body" %)Verarbeitungsreihenfolge von Variablen in der Testdurchführung 194 +(%%) == 191 191 {{/layout-cell}} 192 192 {{/layout-section}} 193 193 194 194 {{layout-section ac:type="two_right_sidebar"}} 195 195 {{layout-cell}} 196 -Die Verarbeitung der durch den Autor definiert(% style="color: #000000" %)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:#000000" %)n(%%) Ablauf integriert. Die Reihenfolge wird immer schrittweise im nachfolgen(% style="color:#000000" %)d(%%)en Ablaufschema, von "oben nach unten" abgearbeitet. Schritte, die im Text mit grauer Schriftfarbe erscheinen, können vom Autor nicht beeinflusst werden.200 +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. 197 197 {{/layout-cell}} 198 198 199 199 {{layout-cell}} ... ... @@ -227,7 +227,7 @@ 227 227 {{layout-cell}} 228 228 * Existieren Verknüpfungen von Test- oder Aufgabenvariablen, mit dieser Aufgabe, werden sie als erstes ausgewertet und die entsprechenden Werte an die Aufgabe übergeben. 229 229 * 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:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Test-Optionen festlegen]]selbst entscheiden, ob bei Start eines neuen Lösungsversuchs eine erneute Durchführung des Pre-Processings erfolgen soll. 230 -* (% style="color: #7a869a" %)Wird eine korrekte Antwort dynamisch erzeugt (bspw. bei Formelvergleichs- oder Berechnungsaufgaben), erfolgt nun die Generierung der konkreten Antwort.234 +* (% style="color: rgb(122,134,154);" %)Wird eine korrekte Antwort dynamisch erzeugt (bspw. bei Formelvergleichs- oder Berechnungsaufgaben), erfolgt nun die Generierung der konkreten Antwort. 231 231 {{/layout-cell}} 232 232 233 233 {{layout-cell}} ... ... @@ -260,23 +260,23 @@ 260 260 (% style="margin-left: 40.0px;" %) 261 261 ==== Reihenfolge Aufgaben Post-Processing: ==== 262 262 263 -* 264 -** (% style="color: #7a869a" %)Auswertung der Einzelantworten (setzen von SCORE_GAP_ID)265 -** (% style="color: #7a869a" %)Auswertung der Gesamtaufgabe (setzen von SCORE)267 +* 268 +** (% style="color: rgb(122,134,154);" %)Auswertung der Einzelantworten (setzen von SCORE_GAP_ID) 269 +** (% style="color: rgb(122,134,154);" %)Auswertung der Gesamtaufgabe (setzen von SCORE) 266 266 ** Variablen Post-Processing durchführen (Autor) 267 -** (% style="color: #7a869a" %)Setzen der MINSCORE / MAXSCORE Grenzen268 -** (% style="color: #7a869a" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC)269 -** (% style="color: #000000" %)Setzen der individuellen Feedback-Bedingungen271 +** (% style="color: rgb(122,134,154);" %)Setzen der MINSCORE / MAXSCORE Grenzen 272 +** (% style="color: rgb(122,134,154);" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC) 273 +** (% style="color: rgb(0,0,0);" %)Setzen der individuellen Feedback-Bedingungen 270 270 271 271 (% style="margin-left: 40.0px;" %) 272 272 ==== Reihenfolge Test Post-Processing: ==== 273 273 274 -* 275 -** (% style="color: #7a869a" %)Auswertung der Sektionen (setzen von SCORE_SECTION_ID)276 -** (% style="color: #7a869a" %)Auswertung des Tests (setzen von SCORE)277 -** (% style="color: #7a869a" %)Auswertung des Tests (setzen von PASS)278 +* 279 +** (% style="color: rgb(122,134,154);" %)Auswertung der Sektionen (setzen von SCORE_SECTION_ID) 280 +** (% style="color: rgb(122,134,154);" %)Auswertung des Tests (setzen von SCORE) 281 +** (% style="color: rgb(122,134,154);" %)Auswertung des Tests (setzen von PASS) 278 278 ** Variablen Post-Processing 279 -** (% style="color: #7a869a" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC)283 +** (% style="color: rgb(122,134,154);" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC) 280 280 ** Setzen der individuellen Feedback-Bedingungen 281 281 {{/layout-cell}} 282 282 ... ... @@ -295,5 +295,152 @@ 295 295 {{layout-cell}} 296 296 * Mit Abgabe Tests erfolgt das beschriebene Test Post-Processing ein letztes Mal. 297 297 {{/layout-cell}} 302 + 303 +{{layout-cell}} 304 +\\ 305 +{{/layout-cell}} 298 298 {{/layout-section}} 299 299 {{/layout}} 308 + 309 + 310 + 311 +{{layout}} 312 +{{layout-section ac:type="two_right_sidebar"}} 313 +{{layout-cell}} 314 +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: 315 + 316 +* **Pre-processed variables** 317 +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. 318 +* **{{id name="PostVariablen_en"/}}Post-processed variables** 319 +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. 320 + 321 +[[image:attach:Editor - Tab Variablen_de.png]] 322 +{{/layout-cell}} 323 + 324 +{{layout-cell}} 325 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}} 326 + 327 + 328 +{{toc/}} 329 +{{/panel}} 330 + 331 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Related topics"}} 332 +* [[Calculation interaction>>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Berechnungsaufgabe]] 333 +* [[Formula comparison>>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Formelvergleich]] 334 +* [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Expertenbewertung]] 335 +{{/panel}} 336 + 337 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Further information"}} 338 +* [[MAXIMA manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]] 339 +* [[MAXIMA good practice examples>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]] 340 +* [[MAXIMA system information>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]] 341 +{{/panel}} 342 +{{/layout-cell}} 343 +{{/layout-section}} 344 + 345 +{{layout-section ac:type="single"}} 346 +{{layout-cell}} 347 +(% class="help-heading" %) 348 +== Pre-processed variables == 349 + 350 +(% class="help-heading" %) 351 +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**(%%). 352 + 353 +(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]] 354 + 355 +{{info}} 356 +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"]]. 357 +{{/info}} 358 + 359 +== (% style="background-color: rgb(220,231,239);font-size: 20.0px;" %)Post-processed variables(%%) == 360 + 361 +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. 362 + 363 +(% 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]] 364 + 365 +\\ 366 + 367 +{{info}} 368 +The following examples for the use of post-processed variables show possible application scenarios: 369 + 370 +* [[Example "Transport" - Adaptive task feedback>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]] 371 +* [[Example "Transport" - Points deduction per attempt>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]] 372 +* [[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"]] 373 +* [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Expertenbewertung]] 374 +{{/info}} 375 + 376 +== Definition of a variable == 377 + 378 +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. 379 + 380 +[[image:attach:Editor - Definition einer Variable_de.png]] 381 + 382 +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}. 383 + 384 +Select the **variable type**. The following variable types are available: 385 + 386 +* [[Numerical variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]: 387 +** Integer 388 +** Floating-point number 389 +* [[Text variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]] 390 +* [[Image variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Bild+Variablen+v1.11||shape="rect"]] 391 + 392 +Depending on the selected variable type, you have various options for the **determination of the value**: 393 + 394 +* Value 395 +* Value range 396 +* Random selection 397 +* Calculation (MAXIMA) 398 + 399 +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). 400 + 401 +== Use of variables == 402 + 403 +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. 404 + 405 +In the example, the variables {VAR1}, {VAR2}, and {VAR3} were declared: 406 + 407 +[[image:attach:Beispiel zur Verwendung von Variablen_de.png]] 408 + 409 +== Definition of a condition == 410 + 411 +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**. 412 + 413 +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. 414 + 415 +[[image:attach:Editor - Neue Bedinung anlegen_de.png]] 416 + 417 +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. 418 + 419 +[[image:attach:Editor - Vergleichsoperatoren_de.png]] 420 + 421 +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. 422 + 423 +**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. 424 + 425 +(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" style="color: rgb(255,102,0);" %)[[image:attach:Editor - Verknüpfung von Bedingungen_de.png]] 426 + 427 +(% 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. 428 + 429 +== Expert mode (IMS QTI) == 430 + 431 +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. 432 + 433 +[[image:attach:Editor - Variable im Expertenmodus_de.jpg]] 434 + 435 +Please note that after changing the description in the expert mode, there is no way to return to the simple mode. 436 + 437 +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. 438 + 439 +== View variable assignment == 440 + 441 +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. 442 + 443 +For more detailed information, please refer to the following help sections: 444 + 445 +* [[View variable assignment>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-Variablen-BelegungeinsehenVariablen-Belegung||shape="rect"]] 446 +* [[View MAXIMA output>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]] 447 +* [[Display of system errors>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]] 448 +{{/layout-cell}} 449 +{{/layout-section}} 450 +{{/layout}}