Wiki-Quellcode von Variablen verwenden

Version 449.1 von Carina Enke am 24.09.2018

Zeige letzte Bearbeiter
1 {{layout}}
2 {{layout-section ac:type="single"}}
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 \\
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 {{/layout-cell}}
80 {{/layout-section}}
81
82 {{layout-section ac:type="two_right_sidebar"}}
83 {{layout-cell}}
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
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.
90
91
92
93 [[image:attach:Editor - Tab Variablen_de.png]]
94 {{/layout-cell}}
95
96 {{layout-cell}}
97 {{scroll-ignore}}
98 {{panel borderColor="#ddd" borderStyle="solid" title="Inhalt"}}
99
100
101 {{toc/}}
102 {{/panel}}
103
104 {{panel borderColor="#ddd" borderStyle="solid" title="Verwandte Themen"}}
105 * [[doc:Berechnungsaufgabe]]
106 * [[doc:Formelvergleich]]
107 {{/panel}}
108
109 {{panel borderColor="#ddd" borderStyle="solid" title="Weiterführende Informationen"}}
110 * [[MAXIMA Manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]]
111 * [[MAXIMA Good-Practice-Beispiele>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]]
112 * [[MAXIMA Systeminformationen>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]]
113 {{/panel}}
114 {{/scroll-ignore}}
115
116
117
118
119 {{/layout-cell}}
120 {{/layout-section}}
121
122 {{layout-section ac:type="single"}}
123 {{layout-cell}}
124 (% class="help-heading" %)
125 == Vor Anzeige verarbeitete Variablen ==
126
127 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.
128
129 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
130
131
132
133 {{id name="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"/}}
134
135 === Beispiel "Transport" - Einsatz von Zufallsparametern ===
136
137 Als Beispiel wird eine typische Anwendungsaufgabe erstellt. Es soll der zurückgelegte Weg eines beliebigen Fahrzeugs auf Grundlage der Geschwindigkeit und der Zeit berechnet werden. Die Geschwindigkeit ist dabei abhängig vom Fahrzeugtyp.
138
139 |(% colspan="1" %)(% colspan="1" %)
140 (((
141 [[image:attach:Editor - Tab Variablen zur Beispielaufgabe_de.png]]
142 )))|(% colspan="1" %)(% colspan="1" %)
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
147 )))
148 |(((
149 [[image:attach:Editor - Beispiel einer Bedingung_de.png]][[image:attach:Editor - weiteres Beispiel einer Bedingung_de.png]]
150 )))|(((
151 Zur abhängigen Wertsetzung nutzen wir die Variablen-Bedingung. In der Bedingung können wir in Abhängigkeit von dem gewählten Wert der Variable {transport} den Wertebereich für die Variable {speed} definieren. Für das Fahrrad ({transport}="bike") wird auf diese Weise ein Wertebereich von 10 bis 30 (km/h) gesetzt.
152 )))
153 |(((
154 [[image:attach:Editor - Nutzung von Variablen in der Aufgabenstellung_de.png]]
155 )))|(((
156 Die gegebenen Werte der Aufgabe werden in den Aufgabentext durch Angabe des Variablen-Namens ({transport}, {speed} und {hours}) eingebunden. Im Beispiel wird die Variable in eine Aufgabe von Typ [[Berechnung (Lückentext) >>doc:Berechnungsaufgabe]]eingebunden.
157
158 An die Lücke wird die Variable mit der korrekten Lösung {distance} gebunden.
159
160
161 )))
162 |(((
163 [[image:attach:Testrun - Beispielaufgabe im Testrun_de.png]]
164 )))|(((
165 Für den Testdurchlauf wird für jeden Teilnehmer und jeden Versuch zufällig einer der definierten Werte ausgewählt. Im Beispiel wurde zufällig der Wert "bike" eingesetzt und damit eine Geschwindigkeit im Wertebereich von 10 bis 30 (km/h) gewählt.
166 )))
167
168
169
170 {{id name="Nach Abgabe verarbeitete Variablen"/}}
171
172 == Nach Abgabe verarbeitete Variablen ==
173
174 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.
175
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
178
179
180 {{id name="Beispiel ~"Transport~" - Adaptives Aufgabenfeedback"/}}
181
182 === Beispiel "Transport" - Adaptives Aufgabenfeedback ===
183
184 Adaptives Feedback ermöglicht ein individuelles Feedback auf Basis der eingegebenen Lernerantwort. Dem Teilnehmer können so konkrete Lösungs- oder Fehlerhinweise im Bezug zu seiner eingegebenen Lösung gegeben werden. Die Post-Variablen (Nach Abgabe verarbeitete Variablen[[doc:||anchor="Variablenverwenden-NachAbgabeverarbeiteteVariablen"]]) ermöglichen einen Zugriff auf die Lernerantwort bspw. jeder Lücke. Zusätzlich können die Anzahl der Lösungsversuche oder auch vorangegangene Antworten in das Feedback einbezogen werden.
185
186 Folgend wird das (% class="confluence-link" %)[[Beispiel "Transport">>doc:||anchor="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"]](%%) um ein einfaches adaptives Feedback ergänzt. Das Feedback soll dem Nutzer einen Hinweis geben, ob seine Antwort kleiner oder größer als die korrekte Lösung war und bei einer falschen Antwort einen Hinweis geben, wie die korrekte Lösung berechnet wird.
187
188 |(((
189 [[image:attach:Editor - Angabe von POST-Variablen_de.png]]
190 )))|(((
191 Im ersten Schritt wird im Tab Variablen die [[Text-Variable>>doc:Textvariablen]] {div} in einer Bedingung, abhängig davon ob die eingegebene Lerneranwort kleiner oder größer als die korrekte Antwort ist, auf den Wert "less" oder "more" gesetzt.
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
196 )))
197 |(((
198 [[image:attach:Editor - Post-Variablen im Feedback_de.png]]
199 )))|(((
200 Im zweiten Schritt werden die konkreten Feedbacktexte für die Aufgabe hinterlegt. Dem Teilnehmer soll das Feedback nur angezeigt werden, wenn er die Aufgabe falsch beantwortet hat. Hierfür wird im Tab Feedback das allgemeine Feedback "Aufgabe falsch beanwortet" genutzt. Weitere Informationen zum Aufgabenfeedback erhalten Sie auf der Seite [[doc:Feedback festlegen]].
201
202 Die individuellen Feedbacktexte und -werte, welche in den Variablen gespeichert wurden, werden durch Angabe des Variablen-Namens ({div}, {answer}) in den Feedbacktext eingebunden.
203
204 Weitere Feedbackblöcke können beispielsweise als individuelles Feedback hinzugefügt werden. Für das Beispiel wurde zusätzlich noch ein Lösungshinweis als Feedback hinterlegt, welcher unabhängig von der Lernerantwort immer angezeigt wird. Im Feedback können ebenso detaillierte Musterlösungen und -rechnungen angezeigt werden. Für Aufgaben mit Zufallsparameter können in das Feedback hierfür die vor Anzeige berechneten Variablen eingebunden werden.
205 )))
206 |(((
207 [[image:attach:Testrun - Feedback mit Post-Variablen_de.png]]
208 )))|(((
209 Da die Aufgabe Zufallsparameter enthält werden für jeden Testdurchlauf und Teilnehmer andere Aufgabenwerte angezeigt. Entsprechend der definierten Inhalte wird dem Teilnehmer nun zusätzlich ein individuelles Feedback auf Basis seiner gegebenen Antwort angezeigt.
210
211 Sie können die Zufallsparameter einer Aufgabe für weitere Aufgaben-Lösungsversuch beibehalten oder neu ermitteln. Weitere Informationen finden Sie im Abschnitt "Variablen zurücksetzen" auf der Seite [[doc:Test-Optionen festlegen]].
212 )))
213
214
215
216 {{id name="Beispiel ~"Transport~" - Punktabzug pro Lösungsversuch"/}}
217
218 === Beispiel "Transport" - Punktabzug pro Lösungsversuch ===
219
220 Stehen dem Teilnehmer mehrere Lösungsversuche zur Verfügung, kann durch individuelle und aufbauende Lösungshinweise eine Hilfestellung zur Aufgabenbearbeitung gegeben werden. Insbesondere in diesen Szenarien kann es gewünscht sein, dass dem Teilnehmer pro Lösungsversuch Punkte abgezogen werden. Ein Teilnehmer, welcher die Aufgabe ohne Lösungsversuche löst erhält die volle Punktzahl. Je mehr Lösungshinweise mit jedem Versuch benötigt werden, um so weniger Punkte erhält der Teilnehmer.
221
222 Nachfolgend soll für das Beispiel "Transport"[[ >>doc:||anchor="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"]](% class="confluence-link" %)ein Punktabzug pro Lösungsversuch mit Hilfe von Variablen realisiert werden. Dafür wird die maximal mögliche Punktzahl der Aufgabe auf 10 Punkte erhöht.(%%) Pro benötigten Lösungsversuch soll die erreichte Punktzahl um einen Punkt reduziert werden. Der Punktabzug erfolgt pro Aufgaben-Lösungsversuch innerhalb eines Testdurchlaufs. Die Anzahl der Testversuche wird nicht berücksichtigt. Um dem Teilnehmer den Punktabzug anzuzeigen werden entsprechende Textbausteine in die Aufgabenstellung und das Feedback eingebaut.
223
224 |(((
225 [[image:attach:Editor - Variablen zur Beispielaufgabe_de.png]]
226 )))|(((
227 Zur Umsetzung werden folgende Variablen definiert:
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.
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.
237
238 //Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle Variablen zur Generierung der allgemeinen Aufgaben- und Feedbackinhalte ausgeblendet.//
239 )))
240 |(((
241 Hinweis in der Aufgabenstellung:
242
243 [[image:attach:Editor - Hinweis in der Aufgabenstellung_de.png]]
244
245 Hinweis als individuelles Feedback:
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.
250
251
252
253 {{note}}
254 //Hinweis: Bitte beachten Sie, dass ein Punktabzug im Folgeversuch dazu führt, dass die Aufgabe nicht mehr als vollständig richtig gewertet wird, da die maximale Punktzahl nicht erreicht wurde. Dies hat Auswirkungen auf die Anzeige der erreichten Punkte (farbliche Kennzeichnung), sowie die Symbolik der Richtig/Falsch-Auswertung. Ebenso betroffen ist das allgemeine Aufgaben-Feedback, welches auf Basis der Bedingung ob der Teilnehmer die maximale Punktzahl der Aufgabe erreicht hat, gesteuert wird. Durch Nutzung des individuellen Feedbacks kann die Logik zur Anzeige der Feedbackinhalte individuell an die Aufgabe angepasst werden.//
255 {{/note}}
256 )))
257 |(((
258 [[image:attach:Testrun - Beispielaufgabe in unterschiedlichen Versuchen_de.png]]
259 )))|(((
260 Entsprechend der Anzahl der notwendigen Lösungsversuche werden nun Punkte pro Lösungsversuch abgezogen:\\
261
262 * Teilnehmer, welche im ersten Lösungsversuch die richtige Antwort eingeben, erhalten die volle Punktzahl.
263 * Teilnehmer, welche in einem der Folgeversuche die richtige Antwort eingeben, erhalten Teilpunkte. Durch entsprechendes Feedback können diesen Teilnehmern individuelle Lösungshinweise und damit Unterstützung zur eigenständigen Weiterbearbeitung der Aufgabe gegeben werden.\\
264 )))
265
266
267
268 {{id name="Beispiel ~"Transport~" - Wertung der maximal erreichten Punktzahl"/}}\\
269
270 === Beispiel "Transport" - Wertung der maximal erreichten Punktzahl
271 ===
272
273 Werden mehrere Lösungsversuche pro Aufgabe angeboten, kann es dazu kommen, dass ein Teilnehmer in Folgeversuchen weniger Punkte erreicht, als er bereits für einen vorangegangenen Versuch erhalten hat. Wenn gewünscht, kann sich die maximal erreichte Punktzahl über alle Antwortversuche gemerkt und für die Wertung genutzt werden. Der Teilnehmer sollte auh hier durch Hinweise entsprechend informiert werden und sowohl die Wertung des aktuellen Versuchs, als auch die maximale Wertung über alle Versuche angezeigt bekommen.
274
275 Folgend wird für das Beispiel "Transport"[[ >>doc:||anchor="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"]]erläutert wie die Wertung der maximal erreichten Punktzahl realisiert werden kann.\\
276
277 |(((
278 \\
279
280 [[image:attach:Editor - Beispiel mehrere Versuche_de.png]]\\
281 )))|(((
282 Zur Umsetzung werden folgende Variablen definiert:
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.//
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//
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 //
304 )))
305 |(((
306 Hinweis in der Aufgabenstellung:
307
308 [[image:attach:Editor - Hinweis zur Wertung in Aufgabenstellung_de.png]]
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
315 )))
316 |(% colspan="1" %)(% colspan="1" %)
317 (((
318 Hinweis als individuelles Feedback:[[image:attach:Editor - Hinweis zur Wertung als individuelles Feedback_de.png]]
319 )))|(% colspan="1" %)(% colspan="1" %)
320 (((
321 Zur Feedback-Steuerung wird auf die Hilfsvariable {best_score_is_used} zugegriffen und in Abhängigkeit von deren Wert (0 oder 1) ein individuelles Feedback für den Teilnehmer angezeigt. Das Feedback enthält einen Hinweis zur aktuellen Punktzahl {current_score}, sowie zur maximal erreichten {max_score}. Zusätzlich wird die Systemvariable MAXSCORE genutzt, um die maximal mögliche Punktzahl in den Hinweistext zu integrieren.
322 )))
323 |(((
324 [[image:attach:Testrun - Beispielaufgabe Wertung in unterschiedlichen Versuchen_de.png]]
325 )))|(((
326 Sollte der Teilnehmer nun in einem Folgeversuch weniger Punkte erreichen, als er bereits in einem vorangegangenen Versuch erhalten hat, wird immer die maximale Punktzahl gewertet. Im abgebildeten Beispiel ist die Übungsaufgabe so konfiguriert, dass mit jedem Versuch neue Aufgabenwerte gesetzt werden. Der Teilnehmer hat die Aufgabe im zweiten Versuch bereits richtig gelöst und die volle Punktzahl erhalten. Im dritten Versuch erhält der Teilnehmer daher trotz falscher Antwort für die gesamte Aufgabe die volle Punktzahl. Zusätzlich wird dem Teilnehmer im Feedback angezeigt, dass er für den aktuellen Versuch 0 Punkte erhalten hat, aber die bisher maximal erreichte Punktzahl von 10 Punkten gewertet wird.
327
328 Diese Aufgabenbeispiel ist mit den voranbeschriebenen Anwendungsszenarien kombinierbar:
329
330 * Beispiel "Transport" - Einsatz von Zufallsparametern[[doc:||anchor="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"]]
331 * Beispiel "Transport" - Adaptives Aufgabenfeedback[[doc:||anchor="Beispiel ~"Transport~" - Adaptives Aufgabenfeedback"]]
332 * Beispiel "Transport" - Punktabzug pro Lösungsversuch[[doc:||anchor="Beispiel ~"Transport~" - Punktabzug pro Lösungsversuch"]]
333 )))
334
335 (% class="help-heading" %)
336 == Definition einer Variable ==
337
338 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.
339
340 [[image:attach:Editor - Definition einer Variable_de.png]]
341
342 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.
343
344 Wählen Sie den **Variablen-Typ**. Folgende Variablen-Typen werden bereitgestellt:
345
346 * [[doc:Numerische Variablen]]:
347 ** Ganze Zahl
348 ** Gleitkommazahl
349 * [[doc:Textvariablen]]
350 * [[doc:Bild Variablen]]
351
352 Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur **Wert-Ermittlung** bereit:
353
354 * Wert
355 * Wertebereich
356 * Zufällige Auswahl
357 * Berechnung (MAXIMA)
358
359 Variablen können auch ohne Wert-Setzung angelegt werden, um den Wert beispielsweise später in Abhängigkeit anderer Variablen zu setzen (vgl. Bedingungen).
360
361 == Verwendung von Variablen ==
362
363 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.
364
365 Im Beispiel wurden die Variablen {VAR1}, {VAR2} und {VAR3} deklariert:
366
367 (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]]
368
369 == Definition einer Bedingung ==
370
371 Im **Tab Variablen** können Sie zudem Bedingungen verwenden. Eine Bedingung ermöglicht **das Setzen eines Variablen-Wertes, abhängig von anderen Variablen-Werten**.
372
373 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.
374
375 [[image:attach:Editor - Neue Bedinung anlegen_de.png]]
376
377 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.
378
379 [[image:attach:Editor - Vergleichsoperatoren_de.png]]
380
381 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.
382
383 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.
384
385 == Expertenmodus (IMS QTI) ==
386
387 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.
388
389 [[image:attach:Editor - Variable im Expertenmodus_de.jpg]]
390
391 Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurück zu wechseln.
392
393 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.
394
395 == Variablen-Belegung einsehen ==
396
397 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.
398
399 Detaillierte Informationen finden Sie in den jeweiligen Hilfeabschnitten zur Ergebniseinsicht für den Betreuer:
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"]]
405 {{/layout-cell}}
406 {{/layout-section}}
407 {{/layout}}