Änderungen von Dokument 07 Variablen verwenden

Zuletzt geändert von Carina Enke am 25.07.2024

Von 407.1 nach 408.1 Von 428.1 nach 429.1

Von Version 408.1

bearbeitet von Carina Enke
am 08.05.2019

Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 8.7.

Auf Version 428.1

bearbeitet von Carina Enke
am 22.01.2019

Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.13B.

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Objekte (1 geändert, 0 hinzugefügt, 0 gelöscht)
- Confluence.Code.ConfluencePageClass[0]

Details

Seiteneigenschaften

Inhalt

@@ -2,7 +2,12 @@
  {{layout}}
  {{layout-section ac:type="single"}}
  {{layout-cell}}
--\\
++
++
++(% class="removedPlaceholderWrapper" %)
++
++
++
  {{/layout-cell}}
  {{/layout-section}}
@@ -12,7 +12,7 @@
  * **Vor Anzeige verarbeitete Variablen**
  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.
--* **{{id name="PostVariablen"/}}Nach Abgabe verarbeitete Variablen**
++* **Nach Abgabe verarbeitete Variablen**
  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.
  \\
@@ -27,13 +27,6 @@
  {{toc/}}
  {{/panel}}
--{{panel borderColor="#ddd" borderStyle="solid" title="Anwendungsbeispiele"}}
--* [[doc:Beispiel Transport - Einsatz von Zufallsparametern]]
--* [[doc:Beispiel Transport - Adaptives Aufgabenfeedback]]
--* [[doc:Beispiel Transport - Punktabzug pro Loesungsversuch]]
--* [[doc:Beispiel Transport - Wertung der maximal erreichten Punktzahl]]
--{{/panel}}
--
  {{panel borderColor="#ddd" borderStyle="solid" title="Verwandte Themen"}}
  * [[doc:Berechnungsaufgabe]]
  * [[doc:Formelvergleich]]
@@ -46,9 +46,9 @@
  {{/panel}}
  {{/scroll-ignore}}
--\\
++
--\\
++
  {{/layout-cell}}
  {{/layout-section}}
@@ -61,12 +61,51 @@
  (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
--\\
--{{info}}
--Ein typisches Anwendungsbeispiel zum Einsatz von Variablen als Zufallsparameter wird im [[doc:Beispiel Transport - Einsatz von Zufallsparametern]] vorgestellt.
--{{/info}}
++{{id name="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"/}}
++
++=== Beispiel "Transport" - Einsatz von Zufallsparametern ===
++
++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.
++
++|(% colspan="1" %)(% colspan="1" %)
++(((
++[[image:attach:Editor - Tab Variablen zur Beispielaufgabe_de.png]]
++)))|(% colspan="1" %)(% colspan="1" %)
++(((
++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 vom gewählten Fahrzeug {transport} gesetzt werden. Schließlich fährt ein "bike" im Allgemeinen langsamer, als ein "train".
++
++
++)))
++|(((
++[[image:attach:Editor - Beispiel einer Bedingung_de.png]][[image:attach:Editor - weiteres Beispiel einer Bedingung_de.png]]
++)))|(((
++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.
++)))
++|(((
++[[image:attach:Editor - Nutzung von Variablen in der Aufgabenstellung_de.png]]
++)))|(((
++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 vom Typ [[Berechnung (Lückentext) >>doc:Berechnungsaufgabe]]eingebunden.
++
++An die Lücke wird die Variable mit der korrekten Lösung {distance} gebunden.
++
++
++)))
++|(((
++[[image:attach:Testrun - Beispielaufgabe im Testrun_de.png]]
++)))|(((
++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.
++
++
++
++
++)))
++
++
++
++{{id name="Nach Abgabe verarbeitete Variablen"/}}
++
  == Nach Abgabe verarbeitete Variablen ==
  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.
@@ -73,16 +73,168 @@
  (% 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]]
