Templatepaletten

2017-11-21T07:56:44Z

Nschwinning:

Templatepaletten

2017-11-21T07:54:35Z

Nschwinning:

Eine [[Templatepaletten|Templatepalette]] ist eine selbsterstellte Palette, die im Formeleditor in JACK eingesetzt werden kann. So können eigene Paletten erstellt werden, welche nicht im Standardrepertoire von JACK enthalten sind.

Eine Templatepalettendatei ist wiefolgt aufgebaut:

{| class="wikitable"
|
<OMOBJ version='2.0' xmlns='http://www.openmath.org/OpenMath'>
<OMA>
<OMS cd='editor1' name='palette'/>
<OMA>
<OMS cd='editor1' name='palette_tab'/>
<OMA>
<OMS cd='editor1' name='palette_row'/>
<OMS cd='arith1' name='plus'/>
<OMS cd='arith1' name='minus'/>
<OMS cd='arith1' name='times'/>
<OMA>
<OMS cd='transc1' name='cos'/>
<OMS cd='editor1' name='input_box'/>
</OMA>
<OMA>
<OMS cd='arith1' name='root'/>
<OMS cd='editor1' name='input_box'/>
<OMI>2</OMI>
</OMA>
</OMA>
<OMA>
<OMS cd='editor1' name='palette_row'/>
<OMS cd='relation1' name='lt'/>
<OMS cd='relation1' name='leq'/>
<OMS cd='relation1' name='eq'/>
<OMS cd='relation1' name='geq'/>
<OMS cd='relation1' name='gt'/>
</OMA>
</OMA>
</OMA>
</OMOBJ>
|[[Datei:Templatepalette1-spobel.png]]
|}

=== Siehe auch ===
* [[Standardpaletten]]

Migration zur Evaluator 2 Syntax (Jack2)

2017-11-20T15:15:13Z

Nschwinning:

Durch die Migration auf den Evaluator Version 2, welche im November 2017 vorgenommen wurde, kann es zu fehlerhaften Aufgaben kommen. Auf dieser Seite werden die typischen Fehler aufgeführt und Maßnahmen zur Behebung angegeben.

== Fehler in der Funktion EqualsExpr ==
* Multiplikation
: Zwischen den Variablen müssen Mal-Zeichen gesetzt werden.
:: ''Bsp.: 2xy -> 2*x*y''
: ''2xy'' ist als Eingabemöglichkeit im Moment nicht möglich.
*Methoden
: Methodennamen werden klein geschrieben und '[]' durch '()' ersetzt.
:: ''Bsp.: Factorial[ [var=f] ] -> factorial([var=f])''
*Ausdrücke
: π muss '[var=PI]' geschrieben werden.
:: Bsp.: ''equalsExpr('[pos=12]','2*[var=PI]*r')''

==Berechnungen==
* Bei Problemen bei der Berechnung von double-Variablen:
: In der '''exerciseChain.xml'''-Datei:
:: ''round([var=a]*100.)/100.'' --> ''round([var=a]*100.0)/100.0''

==Deklaration von Mengenvariablen==
Bei der Mengenangabe "Set" müssen Strings in Apostrophe gesetzt werden:
: set="{'Berlin','Paris','Prag'}"
Zahlen und Variablen werden weiterhin ohne Apostrophe geschrieben
: set="{1,2,3,4}"
: set="{a,b,c}"

== Hochkommata in Funktionsargumenten==
Hochkommata sind der Deklaration von Zeichenketten für den Evaluator vorbehalten. Dies kann problematisch sein, wenn man Hochkommata auch innerhalb dieser Zeichenketten verwenden möchte, also bspw. in folgendem Aufruf:

<code><option name="land" value="sample(c('Island', 'Frankreich', 'Japan', 'Großbritannien', 'Norwegen', 'Deutschland', 'Italien', 'die Niederlande', 'Tschechien', 'Polen', 'Österreich', 'Griechenland', 'die USA', 'die Türkei'), 1)" cas=“R"/></code>

