Zum Inhalt springen

Wiki-Quellcode von Variablen verwenden

Version 502.1 von Hendrik Zschocke am 11.01.2024
Zeige letzte Bearbeiter
1 {{layout}}
2 {{layout-section ac:type="single"}}
3 {{layout-cell}}
4
5 {{/layout-cell}}
6 {{/layout-section}}
7
8 {{layout-section ac:type="two_right_sidebar"}}
9 {{layout-cell}}
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
12 * **Vor Anzeige verarbeitete Variablen**
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**
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
17
18 [[image:attach:Editor - Tab Variablen_de.png]]
19 {{/layout-cell}}
20
21 {{layout-cell}}
22 {{panel borderColor="#ddd" borderStyle="solid" title="Inhalt"}}
23 {{toc/}}
24 {{/panel}}
25
26 {{panel borderColor="#ddd" borderStyle="solid" title="Anwendungsbeispiele"}}
27 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Einsatz von Zufallsparametern]]
28 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Adaptives Aufgabenfeedback]]
29 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Punktabzug pro Loesungsversuch]]
30 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Wertung der maximal erreichten Punktzahl]]
31 {{/panel}}
32
33 {{panel borderColor="#ddd" borderStyle="solid" title="Verwandte Themen"}}
34 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Berechnungsaufgabe]]
35 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Formelvergleich]]
36 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Expertenbewertung]]
37 {{/panel}}
38
39 {{panel borderColor="#ddd" borderStyle="solid" title="Weiterführende Informationen"}}
40 * [[MAXIMA Manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]]
41 * [[MAXIMA Good-Practice-Beispiele>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]]
42 * [[MAXIMA Systeminformationen>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]]
43 {{/panel}}
44
45
46
47
48 {{/layout-cell}}
49 {{/layout-section}}
50
51 {{layout-section ac:type="single"}}
52 {{layout-cell}}
53 (% id="HVorAnzeigeverarbeiteteVariablen" class="help-heading" %)
54 == Vor Anzeige verarbeitete Variablen ==
55
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
58 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
59
60 {{info}}
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.
62 {{/info}}
63 {{/layout-cell}}
64 {{/layout-section}}
65
66 {{layout-section ac:type="single"}}
67 {{layout-cell}}
68 == Nach Abgabe verarbeitete Variablen ==
69
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
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]]
73
74 {{info}}
75 Folgende Beispiele zum Einsatz der Nach-Abgabe-verarbeiteten-Variablen zeigen mögliche Anwendungsszenarien:
76
77 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Adaptives Aufgabenfeedback]]
78 * [[Beispiel Transport - Punktabzug pro Lösungsversuch>>doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Punktabzug pro Loesungsversuch]]
79 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Beispiel Transport - Wertung der maximal erreichten Punktzahl]]
80 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Expertenbewertung]]
81 {{/info}}
82 {{/layout-cell}}
83 {{/layout-section}}
84
85 {{layout-section ac:type="single"}}
86 {{layout-cell}}
87 (% id="HDefinitioneinerVariable" class="help-heading" %)
88 == Definition einer Variable ==
89
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.
91
92 [[image:attach:Editor - Definition einer Variable_de.png]]
93
94 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.
95
96 Wählen Sie den **Variablen-Typ**. Folgende Variablen-Typen werden bereitgestellt:
97
98 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Numerische Variablen]]:
99 ** Ganze Zahl
100 ** Gleitkommazahl
101 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Text Variables]]
102 * [[doc:ONYX.ONYX Editor.Aufgaben.Variablen verwenden.Bild Variablen]]
103
104 Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur **Wert-Ermittlung** bereit:
105
106 * Wert
107 * Wertebereich
108 * Zufällige Auswahl
109 * Berechnung (MAXIMA)
110
111 Variablen können auch **ohne Wert-Setzung** angelegt werden, um den Wert beispielsweise später in Abhängigkeit anderer Variablen zu setzen (vgl. Bedingungen).
112 {{/layout-cell}}
113 {{/layout-section}}
114
115 {{layout-section ac:type="single"}}
116 {{layout-cell}}
117 == Verwendung von Variablen ==
118
119 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.
120
121 Im Beispiel wurden die Variablen {VAR1}, {VAR2} und {VAR3} deklariert:
122
123 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size image-center-wrapper" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]]
124 {{/layout-cell}}
125 {{/layout-section}}
126
127 {{layout-section ac:type="single"}}
128 {{layout-cell}}
129 == Definition einer Bedingung ==
130
131 Im Tab//** **//**Variablen**// //können Sie zudem Bedingungen verwenden. Eine Bedingung ermöglicht **das Setzen eines Variablen-Wertes, abhängig von anderen Variablen-Werten**.
132
133 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.
134
135 [[image:attach:Editor - Neue Bedinung anlegen_de.png]]
136
137 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.
138
139 [[image:attach:Editor - Vergleichsoperatoren_de.png]]
140
141 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.
142
143 **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.
144
145 [[image:attach:Editor - Verknüpfung von Bedingungen_de.png]]
146
147 **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.
148 {{/layout-cell}}
149 {{/layout-section}}
150
151 {{layout-section ac:type="single"}}
152 {{layout-cell}}
153 == Expertenmodus (IMS QTI) ==
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.
156
157 [[image:attach:Editor - Variable im Expertenmodus_de.jpg]]
158
159 Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurückzuwechseln.
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.
162
163
164 {{/layout-cell}}
165 {{/layout-section}}
166
167 {{layout-section ac:type="single"}}
168 {{layout-cell}}
169 == Variablen-Belegung einsehen ==
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.
172
173 Detaillierte Informationen finden Sie in den jeweiligen Hilfeabschnitten zur Ergebniseinsicht für den Betreuer:
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" %)
176
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 * (% class="toc-item-body" %)[[Anzeige von Systemfehlern>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]]
179 {{/layout-cell}}
180 {{/layout-section}}
181
182 {{layout-section ac:type="single"}}
183 {{layout-cell}}
184
185 {{/layout-cell}}
186 {{/layout-section}}
187
188 {{layout-section ac:type="single"}}
189 {{layout-cell}}
190 == (% class="toc-item-body" %)Verarbeitungsreihenfolge von Variablen in der Testdurchführung(%%) ==
191 {{/layout-cell}}
192 {{/layout-section}}
193
194 {{layout-section ac:type="two_right_sidebar"}}
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.
197 {{/layout-cell}}
198
199 {{layout-cell}}
200 [[image:attach:Variablenauswertung2.png]]
201 {{/layout-cell}}
202 {{/layout-section}}
203
204 {{layout-section ac:type="single"}}
205 {{layout-cell}}
206 === Testaufruf bzw. Teststart ===
207 {{/layout-cell}}
208 {{/layout-section}}
209
210 {{layout-section ac:type="two_equal"}}
211 {{layout-cell}}
212 * Vor Anzeige aller Aufgaben erfolgt das Pre-Processing der Testvariablen.
213 {{/layout-cell}}
214
215 {{layout-cell}}
216 [[image:attach:image-2023-11-3_14-25-6.png]]
217 {{/layout-cell}}
218 {{/layout-section}}
219
220 {{layout-section ac:type="single"}}
221 {{layout-cell}}
222 === Aufgabenaufruf innerhalb des Tests ===
223 {{/layout-cell}}
224 {{/layout-section}}
225
226 {{layout-section ac:type="two_equal"}}
227 {{layout-cell}}
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 * 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.
231 {{/layout-cell}}
232
233 {{layout-cell}}
234 [[image:attach:image-2023-11-3_14-25-52.png]][[image:attach:image-2023-11-3_14-41-6.png]]
235
236 [[image:attach:image-2023-11-3_14-42-52.png]]
237 {{/layout-cell}}
238 {{/layout-section}}
239
240 {{layout-section ac:type="single"}}
241 {{layout-cell}}
242 === Abgabe einer Aufgabe ===
243 {{/layout-cell}}
244 {{/layout-section}}
245
246 {{layout-section ac:type="two_equal"}}
247 {{layout-cell}}
248 Eine Aufgabe gilt als abgegeben, wenn der Nutzer den Button **Antwort abgeben** an einer Aufgabe klickt oder im linearen Testverlauf auf den Button **Weiter **klickt, um zur nächsten Aufgabe zu navigieren oder wenn der Test beendet wird.
249 {{/layout-cell}}
250
251 {{layout-cell}}
252 [[image:attach:image-2023-11-3_15-15-2.png]]
253 {{/layout-cell}}
254 {{/layout-section}}
255
256 {{layout-section ac:type="two_equal"}}
257 {{layout-cell}}
258 * Mit Abgabe einer Aufgabenantwort erfolgt erst das **Aufgaben-Post-Processing**, anschließend das **Test-Post-Processing**, bevor der Zyklus mit dem Öffnen der nächsten Aufgabe erneut durchlaufen wird oder mit Testabgabe endet.
259
260 (% style="margin-left: 40.0px;" %)
261 ==== Reihenfolge Aufgaben Post-Processing: ====
262
263 *
264 ** (% style="color:#7a869a" %)Auswertung der Einzelantworten (setzen von SCORE_GAP_ID)
265 ** (% style="color:#7a869a" %)Auswertung der Gesamtaufgabe (setzen von SCORE)
266 ** Variablen Post-Processing durchführen (Autor)
267 ** (% style="color:#7a869a" %)Setzen der MINSCORE / MAXSCORE Grenzen
268 ** (% style="color:#7a869a" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC)
269 ** (% style="color:#000000" %)Setzen der individuellen Feedback-Bedingungen
270
271 (% style="margin-left: 40.0px;" %)
272 ==== Reihenfolge Test Post-Processing: ====
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 ** Variablen Post-Processing
279 ** (% style="color:#7a869a" %)Setzen der allgemeinen Feedback-Bedingungen (FEEDBACKBASIC)
280 ** Setzen der individuellen Feedback-Bedingungen
281 {{/layout-cell}}
282
283 {{layout-cell}}
284 [[image:attach:image-2023-11-3_14-46-47.png]][[image:attach:image-2023-11-3_14-54-46.png]]
285 {{/layout-cell}}
286 {{/layout-section}}
287
288 {{layout-section ac:type="single"}}
289 {{layout-cell}}
290 === Abgabe eines Tests ===
291 {{/layout-cell}}
292 {{/layout-section}}
293
294 {{layout-section ac:type="two_equal"}}
295 {{layout-cell}}
296 * Mit Abgabe Tests erfolgt das beschriebene Test Post-Processing ein letztes Mal.
297 {{/layout-cell}}
298 {{/layout-section}}
299 {{/layout}}