++
++
++{{id name="Beispiel ~"Transport~" - Adaptives Aufgabenfeedback"/}}
++
++=== Beispiel "Transport" - Adaptives Aufgabenfeedback ===
++
++Adaptives Feedback ermöglicht ein individuelles Feedback auf Basis der eingegebenen Lernerantwort. Dem Teilnehmer können so konkrete Lösungs- oder Fehlerhinweise in Bezug auf seine eingegebene 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.
++
++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 darauf 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.
++
++{{panel titleColor="black" titleBGColor="#FFB266" title="Beispiel ~"Transport~" - Adaptives Aufgabenfeedback"}}
++{{expand title="Beispiel anzeigen ..."}}
++|(((
++[[image:attach:Editor - Angabe von POST-Variablen_de.png]]
++)))|(((
++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.
++
++Zusätzlich wird die Lernerantwort in einer [[Numerischen Variable>>doc:Numerische Variablen]] {answer} gespeichert, um auf diese im Feedback auf einfache Weise zugreifen zu können.
++
++
++)))
++|(((
++[[image:attach:Editor - Post-Variablen im Feedback_de.png]]
++)))|(((
++Im zweiten Schritt werden die konkreten Feedbacktexte für die Aufgabe hinterlegt. Dem Teilnehmer soll das Feedback nur dann 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]].
++
++Die individuellen Feedbacktexte und -werte, welche in den Variablen gespeichert wurden, werden durch Angabe des Variablen-Namens ({div}, {answer}) in den Feedbacktext eingebunden.
++
++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.
++)))
++|(((
++[[image:attach:Testrun - Feedback mit Post-Variablen_de.png]]
++)))|(((
++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.
++
++Sie können die Zufallsparameter einer Aufgabe für weitere Aufgaben-Lösungsversuche beibehalten oder neu ermitteln. Weitere Informationen finden Sie im Abschnitt //**Variablen zurücksetzen**// auf der Seite [[doc:Test-Optionen festlegen]].
++)))
++{{/expand}}
++{{/panel}}
++
++
++
  \\