Der Ausdruck im Attribut ''value'' wird der Funktion ''evaluateInR'' in Hochkommata übergeben und diese wird ausgewertet. Daher muss wie in Java üblich ein Escaping mittels Backslash betrieben werden. Der korrekte Aufruf lautet also nun folgendermaßen:

<code><option name="land" value="sample(c(\'Island\', \'Frankreich\', \'Japan\', \'Großbritannien\', ...), 1)" cas=“R"/></code>

Versionshistorie (Jack2)

2017-11-20T07:54:49Z

Nschwinning: /* Oktober 2017 */

== November 2017 ==
* ''20. November 2017'': Der Evaluator 2.0 läuft nun auch auf http://jack.s3.uni-due.de. Hinweise zu notwendigen Änderungen an formularbasierten Aufgaben findet man unter [[Migration zur Evaluator 2 Syntax]]

== Oktober 2017 ==
* ''04. Oktober 2017'': Die Funktionen des [[Evaluator|Evaluators]] sind nun in diesem Wiki kategorisiert. Eine Übersicht aller Kategorien findet man unter [[:Kategorie:Evaluatorfunktionenkategorie|Evaluatorfunktionenkategorien]]

== September 2017 ==
* ''29. September 2017'': Auf der Spielwiese läuft seit heute Version 2 vom [[Evaluator]]. Neu ist insbesondere, dass Lehrende in den Funktionen anstatt CAS-Syntax sogenannte [[:Kategorie:Konstruktor|Konstruktoren]] verwendet werden müssen. Dies zieht ggf. Änderungen nach sich, z.B. an der Funktion [[equalsExpr]].

== August 2017 ==
* ''30. August 2017'': In [[Fill In|Fill-In-Aufgaben]] können die Warnungen des Checkers bei leerer Eingabe unterdrückt werden. Die Dokumentation dazu findet man im Artikel [[Stage]] in der Erläuterung des Tags '''exercise'''. Bisher kann dieses Feature nur auf der Spielwiese verwendet werden.
* ''29. August 2017'': Sage läuft jetzt in JACK auf Version 8.0
* ''29. August 2017'': [[Fill In|Fill-In-Aufgaben]] erhalten eine [[Evaluator-Konsole]] für Lehrende, um Aufgaben einfacher Testen zu können.

== Juli 2017 ==
* ''5. Juli 2017'': Der Server jack-server05.s3.uni-due.de (Spielwiese) wird ab ca. 14:45 Uhr offline sein um ihn zu aktualisieren. Bis ca. 16 Uhr sollten alle Maßnahmen abgeschlossen und der Server wieder verfügbar sein. Vielen Dank für ihr Verständnis!

== Juni 2017 ==
* ''29. Juni 2017'': Eine neue stabile Version findet sich auf allen JACK-Servern, eine neue Testversion (2.4.2) befindet sich auf der Spielwiesen-Instanz! Im Wesentlichen beinhaltet die neue Version zahlreiche Bugfixes.
* ''19. Juni 2017'': Herzlich Willkommen auf dem Feature-News-Ticker. Auf dieser Seite stellen wir in Zukunft neue Features innerhalb von JACK vor und dokumentieren ihre Verwendung. Bitte schauen Sie also regelmäßig rein.

Versionshistorie (Jack2)

2017-11-20T07:53:30Z

Nschwinning:

== Oktober 2017 ==
* ''20. November 2017'': Der Evaluator 2.0 läuft nun auch auf http://jack.s3.uni-due.de. Hinweise zu notwendigen Änderungen an formularbasierten Aufgaben findet man unter [[Migration zur Evaluator 2 Syntax]]

== Oktober 2017 ==
* ''04. Oktober 2017'': Die Funktionen des [[Evaluator|Evaluators]] sind nun in diesem Wiki kategorisiert. Eine Übersicht aller Kategorien findet man unter [[:Kategorie:Evaluatorfunktionenkategorie|Evaluatorfunktionenkategorien]]

