Änderungen von Dokument 07 Variablen verwenden
Zuletzt geändert von Carina Enke am 25.07.2024
Von Version 449.1
bearbeitet von Carina Enke
am 24.09.2018
am 24.09.2018
Änderungskommentar:
Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.11.1.
Auf Version 413.1
bearbeitet von Carina Enke
am 08.05.2019
am 08.05.2019
Änderungskommentar:
Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 8.7.
Zusammenfassung
-
Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
-
Objekte (1 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Inhalt
-
... ... @@ -1,81 +1,8 @@ 1 +{{sv-translation language="de"}} 1 1 {{layout}} 2 2 {{layout-section ac:type="single"}} 3 3 {{layout-cell}} 4 - 5 - 6 -{{conditionalcontent 0="Zielgruppe: (BPS)" sv-attr:866DE48701525447C13BC59401CD793F="866DE48701525447C13C469E1E314A59" atlassian-macro-output-type="INLINE"}} 7 -{{details}} 8 -|=((( 9 -Verantwortlicher 10 -)))|((( 11 - 12 -))) 13 -|=(% colspan="1" %)(% colspan="1" %) 14 -((( 15 -Status 16 -)))|(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %)(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %) 17 -((( 18 -{{sv-metadata type="workflow-status"/}} 19 - 20 -{{status colour="Green" title="Fertig"/}} 21 -))) 22 -|=(% colspan="1" %)(% colspan="1" %) 23 -((( 24 -Varianten 25 -)))|(% colspan="1" %)(% colspan="1" %) 26 -((( 27 -{{sv-metadata type="variants"/}} 28 -))) 29 -|=(% colspan="1" %)(% colspan="1" %) 30 -((( 31 -Attribute 32 -)))|(% colspan="1" %)(% colspan="1" %) 33 -((( 34 -{{sv-metadata type="attributes"/}} 35 -))) 36 -|=(% colspan="1" %)(% colspan="1" %) 37 -((( 38 -Pagekey 39 -)))|(% colspan="1" %)(% colspan="1" %) 40 -((( 41 -{{sv-metadata type="pagekey"/}} 42 -))) 43 -|=(% colspan="1" %)(% colspan="1" %) 44 -((( 45 -Übersetzung 46 -)))|(% colspan="1" %)(% colspan="1" %) 47 -((( 48 -{{status colour="Yellow" title="Update"/}} 49 -))) 50 -|=(% colspan="1" %)(% colspan="1" %) 51 -((( 52 -TODOs 53 -)))|(% colspan="1" %)(% colspan="1" %) 54 -((( 55 -(% class="task-list" %) 56 -((( 57 -{{task reference="/Tasks/Task_1" status="Done"}} 58 -carina: MARKETING-143 Versionstypen angepasst 59 -Deutsche Bildüberschriften und englische Bilder fehlen noch. 60 -{{/task}} 61 - 62 -{{task reference="/Tasks/Task_2" status="Done"}} 63 -{{mention reference="XWiki.carina" style="FULL_NAME" anchor="XWiki-carina-XIOes"/}}: Bitte finalisieren und online bringen. 64 64 \\ 65 -{{/task}} 66 -))) 67 -))) 68 -|=(% colspan="1" %)(% colspan="1" %) 69 -((( 70 -Beispieldateien 71 -)))|(% colspan="1" %)(% colspan="1" %) 72 -((( 73 -[[attach:Transport__maxScore_.zip]] 74 - 75 -[[attach:Transport__deduction_.zip]] 76 -))) 77 -{{/details}} 78 -{{/conditionalcontent}} 79 79 {{/layout-cell}} 80 80 {{/layout-section}} 81 81 ... ... @@ -84,12 +84,11 @@ 84 84 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: 85 85 86 86 * **Vor Anzeige verarbeitete Variablen** 87 -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 mit Hilfe von Platzhaltern Aufgabenschablonen definiert werden. Die Platzhalter werden pro Testdurchlauf auf Basis definierter Intervalle, Wertauswahllisten oder Berechnungsvorschriften durch konkrete Zufallswerten ersetzt. Für unterschiedliche Teilnehmer und Testdurchläufe entstehen somit verschiedene, aber gleichartige Testaufgaben. 88 -* **Nach Abgabe verarbeitete Variablen** 89 -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. Mit Hilfe 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. 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 +\\ 90 90 91 - 92 - 93 93 [[image:attach:Editor - Tab Variablen_de.png]] 94 94 {{/layout-cell}} 95 95 ... ... @@ -101,6 +101,13 @@ 101 101 {{toc/}} 102 102 {{/panel}} 103 103 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}} 36 + 104 104 {{panel borderColor="#ddd" borderStyle="solid" title="Verwandte Themen"}} 105 105 * [[doc:Berechnungsaufgabe]] 106 106 * [[doc:Formelvergleich]] ... ... @@ -113,9 +113,9 @@ 113 113 {{/panel}} 114 114 {{/scroll-ignore}} 115 115 116 - 49 +\\ 117 117 118 - 51 +\\ 119 119 {{/layout-cell}} 120 120 {{/layout-section}} 121 121 ... ... @@ -128,280 +128,427 @@ 128 128 129 129 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]] 130 130 64 +\\ 131 131 66 +{{info}} 67 +Ein typisches Anwendungsbeispiel zum Einsatz von Variablen als Zufallsparameter wird im [[doc:Beispiel Transport - Einsatz von Zufallsparametern]] vorgestellt. 68 +{{/info}} 132 132 133 - {{idname="Beispiel~"Transport~" - Einsatzvon Zufallsparametern"/}}70 +== Nach Abgabe verarbeitete Variablen == 134 134 135 - === Beispiel"Transport"-Einsatzvon Zufallsparametern===72 +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. 136 136 137 - AlsBeispielwirdeine typischeAnwendungsaufgabeerstellt. Es sollderzurückgelegteWegeinesbeliebigen Fahrzeugsauf GrundlagederGeschwindigkeit und derZeitberechnet werden.DieGeschwindigkeitistdabeiabhängigvomFahrzeugtyp.74 +(% 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]] 138 138 76 +\\ 77 + 78 +{{info}} 79 +Folgende Beispiele zum Einsatz der Nach-Abgabe-verarbeiteten-Variablen zeigen mögliche Anwendungsszenarien: 80 + 81 +* [[doc:Beispiel Transport - Adaptives Aufgabenfeedback]] 82 +* [[doc:Beispiel Transport - Punktabzug pro Loesungsversuch]] 83 +* [[doc:Beispiel Transport - Wertung der maximal erreichten Punktzahl]] 84 +{{/info}} 85 + 86 +(% class="help-heading" %) 87 +== Definition einer Variable == 88 + 89 +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. 90 + 91 +[[image:attach:Editor - Definition einer Variable_de.png]] 92 + 93 +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. 94 + 95 +Wählen Sie den **Variablen-Typ**. Folgende Variablen-Typen werden bereitgestellt: 96 + 97 +* [[doc:Numerische Variablen]]: 98 +** Ganze Zahl 99 +** Gleitkommazahl 100 +* [[doc:Text Variables]] 101 +* [[doc:Bild Variablen]] 102 + 103 +Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur **Wert-Ermittlung** bereit: 104 + 105 +* Wert 106 +* Wertebereich 107 +* Zufällige Auswahl 108 +* Berechnung (MAXIMA) 109 + 110 +Variablen können auch **ohne Wert-Setzung** angelegt werden, um den Wert beispielsweise später in Abhängigkeit anderer Variablen zu setzen (vgl. Bedingungen). 111 + 112 +== Verwendung von Variablen == 113 + 114 +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. 115 + 116 +Im Beispiel wurden die Variablen {VAR1}, {VAR2} und {VAR3} deklariert: 117 + 118 +(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]] 119 + 120 +== Definition einer Bedingung == 121 + 122 +Im Tab//** Variablen** //können Sie zudem Bedingungen verwenden. Eine Bedingung ermöglicht **das Setzen eines Variablen-Wertes, abhängig von anderen Variablen-Werten**. 123 + 124 +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. 125 + 126 +[[image:attach:Editor - Neue Bedinung anlegen_de.png]] 127 + 128 +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. 129 + 130 +[[image:attach:Editor - Vergleichsoperatoren_de.png]] 131 + 132 +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. 133 + 134 +**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. 135 + 136 +[[image:attach:Editor - Verknüpfung von Bedingungen_de.png]] 137 + 138 +**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. 139 + 140 +== Expertenmodus (IMS QTI) == 141 + 142 +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. 143 + 144 +[[image:attach:Editor - Variable im Expertenmodus_de.jpg]] 145 + 146 +Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurückzuwechseln. 147 + 148 +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. 149 + 150 +== Variablen-Belegung einsehen == 151 + 152 +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. 153 + 154 +Detaillierte Informationen finden Sie in den jeweiligen Hilfeabschnitten zur Ergebniseinsicht für den Betreuer: 155 + 156 +* (% 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" %) 157 + 158 +* (% class="toc-item-body" %)[[MAXIMA-Ausgaben einsehen>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]] 159 +* (% class="toc-item-body" %)[[Anzeige von Systemfehlern>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]] 160 +{{/layout-cell}} 161 +{{/layout-section}} 162 +{{/layout}} 163 +{{/sv-translation}} 164 + 165 +{{sv-translation language="en"}} 166 +{{layout}} 167 +{{layout-section ac:type="two_right_sidebar"}} 168 +{{layout-cell}} 169 +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: 170 + 171 +* **Pre-processed variables** 172 +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. 173 +* **Post-processed variables** 174 +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. 175 + 176 +[[image:attach:Editor - Tab Variablen_de.png]] 177 +{{/layout-cell}} 178 + 179 +{{layout-cell}} 180 +{{scroll-ignore}} 181 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}} 182 + 183 + 184 +{{toc/}} 185 +{{/panel}} 186 + 187 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Related topics"}} 188 +* [[Calculation interaction>>doc:Berechnungsaufgabe]] 189 +* [[Formula comparison>>doc:Formelvergleich]] 190 +{{/panel}} 191 + 192 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Further information"}} 193 +* [[MAXIMA manual>>url:http://maxima.sourceforge.net/docs/manual/maxima.html||shape="rect"]] 194 +* [[MAXIMA good practice examples>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]] 195 +* [[MAXIMA system information>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]] 196 +{{/panel}} 197 +{{/scroll-ignore}} 198 +{{/layout-cell}} 199 +{{/layout-section}} 200 + 201 +{{layout-section ac:type="single"}} 202 +{{layout-cell}} 203 +(% class="help-heading" %) 204 +== Pre-processed variables == 205 + 206 +(% class="help-heading" %) 207 +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**(%%). 208 + 209 +(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]] 210 + 211 + 212 + 213 +{{id name="Example ~"transport~" - Use of random parameters"/}} 214 + 215 +=== Example "transport" - Use of random parameters === 216 + 217 +As an example, a typical application task is created. The goal is to calculate the distance travelled by a vehicle based on speed and time. The speed is dependent on the vehicle type. 218 + 219 + 220 + 139 139 |(% colspan="1" %)(% colspan="1" %) 140 140 ((( 141 141 [[image:attach:Editor - Tab Variablen zur Beispielaufgabe_de.png]] 142 142 )))|(% colspan="1" %)(% colspan="1" %) 143 143 ((( 144 -Im Beispiel wird die [[Text-Variable>>doc:Textvariablen]] {transport} zufällig mit einem der Werte "bike", "bus", "car" oder "train" initialisiert. Die [[Numerische Variable>>doc:Numerische Variablen]] {speed} soll aus einem Wertebereich zufällig gesetzt werden. Dabei soll der Wertebereich für die Geschwindigkeit {speed} in Abhängigkeit von dem gewählten Fahrzeug {transport} gesetzt werden. Schließlich fährt im Allgemeinen ein "bike" langsamer, als ein "train". 145 - 146 - 226 +In the example, the [[text variable>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]] {transport} will be randomly initialised with one of the following values: "bike", "bus", or "train". The [[numeric variable>>doc:Numerische Variablen]] {speed} is randomly selected from a value range. Thus, the value range for the speed {speed} should be set in dependence of the selected vehicle {transport}, since a "bike" is generally slower than a "train". 147 147 ))) 148 148 |((( 149 149 [[image:attach:Editor - Beispiel einer Bedingung_de.png]][[image:attach:Editor - weiteres Beispiel einer Bedingung_de.png]] 150 150 )))|((( 151 - ZurabhängigenWertsetzungnutzenwir dieVariablen-Bedingung. InderBedingungkönnenwir inAbhängigkeitvon demgewähltenWertderVariable {transport} denWertebereichfürdieVariable {speed} definieren. Fürdas Fahrrad({transport}="bike")wirdauf dieseWeiseeinWertebereichvon10bis30 (km/h)gesetzt.231 +For dependent value setting, we use the variable condition. In the condition, we can define the value range for the variable {speed} depending on the selected value of the variable {transport}. For the bike ({transport}="bike"), for example, a value range of 10 to 30 (km/h) was set. 152 152 ))) 153 153 |((( 154 154 [[image:attach:Editor - Nutzung von Variablen in der Aufgabenstellung_de.png]] 155 155 )))|((( 156 - Die gegebenenWertederAufgabewerdenindenAufgabentextdurchAngabedesVariablen-Namens({transport}, {speed}und {hours})eingebunden. ImBeispielwird dieVariable ineineAufgabevonTyp [[Berechnung(Lückentext)>>doc:Berechnungsaufgabe]]eingebunden.236 +The given values of the task are integrated into the task text by specifying the variable name ({transport}, {speed}, and {hours}). In the example, the variable is included in a task of the type [[calculation interaction>>url:https://www.bps-system.de/help/display/ONYXintern/.Berechnungsaufgabe+v1.6||shape="rect"]]. 157 157 158 -An die Lücke wird die Variable mit der korrekten Lösung {distance} gebunden. 159 - 160 - 238 +The variable with the correct solution {distance} is bound to the gap. 161 161 ))) 162 162 |((( 163 163 [[image:attach:Testrun - Beispielaufgabe im Testrun_de.png]] 164 164 )))|((( 165 - Für denTestdurchlaufwirdfürjedenTeilnehmerundjedenVersuchzufällig einerderdefiniertenWerte ausgewählt. ImBeispielwurdezufällig derWert"bike"eingesetztunddamiteineGeschwindigkeitimWertebereichvon10bis30 (km/h)gewählt.243 +One of the defined values will be randomly chosen for each participant and each test attempt. In the example, the value "bike" was randomly inserted, which is why a speed in the value range of 10 to 30 (km/h) was selected. 166 166 ))) 167 167 168 168 169 169 170 -{{id name=" Nach Abgabe verarbeitete Variablen"/}}248 +{{id name="Post-processed variables"/}}\\ 171 171 172 -== NachAbgabe verarbeiteteVariablen==250 +== (% style="background-color: rgb(220,231,239);font-size: 20.0px;" %)Post-processed variables(%%) == 173 173 174 -Defin ierenSie Variablen,welche nachAbgabe derAufgabe ermitteltwerden,umadaptiveAufgaben-undTestszenarienzu erstellen.Nach Abgabeverarbeitete Variablen(kurz:Post-Variablen)ermöglichenIhnen den ZugriffaufdiegegebenenLernerantwortenunderreichtenPunkte.SiekönnennachfolgendeInhaltewieFeedbacktexteoder denAufgabentextvonFolgeversuchenauf dieserBasisanpassen. Darüberhinausistesmöglich indieBewertungeinzugreifen unddieseindividuellnachträglichzu ändern.252 +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. 175 175 176 176 (% 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]] 177 177 178 178 179 179 180 -{{id name=" Beispiel ~"Transport~" - AdaptivesAufgabenfeedback"/}}258 +{{id name="Example ~"transport~" - Adaptive task feedback"/}} 181 181 182 -=== Beispiel "Transport" - AdaptivesAufgabenfeedback ===260 +=== Example "transport" - Adaptive task feedback === 183 183 184 -Adaptive sFeedbackermöglichteinindividuellesFeedback auf Basis dereingegebenenLernerantwort.DemTeilnehmerkönnensokonkreteLösungs-oderFehlerhinweiseimBezug zuseiner eingegebenen Lösunggegeben werden.DiePost-Variablen(Nach Abgabe verarbeitete Variablen[[doc:||anchor="Variablenverwenden-NachAbgabeverarbeiteteVariablen"]])ermöglicheneinenZugriff auf dieLernerantwortbspw. jederLücke.ZusätzlichkönnendieAnzahlder LösungsversucheoderauchvorangegangeneAntwortenindas Feedbackeinbezogenwerden.262 +Adaptive feedback allows for individual feedback based on the learners' answers. The participant can, for example, be provided with concrete hints or error messages. Post-variables (post-processed variables) allow access to the learners' responses, e.g. to each gap. Attempts at solutions or even previous answers can also be included in the feedback. 185 185 186 - Folgendwirddas (% class="confluence-link"%)[[Beispiel "Transport">>doc:||anchor="Beispiel~"Transport~"- Einsatz von Zufallsparametern"]](%%)umeineinfachesadaptivesFeedbackergänzt.DasFeedback solldemNutzereinenHinweis geben,obseineAntwortkleineroder größer alsdiekorrekteLösungwarund beieinerfalschen Antworteinen Hinweisgeben,wie die korrekteLösungberechnetwird.264 +In the following, the example "transport" will be extended by simple adaptive feedback. Feedback should give the user an indication of whether their answer was less than or greater than the correct solution or hint at how the correct solution can be calculated. 187 187 266 +{{panel titleColor="black" titleBGColor="#FFB266" title="Example ~"transport~" - Adaptive task feedback"}} 267 +{{expand title="Show example ..."}} 188 188 |((( 189 189 [[image:attach:Editor - Angabe von POST-Variablen_de.png]] 190 190 )))|((( 191 -I merstenSchrittwird im Tab Variablendie [[Text-Variable>>doc:Textvariablen]] {div} ineinerBedingung,abhängigdavonobdie eingegebeneLerneranwortkleinerodergrößer alsdiekorrekteAntwortist,auf denWert"less"oder"more"gesetzt.271 +In the first step, the __[[text variable>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]] __{div} in a condition is set to the value "less than" or "greater than" in the tab **//Variables// **, depending on whether the answer given by the learner was less than or greater than the correct answer. 192 192 193 -Zusätzlich wird sich die Lernerantwort in einer [[Numerische Variable>>doc:Numerische Variablen]] {answer} gespeichert, um auf diese im Feedback auf einfache Weise zugreifen zu können. 194 - 195 - 273 +In addition, the learner's answer will be stored in a __[[numeric variable >>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]__{answer} so that it can be easily accessed from within the feedback. 196 196 ))) 197 197 |((( 198 198 [[image:attach:Editor - Post-Variablen im Feedback_de.png]] 199 199 )))|((( 200 -I mzweitenSchritt werdendiekonkretenFeedbacktextefür dieAufgabe hinterlegt.DemTeilnehmer solldasFeedback nurangezeigtwerden,wenner die Aufgabefalschbeantwortethat.Hierfürwirdim TabFeedbackdas allgemeineFeedback"Aufgabefalsch beanwortet"genutzt.WeitereInformationenzumAufgabenfeedback erhaltenSie auf derSeite [[doc:Feedbackfestlegen]].278 +In the second step, concrete task feedback is stored. The participant should see the feedback only if they have submitted an incorrect answer. Therefore, the general feedback **//Answer was wrong// **needs to be selected from the tab **//Feedback// **. For more information about task feedback, refer to the help page __[[Set>>url:https://www.bps-system.de/help/display/ONYXintern/.Feedback+festlegen+v1.11||shape="rect"]] [[feedback>>url:https://www.bps-system.de/help/display/ONYXintern/.Feedback+festlegen+v1.11||shape="rect"]] __. 201 201 202 - Die individuellenFeedbacktexteund-werte,welcheindenVariablengespeichert wurden,werdendurchAngabedesVariablen-Namens({div}, {answer})in den Feedbacktext eingebunden.280 +Individual feedback and values stored in the variables can be included in other feedback by entering the variable name ({div}, {answer}). 203 203 204 - WeitereFeedbackblöckekönnenbeispielsweise als individuellesFeedbackhinzugefügtwerden.Für dasBeispielwurdezusätzlich nochein Lösungshinweisals Feedback hinterlegt,welcherunabhängigvonderLernerantwort immerangezeigt wird.ImFeedbackkönnenebenso detaillierteMusterlösungenund-rechnungenangezeigtwerden. FürAufgabenmitZufallsparameterkönnen in dasFeedback hierfür dievorAnzeige berechnetenVariablen eingebundenwerden.282 +Additional feedback blocks can also be added as individual feedback. In the example, a hint was added to the feedback, which is permanently displayed regardless of the learner's answer. Feedback can also contain detailed sample solutions and calculations. For tasks with random parameters, pre-processed variables can be added to the feedback. 205 205 ))) 206 206 |((( 207 207 [[image:attach:Testrun - Feedback mit Post-Variablen_de.png]] 208 208 )))|((( 209 - Da dieAufgabeZufallsparameter enthältwerdenfürjedenTestdurchlaufund TeilnehmerandereAufgabenwerteangezeigt.Entsprechendder definiertenInhaltewird dem Teilnehmernunzusätzlichein individuellesFeedback auf Basis seinergegebenenAntwortangezeigt.287 +Since the task contains random parameters, different values will be displayed for each test attempt and participant. According to the defined content, the participant will now additionally be shown individual feedback based on their answer. 210 210 211 - SiekönnendieZufallsparameter einerAufgabefürweitereAufgaben-Lösungsversuchbeibehaltenoderneuermitteln.WeitereInformationenfindenSieim Abschnitt"Variablenzurücksetzen"aufderSeite[[doc:Test-Optionenfestlegen]].289 +You can decide whether you want to retain the random parameters of a task or have them redefined for future attempts. For more information, see the section **//Reset variables// **on the help page __[[Set test options__.__>>url:https://www.bps-system.de/help/display/ONYXintern/.Test-Optionen+festlegen+v1.11||shape="rect"]]__ 212 212 ))) 291 +{{/expand}} 292 +{{/panel}} 213 213 214 214 215 215 216 -{{id name=" Beispiel ~"Transport~" - PunktabzugproLösungsversuch"/}}296 +{{id name="Example ~"transport~" - Points deduction per attempt"/}}\\ 217 217 218 -=== Beispiel "Transport" - PunktabzugproLösungsversuch===298 +=== Example "transport" - Points deduction per attempt === 219 219 220 - Stehendem TeilnehmermehrereLösungsversuchezurVerfügung,kann durchindividuelleundaufbauendeLösungshinweise eineHilfestellungzur Aufgabenbearbeitunggegebenwerden.InsbesondereindiesenSzenarienkannesgewünscht sein, dassdem TeilnehmerproLösungsversuch Punkteabgezogenwerden.EinTeilnehmer,welcherdie AufgabeohneLösungsversuchelösterhältdie vollePunktzahl.Je mehrLösungshinweisemitjedemVersuchbenötigtwerden,umsowenigerPunkteerhältderTeilnehmer.300 +If the participant has several attempts at a solution, individual and successive hints can be provided to help them answer the question. In such scenarios, it may be especially desirable to have points deducted from the participant's total score for each additional attempt. A participant who answers the task correctly at the first attempt receives the full score. The more hints or attempts they need, the fewer points they will obtain. 221 221 222 - Nachfolgend soll fürdasBeispiel "Transport"[[>>doc:||anchor="Beispiel~"Transport~"-EinsatzvonZufallsparametern"]](% class="confluence-link"%)einPunktabzugproLösungsversuch mitHilfe vonVariablenrealisiertwerden.Dafürwird die maximalmöglichePunktzahlderAufgabeauf10Punkteerhöht.(%%)ProbenötigtenLösungsversuchsolldieerreichtePunktzahlum einenPunktreduziertwerden.DerPunktabzugerfolgt proAufgaben-LösungsversuchinnerhalbeinesTestdurchlaufs.DieAnzahl derTestversuchewirdnichtberücksichtigt.Um demTeilnehmerdenPunktabzuganzuzeigenwerdenentsprechendeTextbausteinein dieAufgabenstellungunddasFeedbackeingebaut.302 +For the __[[example "transport">>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-Beispiel"Transport"-EinsatzvonZufallsparametern||shape="rect"]] __, a points deduction for each attempt should be realised using variables. Therefore, the maximum possible score for the task has been increased to 10 points. For each additional attempt, the score should be reduced by one point. In other words, if a task is attempted multiple times within one test run, points will be deducted for each additional attempt. The number of **test attempts** is not considered. It is strongly recommended to make the points deduction visible to the participant. This can be achieved by embedding appropriate text elements into the task and feedback. 223 223 224 224 |((( 225 225 [[image:attach:Editor - Variablen zur Beispielaufgabe_de.png]] 226 226 )))|((( 227 -Zur Umsetzung werden folgende Variablen definiert: 307 +(% class="WordSection1" %) 308 +((( 309 +To perform the points deduction, the following variables need to be defined: 228 228 229 -* **Die Numerische Variable[[ >>doc:Numerische Variablen]]{deduction_attempt} speichert der Punktabzug pro Versuch.** 230 -Im Beispiel soll die Gesamtpunktzahl um einen Punkt reduziert werden. Daher wird {deduction_attempt} auf den statischen Wert 1 gesetzt. 231 -Da es sich um einen statischen Wert handelt, kann dieser als Pre-Variable (Vor Anzeige verarbeitete Variable) angelegt werden. 232 -* **Die Numerische Variable[[ >>doc:Numerische Variablen]]{deduction} speichert den aktuellen Punktabzug in Abhängigkeit vom Lösungsversuch.** 233 -Der Punktabzug {deduction} berechnet sich als Produkt aus der Anzahl der bisherigen Lösungsversuche (Systemvariable NUMATTEMPTS) und dem Punktabzug pro Versuch {deduction_attempt}. 234 -Da es sich um einen pro Lösungsversuch berechneten Wert handelt, muss dieser als Post-Variable (Nach Abgabe verarbeitet Variable) berechnet werden. 311 +* ((( 312 +**The [[numeric variable>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]] [[url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]{deduction_attempt} stores the points deduction for each attempt.** 235 235 236 -Zusätzlich muss die Punktzahl der Aufgabe entsprechend des Punktabzugs durch **Setzen der Systemvariable SCORE** neu berechnet und durch den Autor explizit werden. Hierzu wird eine neue Bedingung definiert: Wenn der Punktabzug größer 0 ist, wird die Punktzahl der Aufgabe um den aktuellen Punktabzug minimiert. 314 +In this example, the total score should be reduced by one point. Therefore, {deduction_attempt) is set to a static value of 1. Since the value is static, it can be created as a pre-variable (pre-processed variable). 315 +))) 237 237 238 -//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle Variablen zur Generierung der allgemeinen Aufgaben- und Feedbackinhalte ausgeblendet.// 317 +* ((( 318 +**The [[numeric variable>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]] [[url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]{deduction} stores the current points deduction depending on the attempt.** 319 + 320 +The points deduction {deduction} is calculated as the product of the number of attempts (system variable NUMATTEMPTS) and the deduction of points per attempt {deduction_attempt}. Since this value is computed per attempt, it must be calculated as a post-variable (post-processed variable). 239 239 ))) 240 -|((( 241 -Hinweis in der Aufgabenstellung: 242 242 243 - [[image:attach:Editor-Hinweis inderAufgabenstellung_de.png]]323 +In addition, the score of the task must be recalculated according to the points deducted by **setting the system variable SCORE** and verified by the author. This includes the definition of a new condition: If the points deduction is greater than 0, the score of the task is reduced by the respective value. 244 244 245 -Hinweis als individuelles Feedback: 325 +//Note: For the sake of simplicity, all of the variables for generating general task and feedback content have been hidden in the screenshot.// 326 +))) 327 +))) 328 +|(% colspan="1" %)(% colspan="1" %) 329 +((( 330 +Note within the task: 246 246 247 -[[image:attach:Editor - Hinweis als individuelles Feedback_de.png]] 248 -)))|((( 249 -Um dem Lerner den Punktabzug kenntlich zu machen, wird zum einen in die Aufgabenstellung ein genereller Hinweis zum Punktabzug eingefügt und zum anderen wird als Feedback ein individueller Hinweis eingebunden, wenn ein Punktabzug erfolgt ist. 332 + [[image:attach:Editor - Hinweis in der Aufgabenstellung_de.png]] 250 250 251 - 334 +Note as individual feedback: 252 252 336 +[[image:attach:Editor - Hinweis als individuelles Feedback_de.png]] 337 +)))|(% colspan="1" %)(% colspan="1" %) 338 +((( 339 +A general note will be included in the task to make the learner aware of the fact that points may be deducted, and an individual note will be displayed as a feedback message immediately after the deduction. 340 + 253 253 {{note}} 254 -// Hinweis:BittebeachtenSie,dasseinPunktabzugimFolgeversuchdazuführt,dassdieAufgabe nicht mehr alsvollständigrichtiggewertetwird, da diemaximalePunktzahlnichterreicht wurde.Dieshat AuswirkungenaufdieAnzeigedererreichtenPunkte(farblicheKennzeichnung),sowiedie Symbolik derRichtig/Falsch-Auswertung.Ebensobetroffenist das allgemeineAufgaben-Feedback, welchesauf Basisder BedingungobderTeilnehmerdiemaximale PunktzahlderAufgabe erreicht hat,gesteuertwird.DurchNutzungdesindividuellenFeedbackskann dieLogikzurAnzeigeder Feedbackinhalte individuell andie Aufgabeangepasstwerden.//342 +//Please note that if there has been a points deduction, the follow-up attempt can no longer be considered as completely correct because the maximum score can no longer be achieved. This also affects the presentation of the points achieved (colour marking), the correct/incorrect marking, and the general task feedback, which depends on the condition whether or not the participant has reached the maximum score. By using individual feedback, the logic for displaying feedback content can be individually adapted to the task.// 255 255 {{/note}} 256 256 ))) 257 257 |((( 258 258 [[image:attach:Testrun - Beispielaufgabe in unterschiedlichen Versuchen_de.png]] 259 259 )))|((( 260 - Entsprechendder AnzahldernotwendigenLösungsversuchewerdennunPunkteproLösungsversuchabgezogen:\\348 +Points will now be negated according to the number of attempts needed. 261 261 262 -* Teilnehmer,welcheimersten Lösungsversuchdie richtigeAntwort eingeben,erhaltendievollePunktzahl.263 -* Teilnehmer,welcheineinem derFolgeversuchedierichtigeAntworteingeben,erhaltenTeilpunkte.DurchentsprechendesFeedbackkönnendiesenTeilnehmern individuelleLösungshinweiseund damitUnterstützungzureigenständigenWeiterbearbeitungderAufgabegegebenwerden.\\350 +* Participants who enter the correct answer at the first attempt receive the full score. 351 +* Participants who enter the correct answer in a follow-up attempt receive partial points. Through appropriate feedback, these participants can be given individual hints at the solution to encourage them to continue processing the task on their own. 264 264 ))) 265 265 266 266 267 267 268 -{{id name=" Beispiel ~"Transport~" -Wertungdermaximalerreichten Punktzahl"/}}\\356 +{{id name="Example ~"transport~" - Assessment of the maximum score"/}}\\ 269 269 270 -=== Beispiel "Transport" - Wertung der maximal erreichten Punktzahl 271 - === 358 +=== Example "transport" - Assessment of the maximum score === 272 272 273 - WerdenmehrereLösungsversuche proAufgabeangeboten,kann esdazukommen,dasseinTeilnehmerinFolgeversuchen wenigerPunkteerreicht,alserbereitsfür einenvorangegangenenVersucherhaltenhat.Wenn gewünscht,kannsichdiemaximalerreichtePunktzahl überalleAntwortversuchegemerktundfür dieWertunggenutzt werden.DerTeilnehmersollteauhhierdurch Hinweise entsprechend informiertwerden und sowohldieWertungdesaktuellenVersuchs,als auchdie maximaleWertungüber alleVersucheangezeigtbekommen.360 +If several attempts are possible per task, it might be the case that a participant will not score as many points in a follow-up attempt as was already scored before. If desired, the highest score achieved can be remembered and eventually used for the assessment. The participant should be informed accordingly through notes and be shown the scoring of the current attempt as well as the maximum score achieved for all attempts. 274 274 275 - Folgendwirdfürdas Beispiel "Transport"[[>>doc:||anchor="Beispiel~"Transport~"-EinsatzvonZufallsparametern"]]erläutert wiedieWertungdermaximalerreichtenPunktzahlrealisiert werden kann.\\362 +In the following, the __[[example "transport">>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-Beispiel"Transport"-EinsatzvonZufallsparametern||shape="rect"]] __will help to explain how the assessment of the maximum score can be enabled. 276 276 277 277 |((( 278 -\\ 279 - 280 -[[image:attach:Editor - Beispiel mehrere Versuche_de.png]]\\ 365 +[[image:attach:Editor - Beispiel mehrere Versuche_de.png]] 281 281 )))|((( 282 - ZurUmsetzungwerdenfolgendeVariablen definiert:367 +To do this, the following variables need to be defined. 283 283 284 -Die gesamte Umsetzung erfolgt durch Post-Variablen (Nach Abgabe verarbeitete Variablen[[doc:||anchor="Nach Abgabe verarbeitete Variablen"]]), da u.a. auf die Wertung des aktuellen Lösungsversuches zugegriffen wird. 285 -//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle anderen Variablen zur Generierung der Aufgaben- und Feedbackinhalte ausgeblendet.// 369 +The entire implementation is done using post-variables ( [[post-processed variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-NachAbgabeverarbeiteteVariablen||shape="rect"]] ), since, among other things, the score of the current attempt will be accessed. 286 286 287 -* **Die Numerische Variable [[ >>doc:Numerische Variablen]]{best_score} speichert die maximal erreichte Punktzahl über alle Aufgabenversuche.** 288 -Die Variable {best_score} wird ohne Wertsetzung initialisiert und später durch eine Bedingung gesteuert:\\ 289 -** Beim **ersten Lösungsversuch**, ist {best_score} noch nicht initialisiert (NULL) und wird auf die aktuelle Punktzahl {current_score} gesetzt. 290 -Bedingung~:// IF best_score = NULL THEN best_score = Wert: current_score// 291 -** Für jeden** folgenden Lösungsversuch** wird geprüft, ob die aktuell erreichte Punktzahl {current_score} größer als die maximal erreichte Punktzahl {best_score} ist und nur in diesem Fall angepasst. 292 -Bedingung : //IF current_score > best_score THEN best_score = Wert: current_score// 371 +(% style="font-size: 10.5pt;line-height: 107.0%;" %)Note: For the sake of simplicity, all of other variables for generating task and feedback content have been hidden in the screenshot. 293 293 294 -* **Die Numerische Variable [[ >>doc:Numerische Variablen]]{current_score} speichert die aktuell erreichte Punktzahl für den aktuellen Aufgabenversuch.** 295 -Die aktuelle Punktzahl kann durch die Systemvariable SCORE ausgelesen werden. Da dieser Wert durch den Autor manuell verändert wird, soll der Wert in einer Variable zwischengespeichert werden. Dies ermöglicht in jedem Fall einen Zugriff auf die aktuell erreichte Punktzahl und beispielsweise die Ausgabe dieses Wertes in Hinweis- und Feedbacktexten. 296 -** Die Variable {current_score} wird mit jedem Versuch auf den Wert der Systemvariable SCORE gesetzt. 297 -Bedingung : // IF best_score = NULL THEN best_score = Wert: current_score// 298 - 299 -* **Die Numerische Variable [[ >>doc:Numerische Variablen]]{best_score_is_used} speichert ob die Aufgabenbewertung manuell geändert wurde 300 - **Für das Beispiel soll dem Teilnehmer ein zusätzlicher Hinweis zur Bewertung angezeigt werden, wenn statt der aktuell erreichten Punktzahl die maximale Punktzahl für die Aufgabenbewertung genutzt wurde. Hierfür wird die Hilfsvariable {best_score_is_used} genutzt, welche auf den Wert 1 gesetzt wird, wenn die Aufgabenbewertung manuell geändert wurde.\\ 301 -** Die Variable(% class="confluence-link" title="Numerische Variablen" %) {best_score_is_used} (%%)wird auf den Wert 1 gesetzt, wenn die aktuellen Punkte kleiner der bisher maximal erreichten Punkte sind, ansonsten erhält die Variable den Wert 0. 302 -Bedingung : //IF// //best_score > current_score THEN best_score_is_used = Wert: 1 ELSE best_score_is_used = Wert: 0 303 -// 373 +* **The [[numeric variable >>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]{best_score} stores the highest score achieved in multiple attempts. ** 374 +The variable {best_score} is initialised without a value and later controlled by a condition: 375 +** At the **first attempt** (% style="text-indent: -18.0pt;" %),(%%) {best_score} is not yet initialised (NULL) and will be set to the current score {current_score}. Condition: IF best_score = (% style="font-size: 10.5pt;" %)//NULL THEN best_score = value: current_score// 376 +** Each **successive attempt** is checked to see whether the score achieved {current_score} is greater than the present maximum score {best_score}, in which case the latter will be adjusted accordingly. Condition: IF current_score > best_score THEN best_score = value: current_score 377 +* **The [[numeric variable >>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]{current_score} stores the current score for the current attempt.** ** 378 +**The current score can be read out using the system variable SCORE. As this value is changed manually by the author, it should be temporarily stored in a variable. This guarantees access to the current score and, for example, the output of this value in notes and feedback. 379 +** With each attempt, the variable** **{current_score} is set to the value of the system variable SCORE. Condition: IF best_score = NULL THEN best_score = value: current_score** 380 +** 381 +* **The [[numeric variable>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]] {best_score_is_used} stores whether the task assessment was changed manually.** 382 +In the example, the participant should be shown an additional note if the best score is used for assessment instead of the current score. Therefore, the auxiliary variable {best_score_is_used} is applied, which will be set to the value 1 if the task assessment was changed manually.** 383 +** 384 +** The variable {best_score_is_used} is set to the value 1 if the current score is less than the highest score, which has been achieved so far. Otherwise, the variable is given the value 0. Condition: IF best_score > current_score THEN best_score_is_used = value: 1 ELSE best_score_is_used = value: 0 304 304 ))) 305 305 |((( 306 - HinweisinderAufgabenstellung:387 +Note within the task: 307 307 308 308 [[image:attach:Editor - Hinweis zur Wertung in Aufgabenstellung_de.png]] 309 309 )))|((( 310 -Um dem Lerner das aktuelle Wertungsverfahren zu erläutern, wird zum einen in die Aufgabenstellung ein genereller Hinweis zur Bewertung eingefügt. Zum anderen soll ein individuelles Feedback angezeigt werden, wenn die Aufgabenbewertung manuell geändert und auf die maximale Punktzahl gesetzt wurde. 311 - 312 - 313 - 314 - 391 +In order to let the learners know which assessment procedure will be applied, a general note is included with the task. This note will be accompanied by some individual feedback information if the task assessment has been changed manually and the best score option has been configured. 315 315 ))) 316 316 |(% colspan="1" %)(% colspan="1" %) 317 317 ((( 318 -Hinweis als individuelles Feedback:[[image:attach:Editor - Hinweis zur Wertung als individuelles Feedback_de.png]] 395 +Note as individual feedback: 396 + 397 +[[image:attach:Editor - Hinweis zur Wertung als individuelles Feedback_de.png]] 319 319 )))|(% colspan="1" %)(% colspan="1" %) 320 320 ((( 321 - ZurFeedback-Steuerungwirdauf die Hilfsvariable {best_score_is_used}zugegriffen und in Abhängigkeitvonderen Wert (0 oder 1) einindividuellesFeedbackfürdenTeilnehmerangezeigt.DasFeedbackenthälteinenHinweiszuraktuellenPunktzahl{current_score},sowiezurmaximalerreichten{max_score}.Zusätzlichwird dieSystemvariable MAXSCOREgenutzt,umdie maximalmöglichePunktzahl in denHinweistextzu integrieren.400 +Feedback can be controlled using the auxiliary variable {best_score_is_used}, which displays individual feedback to the participant depending on whether its value is 0 or 1. It includes a reference to the current score {current_score} as well as to the maximum score {max_score} achieved so far. In addition, the system variable MAXSCORE is used to embed the maximum possible score in the note. 322 322 ))) 323 323 |((( 324 324 [[image:attach:Testrun - Beispielaufgabe Wertung in unterschiedlichen Versuchen_de.png]] 404 + 405 + 325 325 )))|((( 326 - SolltederTeilnehmer nunin einem FolgeversuchwenigerPunkte erreichen,alserbereitsineinemvorangegangenenVersucherhalten hat,wirdimmerdiemaximalePunktzahlgewertet. ImabgebildetenBeispiel istdieÜbungsaufgabe sokonfiguriert,dassmitjedem Versuchneue Aufgabenwertegesetztwerden.DerTeilnehmerhatdieAufgabeim zweiten Versuchbereitsrichtiggelöstunddie vollePunktzahlerhalten.Im drittenVersucherhält derTeilnehmerdaher trotzfalscherAntwortfürdie gesamteAufgabedie volle Punktzahl.Zusätzlich wird demTeilnehmerim Feedback angezeigt,dasserfür denaktuellenVersuch0 Punkteerhaltenhat, aberdiebishermaximalerreichtePunktzahlvon10Punktengewertetwird.407 +If the participant receives a lower score in a test attempt than in a previous attempt, the best score will be the one counted. In the example given, the exercise is configured in such a way that different values will be displayed for each test attempt. The participant has already solved the task at the second attempt and received the full score. Therefore, the participant obtains the full score for the task despite giving an incorrect answer. The feedback displayed to the participant also indicates that they have received 0 points for the current attempt, but that their best score of 10 points will be assessed. 327 327 328 - DieseAufgabenbeispielistmitdenvoranbeschriebenenAnwendungsszenarien kombinierbar:409 +This example can be combined with the application scenarios described above: 329 329 330 -* Beispiel "Transport"-Einsatzvon Zufallsparametern[[doc:||anchor="Beispiel~"Transport~" - Einsatz von Zufallsparametern"]]331 -* Beispiel "Transport"-AdaptivesAufgabenfeedback[[doc:||anchor="Beispiel ~"Transport~" - AdaptivesAufgabenfeedback"]]332 -* Beispiel "Transport"-Punktabzug pro Lösungsversuch[[doc:||anchor="Beispiel ~"Transport~" - Punktabzug pro Lösungsversuch"]]411 +* Example "transport" – Use of random parameters 412 +* Example "transport" – Adaptive task feedback 413 +* Example "transport" – Points deduction per attempt 333 333 ))) 334 334 335 -(% class="help-heading" %) 336 -== Definition einer Variable == 416 +== Definition of a variable == 337 337 338 - KlickenSie im**TabVariablen**auf denButton (%class="button"%)NeueVariablehinzufügen(%%),umeine neueVariablezu definieren.Die neueVariablewirddirekthinzugefügtund inderÜbersichtstabelleangezeigt.Unterhalböffnetsichfürdie neueVariableein Bearbeitungsfenster.418 +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. 339 339 340 340 [[image:attach:Editor - Definition einer Variable_de.png]] 341 341 342 - VergebenSieeinen**eindeutigenVariablen-Namen**fürihreVariable.DerVariablen-NamedientalsIdentifierundermöglichtIhnendie**NutzungderVariable imAufgabentext**.BittebeachtenSie,dassimVariablen-NamenkeineUmlaute,Sonder- und Leerzeichen verwendetwerdendürfen. Die Groß- undKleinschreibung mussbeachtetwerden. Wird eineVariablemitdemNamen"a"definiert,kannmitdemPlatzhalter {a}darauf zugegriffen werden.422 +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}. 343 343 344 - WählenSieden**Variablen-Typ**.FolgendeVariablen-Typenwerdenbereitgestellt:424 +Select the **Variable type**. The following variable types are available: 345 345 346 -* [[ doc:NumerischeVariablen]]:347 -** GanzeZahl348 -** Gleitkommazahl349 -* [[ doc:Textvariablen]]350 -* [[ doc:BildVariablen]]426 +* [[Numeric variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]: 427 +** Integer 428 +** Floating-point number 429 +* [[Text variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]] 430 +* [[Image Variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Bild+Variablen+v1.11||shape="rect"]] 351 351 352 - AbhängigvomgewähltenVariablen-TypstehenIhnenunterschiedlicheMöglichkeitenzur **Wert-Ermittlung**bereit:432 +Depending on the selected variable type, you have various options for the **determination of the value**: 353 353 354 -* Wert355 -* Wertebereich356 -* ZufälligeAuswahl357 -* Berechnung(MAXIMA)434 +* Value 435 +* Value range 436 +* Random selection 437 +* Calculation (MAXIMA) 358 358 359 -Variable nkönnenauchohneWert-Setzungangelegtwerden,umdenWertbeispielsweisespäter inAbhängigkeit andererVariablenzusetzen(vgl.Bedingungen).439 +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). 360 360 361 -== VerwendungvonVariablen==441 +== Use of variables == 362 362 363 -Defin ierteVariablenkönnen durch **Angabedes Variablen-Namens indie AufgabenstellungundinAntworttexte** eingefügtwerden.Ebenfalls ist die**direkteIntegration in LaTeX-Formeln**möglich.DerdefinierteVariablenname mussingeschweiftenKlammernstehen. ONYXerkenntautomatisch,obeineVariablen-DeklarationmitentsprechendemNamen vorliegt.WirdeinBezeichnerverwendet,der nicht definiertist,wirddieserignoriertund alsTextausgegeben.443 +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. 364 364 365 -I mBeispielwurdendieVariablen{VAR1}, {VAR2}und {VAR3} deklariert:445 +In the example, the variables {VAR1}, {VAR2}, and {VAR3} were declared: 366 366 367 - (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]]447 +[[image:attach:Beispiel zur Verwendung von Variablen_de.png]] 368 368 369 -== Definition einerBedingung==449 +== Definition of a condition == 370 370 371 -I m **Tab Variablen**könnenSie zudemBedingungenverwenden.EineBedingungermöglicht**dasSetzeneinesVariablen-Wertes,abhängigvonanderenVariablen-Werten**.451 +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**. 372 372 373 - KlickenSie auf den Button//(%class="button" %)Neue Bedingung hinzufügen(%%)//,umeine neueBedingung zudefinieren.Die neueBedingungwirddirekthinzugefügtund inderÜbersichtstabelleangezeigt.Unterhalböffnetsich fürdieBedingungeinBearbeitungsfenster.453 +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. 374 374 375 375 [[image:attach:Editor - Neue Bedinung anlegen_de.png]] 376 376 377 -Variable nkönnenmitanderenVariablengleichenTypsodermit festenWertenverglichen werden.DieVergleichsoperatorenrichtensichnachdemVariablentyp.SokönnenSiebeispielsweiseprüfen,ob Wertegleich(=) oderungleich(!=)zu einemanderenWert sind.457 +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. 378 378 379 379 [[image:attach:Editor - Vergleichsoperatoren_de.png]] 380 380 381 - BittebeachtenSie:EineVariabledie innerhalbeinerBedingungverwendetwird,mussvor derBedingunginitialisiertwerden.Dieinder Bedingungoderin derAnweisungverwendeteVariable,mussalseinzelneVariablevorderBedingunghinzugefügtwerden.WirdderWerteinerVariableninnerhalbeineroder mehrererBedingungen gesetzt, isteineWertsetzungfürdieVariable selbstnichtnotwendig. WählenSiedenleerenEintragin derWert-Auswahlliste.461 +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. 382 382 383 - SiekönnenbeliebigvielealternativeBedingungen(ELSE IF -Zweige) hinzufügen.In den Bedingungen könnenunterschiedlicheVariablengesetztwerden.Pro BedingungkannimeinfachenModusnureineVariablegesetztwerden. FürkomplexereRegelnkönnenSieinden**Expertenmodus**wechseln.Eine detaillierteBeschreibungerhaltenSie inderHilfe-Beschreibungzum Expertenmodus.463 +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. 384 384 385 -== Expert enmodus(IMS QTI) ==465 +== Expert mode (IMS QTI) == 386 386 387 - DieVariablen-AbbildungindenTest-undAufgabeninhalten basiertaufdemPrinzipderTemplate-DeclarationunddemTemplate-Processingder[[IMS QTI 2.1Spezifikation>>url:http://www.imsglobal.org/question/||title="Zur IMS Homepage" rel="nofollow"shape="rect"class="external-link"]].DasTemplate-ProcessingvonIMS QTI 2.1bietetweitausmehrMöglichkeitenzumSetzen von Variablen, insbesonderedurchdieVerschachtelung logischerAusdrückeundBedingungen.Dieim ExpertenmoduseingegebeneBeschreibungwirddirekt indasXMLderAufgabe,alseinzelnerTemplate-Processing-Ausdruck,übernommen.467 +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. 388 388 389 389 [[image:attach:Editor - Variable im Expertenmodus_de.jpg]] 390 390 391 - BittebeachtenSie,dassnacheinerÄnderungder eingegebenenBeschreibungimExpertenmodus,keineMöglichkeit besteht,inden einfachenModuszurückzuwechseln.471 +Please note that after changing the description in the expert mode, there is no way to return to the simple mode. 392 392 393 - WeitereHinweisezurXML-DefinitiondesTemplate-Processing erhaltenSie inder[[IMS QTI 2.1Spezifikation>>url:http://www.imsglobal.org/question/||title="ZurIMS Homepage"rel="nofollow"shape="rect"class="external-link"]].Aktuellunterstützt dieONYX TestsuitebereitseinweitesSetderIMS QTIExpressionsundMöglichkeiten.BeiNutzungdesExpertenmodus empfehlenwirdennocheinegenauePrüfungzur korrektenFunktionsweisederAufgabenvorlage.473 +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. 394 394 395 -== Variable n-Belegungeinsehen ==475 +== View variable assignment == 396 396 397 - Beider ErprobungIhrerTestinhaltekönnenSiedieVariablen-Belegunginder[[Vorschau>>doc:Inhalteansehen]]jederzeiteinsehen.Ebensostehendem BetreueroderBewerterdieseDetailinformationeninden[[Ergebniseinsichten>>doc:Ergebniseinsicht]]zu Verfügung.Neben derVariablen-Belegung werdenIhnen auch Informationenzu denMAXIMA-AufgabenundmöglichenSystemfehlernangezeigt.477 +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. 398 398 399 - DetaillierteInformationenfindenSiein denjeweiligenHilfeabschnittenzur Ergebniseinsichtfür denBetreuer:479 +For more detailed information, please refer to the following help sections: 400 400 401 -* (% 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" %) 402 - 403 -* (% class="toc-item-body" %)[[MAXIMA-Ausgaben einsehen>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]] 404 -* (% class="toc-item-body" %)[[Anzeige von Systemfehlern>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]] 481 +* [[View variable assignment>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-Variablen-BelegungeinsehenVariablen-Belegung||shape="rect"]] 482 +* [[View MAXIMA output>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]] 483 +* [[Display of system errors>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]] 405 405 {{/layout-cell}} 406 406 {{/layout-section}} 407 407 {{/layout}} 487 +{{/sv-translation}}
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 1788808711 +226230885 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/ 178880871/Variablen verwenden1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/226230885/Variablen verwenden