--{{info}}
--Folgende Beispiele zum Einsatz der Nach-Abgabe-verarbeiteten-Variablen zeigen mögliche Anwendungsszenarien:
++{{id name="Beispiel ~"Transport~" - Punktabzug pro Lösungsversuch"/}}
--* [[doc:Beispiel Transport - Adaptives Aufgabenfeedback]]
--* [[doc:Beispiel Transport - Punktabzug pro Loesungsversuch]]
--* [[doc:Beispiel Transport - Wertung der maximal erreichten Punktzahl]]
--{{/info}}
++=== Beispiel "Transport" - Punktabzug pro Lösungsversuch ===
++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, umso weniger Punkte erhält der Teilnehmer.
++
++Nachfolgend soll für das Beispiel "Transport"[[ >>doc:||anchor="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"]](% class="confluence-link" %)ein Punktabzug pro Lösungsversuch mithilfe 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.
++
++|(((
++[[image:attach:Editor - Variablen zur Beispielaufgabe_de.png]]
++)))|(((
++Zur Umsetzung werden folgende Variablen definiert:
++
++* **DieNumerische Variable[[  >>doc:Numerische Variablen]]{deduction_attempt} speichert den Punktabzug pro Versuch.**
++Im Beispiel soll die Gesamtpunktzahl um einen Punkt reduziert werden. Daher wird {deduction_attempt} auf den statischen Wert 1 gesetzt. Da es sich um einen statischen Wert handelt, kann dieser als Pre-Variable (Vor Anzeige verarbeitete Variable) angelegt werden.
++* **DieNumerische Variable[[  >>doc:Numerische Variablen]]{deduction} speichert den aktuellen Punktabzug in Abhängigkeit vom Lösungsversuch.**
++Der Punktabzug {deduction} berechnet sich als Produkt aus der Anzahl der bisherigen Lösungsversuche (Systemvariable NUMATTEMPTS) und dem Punktabzug pro Versuch {deduction_attempt}.
++Da es sich um einen pro Lösungsversuch berechneten Wert handelt, muss dieser als Post-Variable (Nach Abgabe verarbeitet Variable) berechnet werden.
++
++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.
++
++//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle Variablen zur Generierung der allgemeinen Aufgaben- und Feedbackinhalte ausgeblendet.//
++)))
++|(((
++Hinweis in der Aufgabenstellung:
++
++[[image:attach:Editor - Hinweis in der Aufgabenstellung_de.png]]
++
++Hinweis als individuelles Feedback:
++
++[[image:attach:Editor - Hinweis als individuelles Feedback_de.png]]
++)))|(((
++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.
++
++{{note}}
++//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.//
++{{/note}}
++)))
++|(((
++[[image:attach:Testrun - Beispielaufgabe in unterschiedlichen Versuchen_de.png]]
++)))|(((
++Entsprechend der Anzahl der notwendigen Lösungsversuche werden nun Punkte pro Lösungsversuch abgezogen:\\
++
++* Teilnehmer, welche im ersten Lösungsversuch die richtige Antwort eingeben, erhalten die volle Punktzahl.
++* Teilnehmer, welche in einem der Folgeversuche die richtige Antwort eingeben, erhalten Teilpunkte. Durch entsprechendes Feedback kann diesen Teilnehmern individuelle Lösungshinweise und damit Unterstützung zur eigenständigen Weiterbearbeitung der Aufgabe gegeben werden.\\
++
++\\
++)))
++
++
++
++{{id name="Beispiel ~"Transport~" - Wertung der maximal erreichten Punktzahl"/}}\\
++
++=== Beispiel "Transport" - Wertung der maximal erreichten Punktzahl
++ ===
++
++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 auch hier durch Hinweise entsprechend informiert werden und sowohl die Wertung des aktuellen Versuchs, als auch die maximale Wertung über alle Versuche angezeigt bekommen.
++
++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.\\
++
++|(((
++[[image:attach:Editor - Beispiel mehrere Versuche_de.png]]
++
++
++)))|(((
++Zur Umsetzung werden folgende Variablen definiert:
++
++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.
++//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle anderen Variablen zur Generierung der Aufgaben- und Feedbackinhalte ausgeblendet.//
++
++* **Die Numerische Variable [[doc:Numerische Variablen]]{best_score} speichert die maximal erreichte Punktzahl über alle Aufgabenversuche.**
++Die Variable {best_score} wird ohne Wertsetzung initialisiert und später durch eine Bedingung gesteuert:\\
++** Beim **ersten Lösungsversuch** ist {best_score} noch nicht initialisiert (NULL) und wird auf die aktuelle Punktzahl {current_score} gesetzt.
++Bedingung~:// IF best_score = NULL THEN best_score = Wert: current_score//
++** 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.
++Bedingung~:// IF current_score > best_score  THEN best_score = Wert: current_score//
++
++* **Die Numerische Variable [[doc:Numerische Variablen]]{current_score} speichert die aktuell erreichte Punktzahl für den aktuellen Aufgabenversuch.**
++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.
++** Die Variable {current_score} wird mit jedem Versuch auf den Wert der Systemvariable SCORE gesetzt.
++Bedingung: //IF best_score = NULL THEN best_score = Wert: current_score//
++
++* **Die Numerische Variable [[doc:Numerische Variablen]]{best_score_is_used} speichert, ob die Aufgabenbewertung manuell geändert wurde
++**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.\\
++** Die Variable(% class="confluence-link" title="Numerische Variablen" %) {best_score_is_used} (%%)wird auf den Wert 1 gesetzt, wenn die aktuellen Punkte kleiner als die bisher maximal erreichten Punkte sind, ansonsten erhält die Variable den Wert 0.
++Bedingung: //IF best_score > current_score THEN best_score_is_used = Wert: 1 ELSE best_score_is_used = Wert: 0
++//
++)))
++|(((
++Hinweis in der Aufgabenstellung:
++
++[[image:attach:Editor - Hinweis zur Wertung in Aufgabenstellung_de.png]]
++)))|(((
++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.
++
++
++
++
++)))
++|(% colspan="1" %)(% colspan="1" %)
++(((
++Hinweis als individuelles Feedback:[[image:attach:Editor - Hinweis zur Wertung als individuelles Feedback_de.png]]
++)))|(% colspan="1" %)(% colspan="1" %)
++(((
++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.
++)))
++|(((
++[[image:attach:Testrun - Beispielaufgabe Wertung in unterschiedlichen Versuchen_de.png]]
++)))|(((
++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.
++
++Dieses Aufgabenbeispiel ist mit den voranbeschriebenen Anwendungsszenarien kombinierbar:
++
++* Beispiel "Transport" - Einsatz von Zufallsparametern[[doc:||anchor="Beispiel ~"Transport~" - Einsatz von Zufallsparametern"]]
++* Beispiel "Transport" - Adaptives Aufgabenfeedback[[doc:||anchor="Beispiel ~"Transport~" - Adaptives Aufgabenfeedback"]]
++* Beispiel "Transport" - Punktabzug pro Lösungsversuch[[doc:||anchor="Beispiel ~"Transport~" - Punktabzug pro Lösungsversuch"]]
++)))
++
  (% class="help-heading" %)
  == Definition einer Variable ==
@@ -97,7 +97,7 @@
  * [[doc:Numerische Variablen]]:
  ** Ganze Zahl
  ** Gleitkommazahl
--* [[doc:Text Variables]]
++* [[doc:Textvariablen]]
  * [[doc:Bild Variablen]]
  Abhängig vom gewählten Variablen-Typ stehen Ihnen unterschiedliche Möglichkeiten zur **Wert-Ermittlung** bereit:
