Skip to Content

Changes for page 07 Variablen verwenden

Last modified by Carina Enke on 13.02.2024
From version 1.1
edited by Hendrik Zschocke
on 11.01.2024
Change comment: There is no comment for this version
To version 3.2
edited by Carina Enke
on 13.02.2024
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Using Variables
1 +07 Using Variables
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.hendrik
1 +XWiki.carina
Content
... ... @@ -8,18 +8,18 @@
8 8  * **{{id name="PostVariablen_en"/}}Post-processed variables**
9 9  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.
10 10  
11 -[[image:attach:Editor - Tab Variablen_de.png]]
11 +[[image:attach:Editor - Tab Variablen_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
12 12  {{/layout-cell}}
13 13  
14 14  {{layout-cell}}
15 15  {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}}
16 -{{toc/}}
16 +{{toc start="2"/}}
17 17  {{/panel}}
18 18  
19 19  {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Related topics"}}
20 -* [[Calculation interaction>>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Berechnungsaufgabe]]
21 -* [[Formula comparison>>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Formelvergleich]]
22 -* [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Expertenbewertung]]
20 +* [[Calculation interaction>>doc:ONYX.Erstellung von Testinhalten.Aufgabentypen.Berechnungsaufgabe.WebHome]]
21 +* [[Formula comparison>>doc:ONYX.Erstellung von Testinhalten.Aufgabentypen.Formelvergleich.WebHome]]
22 +* [[Expert assessment>>doc:ONYX.Erstellung von Testinhalten.Aufgaben.Bewertung festlegen.Expertenbewertung.WebHome]]
23 23  {{/panel}}
24 24  
25 25  {{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Further information"}}
... ... @@ -38,10 +38,10 @@
38 38  (% class="help-heading" %)
39 39  Define variables that are determined before the task is displayed in order to use (% style="background-color:#ffffff; 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:#ffffff; font-size:14.0px" %)**an unlimited number of different test and exam attempts**(%%).
40 40  
41 -(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
41 +(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[image:attach:Testrun - Beispielaufgaben_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
42 42  
43 43  {{info}}
44 -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"]].
44 +For a typical application example for the use of variables as random parameters, see [[Example "Transport" - Use of random parameters>>ONYX.Erstellung von Testinhalten.Test erstellen.Test-Variablen verwenden.Beispiele zur Nutzung von Test-Variablen.Beispieltest Transport - Einsatz von Zufallwerten.WebHome||shape="rect"]].
45 45  {{/info}}
46 46  
47 47  == (% style="background-color:#dce7ef; font-size:20.0px" %)Post-processed variables(%%) ==
... ... @@ -48,15 +48,15 @@
48 48  
49 49  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.
50 50  
51 -(% 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]]
51 +(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[image:attach:Testrun - Nutzerlösung einer Beispielaufgabe_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="454" width="276"]][[image:attach:Testrun - Post-Variable im Feedback_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="454" width="313"]][[image:attach:Testrun - Post-Variable Lösungshinweis_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="280" width="327"]]
52 52  
53 53  {{info}}
54 54  The following examples for the use of post-processed variables show possible application scenarios:
55 55  
56 -* [[Example "Transport" - Adaptive task feedback>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]]
57 -* [[Example "Transport" - Points deduction per attempt>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.X||shape="rect"]]
58 -* [[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"]]
59 -* [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Expertenbewertung]]
56 +* [[Example "Transport" - Adaptive task feedback>>doc:.Beispiele zum Einsatz von Variablen.Beispiel Transport - Adaptives Aufgabenfeedback.WebHome||shape="rect"]]
57 +* [[Example "Transport" - Points deduction per attempt>>doc:.Beispiele zum Einsatz von Variablen.Beispiel Transport - Punktabzug pro Loesungsversuch.WebHome||shape="rect"]]
58 +* [[Example "Transport" - Assessment of the Maximum Score>>doc:.Beispiele zum Einsatz von Variablen.Beispiel Transport - Wertung der maximal erreichten Punktzahl.WebHome||shape="rect"]]
59 +* [[Expert assessment>>doc:ONYX.Erstellung von Testinhalten.Aufgaben.Bewertung festlegen.Expertenbewertung.WebHome]]
60 60  {{/info}}
61 61  
62 62  == Definition of a variable ==
... ... @@ -63,17 +63,17 @@
63 63  
64 64  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.
65 65  
66 -[[image:attach:Editor - Definition einer Variable_de.png]]
66 +[[image:attach:Editor - Definition einer Variable_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
67 67  
68 68  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}.
69 69  
70 70  Select the **variable type**. The following variable types are available:
71 71  
72 -* [[Numerical variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]:
72 +* [[Numerical variables>>doc:.Numerische Variablen.WebHome||shape="rect"]]:
73 73  ** Integer
74 74  ** Floating-point number
75 -* [[Text variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]]
76 -* [[Image variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Bild+Variablen+v1.11||shape="rect"]]
75 +* [[Text variables>>doc:.Text Variables.WebHome||shape="rect"]]
76 +* [[Image variables>>doc:.Bild Variablen.WebHome||shape="rect"]]
77 77  
78 78  Depending on the selected variable type, you have various options for the **determination of the value**:
79 79  
... ... @@ -84,6 +84,7 @@
84 84  
85 85  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).
86 86  
87 +
87 87  == Use of variables ==
88 88  
89 89  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.
... ... @@ -90,8 +90,9 @@
90 90  
91 91  In the example, the variables {VAR1}, {VAR2}, and {VAR3} were declared:
92 92  
93 -[[image:attach:Beispiel zur Verwendung von Variablen_de.png]]
94 +[[image:attach:Beispiel zur Verwendung von Variablen_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="420" width="429"]]
94 94  
96 +
95 95  == Definition of a condition ==
96 96  
97 97  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**.
... ... @@ -98,39 +98,41 @@
98 98  
99 99  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.
100 100  
101 -[[image:attach:Editor - Neue Bedinung anlegen_de.png]]
103 +[[image:attach:Editor - Neue Bedinung anlegen_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
102 102  
103 103  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.
104 104  
105 -[[image:attach:Editor - Vergleichsoperatoren_de.png]]
107 +[[image:attach:Editor - Vergleichsoperatoren_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
106 106  
107 107  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.
108 108  
109 109  **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.
110 110  
111 -(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" style="color:#ff6600" %)[[image:attach:Editor - Verknüpfung von Bedingungen_de.png]]
113 +(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" style="color:#ff6600" %)[[image:attach:Editor - Verknüpfung von Bedingungen_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
112 112  
113 113  (% style="color:#333333" %)**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.
114 114  
117 +
115 115  == Expert mode (IMS QTI) ==
116 116  
117 117  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.
118 118  
119 -[[image:attach:Editor - Variable im Expertenmodus_de.jpg]]
122 +[[image:attach:Editor - Variable im Expertenmodus_de.jpg||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="490" width="411"]]
120 120  
121 121  Please note that after changing the description in the expert mode, there is no way to return to the simple mode.
122 122  
123 -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.
126 +For further information on the XML definition of the template processing, please refer to the section [[IMS QTI 2.1 specification>>http://www.imsglobal.org/question/]]. 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.
124 124  
128 +
125 125  == View variable assignment ==
126 126  
127 -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.
131 +When testing your test content, you can view the variable assignment in the [[preview>>doc:ONYX.Erstellung von Testinhalten.Inhalte ansehen.WebHome||shape="rect"]] at any time. These details are also available to the supervisor or assessor in the [[results views>>doc:ONYX.Auswertung von Tests.Ergebniseinsicht.WebHome||shape="rect"]]. In addition to the variable assignment, information on the MAXIMA tasks as well as possible system errors are displayed.
128 128  
129 129  For more detailed information, please refer to the following help sections:
130 130  
131 -* [[View variable assignment>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-Variablen-BelegungeinsehenVariablen-Belegung||shape="rect"]]
132 -* [[View MAXIMA output>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]]
133 -* [[Display of system errors>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]]
135 +* [[View variable assignment>>doc:ONYX.Auswertung von Tests.Ergebniseinsicht.WebHome||shape="rect"]]
136 +* [[View MAXIMA output>>doc:ONYX.Auswertung von Tests.Ergebniseinsicht.WebHome||shape="rect"]]
137 +* [[Display of system errors>>doc:ONYX.Auswertung von Tests.Ergebniseinsicht.WebHome||shape="rect"]]
134 134  {{/layout-cell}}
135 135  {{/layout-section}}
136 136  {{/layout}}