Kurzanleitung: Aufgabe FormBased (Jack2)

Aus JACK Wiki
Version vom 18. April 2017, 11:12 Uhr von Mbuttgereit (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „Hier wird das Erstellen einer Aufgabe kurz und einfach beschrieben, um ohne viele Vorkenntnisse erfolgreich erste Aufgaben zu generieren. Diese Anleitung behan…“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Hier wird das Erstellen einer Aufgabe kurz und einfach beschrieben, um ohne viele Vorkenntnisse erfolgreich erste Aufgaben zu generieren. Diese Anleitung behandelt dabei nicht den kompletten Funktionsumfang von JACK, sondern dient lediglich als Einstieg. Weiterführende Informationen finden sich in den verlinkten Artikeln.

Grundlegende Information

Jede Aufgabe in JACK besteht aus mindestens zwei Dateien:

  • eine xml-Datei exerciseChain.xml, die die einzelnen Teilaufgaben verwaltet
  • mindestens eine xml-Datei stageX.xml, die jeweils eine Teilaufgabe darstellt und entsprechend durchnummeriert sein sollte (stage1.xml, stage2.xml, usw.)

exerciseChain

→ Hauptartikel: ExerciseChain

Eine exerciseChain hat immer folgenden Aufbau

<?xml version="1.0" encoding="ISO-8859-1"?>

<exercisechain>
 <variables>
  <option name="ersteVariable" min="1" max="10" />
 </variables>
 <step id="1" file="stage1.xml">
  <input value="[var=ersteVariable]" />
  <next default="repeat">
   <path target="end" result="100" />
  </next>
 </step>
</exercisechain>

Innerhalb von <variables> können mehrere Variablen unterschiedlichen Types definiert werden, die stage-übergreifend genutzt werden können. Auf jede Teilaufgabe kann jeweils mit einem <step> zugegriffen werden. Diese benötigen eine eindeutige id und den Namen der zugehörigen xml-Datei. Außerdem werden hier Variablen an die Teilaufgabe übergeben.

Stage

Eine Stage hat immer folgenden Aufbau

<?xml version="1.0" encoding="iso-8859-1"?>
<exercise type="fillIn">
 <input>
  <inputvalue name="zahl" type="integer"/>
 </input>

 <task>
  Hier steht der Aufgabentext.
  Trage die richtige Zahl ein: [fillIn groesse="6"]
 </task>

 <advice>
  <option> Hier können Hinweise gegeben werden </option>
 </advice>

 <correctanswer>
  <option result="[pos=1]==([var=faktor11]*[var=faktor12])"/>
  <message>
    Nachricht bei richtigem Beantworten der Aufgabe.
  </message>
 </correctanswer>

 <feedback>
  <option result="[pos=1]!=[var=zahl]"> Nachricht bei konkreter Falscheingabe. </option>
  <option result="andere"> Nachricht bei genereller Falscheingabe. </option>
 </feedback>

 <output/>
</exercise>

Innerhalb von <input>