JACK Wiki - Benutzerbeiträge [de]

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-27T10:15:06Z

Dhaeckel: /* Stage */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise folgenden Aufbau:
<syntaxhighlight lang="xml" line='line'>
<?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>
</syntaxhighlight>

Innerhalb von '''<variables>''' können mehrere [[Variablen]] unterschiedlichen Types definiert werden, die stage-übergreifend genutzt werden können (hier wird bspw. eine Variable namens ''ersteVariable'' erstellt, die eine zufällige Ganzzahl zwischen einschließlich 1 und 10 enthält).
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 (in diesem Beispiel wird die Variable ''ersteVariable'' an die erste Teilaufgabe übergeben). Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise folgenden Aufbau:
<syntaxhighlight lang="xml" line='line'>
<?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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>
</syntaxhighlight>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|thumb|Einfügen einer Aufgabe in JACK]]

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeBearbeiten-Ressourcen-dhaeckel.PNG|mini|Ressourcen einer Aufgabe]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

[[File:JACK-AufgabeBearbeiten-Checker-dhaeckel.PNG|mini|Ausgewählter Checker]]

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-27T10:14:46Z

Dhaeckel: /* exerciseChain */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise folgenden Aufbau:
<syntaxhighlight lang="xml" line='line'>
<?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>
</syntaxhighlight>

Innerhalb von '''<variables>''' können mehrere [[Variablen]] unterschiedlichen Types definiert werden, die stage-übergreifend genutzt werden können (hier wird bspw. eine Variable namens ''ersteVariable'' erstellt, die eine zufällige Ganzzahl zwischen einschließlich 1 und 10 enthält).
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 (in diesem Beispiel wird die Variable ''ersteVariable'' an die erste Teilaufgabe übergeben). Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|thumb|Einfügen einer Aufgabe in JACK]]

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeBearbeiten-Ressourcen-dhaeckel.PNG|mini|Ressourcen einer Aufgabe]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

[[File:JACK-AufgabeBearbeiten-Checker-dhaeckel.PNG|mini|Ausgewählter Checker]]

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-27T10:14:15Z

Dhaeckel: /* exerciseChain */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise folgenden Aufbau:
<syntaxhighlight lang="xml" line='line'>
<?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>
<syntaxhighlight>

Innerhalb von '''<variables>''' können mehrere [[Variablen]] unterschiedlichen Types definiert werden, die stage-übergreifend genutzt werden können (hier wird bspw. eine Variable namens ''ersteVariable'' erstellt, die eine zufällige Ganzzahl zwischen einschließlich 1 und 10 enthält).
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 (in diesem Beispiel wird die Variable ''ersteVariable'' an die erste Teilaufgabe übergeben). Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|thumb|Einfügen einer Aufgabe in JACK]]

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeBearbeiten-Ressourcen-dhaeckel.PNG|mini|Ressourcen einer Aufgabe]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

[[File:JACK-AufgabeBearbeiten-Checker-dhaeckel.PNG|mini|Ausgewählter Checker]]

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Datei:JACK-AufgabeErstellen-01-dhaeckel.PNG

2017-04-24T09:50:55Z

Dhaeckel: Dhaeckel lud eine neue Version von Datei:JACK-AufgabeErstellen-01-dhaeckel.PNG hoch

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-20T12:02:46Z

Dhaeckel: /* Einfügen in JACK */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise 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. Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|800px|Einfügen einer Aufgabe in JACK]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

[[File:JACK-AufgabeBearbeiten-Ressourcen-dhaeckel.PNG|mini|Ressourcen einer Aufgabe]]
[[File:JACK-AufgabeBearbeiten-Checker-dhaeckel.PNG|mini|Ausgewählter Checker]]

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-20T12:02:26Z

Dhaeckel: /* Einfügen in JACK */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise 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. Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|900px|Einfügen einer Aufgabe in JACK]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

[[File:JACK-AufgabeBearbeiten-Ressourcen-dhaeckel.PNG|mini|Ressourcen einer Aufgabe]]
[[File:JACK-AufgabeBearbeiten-Checker-dhaeckel.PNG|mini|Ausgewählter Checker]]

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Datei:JACK-AufgabeBearbeiten-Checker-dhaeckel.PNG

2017-04-20T12:00:26Z

Dhaeckel:

Datei:JACK-AufgabeBearbeiten-Ressourcen-dhaeckel.PNG

2017-04-20T11:58:44Z

Dhaeckel:

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-20T11:55:15Z

Dhaeckel: /* Einfügen in JACK */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise 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. Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|900px|Einfügen einer Aufgabe in JACK]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Datei:JACK-AufgabeErstellen-01-dhaeckel.PNG

2017-04-20T11:54:46Z

Dhaeckel: Dhaeckel lud eine neue Version von Datei:JACK-AufgabeErstellen-01-dhaeckel.PNG hoch

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-20T11:28:05Z

Dhaeckel: /* Einfügen in JACK */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise 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. Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|mini|Einfügen einer Aufgabe in JACK]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-20T11:25:47Z

Dhaeckel: /* Einfügen in JACK */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise 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. Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|zentriert|800px|Einfügen einer Aufgabe in JACK - Schritt 1]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-20T11:13:35Z

Dhaeckel: /* Einfügen in JACK */

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 FormBased Aufgabe in JACK besteht aus mindestens zwei Dateien:
* eine xml-Datei '''exerciseChain.xml''', die die einzelnen Teilaufgaben verwaltet [NAME WICHTIG]
* 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 beispielsweise 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. Bei dieser Einstellung kann die Aufgabe so lange bearbeitet werden bis die maximale Punktzahl von 100 erreicht wurde.

=== Stage ===