@@ -166,35 +166,41 @@
  {{layout}}
  {{layout-section ac:type="two_right_sidebar"}}
  {{layout-cell}}
--The use of variables allows the creation of dynamic task text. Task content can be generated randomly or adapted to the user, previously given answers, or assessments. For implementation, two different types of variables are provided in the tab of the same name:
++(% style="color: rgb(255,102,0);" %)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:
--* **Pre-processed variables**
--Pre-variables are assigned before the task is displayed and therefore make it possible to adapt the task text as well as the predefined and correct answers dynamically. In this way, task templates can be defined with the help of placeholders. These are replaced by specific random values per test run on the basis of defined intervals, value drop-down lists, or calculation rules. As a result, test tasks will be different but similar for each participant and test run.
--* **{{id name="PostVariablen_en"/}}Post-processed variables**
--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.
++* (% style="color: rgb(255,102,0);" %)**Vor Anzeige verarbeitete Variablen** (%%)
++(% style="color: rgb(255,102,0);" %)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.
++* (% style="color: rgb(255,102,0);" %)**Nach Abgabe verarbeitete Variablen** (%%)
++(% style="color: rgb(255,102,0);" %)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.
++
++
  [[image:attach:Editor - Tab Variablen_de.png]]
  {{/layout-cell}}
  {{layout-cell}}
  {{scroll-ignore}}
