Zum Inhalt springen

Änderungen von Dokument 07 Variablen verwenden

Zuletzt geändert von Carina Enke am 25.07.2024
Von Version 488.1
bearbeitet von Katharina Schönefeld (Admin)
am 02.11.2016
Änderungskommentar: Published by Scroll Versions from space ONYXintern and version 1.8
Auf Version 453.1
bearbeitet von Carina Enke
am 29.05.2018
Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.11.1.

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.katharina
1 +XWiki.carina
Inhalt
... ... @@ -5,12 +5,16 @@
5 5  
6 6  {{layout-section ac:type="two_right_sidebar"}}
7 7  {{layout-cell}}
8 -Definieren Sie Variablen, 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.
8 +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:
9 9  
10 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables1.png]]
10 +* **Vor Anzeige verarbeitete Variablen**
11 +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.
12 +* **Nach Abgabe verarbeitete Variablen**
13 +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.
11 11  
12 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)
15 +
13 13  
17 +[[image:attach:Editor - Tab Variablen_de.png]]
14 14  {{/layout-cell}}
15 15  
16 16  {{layout-cell}}
... ... @@ -19,12 +19,18 @@
19 19  
20 20  
21 21  {{toc/}}
26 +{{/panel}}
22 22  
23 -**Verwandte Themen**
24 -
28 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Verwandte Themen"}}
25 25  * [[doc:Berechnungsaufgabe]]
26 26  * [[doc:Formelvergleich]]
27 27  {{/panel}}
32 +
33 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Weiterführende Informationen"}}
34 +* [[MAXIMA Manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]]
35 +* [[MAXIMA Good-Practice-Beispiele>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]]
36 +* [[MAXIMA Systeminformationen>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]]
37 +{{/panel}}
28 28  {{/scroll-ignore}}
29 29  
30 30  
... ... @@ -36,116 +36,250 @@
36 36  {{layout-section ac:type="single"}}
37 37  {{layout-cell}}
38 38  (% class="help-heading" %)
39 -== Definition einer Variable ==
49 +== Vor Anzeige verarbeitete Variablen ==
40 40  
41 -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.
51 +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.
42 42  
43 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables2.png]]
53 +(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
44 44  
45 -Vergeben Sie einen **eindeutigen Namen** für ihre Variable. Der Variablen-Name dient als Identifier und ermöglicht Ihnen die **Nutzung der Variable im Aufgabentext**. Wählen Sie nun noch den Variablen-Typ. Folgende Variablen-Typen werden bereitgestellt:
55 +=== Beispiel "Transport" - Einsatz von Zufallsparametern ===
46 46  
47 -* Text
48 -* Ganze Zahl (Integer)
49 -* Gleitkommazahl (Float)
57 +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.
50 50  
51 -Für Variablen vom Typ Gleitkommazahl kann für die Anzeige die Anzahl der Dezimalstellen konfiguriert werden. Bitte beachten Sie, dass die Einstellung nur die Anzeige, nicht aber die Rechengenauigkeit und den Lösungsvergleich beeinflusst. Das bedeutet: Wird die Variable für die Berechnung weiterer Variablen genutzt, wird der vollständige Wert zur Berechnung verwendet. Ist die Variable als Lösung für eine Lücke (Berechnungsaufgabe) hinterlegt, wird die konfigurierte Anzahl der Dezimalstellen für die Lösungsanzeige verwendet, nicht aber für den Lösungsvergleich.
52 -
53 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables-float.png]]
54 -
55 -(% class="confluence-information-macro confluence-information-macro-information conf-macro output-block" %)
59 +|(% colspan="1" %)(% colspan="1" %)
56 56  (((
57 -(% class="title" %)
58 -Hinweis
59 -
60 -(% class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon" %)
61 -
62 -(% class="confluence-information-macro-body" %)
61 +[[image:attach:Editor - Tab Variablen zur Beispielaufgabe_de.png]]
62 +)))|(% colspan="1" %)(% colspan="1" %)
63 63  (((
64 -//Möchten Sie erreichen, dass der Teilnehmer Berechnungsaufgaben nur mit einer bestimmten Genauigkeit lösen muss, verwenden Sie die Einstellung zur Definition eines [[Toleranzbereiches>>url:https://www.bps-system.de/help/display/ONYX/Berechnungsaufgabe#Berechnungsaufgabe-Schritt5%28optional%29:DefinitioneinesToleranzbereiches||shape="rect"]] im Bearbeitungsfenster der Lücke.//
64 +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".
65 +
66 +
65 65  )))
68 +|(((
69 +[[image:attach:Editor - Beispiel einer Bedingung_de.png]][[image:attach:Editor - weiteres Beispiel einer Bedingung_de.png]]
70 +)))|(((
71 +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.
66 66  )))
73 +|(((
74 +[[image:attach:Editor - Nutzung von Variablen in der Aufgabenstellung_de.png]]
75 +)))|(((
76 +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) >>url:https://www.bps-system.de/help/display/ONYXintern/.Berechnungsaufgabe+v1.6||shape="rect"]]eingebunden.
67 67  
78 +An die Lücke wird die Variable mit der korrekten Lösung {distance} gebunden.
79 +
68 68  
81 +)))
82 +|(((
83 +[[image:attach:Testrun - Beispielaufgabe im Testrun_de.png]]
84 +)))|(((
85 +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.
86 +)))
69 69  
70 -Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur Wert-Ermittlung bereit:
88 +== Nach Abgabe verarbeitete Variablen ==
71 71  
72 -|=(((
73 -Wertebereich
90 +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.
91 +
92 +(% 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]]
93 +
94 +=== Beispiel "Transport" - Adaptives Aufgabenfeedback ===
95 +
96 +Das oben beschriebene Beispiel wird folgend um ein 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.
97 +
98 +|(((
99 +[[image:attach:Editor - Angabe von POST-Variablen_de.png]]
74 74  )))|(((
75 -Für numerische Variablen kann ein Wertebereich definiert werden. Der Variablen-Wert wird **zufällig innerhalb des Wertebereiches** ermittelt. Die angegebenen Grenzen werden in die Auswahl einbezogen. Für Variablen vom Typ „Ganze Zahl“ kann zusätzlich zu den Grenzen (Einstellung Minimum und Maximum) die Schrittweite (Einstellung Schritte) gewählt werden.
101 +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.
76 76  
77 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables3.png]]
103 +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.
78 78  
79 -Für den im dargestellten Beispiel verwendeten Wertebereich: Minimum=2, Maximum=11, Schritte=3 sind die **Werte {2, 5, 8, 11}** möglich.
105 +
80 80  )))
81 -|=(((
82 -Berechnung (MAXIMA)
107 +|(((
108 +[[image:attach:Editor - Post-Variablen im Feedback_de.png]]
83 83  )))|(((
84 -Die ONYX Testsuite ist mit dem Computer-Algebra-System MAXIMA gekoppelt. Sie können Variablenwerte auf Basis anderer Variablen berechnen. Geben Sie hierfür die Berechnungsvorschrift in MAXIMA-Schreibweise an.
110 +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]].
85 85  
86 -Mögliche Eingaben sind beispielsweise:
112 +Die individuellen Feedbacktexte und -werte, welche in den Variablen gespeichert wurden, werden durch Angabe des Variablen-Namens ({div}, {answer}) in den Feedbacktext eingebunden.
87 87  
88 -* **({A}*{B})^2:** Berechnet den Variablenwert auf Basis der Variablen mit dem Namen {A} und {B}.
89 -* **sqrt({A})/(5+sqrt({B})):** MAXIMA unterstützt mathematische Ausdrücke wie sqrt() für die Quadratwurzel.
90 -* **2*sin({A})+log({B}):** Ebenso können trigonometrische Funktionen oder die Logarithmusfunktion genutzt werden.
114 +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.
115 +)))
116 +|(((
117 +[[image:attach:Testrun - Feedback mit Post-Variablen_de.png]]
118 +)))|(((
119 +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.
91 91  
92 -(% class="confluence-information-macro confluence-information-macro-information conf-macro output-block" %)
93 -(((
94 -(% class="title" %)
95 -Hinweis
121 +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]].
122 +)))
96 96  
97 -(% class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon" %)
124 +=== Beispiel "Transport" - Punktabzug pro Lösungsversuch ===
98 98  
99 -(% class="confluence-information-macro-body" %)
100 -(((
101 -Weitere Hinweise zur MAXIMA-Schreibweise erhalten Sie auf den Hilfeseiten zum [[Computer-Algebra-System MAXIMA>>url:http://maxima.sourceforge.net/||title="Weitere Informationen zu MAXIMA" rel="nofollow" shape="rect" class="external-link"]].
126 +Folgend soll das Beispiel "Transport", um einen Punktabzug pro Lösungsversuch erweitert werden. Die maximale Punktzahl der Aufgabe wurde dafür 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.
127 +Es wird unbedingt empfohlen dem Teilnehmer den Punktabzug anzuzeigen. Hierzu werden entsprechende Textbausteine in die Aufgabenstellung und das Feedback eingebaut.
128 +
129 +|(((
130 +[[image:attach:Editor - Variablen zur Beispielaufgabe_de.png]]
131 +)))|(((
132 +Zur Umsetzung werden folgende Variablen definiert:
133 +
134 +* **Die Numerische Variable[[ >>doc:Numerische Variablen]]{deduction_attempt} speichert der Punktabzug pro Versuch.**
135 +Im Beispiel soll die Gesamtpunktzahl um einen Punkt reduziert werden. Daher wird {deduction_attempt} auf den statischen Wert 1 gesetzt.
136 +Da es sich um einen statischen Wert handelt, kann dieser als Pre-Variable (Vor Anzeige verarbeitete Variable) angelegt werden.
137 +* **Die Numerische Variable[[ >>doc:Numerische Variablen]]{deduction} speichert den aktuellen Punktabzug in Abhängigkeit vom Lösungsversuch.**
138 +Der Punktabzug {deduction} berechnet sich als Produkt aus der Anzahl der bisherigen Lösungsversuche (Systemvariable NUMATTEMPTS) und dem Punktabzug pro Versuch {deduction_attempt}.
139 +Da es sich um einen pro Lösungsversuch berechneten Wert handelt, muss dieser als Post-Variable (Nach Abgabe verarbeitet Variable) berechnet werden.
140 +
141 +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.
142 +
143 +//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle Variablen zur Generierung der allgemeinen Aufgaben- und Feedbackinhalte ausgeblendet.//
102 102  )))
145 +|(((
146 +Hinweis in der Aufgabenstellung:
147 +
148 +[[image:attach:Editor - Hinweis in der Aufgabenstellung_de.png]]
149 +
150 +Hinweis als individuelles Feedback:
151 +
152 +[[image:attach:Editor - Hinweis als individuelles Feedback_de.png]]
153 +)))|(((
154 +\\
155 +
156 +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.
157 +
158 +//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.//
103 103  )))
160 +|(((
161 +[[image:attach:Testrun - Beispielaufgabe in unterschiedlichen Versuchen_de.png]]
162 +)))|(((
163 +Entsprechend der Anzahl der notwendigen Lösungsversuche werden nun Punkte abgezogen.\\
164 +
165 +Teilnehmer, welche im ersten Lösungsversuch die richtige Antwort eingeben, erhalten die volle Punktzahl.
166 +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.\\
104 104  )))
105 -|=(((
106 -Zufällige Auswahl
168 +
169 +=== Beispiel "Transport" - Wertung der maximal erreichten Punktzahl
170 + ===
171 +
172 +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.
173 +Der Teilnehmer sollte durch Hinweise entsprechend informiert werden und sowohl die Wertung des aktuellen Versuchs, als auch die maximale Wertung über alle Versuche angezeigt bekommen\\
174 +
175 +|(((
176 +[[image:attach:Editor - Beispiel mehrere Versuche_de.png]]
107 107  )))|(((
108 -Für Text-Variablen kann eine **Werte-Liste** definiert werden, aus welcher **zufällig ein Wert ausgewählt** wird. Definieren Sie Ihre Werte-Liste durch Angabe der alternativen Werte. Trennen Sie die Werte durch **Komma oder Zeilenumbruch**.
178 +Zur Umsetzung werden zunächst folgende Variablen definiert:
109 109  
110 -//Wenn im Auswahlwert (Typ:Text) ein Komma enthalten ist, setzen Sie dieses bitte mit einem Backslash vor dem Komma um. (Beispiel: "Die Bedingung\, dass ...")//
180 +* **Die Numerische Variable[[ >>doc:Numerische Variablen]]{best_score} speichert die maximal erreichte Punktzahl über alle Aufgabenversuche.**
181 +Die Variable {best_score} wird einmalig mit dem Wert 0 initialisiert und später durch eine Bedingung gesteuert.
182 +* **Die Numerische Variable[[ >>doc:Numerische Variablen]]{current_score} speichert die aktuell erreichte Punktzahl für den aktuellen Aufgabenversuch.**
183 +Die Variable {current_score} wird mit jedem Versuch auf den Wert der Systemvariable SCORE gesetzt.
111 111  
112 -Nutzen Sie den Typ Zufällige Auswahl auch beim Einsatz von **Konstanten**. Geben Sie dazu nur einen einzelnen Wert für die zu verwendende Konstante vor.
185 +Durch Bedingungen wird folgend die maximale Punktzahl über alle Aufgabenversuche aktualisiert und die Aufgabenpunktzahl ggf. angepasst:
186 +
187 +* **Bedingung zur Ermittlung der maximal erreichten Punktzahl **
188 +Wenn die aktuell erreichte Punktzahl {current_score} größer als die maximal erreichte Punktzahl {best_score} ist, soll  {best_score} auf den Wert von  {current_score} gesetzt werden.
189 +* **Bedingung zur Wertung der maximal erreichten Punktzahl **
190 +Wenn die maximal erreichte Punktzahl {best_score} größer als die aktuell erreichte Punktzahl {current_score} ist, soll die Aufgabenpunktzahl (Systemvariable SCORE) auf den Wert von  {best_score} gesetzt werden.
191 +
192 +//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle anderen Variablen zur Generierung der Aufgaben- und Feedbackinhalte ausgeblendet.//
113 113  )))
194 +|(((
195 +Hinweis in der Aufgabenstellung:
114 114  
115 -== Definition einer Bedingung ==
197 +[[image:attach:Editor - Hinweis zur Wertung in Aufgabenstellung_de.png]]
198 +)))|(((
199 +\\
116 116  
117 -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.
201 +Um dem Lerner das aktuelle Wertungsverfahren zu erläutern, wird zum einen in die Aufgabenstellung ein genereller Hinweis zur Bewertung eingefügt.
202 + Um darüber hinaus die aktuelle, als auch die beste Bewertung anzuzeigen, wird ein entsprechendes Feedback definiert.
203 +)))
204 +|(% colspan="1" %)(% colspan="1" %)
205 +(((
206 +Hinweis als individuelles Feedback:
118 118  
119 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables4.png]]
208 +[[image:attach:Editor - Variablen für Hinweis zur Wertung_de.png]]
120 120  
121 -Eine Bedingung ermöglicht **das Setzen eines Variablen-Wertes, abhängig von anderen Variablen-Werten**. Im Beispiel soll die Variable {B} in Abhängigkeit von der Variable {A} definiert werden. Ist die Variable {A} kleiner 4, soll {B} im Wertebereich von [0,10] zufällig gewählt werden.
210 + [[image:attach:Editor - Hinweis zur Wertung als individuelles Feedback_de.png]]
211 +)))|(% colspan="1" %)(% colspan="1" %)
212 +(((
213 +Für das Beispiel soll der Hinweis in Form eines Feedback-Textes nur angezeigt werden, wenn die aktuell erreichte Punktzahl {current_score} kleiner der maximal erreichten Punktzahl {best_score} ist. Nur wenn die aktuellen Punkte kleiner der bisher maximal erreichten Punkte sind, wird die Aufgabenwertung so geändert, dass statt der aktuellen, die maximale Punktzahl gesetzt wird.
122 122  
123 -Bitte beachten Sie, eine Variable die innerhalb einer Bedingung verwendet wird, muss vor der Bedingung initialisiert 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. Im Beispiel wird die Variable {B} als Variable vor der Bedingung ohne Wertsetzung angelegt. Die Wertsetzung erfolgt innerhalb der Bedingung.
215 +Zur Feedback-Steuerung wird eine zusätzliche Steuer-Variable eingeführt:
124 124  
125 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables5.png]]
217 +* **Die Numerische Variable {diff_score} speichert ob die aktuelle Punktzahl kleiner der maximalen Punktzahl ist**
218 +Die Variable {diff_score} wird zunächst ohne Wert initialisiert und später durch eine Bedingung gesteuert.\\
219 +* **Bedingung zum Setzen von {diff_score}**
220 +Wenn d ie aktuell erreichte Punktzahl {current_score } kleiner als die maximal erreichte Punktzahl {best_score} ist, soll {diff_score} auf 1 gesetzt werden, ansonsten auf den Wert 0.
126 126  
127 -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.
222 +Für das individuelle Feedback kann nun auf die Steuer-Variable {diff_score} zugegriffen werden und in Abhängigkeit von deren Wert (0 oder 1) ein individuelles Feedback für den Teilnehmer angezeigt werden. Für das Beispiel soll ein Hinweis zur Bewertung angezeigt werden, wenn {diff_score} den Wert 1 hat und damit statt der erreichten Punktzahl {current_score} des aktuelle n Versuchs die maximal erreichte Punktzahl {best_score} gewertet wird.
223 +\\\\
224 +)))
225 +|(((
226 +[[image:attach:Testrun - Beispielaufgabe Wertung in unterschiedlichen Versuchen_de.png]]
227 +)))|(((
228 +Entsprechend der Anzahl der notwendigen Lösungsversuche werden nun Punkte abgezogen.\\
128 128  
129 -== Expertenmodus ==
230 +Ein Teilnehmer, welcher zuvor aufgrund falscher Antworten, Hinweise im Feedback erhalten hat, kann somit in einem Folgeversuch nicht mehr die volle Punktzahl für die Aufgabe erreichen.
231 +)))
130 130  
131 -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. 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.
233 +(% class="help-heading" %)
234 +== Definition einer Variable ==
132 132  
133 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables6.jpg]]
236 +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.
134 134  
135 -Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurück zu wechseln.
238 +[[image:attach:Editor - Definition einer Variable_de.png]]
136 136  
137 -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.
240 +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.
138 138  
139 -== Einfügen von Variablen in den Aufgabentext ==
242 +Wählen Sie den **Variablen-Typ**. Folgende Variablen-Typen werden bereitgestellt:
140 140  
141 -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.
244 +* [[doc:Numerische Variablen]]:
245 +** Ganze Zahl
246 +** Gleitkommazahl
247 +* [[doc:Textvariablen]]
248 +* [[doc:Bild Variablen]]
142 142  
143 -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.
250 +Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur **Wert-Ermittlung** bereit:
144 144  
252 +* Wert
253 +* Wertebereich
254 +* Zufällige Auswahl
255 +* Berechnung (MAXIMA)
256 +
257 +Variablen können auch ohne Wert-Setzung angelegt werden, um den Wert beispielsweise später in Abhängigkeit anderer Variablen zu setzen (vgl. Bedingungen).
258 +
259 +== Verwendung von Variablen ==
260 +
261 +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.
262 +
145 145  Im Beispiel wurden die Variablen {VAR1}, {VAR2} und {VAR3} deklariert:
146 146  
147 -(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:onyx-variables7.png]]
265 +(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Beispiel zur Verwendung von Variablen_de.png]]
148 148  
267 +== Definition einer Bedingung ==
268 +
269 +Im **Tab Variablen** können Sie zudem Bedingungen verwenden. Eine Bedingung ermöglicht **das Setzen eines Variablen-Wertes, abhängig von anderen Variablen-Werten**.
270 +
271 +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.
272 +
273 +[[image:attach:Editor - Neue Bedinung anlegen_de.png]]
274 +
275 +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.
276 +
277 +[[image:attach:Editor - Vergleichsoperatoren_de.png]]
278 +
279 +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.
280 +
281 +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.
282 +
283 +== Expertenmodus (IMS QTI) ==
284 +
285 +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.
286 +
287 +[[image:attach:Editor - Variable im Expertenmodus_de.jpg]]
288 +
289 +Bitte beachten Sie, dass nach einer Änderung der eingegebenen Beschreibung im Expertenmodus, keine Möglichkeit besteht, in den einfachen Modus zurück zu wechseln.
290 +
291 +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.
292 +
149 149  == Variablen-Belegung einsehen ==
150 150  
151 151  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.
... ... @@ -152,7 +152,7 @@
152 152  
153 153  Detaillierte Informationen finden Sie in den jeweiligen Hilfeabschnitten zur Ergebniseinsicht für den Betreuer:
154 154  
155 -* (% 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" %) 
299 +* (% 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" %)
156 156  
157 157  * (% class="toc-item-body" %)[[MAXIMA-Ausgaben einsehen>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]]
158 158  * (% class="toc-item-body" %)[[Anzeige von Systemfehlern>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]]
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -64815129
1 +162758739
url
... ... @@ -1,1 +1,1 @@
1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/64815129/Variablen verwenden
1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/162758739/Variablen verwenden