Eine Stage hat beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder bzw. Dropdown-Menüs (Multiple-Choice-Kästchen werde gesondert angegeben)
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, dieser ist später auch für die bearbeitende Person sichtbar. Außerdem kann man die Aufgabe einer Kategorie zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende, die für diese Aufgabe frei geschaltet sind.

[[File:JACK-AufgabeErstellen-01-dhaeckel.PNG|frame|Einfügen einer Aufgabe in JACK - Schritt 1]]

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Datei:JACK-AufgabeErstellen-01-dhaeckel.PNG

2017-04-20T11:11:02Z

Dhaeckel:

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-04-18T10:24:05Z

Dhaeckel:

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 beispielsweise 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 beispielsweise 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 kann ein Hinweise stehen. </option>
<option> Hier kann ein zweiter Hinweis stehen. </option>
</advice>

<correctanswer>
<option result="[pos=1]==[var=zahl]"/>
<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>

* '''<input>''' greift die von der exerciseChain übergebenen Variablen auf, vergibt passende Typen und Namen zur weiteren Bearbeitung
* '''<task>''' beinhaltet den Aufgabentext und gegebenenfalls Fill-In-Felder, Dropdown-Menüs bzw. Multiple-Choice-Kästchen
* '''<advice>''' kann einen oder mehrere Hinweise zu der Aufgabe geben, welche sich nacheinander abrufen lassen
* '''<correctanswer>''' enthält die Regel für eine korrekte Antwort und entsprechendes Feedback bei richtiger Beantwortung
* '''<feedback>''' enthält entsprechend angepasstes Feedback bei nicht korrekten Antworten

=== Einfügen in JACK ===

Nach dem Anmelden auf JACK klickt man rechts auf '''Aufgabe erstellen'''. Anschließend muss man der Aufgabe einen eindeutigen Titel geben, der später auch für die bearbeitende Person sichtbar ist. Außerdem kann man die Aufgabe einer Kategorie oder mehreren zuordnen. Als Sichttyp muss in diesem Fall '''FORMBASED''' ausgewählt sein. Ist das Kästchen für das Aktivieren der Aufgabe gesetzt, steht die Aufgabe für alle bearbeitenden Studenten zur Verfügung, andernfalls nur für Lehrende.

Klickt man nun auf '''Speichern''' gelangt man auf die Übersichtsseite der Aufgabe. Hier kann man nun über den Button '''Ressource hinzufügen''' die vorher erstellten Dateien hochladen. Über '''Durchsuchen''' wählt man nun zunächst die exerchiseChain.xml aus, wählt als Ressource-Typ '''WORKING_SHEET''' und lädt die Datei hoch. Dasselbe macht man für jede
stage-Datei der Aufgabe.

Als letztes muss auf der Übersichtsseite der Aufgabe noch ein Checker hinzugefügt werden. Dieser ist abhängig von der Aufgabenart:
* Hat man eine '''FillIn-''' oder '''Dropdown-Aufgabe''' erstellt, so wählt man den '''InstantFillInChecker''' aus.
* Hat man eine '''MultipleChoice-Aufgabe''' erstellt, so wählt man den '''InstantMultipleChoiceChecker''' aus.
Über den Button '''Checker hinzufügen''' wird der Checker anschließend der Aufgabe hinzugefügt.

Nun sollte die Aufgabe über '''Lösung hinzufügen''' bearbeitbar sein.

Statistische Einstellungen (Jack2)

2017-04-11T07:37:40Z

Dhaeckel: /* Excel-Export */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis +100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe.

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte, würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine solche json-Datei hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta''-Werte in ein Excel-Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json"-Datei vorhanden sein. In der Excel Datei werden sowohl Daten der Aufgaben, als auch der Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wird dies als eine mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an, ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:36:57Z

Dhaeckel: /* Excel-Export */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis +100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe.

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte, würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine solche json-Datei hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta''-Werte in ein Excel-Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json"-Datei vorhanden sein. In der Excel Datei werden sowohl Daten der Aufgaben, als auch der Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wird dies als eine mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:33:00Z

Dhaeckel: /* Excel-Export */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis +100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe.

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte, würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine solche json-Datei hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta''-Werte in ein Excel-Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json"-Datei vorhanden sein. In der Excel Datei werden sowohl Daten der Aufgaben, als auch der Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:32:06Z

Dhaeckel: /* Ergebnis-Delta generieren */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis +100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe.

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte, würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine solche json-Datei hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:30:50Z

Dhaeckel: /* Ergebnis-Delta generieren */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis +100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe.

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte, würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:29:27Z

Dhaeckel: /* Ergebnis-Delta generieren */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis +100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe.

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei noch zu wissen, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:29:12Z

Dhaeckel: /* Ergebnis-Delta generieren */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis 100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe.

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei noch zu wissen, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:28:29Z

Dhaeckel: /* Schwierigkeitsgrad generieren */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe bei ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis 100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei noch zu wissen, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:24:39Z

Dhaeckel: /* Administratormenü */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Werte in ein Excel-Dokument. Sofern noch nie Werte generiert wurden, demnach keine json-Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, da sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis 100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei noch zu wissen, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:23:20Z

Dhaeckel: /* Administratormenü */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind sowohl in den Dateien "statisticalsettings.properties" und "ResultDelta.json", als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich im JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Wert in ein Excel Dokument. Sofern noch nie Werte generiert wurden, demnach keine json Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, das sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis 100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei noch zu wissen, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:21:43Z

Dhaeckel: /* Administratormenü */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenem Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind in den Dateien "statisticalsettings.properties" und "ResultDelta.json" als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Wert in ein Excel Dokument. Sofern noch nie Werte generiert wurden, demnach keine json Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, das sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis 100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei noch zu wissen, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Statistische Einstellungen (Jack2)