--{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}}
++{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Inhalt"}}
  {{toc/}}
  {{/panel}}
--{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Related topics"}}
--* [[Calculation interaction>>doc:Berechnungsaufgabe]]
--* [[Formula comparison>>doc:Formelvergleich]]
++{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Verwandte Themen"}}
++* [[doc:Berechnungsaufgabe]]
++* [[doc:Formelvergleich]]
  {{/panel}}
--{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Further information"}}
--* [[MAXIMA manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]]
--* [[MAXIMA good practice examples>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]]
--* [[MAXIMA system information>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]]
++{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Weiterführende Informationen"}}
++* [[MAXIMA Manual>>url:http://maxima.sourceforge.net/docs/manual/de/maxima.html||shape="rect"]]
++* [[MAXIMA Good-Practice-Beispiele>>url:https://bildungsportal.sachsen.de/opal/auth/RepositoryEntry/5499682817/CourseNode/93229879750473/wiki/Index||shape="rect"]]
++* [[MAXIMA Systeminformationen>>url:http://maxima.sourceforge.net/||rel="nofollow" shape="rect" class="external-link"]]
  {{/panel}}
  {{/scroll-ignore}}
++
++
++
++
  {{/layout-cell}}
  {{/layout-section}}
@@ -201,48 +201,245 @@
  {{layout-section ac:type="single"}}
  {{layout-cell}}
  (% class="help-heading" %)
--== Pre-processed variables ==
++== (% style="color: rgb(255,102,0);" %)Vor Anzeige verarbeitete Variablen(%%) ==
--(% class="help-heading" %)
--Define variables that are determined before the task is displayed in order to use (% style="background-color: rgb(255,255,255);font-size: 14.0px;" %)**random parameters**(%%) in your tasks. Variables are supported in ONYX for all types of tasks and offer various possibilities, especially for calculation interactions. With the help of variables, it is possible to create task templates which automatically allow (% style="background-color: rgb(255,255,255);font-size: 14.0px;" %)**an unlimited number of different test and exam attempts**(%%).
++(% style="color: rgb(255,102,0);" %)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.
--(% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]]
++=== (% class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size" %)[[image:attach:Testrun - Beispielaufgaben_de.png]](%%) ===
--{{info}}
--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.7||shape="rect"]].
--{{/info}}
++=== Example "Transport" ===
--== (% style="background-color: rgb(220,231,239);font-size: 20.0px;" %)Post-processed variables(%%) ==
++As an example, a typical application task is created. The goal is to calculate the distance travelled by a vehicle based on the speed and time. The speed is dependent on the vehicle type.
--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.
++|(% colspan="1" %)(% colspan="1" %)
++(((
++[[image:attach:Editor - Tab Variablen zur Beispielaufgabe_de.png]]
++)))|(% colspan="1" %)(% colspan="1" %)
++(((
++In the example, the [[text variable>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]] {transport} will be randomly initialised with one of the following values: "bike", "bus", or "train". The numerical variable {speed} is randomly selected from a value range. Thus, the value range for the speed {speed} should be set in dependence of the selected vehicle {transport}, since a "bike" is generally slower than a "train".
++
++
++
++)))
++|(((
++[[image:attach:Editor - Beispiel einer Bedingung_de.png]][[image:attach:Editor - weiteres Beispiel einer Bedingung_de.png]]
++)))|(((
++For the dependent value setting, we use the variable condition. In the condition, we can define the value range for the variable {speed} depending on the selected value of the variable {transport}. For the bike ({transport}="bike"), for example, a value range of 10 to 30 (km/h) was set.
++)))
++|(((
++[[image:attach:Editor - Nutzung von Variablen in der Aufgabenstellung_de.png]]
++)))|(((
++The given values of the task are integrated into the task text by specifying the variable name ({transport}, {speed}, and {hours}). In the example, the variable is included in a task of the type [[calculation (cloze)>>url:https://www.bps-system.de/help/display/ONYXintern/.Berechnungsaufgabe+v1.6||shape="rect"]].
++
++The variable with the correct solution {distance} is bound to the gap.
++
++
++)))
++|(((
++[[image:attach:Testrun - Beispielaufgabe im Testrun_de.png]]
++
++
++)))|(((
++One of the defined values will be randomly chosen for each participant and each test attempt. In the example, the value "bike" was randomly inserted, which is why a speed in the value range of 10 to 30 (km/h) was selected.
++)))
++
++== (% style="color: rgb(255,102,0);" %)Nach Abgabe verarbeitete Variablen(%%) ==
++
++(% style="color: rgb(255,102,0);" %)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.
++
  (% 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]]
++=== (% style="color: rgb(255,102,0);" %)Beispiel "Transport" - Adaptives Aufgabenfeedback(%%) ===
++
++(% style="color: rgb(255,102,0);" %)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 ) 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.
++
++(% style="color: rgb(255,102,0);" %)Folgend wird das Beispiel "Transport" ,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.
++
++
++
++|(((
++(% style="color: rgb(255,102,0);" %)[[image:attach:Editor - Angabe von POST-Variablen_de.png]]
++)))|(((
++(% style="color: rgb(255,102,0);" %)Im ersten Schritt wird im Tab Variablen die (% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %)Text-Variable(% style="color: rgb(255,102,0);" %)[[  >>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.
++
++(% style="color: rgb(255,102,0);" %)Zusätzlich wird sich die Lernerantwort in einer (% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %)Numerische Variable(% style="color: rgb(255,102,0);" %)[[  >>doc:Numerische Variablen]]{answer} gespeichert, um auf diese im Feedback auf einfache Weise zugreifen zu können.
++
++
++)))
++|(((
++(% style="color: rgb(255,102,0);" %)[[image:attach:Editor - Post-Variablen im Feedback_de.png]]
++)))|(((
++(% style="color: rgb(255,102,0);" %)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 (% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %)Feedback festlegen(% style="color: rgb(255,102,0);" %)[[  >>doc:Feedback festlegen]].
++
++(% style="color: rgb(255,102,0);" %)Die individuellen Feedbacktexte und -werte, welche in den Variablen gespeichert wurden, werden durch Angabe des Variablen-Namens ({div}, {answer}) in den Feedbacktext eingebunden.
++
++(% style="color: rgb(255,102,0);" %)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.
++)))
++|(((
++(% style="color: rgb(255,102,0);" %)[[image:attach:Testrun - Feedback mit Post-Variablen_de.png]]
++)))|(((
++(% style="color: rgb(255,102,0);" %)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.
++
++(% style="color: rgb(255,102,0);" %)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 (% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %)Test-Optionen festlegen(% style="color: rgb(255,102,0);" %)[[  >>doc:Test-Optionen festlegen]].
++)))
++
++=== (% style="color: rgb(255,102,0);" %)Beispiel "Transport" - Punktabzug pro Lösungsversuch(%%) ===
++
++(% style="color: rgb(255,102,0);" %)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 lost erhält die volle Punktzahl, umso Lösungshinweise mit jedem Versuch benötigt werden, um so weniger Punkte erhält der Teilnehmer.
++
++(% style="color: rgb(255,102,0);" %)Folgend soll für das [[(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %)Beispiel "Transport" >>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-Beispiel%22Transport%22-EinsatzvonZufallsparametern||shape="rect"]](%%), ein Punktabzug pro Lösungsversuch mit Hilfe von Variablen realisiert werden. Die maximal möglichePunktzahl 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.
++
++(% style="color: rgb(255,102,0);" %)Es wird unbedingt empfohlen dem Teilnehmer den Punktabzug anzuzeigen. Hierzu werden entsprechende Textbausteine in die Aufgabenstellung und das Feedback eingebaut.
++
++|(((
++(% style="color: rgb(128,0,128);" %)[[image:attach:Editor - Variablen zur Beispielaufgabe_de.png]]
++)))|(((
++(% style="color: rgb(255,102,0);" %)Zur Umsetzung werden folgende Variablen definiert:
++
++* (% style="color: rgb(255,102,0);" %)**Die **(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %)**Numerische Variable **(% style="color: rgb(255,102,0);" %)**[[ >>doc:Numerische Variablen]]{deduction_attempt} speichert der Punktabzug pro Versuch.** (%%)
++(% style="color: rgb(255,102,0);" %)Im Beispiel soll die Gesamtpunktzahl um einen Punkt reduziert werden. Daher wird {deduction_attempt} auf den statischen Wert 1 gesetzt. (%%)
++(% style="color: rgb(255,102,0);" %)Da es sich um einen statischen Wert handelt, kann dieser als Pre-Variable (Vor Anzeige verarbeitete Variable) angelegt werden.
++* (% style="color: rgb(255,102,0);" %)**Die **(% style="color: rgb(255, 102, 0); color: rgb(255, 102, 0)" %)**Numerische Variable **(% style="color: rgb(255,102,0);" %)**[[ >>doc:Numerische Variablen]]{deduction} speichert den aktuellen Punktabzug in Abhängigkeit vom Lösungsversuch.** (%%)
++(% style="color: rgb(255,102,0);" %)Der Punktabzug {deduction} berechnet sich als Produkt aus der Anzahl der bisherigen Lösungsversuche (Systemvariable NUMATTEMPTS) und dem Punktabzug pro Versuch {deduction_attempt}. (%%)
++(% style="color: rgb(255,102,0);" %)Da es sich um einen pro Lösungsversuch berechneten Wert handelt, muss dieser als Post-Variable (Nach Abgabe verarbeitet Variable) berechnet werden.
++
++(% style="color: rgb(255,102,0);" %)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.
++
++(% style="color: rgb(255,102,0);" %)//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle Variablen zur Generierung der allgemeinen Aufgaben- und Feedbackinhalte ausgeblendet.//
++)))
++|(((
++(% style="color: rgb(128,0,128);" %)Hinweis in der Aufgabenstellung:
++
++(% style="color: rgb(128,0,128);" %)[[image:attach:Editor - Hinweis in der Aufgabenstellung_de.png]]
++
++(% style="color: rgb(128,0,128);" %)Hinweis als individuelles Feedback:
++
++(% style="color: rgb(128,0,128);" %)[[image:attach:Editor - Hinweis als individuelles Feedback_de.png]]
++)))|(((
++(% style="color: rgb(255,102,0);" %)
++
++
++(% style="color: rgb(255,102,0);" %)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.
++
++
++
++
++
++
++
++{{note}}
++(% style="color: rgb(255,102,0);" %)//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.//
++{{/note}}
++
++
++
++
++
++
++)))
++|(((
++[[image:attach:Testrun - Beispielaufgabe in unterschiedlichen Versuchen_de.png]]
++)))|(((
++(% style="color: rgb(255,102,0);" %)Entsprechend der Anzahl der notwendigen Lösungsversuche werden nun Punkte abgezogen.
++
++
++* (% style="color: rgb(255,102,0);" %)Teilnehmer, welche im ersten Lösungsversuch die richtige Antwort eingeben, erhalten die volle Punktzahl.
++* (% style="color: rgb(255,102,0);" %)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.
++
++)))
++
++=== (% style="color: rgb(255,102,0);" %)Beispiel "Transport" - Wertung der maximal erreichten Punktzahl(%%) ===
++
++(% style="color: rgb(128, 0, 128); color: rgb(255, 102, 0)" %)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.(% style="color: rgb(128,0,128);" %) (% style="color: rgb(128, 0, 128); color: rgb(128, 0, 128); color: rgb(255, 102, 0)" %)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(% style="color: rgb(128, 0, 128); color: rgb(128, 0, 128)" %).
++
++(% style="color: rgb(128, 0, 128); color: rgb(128, 0, 128); color: rgb(255, 0, 255)" %)Folgend wird für das [[(% style="color: rgb(128, 0, 128); color: rgb(128, 0, 128); color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Beispiel "Transport"(% style="color: rgb(128, 0, 128); color: rgb(128, 0, 128); color: rgb(255, 0, 255)" %) >>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-Beispiel%22Transport%22-EinsatzvonZufallsparametern||shape="rect"]](%%), erläutert wie die Wertung der maximal erreichten Punktzahl realisiert werden kann.(% style="color: rgb(128, 0, 128); color: rgb(128, 0, 128)" %)
++
++
++|(((
++(% style="color: rgb(128,0,128);" %)[[image:attach:Editor - Beispiel mehrere Versuche_de.png]]
++)))|(((
++(% style="color: rgb(255,0,255);" %)Zur Umsetzung werden folgende Variablen definiert. Die gesamte Umsetzung erfolgt durch Post-Variablen ([[ (% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Nach Abgabe verarbeitete Variablen >>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-NachAbgabeverarbeiteteVariablen||shape="rect"]](%%)), da u.a. auf die Wertung des aktuellen Lösungsversuches zugegriffen wird.(%%)
++(% style="color: rgb(255,0,255);" %)//Hinweis: Zur Vereinfachung wurden im abgebildeten Screenshot alle anderen Variablen zur Generierung der Aufgaben- und Feedbackinhalte ausgeblendet.//
++
++(% style="color: rgb(255,102,0);" %)
++
++* (% style="color: rgb(255,0,255);" %)**Die [[(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Numerische Variable >>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]](%%){best_score} speichert die maximal erreichte Punktzahl über alle Aufgabenversuche.** (%%)
++(% style="color: rgb(255,0,255);" %)Die Variable {best_score} wird ohne Wertsetzung initialisiert und später durch eine Bedingung gesteuert:(%%)\\
++** (% style="color: rgb(255,0,255);" %)Beim **ersten Lösungsversuch**, ist {best_score} noch nicht initialisiert (NULL) und wird auf die aktuelle Punktzahl {current_score} gesetzt. (%%)
++(% style="color: rgb(255,0,255);" %)Bedingung~:// IF best_score = NULL THEN best_score = Wert: current_score//
++** (% style="color: rgb(255,0,255);" %)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.(%%)
++(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Bedingung:(% style="color: rgb(255,0,255);" %) //IF current_score > best_score  THEN best_score = Wert: current_score//
++
++(% style="color: rgb(255,102,0);" %)
++
++* (% style="color: rgb(255,0,255);" %)**Die [[(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Numerische Variable >>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]](%%){current_score} speichert die aktuell erreichte Punktzahl für den aktuellen Aufgabenversuch.** (%%)
++(% style="color: rgb(255,0,255);" %)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.
++** (% style="color: rgb(255,0,255);" %)Die Variable {current_score} wird mit jedem Versuch auf den Wert der Systemvariable SCORE gesetzt.(%%)
++(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Bedingung:(% style="color: rgb(255,0,255);" %)// IF best_score = NULL THEN best_score = Wert: current_sco re//
++
++(% style="color: rgb(255,102,0);" %)
++
++* (% style="color: rgb(255,0,255);" %)**Die [[(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Numerische Variable >>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]](%%){best_score_is_used} speichert, ob die Aufgabenbewertung manuell geändert wurde
++**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} verwendet, welche auf den Wert 1 gesetzt wird, wenn die Aufgabenbewertung manuell geändert wurde.(%%)\\
++** (% style="color: rgb(255,0,255);" %)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.(%%)
++(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Bedingung:(% style="color: rgb(255,0,255);" %)// IF// //best_score > current_score THEN best_score_is_used = Wert: 1 ELSE best_score_is_used = Wert: 0
++//
++
++(% style="color: rgb(255,102,0);" %)//
++//
++)))
++|(((
++(% style="color: rgb(128,0,128);" %)Hinweis in der Aufgabenstellung:
++
++(% style="color: rgb(128,0,128);" %)[[image:attach:Editor - Hinweis zur Wertung in Aufgabenstellung_de.png]]
++)))|(((
++(% style="color: rgb(255, 102, 0); color: rgb(255, 0, 255)" %)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.
++)))
++|(% colspan="1" %)(% colspan="1" %)
++(((
++(% style="color: rgb(128,0,128);" %)Hinweis als individuelles Feedback:
++
++[[image:attach:Editor - Hinweis zur Wertung als individuelles Feedback_de.png]]
++)))|(% colspan="1" %)(% colspan="1" %)
++(((
++(% style="color: rgb(255, 102, 0); color: rgb(255, 0, 255)" %)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.(% style="color: rgb(255,102,0);" %)
  \\
++)))
++|(((
++[[image:attach:Testrun - Beispielaufgabe Wertung in unterschiedlichen Versuchen_de.png]]
--{{info}}
--The following examples for the use of post-processed variables show possible application scenarios:
++
++)))|(((
++(% style="color: rgb(255,0,255);" %)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.
--* [[Example "Transport" - Adaptive task feedback>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.7||shape="rect"]]
--* [[Example "Transport" - Points deduction per attempt>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.7||shape="rect"]]
--* [[Example "Transport" - Assessment of the maximum score>>url:https://www.bps-system.de/help/display/ONYXintern/.Beispiele+zum+Einsatz+von+Variablen+v8.7||shape="rect"]]
--{{/info}}
++(% style="color: rgb(255,0,255);" %) Diese Aufgabenbeispiel ist mit den voranbeschriebenen Anwendungsszenarien kombinierbar:
++* (% style="color: rgb(255,102,0);" %) (% style="color: rgb(255,0,255);" %)[[(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Beispiel "Transport" - Einsatz von Zufallsparametern>>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-Beispiel%22Transport%22-EinsatzvonZufallsparametern||shape="rect"]]
++* (% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Beispiel "Transport" - Adaptives Aufgabenfeedback
++* (% style="color: rgb(255,0,255);" %)[[(% style="color: rgb(255, 0, 255); color: rgb(255, 0, 255)" %)Beispiel "Transport" - Punktabzug pro Lösungsversuch>>url:https://www.bps-system.de/help/display/ONYXintern/.Variablen+verwenden+v1.12#id-.Variablenverwendenv1.12-Variablenverwenden-Beispiel%22Transport%22-WertungdermaximalerreichtenPunktzahl||shape="rect"]]
++
++(% style="color: rgb(255,102,0);" %)
++
++)))
++
  == Definition of a variable ==
--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.
++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.
  [[image:attach:Editor - Definition einer Variable_de.png]]
++
++
  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}.
--Select the **variable type**. The following variable types are available:
++Select the **Variable type**. The following variable types are available:
  * [[Numerical variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Numerische+Variablen+v1.11||shape="rect"]]:
  ** Integer
  ** Floating-point number
  * [[Text variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Textvariablen+v1.11||shape="rect"]]
--* [[Image variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Bild+Variablen+v1.11||shape="rect"]]
++* [[Image Variables>>url:https://www.bps-system.de/help/display/ONYXintern/.Bild+Variablen+v1.11||shape="rect"]]
  Depending on the selected variable type, you have various options for the **determination of the value**:
@@ -251,11 +251,11 @@
  * Random selection
  * Calculation (MAXIMA)
--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).
++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).
  == Use of variables   ==
--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.
++Defined variables can be inserted into** task and answer texts** 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.
  In the example, the variables {VAR1}, {VAR2}, and {VAR3} were declared:
@@ -263,9 +263,9 @@
  == Definition of a condition ==
--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**.
++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**.
--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.
++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.
  [[image:attach:Editor - Neue Bedinung anlegen_de.png]]
@@ -275,18 +275,23 @@
  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.
--**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.
++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 of the expert mode.
--(% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" style="color: rgb(255,102,0);" %)[[image:attach:Editor - Verknüpfung von Bedingungen_de.png]]
++(% style="color: rgb(255,102,0);" %)
--(% style="color: rgb(51,51,51);" %)**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.
++(% style="color: rgb(255,102,0);" %)
--== Expert mode (IMS QTI) ==
--
  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.
++(% style="color: rgb(255,102,0);" %)
++
  [[image:attach:Editor - Variable im Expertenmodus_de.jpg]]
++(% style="color: rgb(255,102,0);" %)
++
++
++
++
  Please note that after changing the description in the expert mode, there is no way to return to the simple mode.
  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.
@@ -293,7 +293,7 @@
  == View variable assignment ==
--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.
++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. The detailed information is 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 and possible system errors are displayed.
  For more detailed information, please refer to the following help sections:
@@ -300,6 +300,12 @@
  * [[View variable assignment>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-Variablen-BelegungeinsehenVariablen-Belegung||shape="rect"]]
  * [[View MAXIMA output>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-MAXIMA-AusgabeneinsehenMAXIMA-Ausgaben||shape="rect"]]
  * [[Display of system errors>>url:https://www.bps-system.de/help/display/ONYX/Ergebniseinsicht#Ergebniseinsicht-AnzeigevonSystemfehlern||shape="rect"]]
++
++
++
++
++
++
  {{/layout-cell}}
  {{/layout-section}}
  {{/layout}}

Confluence.Code.ConfluencePageClass[0]

id

@@ -1,1 +1,1 @@
--234979373
++201064506

url

@@ -1,1 +1,1 @@
--https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/234979373/Variablen verwenden
++https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/201064506/Variablen verwenden

Änderungen von Dokument 07 Variablen verwenden

Zusammenfassung

Details

Suchen

ONYXGlobal

ONYXMenü

Zuletzt besucht