== September 2017 ==
* ''29. September 2017'': Auf der Spielwiese läuft seit heute Version 2 vom [[Evaluator]]. Neu ist insbesondere, dass Lehrende in den Funktionen anstatt CAS-Syntax sogenannte [[:Kategorie:Konstruktor|Konstruktoren]] verwendet werden müssen. Dies zieht ggf. Änderungen nach sich, z.B. an der Funktion [[equalsExpr]].

== August 2017 ==
* ''30. August 2017'': In [[Fill In|Fill-In-Aufgaben]] können die Warnungen des Checkers bei leerer Eingabe unterdrückt werden. Die Dokumentation dazu findet man im Artikel [[Stage]] in der Erläuterung des Tags '''exercise'''. Bisher kann dieses Feature nur auf der Spielwiese verwendet werden.
* ''29. August 2017'': Sage läuft jetzt in JACK auf Version 8.0
* ''29. August 2017'': [[Fill In|Fill-In-Aufgaben]] erhalten eine [[Evaluator-Konsole]] für Lehrende, um Aufgaben einfacher Testen zu können.

== Juli 2017 ==
* ''5. Juli 2017'': Der Server jack-server05.s3.uni-due.de (Spielwiese) wird ab ca. 14:45 Uhr offline sein um ihn zu aktualisieren. Bis ca. 16 Uhr sollten alle Maßnahmen abgeschlossen und der Server wieder verfügbar sein. Vielen Dank für ihr Verständnis!

== Juni 2017 ==
* ''29. Juni 2017'': Eine neue stabile Version findet sich auf allen JACK-Servern, eine neue Testversion (2.4.2) befindet sich auf der Spielwiesen-Instanz! Im Wesentlichen beinhaltet die neue Version zahlreiche Bugfixes.
* ''19. Juni 2017'': Herzlich Willkommen auf dem Feature-News-Ticker. Auf dieser Seite stellen wir in Zukunft neue Features innerhalb von JACK vor und dokumentieren ihre Verwendung. Bitte schauen Sie also regelmäßig rein.

Migration zur Evaluator 2 Syntax (Jack2)

2017-11-16T08:46:23Z

Nschwinning: /* Set */

Migration zur Evaluator 2 Syntax (Jack2)

2017-11-16T08:45:58Z

Nschwinning:

MediaWiki:Sidebar

2017-10-12T08:32:09Z

Nschwinning:

Kurzanleitung: Aufgabe FormBased (Jack2)

2017-10-12T08:31:35Z

Nschwinning: Nschwinning verschob die Seite Kurzanleitung: Aufgabe nach Kurzanleitung: Aufgabe FormBased: Name nicht exakt

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.

MediaWiki:Sidebar

2017-10-12T07:51:33Z

Nschwinning:

MediaWiki:Sidebar

2017-10-12T07:51:06Z

2017-07-27T08:47:18Z

Nschwinning: /* Beispiele */

===Beschreibung===
Die Funktion ''set'' bekommt als Eingabe Mengenelemente und gibt diese als OpenMathObject zurück.

===Syntax===
set(string argument, string argument, ...)

===Parameter===
* '''argument''' - beliebig viele strings für die einzelnen Mengenelemente

===Return Value===
* Gibt die Menge als OpenMathObject zurück

===Beispiele===
set(vector(1,1),vector(1,2)) --> <OMOBJ><OMA><OMS cd="list1" name="list"/><OMA><OMS cd="linalg2" name="vector"/><OMI>1</OMI><OMI>1</OMI></OMA><OMA><OMS cd="linalg2" name="vector"/><OMI>1</OMI><OMI>2</OMI></OMA></OMA></OMOBJ>

<math>\{ \begin{pmatrix} 1 \\ 2 \end{pmatrix} , \begin{pmatrix} 1 \\ 2 \end{pmatrix} \}</math>

===Hinweise===
* Die Funktion setzt eine Menge von Elementen in die OpenMath schreibweise.

[[Kategorie:Evaluatorfunktion]]