2017-04-11T07:21:10Z

Dhaeckel: /* Administratormenü */

===Administratormenü===

[[Datei:StatistischeEinstellungen.png|200px|thumb|right|Menü für die statistischen Einstellungen in JACK]]
Hier finden sich einige nützliche Tools, welche regelmäßig unter Berücksichtigung der studentischen Bearbeitungen, Informationen zu Aufgaben generiert. Diese Informationen werden einerseits den Studierenden angezeigt wie z.B. Aufgabeninformation und Schwierigkeitsgrad oder dienen der Qualitätsanalyse der Aufgaben wie z.B. Schwierigkeitsgrad und Ergebnis-Delta.

Auf der Weboberfläche sieht man die verfügbaren Tools und eine Eingabe für die Timer-Einstellungen. Bei dem Timer muss ein Intervall und eine Startuhrzeit angegeben werden. Derzeit sind die Intervalle "stündlich", "täglich" und "wöchentlich" verfügbar. Durch das Speichern der Einstellungen wird, wenn ein Tool aktiv ist, ein Timer gestartet, welcher je nach vorgegebenen Intervall zu den Stichzeiten die ausgewählten Tools anstößt. Nach der Generierung werden die neuen Werte gesichert. Alle generierten Werte sind in den Dateien "statisticalsettings.properties" und "ResultDelta.json" als auch im Ordner "LevelOfDifficulty" gesichert und werden beim Serverstart wieder ausgelesen. Die Dateien befinden sich JBoss-Verzeichnis unter ".../server/default/conf".

Da sehr viele Daten abgefragt und verarbeitet werden ist es sinnvoll den Zeitpunkt so zu wählen, dass die Performance des laufenden Betriebes nicht gestört wird (beispielsweise in der Nacht).

Der Button "Ergebnis-Delta exportieren" schreibt die generierten Wert in ein Excel Dokument. Sofern noch nie Werte generiert wurden, demnach keine json Datei existiert, wird eine Fehlermeldung ausgegeben.

Der Vorteil der automatischen Generierung ist, dass die Werte nicht bei jedem Abruf neu generiert werden müssen, was teils sehr lange Wartezeiten verursacht, sondern die zuletzt generierten Werte ausgelesen werden. Ein weiterer Vorteil liegt darin, dass diese Werte aussagekräftiger sind als vom Lehrenden frei gewählte, das sie auf tatsächlichen Bearbeitungen von Studierenden basieren.

===Verfügbare Tools===
====Aufgabeninfo generieren====
Dieses Tool generiert möglichst motivierende Aussagen über die Aufgabenschwierigkeit, welche in der Kursansicht die Spalte Schwierigkeitsgrad ersetzen. Dabei werden die Bearbeitungen vorheriger Studierender herangezogen um Aussagen wie folgt zu generieren:

{| class="wikitable" border="1"
|align="center"| '''Aussagen'''
|align="center"| '''Code'''
|-
| "X von Y bisheriger Einreichungen waren richtig."
| if X/Y >= 0.5 && Y>=40
|-
| "X von Y Studenten haben diese Aufgabe richtig gelöst."
| else if X/Y >= 0.5 && Y>= 40
|-
| "Diese Aufgabe hat bisher X richtige Bearbeitungen."
| else if X >= 40
|-
| "Diese Aufgabe lösen im Schnitt mehr als 80% der Studenten."
| else if Schwierigkeitsgrad == 1
|-
| "Im Mittel lösen diese Aufgabe 4 von 5 Studenten."
| else if Schwierigkeitsgrad == 2
|-
| "Im Mittel lösen diese Aufgabe 3 von 5 Studenten."
| else if Schwierigkeitsgrad == 3
|-
| "Im Mittel lösen diese Aufgabe 2 von 5 Studenten."
| else if Schwierigkeitsgrad == 4
|-
| "Im Mittel lösen diese Aufgabe 1 von 5 Studenten."
| else if Schwierigkeitsgrad == 5
|-
|}

Es ist empfehlenswert hierfür den Schwierigkeitsgrad generieren zu lassen, da dieser bei nicht ausreichender Bearbeitungszahl für die Aussage herangezogen wird.

====Schwierigkeitsgrad generieren====
Dieses Tool generiert anhand der Bearbeitungen der Studierenden einen Schwierigkeitsgrad für die Aufgabe. Ab 20 studentischen Bearbeitungen werden jeweils die Endresultate der ersten Bearbeitung (Solution) zur Generierung herangezogen. In der Aufgabenbearbeitung ist ein generierter Wert durch den grauen Schriftzug "Generierter Schwierigkeitsgrad" gekennzeichnet.

[[Datei:LOD.png]]

Der Schwierigkeitsgrad spiegelt den Anteil der richtigen Bearbeitungen (Bearbeitungen mit voller Punktzahl) an allen berücksichtigten Bearbeitungen wieder. Anhand des Anteils findet dann eine Zuordnung zu den Zahlenwerten 1-5 statt. 1 ist eine sehr leichte und 5 eine sehr schwere Aufgabe. Die folgende Tabelle veranschaulicht die genaue Zuordnung.

{| class="wikitable" border="1"
| '''Anteil'''
| align="center"| if<0.2
| align="center"| else if<0.4
| align="center"| else if<0.6
| align="center"| else if<0.8
| align="center"| else if<=1
|-
| '''Schwierigkeitsgrad'''
| align="center"| 5
| align="center"| 4
| align="center"| 3
| align="center"| 2
| align="center"| 1
|-
|}

Bei einem Anteil größer 1 wird ein Fehler mit der Aufgaben-ID geloggt. Daraus ergeben sich gleichzeitig äquivalente Aussagen wie:

Aufgabe hat die Schwierigkeit 1 ⇔ Mehr als oder genau 80% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

Aufgabe hat die Schwierigkeit 5 ⇔ Weniger als 20% der Studierenden haben diese Aufgabe in ihrer ersten Bearbeitung richtig gelöst.

====Ergebnis-Delta generieren====
Das ''Ergebnis-Delta'' ist ein Indikator für die Qualität einer Aufgabe. Es kann Werte von -100 bis 100 annehmen, wobei mit größer werdender Studierendenzahl negative Werte immer unwahrscheinlicher werden. Generell ist ein hohes ''Ergebnis-Delta'' erstrebenswert. Der Wert spiegelt den durchschnittlichen Punktezuwachs zwischen erster und letzter Einreichung der Studierenden innerhalb einer Aufgabe wieder.

'''Beispiel:''' Wir haben 3 Studenten mit je mindestens zwei Einreichungen und eine einstufige Aufgabe

{| class="wikitable" border="0"
| '''Studenten'''
| '''Punktzahl erste Einreichung'''
| '''Punktzahl letzter Einreichung'''
| '''Punktedifferenz'''
|-
| Student 1
| 0
| 100
| 100
|-
| Student 2
| 100
| 100
| 0
|-
| Student 3
| 0
| 100
| 100
|-
|}

Wir erhalten in diesem Beispiel ein ''Stufendelta'' von 66,67, da die Aufgabe nur eine Stufe hat, ist es zugleich das ''Ergebnis-Delta'' der Aufgabe. Wenn die Aufgabe eine zweite Stufe mit ebenfalls 3 Datensätzen hätte würden beide Stufen zu gleichen Teilen in das ''Ergebnis-Delta'' einfließen. Wichtig ist hierbei noch zu wissen, dass die erste und letzte Einreichung nicht innerhalb einer Bearbeitung liegen müssen.

Daraus resultierend werden alle Bearbeitungen, Einreichungen, Stufen und Studenten der Aufgaben ausgelesen und sortiert. Letztendlich werden nur die Bearbeitungen der Studierenden berücksichtigt, welche mindestens zwei unterschiedliche Einreichungen aufweisen. Die Punktedifferenz jedes Studierenden wird für jede Stufe als durchschnitt erfasst. Die Stufendurchschnitte werden dann zum ''Ergebnis-Delta'' der Aufgabe gewichtet zusammengefasst. Nach der Generierung, welche ein paar Minuten in Anspruch nimmt, werden die Resultate in eine json-Datei geschrieben. Diese wird zwingend für den Excel-export benötigt.
Sofern keine hinterlegt ist wird eine Fehlermeldung beim aktivieren des Exports ausgegeben.

====Excel-Export====
Es besteht die Möglichkeit alle generierten ''Ergebnis-Delta'' Werte in ein Excel Dokument schreiben zu lassen. Dazu müssen vorab die Werte generiert worden sein und die "ResultDelta.json" Datei vorhanden sein. In der Excel Datei werden Daten der Aufgaben als auch Stufen geschrieben.

Folgende Spalten sind enthalten:
* '''Exercise ID''' - Identifikationsnummer der Aufgabe
* '''Stage count''' - Anzahl der Stufen einer Aufgabe (nur in Aufgabenzeile)
* '''Stage ID''' - Identifikationsnummer der Stufe (nur in Stufenzeile)
* '''Result-Delta''' - Durchschnittliche Veränderung der Punktzahl von erster und letzter Einreichung
* '''Student count for Result-Delta''' - Anzahl der Berücksichtigten Studenten
* '''Student count all''' - Anzahl aller Studenten, welche Bearbeitungen erzeugt haben
* '''Timestamp''' - Zeitpunkt der Generierung
* '''Level of difficulty (generated)''' - Hinterlegter Schwierigkeitsgrad, sofern dieser generiert wurde
* '''First Result-Average''' - Durchschnittspunktzahl der ersten Einreichungen
* '''Feedback-Average''' - Durchschnittliche Anzahl der hinterlegten Feedback-Fälle (ohne das "andere"-Feedback)
* '''Anzahl möglicher Teilpunktzahlen''' - Durchschnittliche Anzahl möglicher Teilpunktzahlen. Bsp.: Wenn ein Feedback an einer Stelle 50 Punkte gibt, wied dies als 1 mögliche Teilpunktzahl erfasst.
* '''Übung/Leistung''' - Gibt an ob die Aufgabe als "Übung", "Leistung" oder etwas anderes getagt ist.
* '''Result-Delta (positive)''' - Nur die positiven Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (positive)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (positive)" (nur für Stufen verfügbar)
* '''Result-Delta (negative)''' - Nur die negativen Punktedifferenzen (nur für Stufen verfügbar)
* '''Student count (negative)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (negative)" (nur für Stufen verfügbar)
* '''Result-Delta (indifferent)''' - Hat immer den Wert 0
* '''Student count (indifferent)''' - Anzahl der berücksichtigten Studierenden für das "Result-Delta (indifferent)" (nur für Stufen verfügbar)

===Links===
[[Distraktoranalyse]]

[[McIndex-Variablen]]

Aufgaben (Jack2)

2017-04-06T07:27:22Z

Dhaeckel: /* Ressourcen */

=== Zusammenfassung ===

Die Verwaltung von Aufgaben ist eine der zentralen Tätigkeiten in JACK. Jede Aufgabe stellt eine in sich geschlossene Einheit dar, d.h. jede Aufgabe kann unabhängig von anderen Aufgaben konfiguriert und bearbeitet werden. Automatische Prüfverfahren werden immer individuell für genau eine Aufgabe konfiguriert und Studierende geben Lösungen immer für genau eine Aufgabe ab. Jede Aufgabe hat einen Lehrenden oder Administrator, der sie angelegt hat und möglicherweise weitere Lehrende, denen Zugriff auf eine Aufgabe erteilt wurde. Aufgaben können als Übungsaufgaben zur freien Nutzung im normalen Modus direkt freigegeben werden oder zu Prüfungen für die Nutzung zum Prüfungsmodus hinzugefügt werden. Im Folgenden wird zunächst die Verwaltung von Aufgaben erläutert. Nach der Anmeldung am System - als Administrator oder Lehrender - wird automatisch die Übersichtsseite geladen. Administratoren werden im Abschnitt Aufgaben alle verfügbaren Aufgaben angezeigt. Lehrende bekommen nur jene Aufgaben angezeigt, auf die sie Zugriff haben. Die Aufgaben sind nach Kategorien gruppiert und lexikographisch aufsteigend geordnet. Durch Anklicken eines Aufgaben-Titels können Details zu jeder Aufgabe abgerufen und verändert werden. Von der Detailseite führt das Hauptmenü rechts über den Link '''Übersicht''' wieder zurück zur Übersichtsseite. Zu jeder Aufgabe werden allgemeine Angaben (Titel, Beschreibung usw.), eine Liste von Ressourcen, eine Liste von Lehrenden mit Zugriffsrechten auf diese Aufgabe, Prüfeinstellungen für automatische Tests und lösungsbezogene Statistiken verwaltet. Weitere Details zu den einzelnen Punkten können den Folgekapiteln entnommen werden. Solange für eine Aufgabe keine Lösungen vorliegen, kann diese über die Listenansicht der Übersichtsseite gelöscht werden. Neue Aufgaben können aus dem Hauptmenü rechts über den Link '''Aufgabe erstellen''' angelegt werden. Eine Aufgabe kann über den Link '''Duplizieren''' zwecks Wiederverwendung kopiert werden. Um eine Aufgabe auf eine andere JACK-Installation zu übertragen, stellt JACK eine Exportfunktion bereit. Durch Anklicken des Links '''Exportieren''' wird ein ZIP-Archiv generiert, das neben einer Beschreibung der Aufgabenparameter alle aufgabenbezogenen Ressourcen beinhaltet. Der Import einer Aufgabe kann über den Hauptmenüeintrag '''Aufgabe importieren''' vorgenommen werden.

=== Basiseinstellungen ===

Im Abschnitt '''Basiseinstellungen''' der Detailansicht können allgemeine Einstellungen zu einer Aufgabe vorgenommen werden. Folgende Parameter sind in den Basiseinstellungen vorzufinden:

* '''Titel:''' Der Titel dient der Repräsentation einer Aufgabe innerhalb der Benutzeroberfläche.
* '''Eigentümer/-in:''' Der Anmeldename des Benutzers, der eine Aufgabe erstellt hat. Dieser Benutzer ist neben Administratoren automatisch zur uneingeschränkten Bearbeitung der Aufgabe berechtigt. Alle anderen Lehrenden müssen zur Bearbeitung explizit autorisiert werden.
* '''Kategorie:''' Die Kategorie legt fest, zu welcher Gruppe eine Aufgaben in der Übersichtsseite gehört. Es kann ein beliebiger Kategoriename vergeben werden. Die Angabe einer Kategorie ist optional.
* '''Sichttyp:''' Der Sichttyp gibt Auskunft darüber, um welche Art von Aufgabe es sich handelt. Der Aufgabentyp ist hauptsächlich für die Auswahl der richtigen Bearbeitungsmaske und Lösungsansicht in der Web-Oberfläche von Bedeutung.
* '''Aufgabe ist aktiviert:''' Freischaltung einer Aufgabe für die Bearbeitung und Verwendung in Prüfungen und Kursen.
* '''Aufgabe ist öffentlich:''' Öffentliche Aufgaben dürfen von allen Studierenden bearbeitet werden. Für das Einreichen von Lösungen werden keine Transaktionsnummern (TAN) benötigt. Nicht-öffentliche Aufgaben dürfen nur über Prüfungen bearbeitet werden. Alle Prüfungsteilnehmer müssen über eine Transaktionsnummer verfügen.
* '''Interne Beschreibung:''' Die interne Beschreibung der Aufgabe dient administrativen Zwecken und ist für Studierende nicht sichtbar.
* '''Externe Beschreibung:''' Die externe Beschreibung dient der Vermittlung von zusätzlichen Anweisungen zur Bearbeitung der Aufgabe an Studierende und wird in der Web-Oberfläche für Studierende angezeigt.
* '''Prozentabzug:''' Festlegung von Punktabzügen bei hochgeladenen Lösungen. Die ersten drei eingereichten Lösungen werden generell ohne Punktabzug bewertet. Für jede weitere Lösung wird der angegebene Prozentsatz an Punkten abgezogen. Der Abzug erhöht sich mit jeder Lösung um den festgelegten Prozentsatz. Sind bspw. fünf Prozent festgelegt, so werden bei der vierten eingereichten Lösung fünf Prozent der erreichten Punkte abgezogen, bei der fünften Lösung zehn Prozent, usw. Die Verwendung des Prozentabzugs ist optional. '''Wichtig:''' Für den Aufgabentyp FormBased ist ein Prozentabzug für Mehrfacheinreichungen '''nicht''' implementiert.
* '''Minimales korrektes Ergebnis:''' Festlegung der minimalen Punktzahl, die zum Bestehen einer Aufgabe erreicht werden muss.
* '''Evaluierungsregel:''' Die Evaluierungsregel legt fest, wie bei automatischen Überprüfungen die Gesamtbewertung aus den einzelnen Teilbewertungen der Checker errechnet wird. Eine Evaluierungsregel ist ein mathemtischer Ausdruck bestehend aus Variablenwerten der Form #{Variablenname}, Zahlen und Operatoren. Eine Variable repräsentiert jeweils einen spezifischen Checker und der Variablenwert das Checker-Ergebnis. Der Variablenname eines Checkers kann den Checker-Einstellungen einer Aufgabe entnommen werden. Sollen beispielsweise zwei Checker verwendet werden, von denen der erste über die Variable c1 identifiziert wird und 20% der Gesamtbewertung ausmachen soll, der andere über c2 identifiziert wird und 80% beitragen soll, lautet die dafür nötige Regel: #{c1} * 0.2 + #{c2} * 0.8. Für den Aufgabentyp FormBased muss nie eine Evaluierungsregel eingestellt werden.

=== Ressourcen ===

Ressourcen sind Dateien, die einer Aufgabe als Arbeitsmaterial zugewiesen sind. Sie werden in der Detailansicht unter der Überschrift '''Ressourcen''' angezeigt. Vorhandene Einträge können durch Anklicken eingesehen und geändert, über den '''Löschen'''-Link entfernt und über den '''Download'''-Link heruntergeladen werden. Neue Anhänge können über den '''Ressource hinzufügen'''-Button eingefügt werden. Für jeden Anhang kann ein Ressourcen-Typ eingestellt werden. Es wird zwischen den folgenden Typen unterschieden:

* '''INSTRUCTION_SHEET:''' Anweisungen zur Bearbeitung der Aufgabe. Ressourcen dieses Typs können von Studierenden in der Web-Oberfläche heruntergeladen werden. Das JACK-Eclipse-Plugin zeigt diese Dateien in einer Prüfung nicht an.
* '''WORKING_SHEET:''' Arbeitsvorlage für einzureichende Lösungen. Ressourcen diesen Typs können von Studierenden in der Web-Oberfläche heruntergeladen werden und müssen bei der Einreichung einer Lösung hochgeladen werden. Das JACK-Eclipse-Plugin bietet den automatischen Download und Upload aller Arbeitsvorlagen für eine Prüfung an. Exercisechain und Stufendateien für den Aufgabentyp FormBased sind stets von diesem Typ. Ist der vorliegende Aufgabentyp "FORMBASED", so sind die Dateien "exercisechain.xml", "stage1.xml" und weitere ebenfalls als '''WORKING SHEET''' hochzuladen. Diese sind dabei nicht für Studierende sichtbar, sondern dienen allein der Aufgabenkonfiguration und -darstellung in JACK selbst.
* '''REFERENCE_SHEET:''' Zusatzmaterial zu einer Aufgabe. Ressourcen dieses Typs können von Studierenden in der Web-Oberfläche heruntergeladen werden, dürfen jedoch bei der Einreichtung einer Lösung nicht wiederhochgeladen werden. Das JACK-Eclipse-Plugin bietet den automatischen Downloads Zusatzmaterials für eine Prüfung an und unterbindet den Upload.
* '''HIDDEN_SHEET:''' Für Studierende nicht angezeigte Ressourcen, wie z.B. Musterlösungen, die für die automatische Prüfung benötigt werden.

Es sollte mindestens eine Ressource des Typs '''WORKING_SHEET''' angegeben werden, da JACK sonst keine Lösungen von Studierenden entgegennehmen kann. Bei Bedarf kann es sich bei der Arbeitsvorlage um eine leere Datei handeln, so dass nur der Dateiname den Studierenden verbindlich vorgegeben ist.

Möchten Sie beispielsweise eine Programmieraufgabe einrichten, tragen Sie als Arbeitsvorlagen Dateien eines Quellcodegerüsts ein, dass von den Studierenden ausgefüllt werden muss. Als Zusatzmaterial können Sie Interface-Dateien oder Bibliotheksklassen angeben, die bei der Bearbeitung genutzt, aber nicht verändert werden dürfen.

=== Zugriffsrechte ===

Die Einsicht und Bearbeitung von Aufgaben, sowie Verwendung in Testaten, ist nur dem Eigentümer und Administratoren gestattet. Aufgaben denen ein Lehrender nicht explizit zugewiesen wurde, werden in dessen Aufgabenliste nicht angezeigt. Um einem Lehrenden den Zugriff auf eine Aufgabe zu gestatten, kann dieser unter der Überschrift '''Lehrende für diese Aufgabe autorisieren''' zur Einsicht und Bearbeitung explizit berechtigt werden. Es dürfen alle Benutzer autorisiert werden, die in der Benutzerverwaltung als '''Lehrende''' freigeschaltet sind.

=== Checker ===

Automatische Tests von Aufgaben werden in JACK durch Checker konfiguriert und durchgeführt. In der Konfiguration ist festgelegt, welche Eingabedaten für den jeweiligen Checker benötigt werden (z.B. Skript-Dateien, Regel-Dateien usw.). Die in Checkern zu verwendenden Dateien müssen in den Ressourcen-Listen der jeweiligen Aufgaben vorhanden sein. Einige diese Dateien sind typischerweise vom Typ '''HIDDEN_SHEET''', da sie für Studierende nicht sichtbar sein sollen. Alle deklarierten Checker stehen zur Überprüfung von Aufgaben zur Verfügung und können über den '''Checker hinzufügen'''-Button eingebunden werden. Es findet keine automatische Überprüfung statt, ob ein gewählter Checker für den Aufgabentyp grundsätzlich geeignet ist.

Aufgaben (Jack2)

2017-04-06T07:26:49Z

Dhaeckel: /* Ressourcen */

=== Zusammenfassung ===

Die Verwaltung von Aufgaben ist eine der zentralen Tätigkeiten in JACK. Jede Aufgabe stellt eine in sich geschlossene Einheit dar, d.h. jede Aufgabe kann unabhängig von anderen Aufgaben konfiguriert und bearbeitet werden. Automatische Prüfverfahren werden immer individuell für genau eine Aufgabe konfiguriert und Studierende geben Lösungen immer für genau eine Aufgabe ab. Jede Aufgabe hat einen Lehrenden oder Administrator, der sie angelegt hat und möglicherweise weitere Lehrende, denen Zugriff auf eine Aufgabe erteilt wurde. Aufgaben können als Übungsaufgaben zur freien Nutzung im normalen Modus direkt freigegeben werden oder zu Prüfungen für die Nutzung zum Prüfungsmodus hinzugefügt werden. Im Folgenden wird zunächst die Verwaltung von Aufgaben erläutert. Nach der Anmeldung am System - als Administrator oder Lehrender - wird automatisch die Übersichtsseite geladen. Administratoren werden im Abschnitt Aufgaben alle verfügbaren Aufgaben angezeigt. Lehrende bekommen nur jene Aufgaben angezeigt, auf die sie Zugriff haben. Die Aufgaben sind nach Kategorien gruppiert und lexikographisch aufsteigend geordnet. Durch Anklicken eines Aufgaben-Titels können Details zu jeder Aufgabe abgerufen und verändert werden. Von der Detailseite führt das Hauptmenü rechts über den Link '''Übersicht''' wieder zurück zur Übersichtsseite. Zu jeder Aufgabe werden allgemeine Angaben (Titel, Beschreibung usw.), eine Liste von Ressourcen, eine Liste von Lehrenden mit Zugriffsrechten auf diese Aufgabe, Prüfeinstellungen für automatische Tests und lösungsbezogene Statistiken verwaltet. Weitere Details zu den einzelnen Punkten können den Folgekapiteln entnommen werden. Solange für eine Aufgabe keine Lösungen vorliegen, kann diese über die Listenansicht der Übersichtsseite gelöscht werden. Neue Aufgaben können aus dem Hauptmenü rechts über den Link '''Aufgabe erstellen''' angelegt werden. Eine Aufgabe kann über den Link '''Duplizieren''' zwecks Wiederverwendung kopiert werden. Um eine Aufgabe auf eine andere JACK-Installation zu übertragen, stellt JACK eine Exportfunktion bereit. Durch Anklicken des Links '''Exportieren''' wird ein ZIP-Archiv generiert, das neben einer Beschreibung der Aufgabenparameter alle aufgabenbezogenen Ressourcen beinhaltet. Der Import einer Aufgabe kann über den Hauptmenüeintrag '''Aufgabe importieren''' vorgenommen werden.

=== Basiseinstellungen ===

Im Abschnitt '''Basiseinstellungen''' der Detailansicht können allgemeine Einstellungen zu einer Aufgabe vorgenommen werden. Folgende Parameter sind in den Basiseinstellungen vorzufinden:

* '''Titel:''' Der Titel dient der Repräsentation einer Aufgabe innerhalb der Benutzeroberfläche.
* '''Eigentümer/-in:''' Der Anmeldename des Benutzers, der eine Aufgabe erstellt hat. Dieser Benutzer ist neben Administratoren automatisch zur uneingeschränkten Bearbeitung der Aufgabe berechtigt. Alle anderen Lehrenden müssen zur Bearbeitung explizit autorisiert werden.
* '''Kategorie:''' Die Kategorie legt fest, zu welcher Gruppe eine Aufgaben in der Übersichtsseite gehört. Es kann ein beliebiger Kategoriename vergeben werden. Die Angabe einer Kategorie ist optional.
* '''Sichttyp:''' Der Sichttyp gibt Auskunft darüber, um welche Art von Aufgabe es sich handelt. Der Aufgabentyp ist hauptsächlich für die Auswahl der richtigen Bearbeitungsmaske und Lösungsansicht in der Web-Oberfläche von Bedeutung.
* '''Aufgabe ist aktiviert:''' Freischaltung einer Aufgabe für die Bearbeitung und Verwendung in Prüfungen und Kursen.
* '''Aufgabe ist öffentlich:''' Öffentliche Aufgaben dürfen von allen Studierenden bearbeitet werden. Für das Einreichen von Lösungen werden keine Transaktionsnummern (TAN) benötigt. Nicht-öffentliche Aufgaben dürfen nur über Prüfungen bearbeitet werden. Alle Prüfungsteilnehmer müssen über eine Transaktionsnummer verfügen.
* '''Interne Beschreibung:''' Die interne Beschreibung der Aufgabe dient administrativen Zwecken und ist für Studierende nicht sichtbar.
* '''Externe Beschreibung:''' Die externe Beschreibung dient der Vermittlung von zusätzlichen Anweisungen zur Bearbeitung der Aufgabe an Studierende und wird in der Web-Oberfläche für Studierende angezeigt.
* '''Prozentabzug:''' Festlegung von Punktabzügen bei hochgeladenen Lösungen. Die ersten drei eingereichten Lösungen werden generell ohne Punktabzug bewertet. Für jede weitere Lösung wird der angegebene Prozentsatz an Punkten abgezogen. Der Abzug erhöht sich mit jeder Lösung um den festgelegten Prozentsatz. Sind bspw. fünf Prozent festgelegt, so werden bei der vierten eingereichten Lösung fünf Prozent der erreichten Punkte abgezogen, bei der fünften Lösung zehn Prozent, usw. Die Verwendung des Prozentabzugs ist optional. '''Wichtig:''' Für den Aufgabentyp FormBased ist ein Prozentabzug für Mehrfacheinreichungen '''nicht''' implementiert.
* '''Minimales korrektes Ergebnis:''' Festlegung der minimalen Punktzahl, die zum Bestehen einer Aufgabe erreicht werden muss.
* '''Evaluierungsregel:''' Die Evaluierungsregel legt fest, wie bei automatischen Überprüfungen die Gesamtbewertung aus den einzelnen Teilbewertungen der Checker errechnet wird. Eine Evaluierungsregel ist ein mathemtischer Ausdruck bestehend aus Variablenwerten der Form #{Variablenname}, Zahlen und Operatoren. Eine Variable repräsentiert jeweils einen spezifischen Checker und der Variablenwert das Checker-Ergebnis. Der Variablenname eines Checkers kann den Checker-Einstellungen einer Aufgabe entnommen werden. Sollen beispielsweise zwei Checker verwendet werden, von denen der erste über die Variable c1 identifiziert wird und 20% der Gesamtbewertung ausmachen soll, der andere über c2 identifiziert wird und 80% beitragen soll, lautet die dafür nötige Regel: #{c1} * 0.2 + #{c2} * 0.8. Für den Aufgabentyp FormBased muss nie eine Evaluierungsregel eingestellt werden.

=== Ressourcen ===

Ressourcen sind Dateien, die einer Aufgabe als Arbeitsmaterial zugewiesen sind. Sie werden in der Detailansicht unter der Überschrift '''Ressourcen''' angezeigt. Vorhandene Einträge können durch Anklicken eingesehen und geändert, über den '''Löschen'''-Link entfernt und über den '''Download'''-Link heruntergeladen werden. Neue Anhänge können über den '''Ressource hinzufügen'''-Button eingefügt werden. Für jeden Anhang kann ein Ressourcen-Typ eingestellt werden. Es wird zwischen den folgenden Typen unterschieden:

* '''INSTRUCTION_SHEET:''' Anweisungen zur Bearbeitung der Aufgabe. Ressourcen dieses Typs können von Studierenden in der Web-Oberfläche heruntergeladen werden. Das JACK-Eclipse-Plugin zeigt diese Dateien in einer Prüfung nicht an.
* '''WORKING_SHEET:''' Arbeitsvorlage für einzureichende Lösungen. Ressourcen diesen Typs können von Studierenden in der Web-Oberfläche heruntergeladen werden und müssen bei der Einreichung einer Lösung hochgeladen werden. Das JACK-Eclipse-Plugin bietet den automatischen Download und Upload aller Arbeitsvorlagen für eine Prüfung an. Exercisechain und Stufendateien für den Aufgabentyp FormBased sind stets von diesem Typ. Ist der vorliegende Aufgabentyp "FORMBASED", so sind die Dateien "exercisechain.xml" und "stage1.xml" ebenfalls als '''WORKING SHEET''' hochzuladen. Diese sind dabei nicht für Studierende sichtbar, sondern dienen allein der Aufgabenkonfiguration und -darstellung in JACK selbst.
* '''REFERENCE_SHEET:''' Zusatzmaterial zu einer Aufgabe. Ressourcen dieses Typs können von Studierenden in der Web-Oberfläche heruntergeladen werden, dürfen jedoch bei der Einreichtung einer Lösung nicht wiederhochgeladen werden. Das JACK-Eclipse-Plugin bietet den automatischen Downloads Zusatzmaterials für eine Prüfung an und unterbindet den Upload.
* '''HIDDEN_SHEET:''' Für Studierende nicht angezeigte Ressourcen, wie z.B. Musterlösungen, die für die automatische Prüfung benötigt werden.

Es sollte mindestens eine Ressource des Typs '''WORKING_SHEET''' angegeben werden, da JACK sonst keine Lösungen von Studierenden entgegennehmen kann. Bei Bedarf kann es sich bei der Arbeitsvorlage um eine leere Datei handeln, so dass nur der Dateiname den Studierenden verbindlich vorgegeben ist.

Möchten Sie beispielsweise eine Programmieraufgabe einrichten, tragen Sie als Arbeitsvorlagen Dateien eines Quellcodegerüsts ein, dass von den Studierenden ausgefüllt werden muss. Als Zusatzmaterial können Sie Interface-Dateien oder Bibliotheksklassen angeben, die bei der Bearbeitung genutzt, aber nicht verändert werden dürfen.

=== Zugriffsrechte ===

Die Einsicht und Bearbeitung von Aufgaben, sowie Verwendung in Testaten, ist nur dem Eigentümer und Administratoren gestattet. Aufgaben denen ein Lehrender nicht explizit zugewiesen wurde, werden in dessen Aufgabenliste nicht angezeigt. Um einem Lehrenden den Zugriff auf eine Aufgabe zu gestatten, kann dieser unter der Überschrift '''Lehrende für diese Aufgabe autorisieren''' zur Einsicht und Bearbeitung explizit berechtigt werden. Es dürfen alle Benutzer autorisiert werden, die in der Benutzerverwaltung als '''Lehrende''' freigeschaltet sind.

=== Checker ===

Automatische Tests von Aufgaben werden in JACK durch Checker konfiguriert und durchgeführt. In der Konfiguration ist festgelegt, welche Eingabedaten für den jeweiligen Checker benötigt werden (z.B. Skript-Dateien, Regel-Dateien usw.). Die in Checkern zu verwendenden Dateien müssen in den Ressourcen-Listen der jeweiligen Aufgaben vorhanden sein. Einige diese Dateien sind typischerweise vom Typ '''HIDDEN_SHEET''', da sie für Studierende nicht sichtbar sein sollen. Alle deklarierten Checker stehen zur Überprüfung von Aufgaben zur Verfügung und können über den '''Checker hinzufügen'''-Button eingebunden werden. Es findet keine automatische Überprüfung statt, ob ein gewählter Checker für den Aufgabentyp grundsätzlich geeignet ist.