JACK Wiki - Benutzerbeiträge [de]

Java (JACK3)

2026-05-28T12:55:07Z

LGlaser: /* Feedback */ Checker aktualisiert

===Aufgabeninhalt===
In dem Bereich Aufgabeninhalt wird der Aufgabentext erstellt und spezifische Eingaben für den jeweiligen Aufgabenteil gemacht.
[[File:Aufgabentext.jpg|center|thumb|800px|Editor für den Aufgabentext]]
* '''Titel:''' Hier kann optional der Name des Aufgabenteils eingetragen werden.
* '''Aufgabentext:''' Im Aufgabentext steht die Aufgabenstellung. Der Editor für den Aufgabetext lässt sich öffnen in dem man reinklickt. In dem Fließtext kann Latex-Code verwendet werden, indem man diesen mit $-Zeichen einspannt. Der Editor bietet einige Formatierungen an wie z.B. fett, kursiv und unterstrichen. Einfache Tabellen können auch mithilfe des Editors erstellt werden. Wenn man den Button ''source code'' [[File:Icon-source_code.jpg|35px]] verwendet kann man HTML-Code nutzen. Über den Button '''Ressource Einfügen''' lässt sich ein hochgeladenes Bild oder ein Link in den Aufgabentext einfügen.
* '''Einstellungen für den Dateiupload:''' Hier werden die Einstellungen gemacht über die Dateien, die die Lernenden als Lösung bei dieser Aufgabe hochladen.
** '''Erforderliche Dateinamen:''' Zuerst wird festgelegt, wie die Dateien heißen sollen. Alle Dateinamen, die unter Erforderliche Dateinamen aufgeführt werden müssen auch von dem Lernenden hochgeladen werden. Ist das Feld leer haben die Lernenden die freie Wahl bei der Benennung ihrer Klassen.
** '''Erlaubte Dateinamen:''' Hier werden die Dateinamen aufgelistet, die alle erlaubt sind. Dadruch können auch Varianten erlaubt werden.
** '''Mindestzahl hochgeladener Dateien:''' Hier wird angegeben wie viele Dateien mindestens die Lernenden hochladen sollen.
** '''Höchstzahl hochgeladener Dateien:''' Hier wird angegeben wie viele Dateien höchsten die Lernenden hochladen dürfen. Wenn die Anzahl festgelegt ist, wie viele Dateien hochgeladen werden sollen, dann muss bei beiden dieselbe Zahl angegeben werden.
[[File:Java_Einstellungen.JPG|center|thumb|800px|Einstellungen bei einer Java Aufgabe]]

===Feedback===
* '''Gewichtung des Aufgabenteils:''' Gewichtung der Punktzahl eines Aufgabenteils innerhalb der Aufgabe.
* '''Reaktion bei fehlenden oder falschen Dateianhängen:''' Wie soll Jack reagieren, wenn ein Lernender falsche Dateien angehängt hat oder Dateien fehlen. Es gibt die Möglichkeit die '''Stufe wiederholen lassen''' oder die '''Einreichung mit 0 Punkten bewerten'''.
* '''Verhalten bei internen Fehlern während der Überprüfung:''' Während der Überprüfung studentischer Lösungen können schon mal interne Fehler auftreten. Hier muss angegeben werden ob die '''Bearbeitung markiert und abgebrochen''' wird oder ob eine '''Nachricht ausgeben und Bearbeitung fortgesetzt''' wird.
* '''Bewertungsverfahren:''' Über die jeweiligen Button können '''[[GReQLJavaChecker|statische Checker]]''' und '''[[TracingChecker|dynamische Checker]]''' hinzugefügt werden.
** '''Gewichtung dieses Checks:''' Die verschiedenen dynamischen und statischen Checker einer Aufgabe können unterschiedlich stark gewichtet werden. Dadurch lässt sich die unterschiedlichen Aufgaben der Checker berücksichtigen.
** '''Diesen Check löschen:''' Über den Button lässt sich dieser Checker von der Aufgabe entfernen.
** '''Berücksichtigte Dateien in diesem Check:''' Hier werden die Dateien eingetragen, die dieser Checker checken soll.
** '''Weitere Quellcode-Dateien aus der Aufgabe:'''
** '''Checker:'''
*** '''GReQL-Regelsatz zur statischen Überprüfung:''' Hier wird der Regelsatz eingetragen. Weitere Informationen über den GReQL Java Checker und welche Regeln zur Verfügung stehen finden sich [[GReQLJavaChecker|hier]].
*** '''dynamische Tests:''' Hier wird der Testtreiber für die dynamischen Tests eingefügt. Weitere Informationen über den Tracing Java Checker sind [[TracingChecker|hier]] zu finden.
*** '''Metrikberechnung:''' Hier werden einige Softwaremetriken auf den eingereichten Lösung berechnet (z.B. Lines of Code, Zyklomatische Komplexität). Die Ergebnisse werden in Meta Variablen gespeichert und können als Extra-Feedback ausgegeben werden.
<gallery mode="packed">
Java_GReQL_Checker.JPG|statischer Checker (GReQL)
Java_Tracing_Checker.JPG|dynamischer Checker
</gallery>
* '''Überspringen:''' Der Lehrende kann jeden Java Aufgabenteil zum Überspringen anbieten. Dazu muss zunächst der Haken gesetzt werden. Danach gibt es noch die Möglichkeit einen Text den Lernenden anzuzeigen, wenn dieser diesen Aufgabenteil übersprungen hat. Das Textfeld öffnet sich entweder wenn man reinklickt oder über den [[File:Icon-Pencil.jpg|22px]]-Button.

{{JACK3:Hinweise}}

===Verknüpfungen===
* '''Nächster Aufgabenteil (Standard):''' In dem Drop-Down Feld wird der nächste Zustand ausgewählt, in die die Aufgabe sein soll, wenn der Lernende eine Lösung eingereicht hat. Dieses wird immer dann durchgeführt, wenn keine andere Aktion zutrifft. Es gibt die folgenden Möglichkeiten:
** '''Nächster oder Ende:''' Dies ist die default Einstellung. Nach der studentischen Einreichung dieses Aufgabenteils wird der nächste Aufgabenteil in der Reihe angezeigt. Wenn dies der letzte Aufgabenteil dieser Aufgabe ist, ist die Aufgabe beendet.
** '''Ende der Aufgabe:''' Die Aufgabe ist mit der Aktion des Lernenden beendet.
** '''Aufgabenteil wiederholen:''' Der Aufgabenteil wird wiederholt. Der Lernende kann ein weiteres Ergebnis einreichen. Diese Aktion kann man z.B. bei Übungsaufgaben benutzen, wenn der Lernende eine Aufgabe solange wiederholen soll, bis das richtige Ergebnis eingereicht wurde.
** '''#x (x ist dabei ein beliebiger Aufgabenteil dieser Aufgabe):''' Der entsprechende Aufgabenteil wird als nächstes angezeigt. Wenn man die Aufgabenteilnummer des aktuellen Aufgabenteils wählt wird dieser Aufgabenteil neu aufgerufen.
** '''Nicht auf Feedback warten und sofort zum nächsten Aufgabenteil weiterschalten:''' Da bei dieser Aufgabe es teilweise länger dauern kann bis die Checker ein Feedback zurück geben, besteht die Möglichkeit den Haken hier zu setzen. Dann wird nicht auf das Checker Ergebnis gewartet, bevor der nächste Aufgabenteil angezeigt wird.
[[File:Verknuepfung_Java.JPG|center|thumb|800px|Verknüpfung mit anderen Stufen]]
* '''Weitere nächste Aufgabenteile (optional):''' Hier kann die nächste Aktion dynamisch eingestellt werden, d.h. sie kann abhängig von der Variablen Konstelation sein oder von der Eingabe des Lernenden.
* '''Nächster Aufgabenteil beim Überspringen (optional):''' Hier wird eingestellt welcher nächste Aufgabenteil angezeigt werden soll, wennn der Lernende die Stufe übersprungen hat. Diese Einstellungsmöglichkeit steht nur zur Verfügung, wenn der Haken im Tab Feedback fürs Überspringen gesetzt wurde.

{{JACK3:Variablenupdates}}

{{JACK3:Dateien für Studierende}}

=== Variablen ===
Wenn in einem statischen Check ein Regelsatz verwendet wurde, der Regeln vom Typ "report" enthält, stehen die Ergebnisse als Variablen der Form <code>[check=<Name_der_Report-Variablen>]</code> zur Verfügung.

Wenn für das Feedback die Metrikberechnung aktiviert wird, stehen außerdem die folgenden Variablen zur Verfügung:
{| class="wikitable"
|-
! Name !! Beschreibung
|-
| <code>[check=complexity]</code>|| Zyklomatische Komplexität des untersuchten, studentischen Codes
|-
| <code>[check=depth]</code>|| Maximale Tiefe des AST des untersuchten, studentischen Codes
|-
| <code>[check=fields]</code>|| Anzahl der im untersuchten, studentischen Code deklarierten Felder
|-
| <code>[check=methods]</code>|| Anzahl der im untersuchten, studentischen Code deklarierten Methoden
|-
| <code>[check=loops]</code>|| Anzahl der im untersuchten, studentischen Code vorkommenden Schleifen-Konstrukte
|-
| <code>[check=statements]</code>|| Anzahl der im untersuchten, studentischen Code vorkommenden Statements
|-
| <code>[check=expressions]</code>|| Anzahl der im untersuchten, studentischen Code vorkommenden Ausdrücke
|-
| <code>[check=refs]</code>|| Anzahl der im untersuchten, studentischen Code vorkommenden Referenzen (Feld- und Variablenzugriffe, Methoden- und Konstruktoraufrufe)
|}
Für weitere Informationen über Variablen siehe [[Variablen (JACK3)|Variablen]].
[[category:Benutzerhandbuch]]

Benutzerhandbuch (JACK3)

2026-05-21T13:27:26Z

LGlaser: Korrekturworkflow eingefügt

Dies ist das Benutzerhandbuch der neuesten Version JACK3. Hier finden Sie alle wichtigen Information von "Wie erstelle ich eine Aufgabe?" über "Wie lasse ich meine Studierende die Aufgaben bearbeiten?" bis "Wie lässt sich in die studentische Abgaben einsehen?".
Bitte beachten Sie, dass dies noch in Arbeit ist und noch nicht vollständig ist. Es kommen noch weitere Abschnitte hinzu und andere werden noch ausgebaut.

==[[Schnelleinstieg (JACK3)|Schnelleinstieg]]==
[[Schnelleinstieg (JACK3)|Hier]] ist eine Anleitung für den Schnelleinstieg in JACK3. Mit dieser Anleitung lässt sich schnell eine Aufgabe erstellen und diese Studierenden zur Verfügung stellen. Dabei werden nur die wichtigsten Einstellungen betrachtet. Für weitere Details stehen die folgenden Seiten zur Verfügung.

Zum schnellen Finden einzelner Seiten kann auch die [[:Category:Benutzerhandbuch|A-Z]] Liste genutzt werden.

==Allgemeine Informationen und Hinweise zum Start==
Beschreibung der globalen Einstellungen, die ein Nutzer in JACK3 tätigen kann.
Nachdem Aufrufen von JACK3 erscheint zunächst die [[Login (JACK3)|Login]] Seite, auf der man sich in das e-Assessment System JACK3 einloggen können. JACK3 Terminologie kann im [[Glossar (JACK3)|Glossar]] nachgeschlagen werden.
* [[Hauptseite (JACK3)|Hauptseite]] - Erklärung der [[Hauptseite (JACK3)|Hauptseite]], die nach dem Einloggen in das E-Assessment System JACK erscheint.
* [[Mein Account (JACK3)|Mein Account]] - Einstellungsmöglichkeiten des eigenen Benutzerskontos.
* [[Verfügbare Kurse (JACK3)|Verfügbare Kurse]] - Unter [[Verfügbare Kurse (JACK3)|Verfügbare Kurse]] können Lehrende Kursangebote erstellen, die dann von den Studierenden bearbeitet werden. Studierende sehen hier alle [[Kursangebot (Studierendensicht)|Kursangebote]], die sie bearbeiten können.
* [[Meine Teilnahmen (JACK3)|Meine Teilnahmen]] - Hier erscheinen die aktuell laufenden Kurse.
* [[Mein Arbeitsbereich (JACK3)|Mein Arbeitsbereich]] - Kurse und Aufgaben werden in diesem Bereich erstellt.
* [[Spracheinstellung (JACK3)|Spracheinstellung]] - Die Spracheinstellung wirkt sich nur global auf die Seiten aus und nicht auf die Aufgaben selber.
* [[Glossar (JACK3)|Grundlegende Konzepte / Glossar]] - Erklärung der Grundlegenden Konzepte in JACK3, die zum Teil für die Benutzung sehr wichtig sind.
* [[Variablen (JACK3)|Variablen]] - Variablentypen von JACK3 (insb. Aufgaben-Variablen) und die Verwendung

==Aufgaben erstellen / testen==
In diesem Abschnitt wird alles beschrieben, was sich mit einer einzelnen Aufgabe beschäftigt. Es beginnt mit globalen Einstellungen für eine Aufgabe, die Erstellung der verschiedenen Aufgabentypen, bis zum Testen der erstellten Aufgabe.
* [[Aufgaben Konfiguration (JACK3)|Aufgaben Konfigurationen / Einstellungen]]
** [[Aufgaben Einstellungen (JACK3)|Einstellungen]] - globalen Einstellungen der Aufgabe
** [[Variablenkonfiguration (JACK3)|Variablenkonfiguration]]
** [[JSXGraph (JACK3)|Dynamische, grafische Inhalte]]
** [[Aufgabenteile (JACK3)|Aufgabenteile]] - alle möglichen Aufgabenformate in JACK3 werden hier beschrieben
*** [[Atomorbitale (JACK3)|Atomorbitale]] - Erstellen von Atomorbitalschemas
*** [[Dateiupload (JACK3)|Dateiupload]] - Hochladen von Datei(en)
*** [[Drag & Drop (Sichtbare Zonen) (JACK3)|Drag & Drop (Sichtbare Zonen)]] - Drag & Drop auf Bildern mit sichtbaren Zonen
*** [[Drag & Drop (Text) (JACK3)|Drag & Drop (Text)]] - Drag & Drop auf Text
*** [[Drag & Drop (Unsichtbare Zonen) (JACK3)|Drag & Drop (Unsichtbare Zonen)]] - Drag & Drop auf Bildern mit unsichtbaren Zonen
*** [[Fill-In (JACK3)|Fill-In / Drop-Down/ Molekül]] - Lückentext, Eingabefelder, Drop-Down und Molekül Felder
*** [[Freitext (JACK3)|Freitext]] - Textfeld für die Eingabe von Texten, ohne Checker
*** [[Gatterschaltung (JACK3)|Gatterschaltung]]
*** [[Java (JACK3)|Java]] - Programmieraufgaben in Java
*** [[Molekül (JACK3)|Molekül]]
*** [[Multiple-Choice (JACK3)|Multiple-Choice]] - Multiple-Choice und Single-Choice möglich
*** [[MC-Table (JACK3)|Multiple-Choice Tabelle]]
*** [[Nomenklaturen (JACK3)|Nomenklaturen]] - Abfrage von Fachterminologie mit manueller oder automatischer Überprüfung
*** [[Python (JACK3)|Python]] - Programmieraufgaben in Python
*** [[R (JACK3)|R]]
*** [[UML (JACK3)|UML]]
** [[Grafische Darstellung (JACK3)|Grafische Darstellung der Aufgabenteile]] - Ansicht wie die verschiedenen Aufgabenteile miteinander verbunden sind.
** [[Dateien (JACK3)|Dateien]]
** [[Aufgaben Statistik (JACK3)|Statistik]]
* [[Aufgaben testen (JACK3)|Aufgabe testen]] - Beschreibung wie eine Aufgabe getestet werden kann, bevor sie Studierenden gezeigt wird.

==Kurse / Kursangebote erstellen==
In diesem Abschnitt werden Kurse und Kursangebote beschrieben. Wichtig hier ist auch das Zusammespiel der beiden.
* [[Kurs Einstellungen (JACK3)|Kurs Einstellungen]] - Im Kurs werden die Aufgaben zusammengestellt.
* [[Kursangebot Einstellungen (JACK3)|Kursangebot Einstellungen]] - Im Kursangebot werden die Sichtbarkeiten eingestellt.
'''Mögliche Szenarien''': Kursangebote können für verschiedene Zwecke eingesetzt werden. Auf den folgenden Seiten werden gängige Einsatzszenarien mit Schritt-für-Schritt-Anleitungen erläutert. Es ist jedoch zu beachten, dass Einstellungen ggf. individuell angepasst und getestet werden müssen
*[[Kursanmeldung (JACK3)|Kursanmeldung]] - Reines Anmeldesystem ohne Aufgaben, z.B. für die Anmeldung zu einer mündlichen Prüfung.
*[[Übungskurs erstellen (JACK3)|Übungskurs]] - Übungsaufgaben, um Inhalte aus der Vorlesung zu üben.
*[[Prüfung erstellen (JACK3)|Prüfung]] - Prüfung oder Klausur mit JACK3 erstellen.

==Statistiken / Prüfungsergebnisse==
Beschreibung der Einsicht in die Bearbeitungen von den Studierenden.
*<span style="color:#f257ff;font-weight:bold;">[NEU!]</span> [[Korrekturworkflow (JACK3)|Korrekturworkflow]]
*[[Einsicht in Ergebnisse in Aufgaben (JACK3)|Ergebnisse ansehen in Aufgaben]]
*[[Manuelles Feedback (JACK3)|Manuelles Feedback]] - An jeder Einreichung einer Aufgabe und einer Kursbearbeitung kann das automatische Feedback von JACK und die vergebene Punktzahl überschrieben werden.
*[[Einsicht in Ergebnisse in Kursangeboten (JACK3)|Ergebnisse ansehen in Kursangeboten]]

==Anmeldeoptionen / Nutzer Verwaltung / Rechte Konzept==
*[[Kursangebot Einstellungen (JACK3)#Zugangsbeschränkung|Verlinkung von Kursen über den öffentlichen Link]]
* [[LTI Anbindung (JACK3)|Moodle Anbindung]] - Erklärung wie sich ein Kursangebot in JACK3 in einen Moodle Kurs einbinden lässt.
*[[Rechtekonzept (JACK3)|Rechtekonzept]] und [[Rechte bearbeiten (JACK3)|Rechte bearbeiten]] - Erklärung der verschiedenen Rechte in JACK3.
*[[Verwaltung (JACK3)|Verwaltung]] - Verwaltungsmöglichkeiten eines Admins.

==Import / Export==
*[[Inhalte exportieren (JACK3)|Inhalte exportieren]] - Es können nur Inhalte von [[Mein Arbeitsbereich (JACK3)|Mein Arbeitsbereich]] heruntergeladen werden.
*[[Aufgaben aus Jack2 importieren (JACK3)|Aufgaben aus JACK2 importieren]]
**[[Evaluator-Änderungen von JACK2 nach JACK3]]
*[[Inhalte importieren (JACK3)|Inhalte importieren]]
[[Kategorie:JACK3]]
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Hauptseiten]]

Korrekturworkflow (JACK3)

2026-05-21T13:24:22Z

LGlaser: Seite erstellt

Der '''Korrekturworkflow''' wurde mit Version 0.20 eingeführt. Diese Funktion unterstützt bei der Korrektur und anschließenden Freischaltung/Einsicht von Prüfungen/Klausuren („Bearbeitungen“) in JACK, insbesondere durch die Möglichkeit, eine große Menge von eingereichten Lösungen zu einer Aufgabe durchzusehen. Dies ist z. B. für offene Aufgaben hilfreich, die manuell korrigiert werden müssen.

Die Funktion gibt es in zwei unterschiedlichen Formen:

* Zum Durchsehen einer durchgeführten Klausur nach Aufgaben eignet sich der Workflow für '''(Aufgaben-)Bearbeitungen'''. Es wird eine Aufgabe oder Bearbeitung ausgewählt, anschließend kann man sich durch alle eingereichten Lösungen zu dieser Aufgabe durchklicken, [[Manuelles Feedback (JACK3)|manuelles Feedback]] hinzufügen und die entsprechenden Aufgaben als „''geprüft''“ markieren.
* Die Ansicht nach '''Kursbearbeitungen / Kursteilnahmen''' (eine Kursteilnahme entspricht bei Prüfungen i. d. R. einem Studierenden bzw. analog einer abgegebenen Klausur) ist die zweite Option. Hier geht man nacheinander durch alle Kursteilnahmen durch und kann diese zur Ansicht „''freischalten''“, um z. B. eine Einsicht zu ermöglichen.

Beide Formen können gemeinsam, aber auch unabhängig voneinander genutzt werden. Es ist bspw. möglich, den Workflow ausschließlich dazu zu nutzen, um Aufgaben nachzukorrigieren ohne Kursbearbeitungen freizuschalten.

Ein '''typischer Ablauf''' könnte wie folgt aussehen:

* Zunächst wird eine Prüfung mit JACK durchgeführt, die die unten gezeigten Sichtbarkeitseinstellungen hat, d. h. Studierende können die Ergebnisse erst nach manueller Freischaltung sehen.
* Die Prüfung wird aufgabenweise korrigiert, z. B. indem jede korrigierende Person zu einer Aufgabe zugewiesen wird. Alternativ mithilfe der Positionsanzeige: Die erste Position korrigiert die Bearbeitungen 1–50, die nächste Person 51–100, usw. Es wird pro Bearbeitung zunächst die automatische Bewertung durch JACK überprüft und ggf. mit manuellem Feedback überschrieben (im Falle von falschen Bewertungen, internen Fehlern oder ausschließlich manuell zu korrigierenden Aufgaben), anschließend wird die Bearbeitung direkt oder von einem Dritten (z. B. einem Zweitprüfer) als „geprüft“ markiert.
* Zum Zeitpunkt einer Einsicht werden Kursbearbeitungen individuell für die jeweiligen Studierenden zur Ansicht freigeschaltet und nach der Einsicht wieder deaktiviert.

== Einstellungen im Kursangebot ==
''→ Siehe auch: [[Kursangebot Einstellungen (JACK3)#Einstellungen im Kursangebot|Einstellungen in einem Kursangebot]]''

Die Funktion kann über die Einstellung ''Korrekturworkflow aktivieren'' pro Kursangebot aktiviert werden. Dies schaltet in den Einstellungen zu einem Kursangebot folgende Elemente frei:
* Option, was Studierende ''Nach manueller Freischaltung'' sehen dürfen
* Fortschrittsanzeige mit den geprüften bzw. freigeschalteten Bearbeitungen
* Die ''Korrekturübersicht'' als Startpunkt für den Korrekturworkflow
<gallery widths="500" heights="265">
Datei:Korrekturworkflow Einstellungen.png|Beispiel für Sichtbarkeitseinstellungen: Ergebnisse sind erst nach einer Freischaltung (pro Studierendem) sichtbar.
Datei:Korrekturworkflow Status.png|Statusanzeige für den Korrekturworkflow am unteren Ende der Kursangebot-Einstellungen.
</gallery>

== Korrekturübersicht ==
Auf der Seite zur '''Korrekturübersicht''' befinden sich eine detaillierte Statusanzeige und die von anderen Seiten bekannten Ergebnistabellen.<gallery widths="500" heights="150">
Datei:Korrekturworkflow Status Details.png|Detaillierte Fortschrittsanzeige für Aufgaben- (1) und Kursbearbeitungen (3) mit der Möglichkeit, den Workflow zu starten und direkt in die erste Bearbeitung zu springen (2).
</gallery>Die Tabelle für Bearbeitungen (1) bietet die Möglichkeit der Mehrfachauswahl (3), um mehrere/alle Bearbeitungen als „geprüft“ zu markieren („Aktionen“), außerdem können Bearbeitungen u. a. nach Status (4) und Aufgabe (5) sortiert und gefiltert werden. Geprüfte Bearbeitungen werden mit einem grünen Haken markiert (4). Es besteht die Möglichkeit, aus der Ergebnistabelle direkt zu einer spezifischen Bearbeitung zu navigieren (6). Die Tabelle für Kursbearbeitungen (2) bietet ähnliche Funktionen, darunter die Option, mithilfe der Mehrfachauswahl mehrere/alle Kursbearbeitungen freizuschalten und diese nach aktuellem Status der Freischaltung zu filtern; die Freischaltung wird dabei mit einem grünen Auge gekennzeichnet (7). In der Titelleiste wird angezeigt, wie viele (Kurs-)Bearbeitungen noch nicht geprüft bzw. nicht freigeschaltet wurden (8).<gallery widths="500" heights="265">
Datei:Korrekturworkflow Aufgabenbearbeitung Übersicht.png|Tabelle mit „Bearbeitungen“ (erster Reiter)
Datei:Korrekturworkflow Kursbearbeitung Übersicht.png|Tabelle mit „Kursbearbeitungen“ (zweiter Reiter)
</gallery>

==Workflow für Bearbeitungen zu einzelnen Aufgaben==
''→ Siehe auch: [[Manuelles Feedback (JACK3)|Manuelles Feedback]]''

Auf der Detailseite zu einzelnen Aufgabenbearbeitungen gibt es folgende Elemente (Bild 1):

# Titelleiste mit der Möglichkeit, zur vorherigen/nächsten Bearbeitung zu dieser Aufgabe zu springen
# Einen Button, um die gesamte Bearbeitung zu (de-)markieren
# Eine Statusanzeige zur aktuell gewählten Aufgabe
# Die [[Einsicht in Ergebnisse in Aufgaben (JACK3)|bekannte Detailansicht]] zur bearbeiteten Aufgabe inklusive aller Teilaufgaben
# Pro Teilaufgabe einen Button, um diese Teilaufgabe zu markieren. Sind alle Teilaufgaben als „geprüft“ markiert, wird automatisch die gesamte Bearbeitung markiert.
# Die Möglichkeit, zu anderen eingereichten Aufgaben des Studierenden zu springen

Aufgabenteile, die manuell bewertet werden müssen (darunter zählen Freitextaufgaben, Bild 2), können erst als „geprüft“ markiert werden (1), wenn ein [[Manuelles Feedback (JACK3)|manuelles Feedback]] (2) mit mindestens einer vergebenen Punktzahl (3) vorliegt.<gallery widths="500" heights="600">
Datei:Korrekturworkflow Aufgabenbearbeitung Details 1.png|Detailansicht zu einer Aufgabenbearbeitung
Datei:Korrekturworkflow Aufgabenbearbeitung Details 2.png|Detailansicht zu einer Aufgabenbearbeitung mit einem manuell bewerteten und geprüften Freitext-Aufgabenteil
</gallery>

==Workflow für Kursbearbeitungen==
Auf der Detailseite zu einzelnen Kursbearbeitungen gibt es zusätzlich zur bekannten Detailansicht die Möglichkeit, zur vorherigen/nächsten Kursbearbeitung zu springen (1), außerdem können Kursbearbeitungen freigeschaltet werden bzw. die Freigabe wieder entzogen werden (2). Ist eine Kursbearbeitung nicht freigeschaltet, bestimmt sich das, was Studierende sehen dürfen, aus den Einstellungen ''Nach individueller Beendigung des Kurses'' bzw. ''Nachdem die Bearbeitung für alle geendet hat''. Ist sie freigeschaltet, bestimmt sich dies aus der Einstellung ''Nach manueller Freischaltung''.<gallery widths="500" heights="600">
Datei:Korrekturworkflow Kursbearbeitung Details.png|Detailansicht zu einer Kursbearbeitung
</gallery>

== Studierendensicht ==
Für Studierende ist der Status des Workflows, insb. die Prüf-Markierung von Aufgabenteilen, nicht sichtbar, lediglich die Auswirkungen von durchgeführten Aktionen:

* Manuelles Feedback oder eine gesetzte Punktzahl wird je nach Einstellungen im Kursangebot angezeigt.
* Die Sichtbarkeitseinstellungen ''Nach manueller Freischaltung'' (s.o.) bestimmen, was Studierende sehen, wenn die Kursbearbeitung freigeschaltet wurde (grünes Auge).
<gallery widths="600" heights="400">
Datei:Korrekturworkflow Student nicht freigeschaltet.png|Die Kursbearbeitung des jeweiligen Studierenden wurde noch nicht freigeschaltet. Nur die Liste an Aufgaben und die erreichbaren Punktzahlen sind sichtbar (gemäß der Einstellung ''Nach individueller Beendigung'').
Datei:Korrekturworkflow Student freigeschaltet.png|Die Kursbearbeitung des jeweiligen Studierenden wurde freigeschaltet. Nun sind auch die gemachten Eingaben und die erreichte Punktzahl sichtbar (gemäß der Einstellung ''Nach manueller Freischaltung'').
</gallery>

[[Kategorie:JACK3]]
[[Kategorie:Benutzerhandbuch]]

Datei:Korrekturworkflow Student nicht freigeschaltet.png

2026-05-20T17:51:18Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Student freigeschaltet.png

2026-05-20T17:51:16Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Status.png

2026-05-20T17:51:14Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Status Details.png

2026-05-20T17:51:12Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Kursbearbeitung Übersicht.png

2026-05-20T17:51:11Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Kursbearbeitung Details.png

2026-05-20T17:51:09Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Einstellungen.png

2026-05-20T17:51:08Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Aufgabenbearbeitung Übersicht.png

2026-05-20T17:51:01Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Aufgabenbearbeitung Details 2.png

2026-05-20T17:50:59Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Aufgabenbearbeitung Details 1.png

2026-05-20T17:50:58Z

LGlaser: cat

[[Kategorie:JACK3]]

Datei:Korrekturworkflow Student nicht freigeschaltet.png

2026-05-20T17:44:30Z

LGlaser:

Datei:Korrekturworkflow Student freigeschaltet.png

2026-05-20T17:44:28Z

LGlaser:

Datei:Korrekturworkflow Status.png

2026-05-20T17:44:24Z

LGlaser:

Datei:Korrekturworkflow Status Details.png

2026-05-20T17:44:21Z

LGlaser:

Datei:Korrekturworkflow Kursbearbeitung Übersicht.png

2026-05-20T17:43:38Z

LGlaser:

Datei:Korrekturworkflow Kursbearbeitung Details.png

2026-05-20T17:42:32Z

LGlaser:

Datei:Korrekturworkflow Einstellungen.png

2026-05-20T17:41:46Z

LGlaser:

Datei:Korrekturworkflow Aufgabenbearbeitung Übersicht.png

2026-05-20T17:41:16Z

LGlaser:

Datei:Korrekturworkflow Aufgabenbearbeitung Details 2.png

2026-05-20T17:40:44Z

LGlaser:

Datei:Korrekturworkflow Aufgabenbearbeitung Details 1.png

2026-05-20T17:39:54Z

LGlaser:

IEEERemainder

2026-05-20T10:11:23Z

LGlaser: LaTeX ergänzt

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''iEEERemainder'' berechnet die Remainder-Operation zweier Argumente, wie es in dem IEEE 745 Standard beschrieben ist (vgl. [https://doi.org/10.1109/IEEESTD.2019.8766229 IEEE 754-2019, S. 31], [https://de.wikipedia.org/wiki/IEEE_754#Arithmetik_und_Quadratwurzel Wikipedia]). Die Funktion erwartet zwei Zahlen und gibt das Ergebnis von

$f_{1} - (f_{2} \cdot \text{round}(\frac{f_{1}}{f_{2}}))$

zurück.

=== Syntax ===
iEEERemainder([[Gleitkommazahl]] f1, [[Gleitkommazahl]] f2)

=== Parameter ===
* '''f1''' - Zähler
* '''f2''' - Nenner

=== Return Value ===
* Gibt das gerundete Ergebnis von $f_{1} - (f_{2} \cdot Q)$ zurück. Q ist dabei das gerundete Ergebnis von $f_{1}/f_{2}$. '''Hinweis''': Wenn $f_{1}/f_{2}$ genau zwischen zwei ganzen Zahlen liegt, wird die gerade ganze Zahl zurückgegeben ([https://de.wikipedia.org/wiki/Rundung#Symmetrisches_Runden symmetrisches Runden]).
* Wenn das Ergebnis gleich 0 ist, wird bei positivem $f_{1}$ <code>+0</code> und bei negativem $f_{1}$ <code>-0</code> zurückgegeben.
* Wenn $f_{2}$ gleich 0 ist, wird NaN zurückgegeben.

===Unterschied zu Modulo===
Beide geben den Rest nach der Division zurück, verwenden aber unterschiedliche Formeln:

iEEERemainder = dividend - (divisor * Math.Round(dividend / divisor))

Modulo = (Math.Abs(dividend) - (Math.Abs(divisor) * (Math.Floor(Math.Abs(dividend) / Math.Abs(divisor))))) * Math.Sign(dividend)

Beispiel:

3/2 iEEERemainder-->returns -1 Modulo-->returns 1
11/3 iEEERemainder-->returns -1 Modulo-->returns 2
28/5 iEEERemainder-->returns -2 Modulo-->returns 3

=== Beispiele ===
==== Standardfälle ====
iEEERemainder(4,2) --> returns 0
iEEERemainder(3,2) --> returns -1
iEEERemainder(27,4) --> returns -1
iEEERemainder(17.8,4) --> returns 1.8

==== Benutzung mit Variablen ====
iEEERemainder([var=a],[var=b])

==== Benutzung mit studentischen Eingaben ====
'''Jack2:'''
iEEERemainder([pos=1],[pos=2])

'''Jack3:'''
iEEERemainder([input=field1],[input=field2])

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:JACK3]]

IEEERemainder

2026-05-19T12:23:41Z

LGlaser: ‎Hinweis zum Runden

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''iEEERemainder'' berechnet die Remainder-Operation zweier Argumente, wie es in dem IEEE 745 Standard beschrieben ist [https://de.wikipedia.org/wiki/IEEE_754#Aritmetik_und_Quadratwurzel]. Die Funktion erwartet zwei Zahlen und gibt das Ergebnis von
f1-(f2* Math.Round(f1/f2))
zurück.

=== Syntax ===
iEEERemainder([[Gleitkommazahl]] f1, [[Gleitkommazahl]] f2)

=== Parameter ===
* '''f1''' - Zähler
* '''f2''' - Nenner

=== Return Value ===
* Gibt das gerundete Ergebnis von f1-(f2*Q) zurück. Q ist dabei das gerundete Ergebnis von f1/f2. '''Hinweis''': Wenn f1/f2 genau zwischen zwei ganzen Zahlen liegt, wird die gerade ganze Zahl zurückgegeben ([https://de.wikipedia.org/wiki/Rundung#Symmetrisches_Runden symmetrisches Runden]).
* Wenn f1-(f2*Q) gleich 0 ist, wird bei positivem f1 ''+0'' und bei negativem f1 ''-0'' zurückgegeben.
* Wenn f2 gleich 0 ist, wird NaN zurückgegeben.

===Unterschied zu Modulo===
Beide geben den Rest nach der Division zurück, verwenden aber unterschiedliche Formeln:

iEEERemainder = dividend -(divisor * Math.Round(dividend / divisor))

Modulo = (Math.Abs(dividend) - (Math.Abs(divisor) * (Math.Floor(Math.Abs(dividend) / Math.Abs(divisor))))) * Math.Sign(dividend)

Beispiel:

3/2 iEEERemainder-->returns -1 Modulo-->returns 1
11/3 iEEERemainder-->returns -1 Modulo-->returns 2
28/5 iEEERemainder-->returns -2 Modulo-->returns 3

=== Beispiele ===
==== Standardfälle ====
iEEERemainder(4,2) --> returns 0
iEEERemainder(3,2) --> returns -1
iEEERemainder(27,4) --> returns -1
iEEERemainder(17.8,4) --> returns 1.8

==== Benutzung mit Variablen ====
iEEERemainder([var=a],[var=b])

==== Benutzung mit studentischen Eingaben ====
'''Jack2:'''
iEEERemainder([pos=1],[pos=2])

'''Jack3:'''
iEEERemainder([input=field1],[input=field2])

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:JACK3]]

RoundCommercial

2026-05-19T12:17:57Z

LGlaser:

{{Navigation/Rundungsfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''roundCommercial'' rundet eine Gleitkommazahl an der angegebenen Nachkommerstelle, wobei das kaufmännische Rundungsverfahren (round-half-away-from-zero) angewendet wird. Standardmäßig rundet die Funktion auf die nächstgelegene Ganzzahl.
Die Funktion erwartet eine Gleitkommazahl, die gerundet werden soll, sowie eine optionale Ganzzahl, die die Nachkommastelle angibt auf die gerundet werden soll.

{{Hinweis|Die Funktion wendet das [https://de.wikipedia.org/wiki/Rundung#Kaufm%C3%A4nnisches_Runden kaufmännische Runden] (''Round half away from Zero'') an. Zahlen, die genau in der Mitte liegen, werden aufgerundet, negative Zahlen werden nach ihrem Betrag gerundet. Für [https://de.wikipedia.org/wiki/Rundung#Symmetrisches_Runden symmetrisches Runden] siehe [[Round]].|Achtung}}

=== Syntax ===
roundCommercial([[Gleitkommazahl]] zahl, [[Ganzzahl]] index)

=== Parameter ===
* '''zahl''' - die zu rundene Zahl
* '''index''' - die Nachkommastelle - (default = 0)

=== Return Value ===
*Gibt die gerundete Gleitkommazahl zurück

=== Beispiele ===
==== Standardfälle ====
roundCommercial(1.25, 1) --> 1.3
roundCommercial(15.678) --> 16.0
roundCommercial(-4.555, 1) --> -4.6
roundCommercial(3.14149, 3) --> 3.141

round(6.5) --> 7.0 (kaufmännisches Runden)
round(5.5) --> 6.0 (kaufmännisches Runden)
round(0.625, 2) --> 0.63 (kaufmännisches Runden)

=== Hinweise ===
* Weitere Funktionen zum Thema runden sind [[ceil]], [[floor]], [[round]] und [[rint]].
* Der Unterschied zu [[round]] besteht darin, dass roundCommercial kaufmännisch rundet.
* Beim Runden wird nur auf die Stelle direkt nach der Stelle geachtet, auf die gerundet werden soll. Also bei <code>roundCommercial(3.14149,3)</code> wird nur die vierte Nachkommastelle <code>4</code> betrachtet, die fünfte <code>9</code> spielt keine Rolle.

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK3]]

Round

2026-05-19T12:17:20Z

LGlaser: Hinweise zum Runden

{{Navigation/Rundungsfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''round'' rundet eine Gleitkommazahl zu einer Ganzzahl. Die Funktion erwartet eine Zahl und gibt die nächst gelegene Ganzzahl zurück.

Alternativ kann die Funktion ''round'' eine Gleitkommazahl auf eine bestimmt Nachkommastelle runden. Das zweite optionale Argument gibt die Nachkommastelle an. 0 entspricht einem Aufruf ohne zweitem Parameter.

{{Hinweis|Die Funktion wendet das [https://de.wikipedia.org/wiki/Rundung#Symmetrisches_Runden symmetrische Runden] (''Round half to even'', auch bekannt als ''Banker’s Rounding'') an. Zahlen, die genau in der Mitte liegen, werden so gerundet, dass die letzte Ziffer gerade wird (siehe Beispiele). Für [https://de.wikipedia.org/wiki/Rundung#Kaufm%C3%A4nnisches_Runden kaufmännisches Runden] siehe [[RoundCommercial]].|Achtung}}

=== Syntax ===
round([[Gleitkommazahl]] zahl, [ [[Ganzzahl]] index ])

=== Parameter ===
* '''zahl''' - die zu rundene Zahl
* '''index''' - die Nachkommastelle - optional (default = 0)

=== Return Value ===
*Gibt die gerundete [[Ganzzahl]] zurück

=== Beispiele ===
==== Standardfälle ====
round(12.4) --> 12
round(15.678) --> 16
round(15.678, 2) --> 15.68
round(3.21, 2) --> 3.21
round(3.1, 0) --> 3
round(27/4, 2) --> 6.75

round(6.5) --> 6 (symmetrisches Runden)
round(5.5) --> 6 (symmetrisches Runden)
round(0.625, 2) --> 0.62 (symmetrisches Runden)
round(0.635, 2) --> 0.64
round(10:16, 2) --> 0.62
round(10/16, 2) --> 0.62
round(0.625, 1) --> 0.6
round(0.625) --> 1
round(0.555, 2) --> 0.56

==== Benutzung mit Variablen ====
round([var=a])

round([var=a], [var=b])

==== Benutzung mit studentischen Eingaben ====

round([input=field1])

=== Hinweise ===
* Die Funktion kann auch genutzt werden, um aus einem Bruch eine Dezimalzahl zu erzeugen.
* Weitere Funktionen zum Thema runden sind [[ceil]], [[floor]] und [[rint]].

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK2]][[Kategorie:JACK3]]

RoundCommercial

2026-05-19T12:17:08Z

LGlaser: Hinweise zum Runden

{{Navigation/Rundungsfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''roundCommercial'' rundet eine Gleitkommazahl an der angegebenen Nachkommerstelle, wobei das kaufmännische Rundungsverfahren (round-half-away-from-zero) angewendet wird. Standardmäßig rundet die Funktion auf die nächstgelegene Ganzzahl.
Die Funktion erwartet eine Gleitkommazahl, die gerundet werden soll, sowie eine optionale Ganzzahl, die die Nachkommastelle angibt auf die gerundet werden soll.

{{Hinweis|Die Funktion wendet das [https://de.wikipedia.org/wiki/Rundung#Kaufm%C3%A4nnisches_Runden kaufmännische Runden] (''Round half away from Zero'') an. Zahlen, die genau in der Mitte liegen, werden aufgerundet, negative Zahlen werden nach ihrem Betrag gerundet. Für [https://de.wikipedia.org/wiki/Rundung#Symmetrisches_Runden symmetrisches Runden] siehe [[Round]].|Achtung}}

=== Syntax ===
roundCommercial([[Gleitkommazahl]] zahl, [[Ganzzahl]] index)

=== Parameter ===
* '''zahl''' - die zu rundene Zahl
* '''index''' - die Nachkommastelle - (default = 0)

=== Return Value ===
*Gibt die gerundete Gleitkommazahl zurück

=== Beispiele ===
==== Standardfälle ====
roundCommercial(1.25, 1) --> 1.3
roundCommercial(15.678) --> 16.0
roundCommercial(-4.555, 1) --> -4.6
roundCommercial(3.14149, 3) --> 3.141

round(6.5) --> 7 (kaufmännisches Runden)
round(5.5) --> 6 (kaufmännisches Runden)
round(0.625, 2) --> 0.63 (kaufmännisches Runden)

=== Hinweise ===
* Weitere Funktionen zum Thema runden sind [[ceil]], [[floor]], [[round]] und [[rint]].
* Der Unterschied zu [[round]] besteht darin, dass roundCommercial kaufmännisch rundet.
* Beim Runden wird nur auf die Stelle direkt nach der Stelle geachtet, auf die gerundet werden soll. Also bei <code>roundCommercial(3.14149,3)</code> wird nur die vierte Nachkommastelle <code>4</code> betrachtet, die fünfte <code>9</code> spielt keine Rolle.

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK3]]

RoundCommercial

2026-05-13T11:15:18Z

LGlaser: Navigationsvorlage hinzugefügt

{{Navigation/Rundungsfunktionen}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''roundCommercial'' rundet eine Gleitkommazahl an der angegebenen Nachkommerstelle, wobei das kaufmännische Rundungsverfahren (round-half-away-from-zero) angewendet wird. Standardmäßig rundet die Funktion auf die nächstgelegene Ganzzahl.
Die Funktion erwartet eine Gleitkommazahl, die gerundet werden soll, sowie eine optionale Ganzzahl, die die Nachkommastelle angibt auf die gerundet werden soll.

=== Syntax ===
roundCommercial([[Gleitkommazahl]] zahl, [[Ganzzahl]] index)

=== Parameter ===
* '''zahl''' - die zu rundene Zahl
* '''index''' - die Nachkommastelle - (default = 0)

=== Return Value ===
*Gibt die gerundete Gleitkommazahl zurück

=== Beispiele ===
==== Standardfälle ====
roundCommercial(1.25, 1) --> returns 1.3

roundCommercial(15.678) --> returns 16.0

roundCommercial(-4.555, 1) --> returns -4.6

roundCommercial(3.14149, 3) --> returns 3.141

=== Hinweise ===
* Weitere Funktionen zum Thema runden sind [[ceil]], [[floor]], [[round]] und [[rint]].
* Der Unterschied zu [[round]] besteht darin, dass roundCommercial kaufmännisch rundet.
* Beim Runden wird nur auf die Stelle direkt nach der Stelle geachtet, auf die gerundet werden soll. Also bei <code>roundCommercial(3.14149,3)</code> wird nur die vierte Nachkommastelle <code>4</code> betrachtet, die fünfte <code>9</code> spielt keine Rolle.

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Operator]][[Kategorie:JACK3]]

Vorlage:Navigation/Rundungsfunktionen

2026-05-13T11:14:49Z

LGlaser: RoundCommercial hinzugefügt

<onlyinclude>{{Navigation
| TITEL = Rundungsfunktionen
| INHALT =
[[Round]] •
[[RoundCommercial]] •
[[Rint]] •
[[Ceil]] •
[[Floor]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Rundungsfunktionen]]

TracingChecker

2026-05-06T13:24:01Z

LGlaser: Hinweis auf Java-Version

{{Hinweis|Der Checker unterstützt aktuell Programmiercode bis Java 17 inklusive der Standardbibliothek des offiziellen Java 17-JDKs.}}Der TracingChecker führt dynamische Tests auf Java Programmcode aus, die dem Prinzip von Unit-Tests folgen. Es müssen daher die zu prüfenden Dateien (“Source files”) sowie ein Testtreiber (“Test driver”) angegeben werden. Im Eintrag “Classes to trace” kann zudem eine kommaseparierte Liste von Klassennamen angegeben werden, für die während der Testausführung ein Trace erzeugt werden soll. Jeder ausgeführte Programmschritt in diesen Klassen wird dann in den Trace aufgenommen.

=== Beispiel einer Testklasse ===

Die Test-Klasse muss dem Grundgerüst des folgenden Programmcodes folgen.

<syntaxhighlight lang="java" line='line'>
import de.uni_due.s3.jack2.backend.checkers.tracingchecker.framework.TracingFramework;
import de.uni_due.s3.jack2.backend.checkers.tracingchecker.framework.TracingFramework.Test;

public class DemoprojektDynamisch {

private int punkte = 0;

public int getResult() {
return punkte;
}

@Test(name="Test 1")
public void test1() {

Demoprojekt p = new Demoprojekt();

float faktor1 = p.faktor("Andre", 36, 4, 10);
float result1 = p.betrag(faktor1, 50000);

if (result1 < 3207.78f || result1 > 3207.79f){
if (faktor1 < 6.41f || faktor1 > 6.42f) {
TracingFramework.printError("Falsches Ergebnis und falscher Faktor!");
} else {
TracingFramework.printError("Falsches Ergebnis, aber richtiger Faktor!");
punkte += 20;
}
} else {
punkte += 50;
}
}

@Test(name="Test 2")
public void test2() {
// ...
}
}
</syntaxhighlight>

Die Klasse importiert das Tracing-Framework von JACK, das in der Datei “''jack-tracing-framework.jar''” bereitgestellt wird (Zeile 1 und 2). Die einzige Methode, die ein Testtreiber in jedem Fall anbieten muss, ist die Methode <code>getResult()</code>, die die erreichte Punktzahl von 0 bis 100 Punkten als Ganzzahl zurück gibt (Zeile 8-10). Zusätzlich kann der Testtreiber beliebig viele weitere, beliebig komplexe Methoden enthalten, die mit der Annotation @Test(name=“<Name_des_Testfalls>”) versehen werden (Zeile 12 und 32). Ist vor dem Start des gesamte dynamischen Tests eine einmalige Initialisierung notwendig, kann eine Methode <code>init()</code> ergänzt werden. Die Deklaration von zusätzlichen Hilfsmethoden und
beliebigen Feldern ist zulässig.

Die Testmethoden werden in der Reihenfolge abgearbeitet, in der sie im Programmcode deklariert sind. Sie führen Aufrufe auf dem zu testenden Programmcode durch und vergleichen die Rückgaben mit den erwarteten Werten. Zur Erzeugung einer textuellen Rückmeldung an die Studierenden stellt das Tracing-Framework die Methode <code>TracingFramework.printError(“<Meldung>”)</code> bereit (Zeile 22 und 24). Wird eine solche Zeile erreicht, führt dies im Fehlerbericht von JACK zu einer Ausgabe der Form “Fehler in <Name_des_Testfalls>: <Meldung>”. Die Ausführung der Testmethode wird danach weiter fortgesetzt, d.h. eine Testmethode kann mehrere Meldungen erzeugen. Jede Meldung wird automatisch um einen Trace ergänzt, der die ausgeführten Programmschritte seit dem Start der Testmethode bis zur Erzeugung der Fehlermeldung erhält. Analog zur Erzeugung von Fehlermeldungen steht auch eine Methode <code>TracingFramework.printWarning(“<Meldung>”)</code> zur Verfügung. Diese erzeugt Ausgaben der Form “Warnung in <Name_des_Testfalls>: <Meldung>”. Treten während der Ausführung eines Testfalls Exceptions im geprüften Programmcode auf, führt dies automatisch zu einer Ausgabe der Form “Fehler in <Name_des_Testfalls>: <Beschreibung_der_Exception>". In diesem Fall wird die Ausführung der Testmethode abgebrochen und der dynamische Test mit dem Aufruf der nächsten Testmethode fortgesetzt. Auch bei einer Exception wird die Meldung um einen Trace ergänzt. Tritt hingegen eine Exception im Testtreiber auf, führt diese zu einem Abbruch des gesamten dynamischen Tests. Es wird keine Punktzahl vergeben, sondern die Lösung wird stattdessen mit einem “internal error” markiert. Die aufgetretene Exception wird als interne Fehlernachricht ausgegeben.Das Erzeugen der Traces zum Programmablauf führt zu einer signifikant verlängerten Laufzeit für die zu testenden Programme. Um den Server nicht zu lange mit einem einzelnen Test zu blockieren, ist die Erzeugung von Traces daher auf eine Länge von 500 Schritten begrenzt. Das Programm wird nach erreichen dieser Grenze weiter ausgeführt, aber es wird kein Trace mehr dazu aufgezeichnet. Die Traceaufzeichnung kann gezielter gesteuert werden, indem die Aufrufe <code>TracingFramework.switchOffTracing()</code> und <code>TracingFramework.switchOnTracing()</code> verwendet werden. Damit kann für Abschnitte eines Testfalls das zeitaufwändige Tracing abgeschaltet und später wieder eingeschaltet werden. Die Ein-/Ausschaltung gilt immer nur pro Testfall. Insbesondere beginnt jeder Testfall standardmäßig mit eingeschaltetem Tracing.

Schreibt der geprüfte Programmcode während der Testausführung Ausgaben auf die Standardausgabe, werden diese unabhängig von den einzelnen Testfällen gespeichert und als zusätzliche Information in der Web-Oberfläche von JACK mit ausgegeben. Eine automatische inhaltliche Auswertung der Ausgaben ist nicht möglich.

[[category:Checker]]

GReQLJavaChecker

2026-05-06T13:23:50Z

LGlaser: Hinweis auf Java-Version

{{Hinweis|Der Checker unterstützt aktuell Programmiercode bis Java 17. Syntaxelemente im eingereichten Code, die darüber hinausgehen, führen zu einem Kompilierungsfehler.}}

Der GReQLJavaChecker ermöglicht statische Checks auf Programmcode und verwendet dazu Abfragen auf dem Syntaxgraphen. Um einen statischen Check mit dem Checker durchzuführen, müssen die zu untersuchenden Dateien in der Liste "Source Files" ausgewählt werden und eine einzelne Datei mit Prüfregeln ("Rule File") angegeben werden. Die Regeln werden in dieser Datei im XML-Format organisiert und verwenden die Sprache GReQL für Abfragen auf dem Syntaxbaum.

=== Beispiele und Eigenschaften von Regeln ===
Als erstes Element im XML Dokument muss <checkerrules> stehen, entsprechend muss </checkerrules> als letztes Element in dem XML Dokument sein.

Zwei beispielhafte Abfragen in dieser Sprache sehen so aus:

<syntaxhighlight lang="xml" line='line'>
<rule type="absence" points="2">
<query>from u : V{CompilationUnit}, x : V{WhileStatement} with
not isEmpty(u -->* x -->{WhileStatementBody}&{EmptyStatement}) or
(not isEmpty(u -->* x -->{WhileStatementBody}&{Block}) and
isEmpty(u -->* x -->{WhileStatementBody}&{Block} -->{Child}))
report u.name as "name", x.line as "line" end</query>
<feedback>In der Datei {name} besteht die while-Schleife in Zeile {line} nur aus einer
Abbruchbedingung und ist dadurch sinnlos.</feedback>
</rule>
</syntaxhighlight>

<syntaxhighlight lang="xml" line='line'>
<rule type="presence" points="4">
<query>from t : V{TypeDeclaration}, m : V{MethodDeclaration} with
t.name="Miniprojekt2" and
t -->{TypeDeclarationBodyDeclarations2} m and
hasSignature(m, "public static String geometrie1(int)")
report 0 end</query>
<feedback prefix="Signaturcheck">Die Methode "public static String geometrie1(int laenge)" in
der Klasse "Miniprojekt2" fehlt. Hast du die vorgegebene Methodensignatur veraendert?</feedback>
</rule>
</syntaxhighlight>

Die obere Regel ist vom Typ "absence", d.h. sie definiert einen Codestruktur, die nicht in der untersuchten Lösung vorkommen soll. Als Abfrage wird eine Struktur aus Elementen des Syntaxbaums definiert. Als Meldung wird ein String definiert, der zur Fehlerliste hinzugefügt wird, wenn die in der Abfrage definierte Struktur gefunden wird. Dabei dienen {name} und {line} als Platzhalter für Werte, die in der Abfrage in der report-Klausel ausgegeben wurden. Die zweite Regel ist vom Typ "presence" und definiert folglich eine Codestruktur, die in der untersuchten Lösung vorkommen soll. D.h., in diesem Fall wird die definierte Fehlermeldung ausgegeben, wenn die in der Abfrage definierte Struktur nicht auftritt. Folglich können in dieser Regel auch keine Platzhalter in der Ausgabe verwendet werden.

''→ Details zu den verwendeten GReQL-Bezeichnern:'' [[GReQL-Typegraph für Java]]

Die Funktion <code>hasSignature</code> ist eine spezielle, von JACK bereitgestellte Erweiterung der GReQL-Syntax, die eine bequeme Überprüfung von Methodensignaturen ermöglicht. Wie im Beispiel dargestellt, braucht die übergebene Zeichenkette keine vollständige Methodensignatur zu sein, sondern es reicht die Angabe der zu überprüfenden Bestandteile. D.h., Namen der Methodenparameter können ebenso entfallen wie Modifier oder der Rückgabetyp. Es ist allerdings nicht möglich, nur Modifier anzugeben und keinen Rückgabetyp.

''→ Weitere Beispiele:'' [[GReQL Regeln]]

=== Auswertung eines Regelsatzes ===
Bei der Durchführung des statischen Checks wird zunächst der abstrakte Syntaxgraph der abgegebenen Lösung erzeugt und anschließend alle Regeln angewendet. Alle erzeugten Fehlernachrichten werden als Ausgabe des statischen Tests gesammelt. Die vergebene Punktzahl ergibt sich aus den Punkten der einzelnen Regeln, wobei die Gesamtsumme der Punkte in der Regeldatei stets auf 100 normiert wird. D.h., im oben gezeigten Beispiel erhält eine korrekte Lösung 100 Punkte, während eine Lösung, die die erste Regel verletzt, nur 67 Punkte erhält. Tritt während des Checks ein technischer Fehler auf, wird der Check abgebrochen und die Lösung mit einem "internal error" als fehlerhaft markiert.

=== Versionsunterschiede ===
Je nach eingesetzter Checker-Version müssen einige Abfragen zur Code-Struktur leicht unterschiedlich formuliert werden. Dies betrifft insbesondere die beiden Checker-Versionen, die in JACK 2 und JACK 3 zum Einsatz kommen.

{| class="wikitable"
|-
! Art der Änderung !! Alt (insb. JACK 2) !! Neu (insb. JACK 3 und Moodle-Plugin)
|-
| Geänderter Kantentyp || <code>TypeDeclarationBodyDeclarations2</code> || <code>TypeDeclarationBodyDeclarations1</code>
|-
| Geänderter Kantentyp || <code>TypeDeclarationSuperclassType2</code> || <code>TypeDeclarationSuperclassType</code>
|-
| Geänderter Kantentyp || <code>ParameterizedTypeTypeArguments1</code><br><code>ParameterizedTypeTypeArguments2</code> || <code>ParameterizedTypeTypeArguments</code>
|-
| Geänderter Kantentyp || <code>TypeDeclarationSuperInterfaceTypes1</code><br><code>TypeDeclarationSuperInterfaceTypes2</code> || <code>TypeDeclarationSuperInterfaceTypes</code>
|-
| Erweiterte Funktion || Die Funktion <code>hasSignature</code> kann nicht auf geworfene Exceptions prüfen || Die Prüfung ist möglich
|}

==Tools==
[[index.php?title=Medium:GReQL-Referencecard.pdf|GReQL-Referencecard]]

[[category:Checker]]

Dynamischer Python Checker (JACK3)

2026-04-28T06:40:58Z

LGlaser: Anleitung für statische Tests hinzugefügt

Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt werden. Diese können z. B. einen erwarteter Wert mit dem tatsächlichen Wert vergleichen. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces aufzeichnen (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Es lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback, programmiert in Python, erzeugen.

{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}

Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pandas.pydata.org/docs/user_guide/index.html pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

== Unterstützte Aufgabenstellungen ==
Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:

* Schreiben Sie eine parameterlose Funktion, die ... zurückgibt.
* Schreiben Sie eine Funktion, die ... erwartet und ... zurückgibt.
* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)

'''Beispiel''': ''Definieren Sie eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">
def add(a, b):
return a + b
</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

'''Statische Tests & Codeanalyse''': Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul für Syntaxbäume genutzt werden.

==Testtreiber für den Checker==
Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode as s

@Communicator.decorator
def testcase1():
# TODO so something with s ...
pass

@Communicator.decorator
def testcase2():
# TODO so something with s ...
pass

if __name__ == '__main__':
print('Running test case 1...')
testcase1()
print('Running test case 2 ...')
testcase2()
</syntaxhighlight>

===API zum Zurückmelden von Ergebnissen ===
Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
def printResult(result: int, feedback: str = None):
"""
Reports a result.

:param result: Points which are reported. Must be between 0 and 100 (both inclusive).
:param feedback: Optional Feedback presented to the user.
"""
pass
</syntaxhighlight>{{Wichtig|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}

===Schreiben von Testfällen===
Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.

Ein möglicher Testfall 1 für das obige Beispiel wäre dementsprechend:<syntaxhighlight lang="python3" line="1" start="5">
@Communicator.decorator
def testcase1():
try:
# Berechnen des Ergebnisses mit dem "studentcode":
result = s.add(1, 0)
# zu prüfender Ausdruck:
assert result == 1

# Bei Erfolg: +25 Punkte
Trace.printResult(25)
except Exception:
# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht
Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")
</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde. Zusätzlich wird die Variablenbelegung angezeigt und die ausgeführten Zeilen.

Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

In Situationen, bei denen die Punktevergabe von anderen Testfällen abhängig ist (z. B. wenn ausschließlich Punkte vergeben werden sollen, wenn statische Checks erfolgreich waren), kann diese Logik auch in einem einzigen Testfall untergebracht werden. Punktzahl und (ggf. konkatenierte) Feedback(s) müssen dann entsprechend vom Testfall zusammengesetzt werden.

=== Statische Tests===
Mithilfe des [https://docs.python.org/3.11/library/ast.html AST]-Moduls kann der eingereichte Code in einen Syntaxbaum geparst werden. Dieser Syntaxbaum lässt sich mithilfe von Python-Code prüfen. Der folgende Testfall prüft beispielsweise, ob im eingereichten Code Importe enthalten sind:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode
import math
import ast

@Communicator.decorator
def static_check():
# Parsen in Syntaxbaum
with open(studentcode.__file__, mode="r", encoding="utf-8") as f:
source_code = f.read()
tree = ast.parse(source_code)

# Über Syntaxbaum iterieren und Importe suchen
import_detected = None
for node in ast.walk(tree):
if isinstance(node, (ast.Import, ast.ImportFrom)):
import_detected = node.lineno
print(f"Import in line {import_detected}")

# Feedback erzeugen
error_feedback = None
if import_detected is not None:
error_feedback = f"In Zeile {import_detected} wurde ein Import erkannt. Die Lösung sollte ohne Importe auskommen."

# Rückmeldung
try:
assert (error_feedback is None)
Trace.printResult(40) # Statischer Test bestanden
except Exception:
Trace.printResult(0, error_feedback) # Statischer Test nicht bestanden

if __name__ == "__main__":
static_check()
</syntaxhighlight>Dieser Test könnte beliebig erweitert werden, z. B. for-/while-Schleifen suchen oder Rekursion prüfen, indem Funktionsaufrufe auf eine bestimmte Funktion gesucht werden. Es ist wichtig, dass Aufrufe von <code>ast.walk</code> nicht ineinander verschachtelt werden – stattdessen sollten Elemente, über die ein zweites Mal iteriert werden soll, zwischengespeichert werden.

==Ressourcen==
Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Medium:Tracing-Python-Checker-Dummy.zip|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

*<code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
*<code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
*<code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
*<code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).
{{Hinweis|Der Dummy arbeitet nicht exakt wie der Checker. Es gibt keine Garantie, dass Testtreiber, die mit dem Dummy funktionieren, auch genau so in JACK funktionieren. Testen Sie die Aufgabe deshalb immer auch in JACK!}}
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Checker]]

Python (JACK3)

2026-04-27T12:15:09Z

LGlaser: Schnellverweis zum Checker

''Siehe auch: [[Dynamischer Python Checker (JACK3)]]''

===Aufgabeninhalt===
In dem Bereich Aufgabeninhalt wird der Aufgabentext erstellt und spezifische Eingaben für den jeweiligen Aufgabenteil gemacht.
[[File:Aufgabentext.jpg|center|thumb|800px|Editor für den Aufgabentext]]
* '''Titel:''' Hier kann optional der Name des Aufgabenteils eingetragen werden.
* '''Aufgabentext:''' Im Aufgabentext steht die Aufgabenstellung. Der Editor für den Aufgabetext lässt sich öffnen in dem man reinklickt. In dem Fließtext kann Latex-Code verwendet werden, indem man diesen mit $-Zeichen einspannt. Der Editor bietet einige Formatierungen an wie z.B. fett, kursiv und unterstrichen. Einfache Tabellen können auch mithilfe des Editors erstellt werden. Wenn man den Button ''source code'' [[File:Icon-source_code.jpg|35px]] verwendet kann man HTML-Code nutzen. Über den Button '''Ressource Einfügen''' lässt sich ein hochgeladenes Bild oder ein Link in den Aufgabentext einfügen.

===Feedback===
* '''Gewichtung des Aufgabenteils:''' Gewichtung der Punktzahl eines Aufgabenteils innerhalb der Aufgabe.
* '''Verhalten bei internen Fehlern während der Überprüfung:''' Während der Überprüfung der studentischen Lösung können Fehler auftreten. Hier muss angegeben werden ob die '''Bearbeitung markiert und abgebrochen''' wird oder ob eine '''Nachricht ausgegeben und Bearbeitung fortgesetzt''' wird.
* '''Bewertungsverfahren:''' Hier lassen sich Checks definieren, die den eingereichten Code automatisch prüfen. Aktuell ist nur der [[Dynamischer Python Checker (JACK3)|'''dynamische Python Checker''']] verfügbar. Dieser führt Testfälle aus und zeichnet Traces auf.
** '''Gewichtung dieses Checks:''' Ein Python-Aufgabenteil kann mehrere Checks haben. Die Ergebnisse der Checks können unterschiedlich stark in der Gesamtbewertung einfließen.
** '''Timeout:''' Nach wie vielen Sekunden ein Check abbrechen soll.
** '''Module-Pfad für den studentischen Code:''' Name des Python-Moduls, das den eingereichten Code enthält. Diese Information muss beim Schreiben des Testtreibers berücksichtigt werden, um den passenden Import zu wählen. Dieses Feld muss ausgefüllt werden.
** Unter dem Modul-Pfad wird der '''Testtreiber''' für den dynamischen Test geschrieben. Siehe [[Dynamischer Python Checker (JACK3)]] für weitere Informationen.
* '''Feedback beim Überspringen:''' Der Lehrende kann jeden Python Aufgabenteil zum Überspringen anbieten. Dazu muss zunächst der Haken gesetzt werden. Danach gibt es noch die Möglichkeit einen Text den Lernenden anzuzeigen, wenn dieser diesen Aufgabenteil übersprungen hat. Den Text kann man durch Klicken in das Textfeld oder über das Icon [[File:Icon-Pencil.jpg|22px]] hinzufügen.
[[File:Python_Checker.JPG|center|thumb|800px|Einstellungen eines dynamischen Python-Checks]]

{{JACK3:Hinweise}}

===Verknüpfungen===
* '''Nächster Aufgabenteil (Standard):''' In dem Drop-Down Feld wird der nächste Zustand ausgewählt, in die die Aufgabe sein soll, wenn der Lernende eine Lösung eingereicht hat. Dieses wird immer dann durchgeführt, wenn keine andere Aktion zutrifft. Es gibt die folgenden Möglichkeiten:
** '''Nächster oder Ende:''' Dies ist die default Einstellung. Nach der studentischen Einreichung dieses Aufgabenteils wird der nächste Aufgabenteil in der Reihe angezeigt. Wenn dies der letzte Aufgabenteil dieser Aufgabe ist, ist die Aufgabe beendet.
** '''Ende der Aufgabe:''' Die Aufgabe ist mit der Aktion des Lernenden beendet.
** '''Aufgabenteil wiederholen:''' Der Aufgabenteil wird wiederholt. Der Lernende kann ein weiteres Ergebnis einreichen. Diese Aktion kann man z.B. bei Übungsaufgaben benutzen, wenn der Lernende eine Aufgabe solange wiederholen soll, bis das richtige Ergebnis eingereicht wurde.
** '''#x (x ist dabei ein beliebiger Aufgabenteil dieser Aufgabe):''' Der entsprechende Aufgabenteil wird als nächstes angezeigt. Wenn man die Aufgabenteilnummer des aktuellen Aufgabenteils wählt wird dieser Aufgabenteil neu aufgerufen.
* '''Nicht auf Feedback warten und sofort zum nächsten Aufgabenteil weiterschalten:''' Da Python-Checks je nach Anzahl der Testfälle und ihrer Komplexität länger dauern können, besteht die Möglichkeit, das Warten auf die Ergebnisse zu überspringen.
[[File:Verknuepfung_Java.JPG|center|thumb|800px|Verknüpfung mit anderen Aufgabenteilen]]
* '''Weitere nächste Aufgabenteile (optional):''' Hier kann die nächste Aktion dynamisch eingestellt werden, d.h. sie kann abhängig von der Variablen Konstelation sein oder von der Eingabe des Lernenden.
* '''Nächster Aufgabenteil beim Überspringen (optional):''' Hier wird eingestellt welcher nächste Aufgabenteil angezeigt werden soll, wenn der Lernende den Aufgabenteil übersprungen hat. Diese Einstellungsmöglichkeit steht nur zur Verfügung, wenn der Haken im Tab Feedback fürs Überspringen gesetzt wurde.

{{JACK3:Variablenupdates}}

{{JACK3:Dateien für Studierende}}

=== Variablen ===
Die folgenden [[Variablen (JACK3)|JACK-Variablen]] stehen für diesen Aufgabentyp zur Verfügung:

{| class="wikitable"
|-
! Name !! Beschreibung
|-
| <code>[input=code]</code>|| Der eingereichte Python-Code
|}

[[category:Benutzerhandbuch]]

Formeleditor Paletten (JACK3)

2026-04-07T08:40:02Z

LGlaser: LaTeX korrigiert

Die verschiedenen Paletten des [[Formeleditor (JACK3)|JACK3-Formeleditors]] sind in allen [[Fill-In (JACK3)|Fill-In Aufgaben]] einsetzbar. Hier werden die einzelnen Varianten charakterisiert.

== Mathematik-Paletten ==
{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Mathematik)'''
|
| Es wird keine Palette angezeigt. Eingegebene Formeln werden aber automatisch in die Anzeigeform des Formeleditors umgewandelt.
|-
|'''Einfach'''|| style="width: 60%" |<center>[[File:Formeleditor-Basic.jpg|130px]]</center>||
*Wurzeln
*Brüche
*Potenzen
*Beträge
|-
|'''Standard'''||<center>[[File:Formeleditor-Palette.jpg|400px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*Intervalle
|-
|'''Vollständig'''||<center>[[File:Formeleditor-PaletteFull1.jpg|350px]][[File:Formeleditor-PaletteFull2.jpg|350px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Limes
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*sämtliche trigonometrische Funktionen
*Intervalle
|-
|'''UDE Mathematikdidaktik'''||<center>[[File:Formeleditor UdeMathDidactics1.jpg|300px]] [[File:Formeleditor UdeMathDidactics2.jpg|300px]]</center> <center>[[File:Formeleditor UdeMathDidactics3.jpg|300px]] [[File:Formeleditor UdeMathDidactics4.jpg|300px]]</center>||
*Grundrechenarten
*Vergleichsoperatoren
*Brüche
*Potenzen
*Wurzeln
*Betrag
* Summen- und Produktformel
* Fakultät
*Mengen
*Durchschnitt
*Vereinigung
*Differenz
*leere Menge
*Intervalle
*Exponentialfunktion
*Logarithmusfunktionen
*$\pi$
*$i$
*$\infty$
* Vektoren
*Matrizen
*Determinante
*trigonometrische Funktionen
|}

== Chemie-Paletten ==

Die Eingabemöglichkeiten im Chemie-Formeleditor sind wie folgt:

* Durch Tippen von Großbuchstaben (optional gefolgt von einem Kleinbuchstaben) können Atome angegeben werden, beispielsweise $H$ (Wasserstoff) oder $Li$ (Lithium).
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden, beispielsweise $H_{2}$.
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden, beispielsweise $Ca^{2+}$.
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden

{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Chemie)'''
|
|Es wird keine Palette angezeigt. Eingegebene Reaktionsgleichungen werden aber automatisch umgewandelt.
|-
|'''Reaktionsgleichung'''||<center>[[File:Formeleditor-PaletteChemicalReactionEquation.jpg|130px]] ||Ermöglicht die Eingabe von Reaktionsgleichungen und Molekülen
|}

[[category:Benutzerhandbuch]]

Formeleditor Paletten (JACK3)

2026-04-07T08:39:09Z

LGlaser: Aktualisierung der Palettennamen; Ergänzungen zum Chemie-Formeleditor

Die verschiedenen Paletten des [[Formeleditor (JACK3)|JACK3-Formeleditors]] sind in allen [[Fill-In (JACK3)|Fill-In Aufgaben]] einsetzbar. Hier werden die einzelnen Varianten charakterisiert.

== Mathematik-Paletten ==
{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Mathematik)'''
|
| Es wird keine Palette angezeigt. Eingegebene Formeln werden aber automatisch in die Anzeigeform des Formeleditors umgewandelt.
|-
|'''Einfach'''|| style="width: 60%" |<center>[[File:Formeleditor-Basic.jpg|130px]]</center>||
*Wurzeln
*Brüche
*Potenzen
*Beträge
|-
|'''Standard'''||<center>[[File:Formeleditor-Palette.jpg|400px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*Intervalle
|-
|'''Vollständig'''||<center>[[File:Formeleditor-PaletteFull1.jpg|350px]][[File:Formeleditor-PaletteFull2.jpg|350px]]</center>||
*Vergleichsoperationen
*$\pi$, $e^{1}$, $i$ und $\infty$
*Division, Potenzen, Beträge, Fakultät und $e^{x}$
*trigonometrische Funktionen ''Sinus'', ''Kosinus'' und ''Tangens''
*Logarithmen
*Wurzeln
*Integrale
*Limes
*Summen-und Produktzeichen
*Determinante
*Vektoren und Matrizen
*sämtliche trigonometrische Funktionen
*Intervalle
|-
|'''UDE Mathematikdidaktik'''||<center>[[File:Formeleditor UdeMathDidactics1.jpg|300px]] [[File:Formeleditor UdeMathDidactics2.jpg|300px]]</center> <center>[[File:Formeleditor UdeMathDidactics3.jpg|300px]] [[File:Formeleditor UdeMathDidactics4.jpg|300px]]</center>||
*Grundrechenarten
*Vergleichsoperatoren
*Brüche
*Potenzen
*Wurzeln
*Betrag
* Summen- und Produktformel
* Fakultät
*Mengen
*Durchschnitt
*Vereinigung
*Differenz
*leere Menge
*Intervalle
*Exponentialfunktion
*Logarithmusfunktionen
*$\pi$
*$i$
*$\infty$
* Vektoren
*Matrizen
*Determinante
*trigonometrische Funktionen
|}

== Chemie-Paletten ==

Die Eingabemöglichkeiten im Chemie-Formeleditor sind wie folgt:

* Durch Tippen von Großbuchstaben (optional gefolgt von einem Kleinbuchstaben) können Atome angegeben werden, beispielsweise (\H\) (Wasserstoff) oder (\Li\) (Lithium).
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden, beispielsweise (\H_{2}\).
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden, beispielsweise (\Ca^{2+}\).
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden

{| class="wikitable"
!Name!!Formeleditor!!Inhalt
|-
|'''Ohne (Chemie)'''
|
|Es wird keine Palette angezeigt. Eingegebene Reaktionsgleichungen werden aber automatisch umgewandelt.
|-
|'''Reaktionsgleichung'''||<center>[[File:Formeleditor-PaletteChemicalReactionEquation.jpg|130px]] ||Ermöglicht die Eingabe von Reaktionsgleichungen und Molekülen
|}

[[category:Benutzerhandbuch]]

Formeleditor

2026-04-07T08:32:15Z

LGlaser: /* Chemie Editor */ Tippfehler

JACK bietet die Möglichkeit, Fill-In-Aufgaben um einen Editor zu erweitern, der die Eingabe mathematischer und chemischer Ausdrücke vereinfacht.

=Mathematik Editor=
Zum Einbinden des mathematischen Editors in eine Aufgabe muss der <code>exercise</code>-Tag um das Attribut <code>editor</code> mit einem passenden Wert ergänzt werden. Der mathematische Editor bietet eine Palette mit einer Vielfalt an mathematischen Ausdrücken an, die außerdem erweitert werden kann. In JACK gibt es die Möglichkeit eigene Paletten ([[Templatepaletten]]) zu erstellen und vorgefertigte [[Standardpaletten]] zu nutzen.

Um [[Standardpaletten]] einzubinden genügt es den Namen der Palette wie oben beschrieben anzugeben.

Um [[Templatepaletten]] einzubinden, muss die selbsterstellte XML Datei der Aufgabe hinzugefügt werden. Zusätzlich muss in dem <code>editor</code>-Tag der Stage Datei der Name der Datei + Dateiendung übergeben werden. Bsp.: <code>editor="MyPalette.xml"</code>

==Beispiel==
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
<exercise type="fillIn" editor="basic">
...
...
</exercise>
</syntaxhighlight>

In dem Beispiel hat <code>editor</code> den Wert <code>basic</code>.
==Hinweise zum mathematischen Editor==

=== Eingabe mit Multiplikationszeichen ===
Damit der Formeleditor Terme richtig erkennen kann, muss zwischen den Variablen ein Multiplikationszeichen stehen.
::*Bsp.:
:::*<code>a^4c</code> kann vom Editor nicht erkannt werden
:::*<code>a^4*c</code> dieser Ausdruck wird vom Editor korrekt erkannt

===Mehrere Buchstaben werden als eine Variable zusammengefasst===
Der Formeleditor erlaubt Variablen mit mehrere Buchstaben.

::*Beispiele:
:::*Für <code>ca^4</code> wird als die Variable "ca" hoch 4 interpretiert.
:::*<code>x*y^2</code> führt zu <code>x*y*y</code>
:::*<code>x*yz^2</code> wird als die Variable "x" multipliziert mit der Variablen "yz" hoch vier interpretiert.
:::*<code>ab*ab</code> führt zu <code>(ab)^2</code>, wobei <code>ab</code> wieder als eine Variable erkannt wird.
:::*<code>abc</code> wird als Variable <code>abc</code> erkannt. Schreibt man aber <code>a*b*c</code> werden alle drei Buchstaben als einzelne Variablen erkannt.

=== Keine Palette anzeigen===
Es gibt die Möglichkeit die FillIn Kästchen des Formeleditors zu nutzen, ohne eine Palette anzuzeigen. Hierzu kann <code>editor="invisible"</code> gesetzt werden.

===Besondere Zeichen===
* <code>%</code>: Wird in einem FillIn Kästchen ein <code>%</code> eingefügt, wird ein Bruch anstelle eines <code>%</code> erstellt.

=Chemie Editor=
[[file:Beispiel_Chem.PNG|thumb|Stimulierendes Beispiel mit der Palette "palette_chemical_reaction_equation"]]
Um den chemischen Editor für eine Aufgabe zu nutzen muss dem Tag <code>exercise</code> das Attribut <code>domain</code> mit dem Wert "chem" und das Attribut <code>editor</code> mit Wert "palette_chemical_reaction_equation" oder "invisibleChem".

Durch tippen von Großbuchstaben (optional gefolgt durch einen Kleinbuchstaben) können Atome angegeben werden.
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden.
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden.
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden

Die Palette "palette_chemical_reaction_equation" beinhaltet Elemente um Oxidationszahlen anzugeben und die Elemente, die mit <code> Shift + Pfeiltaste </code> erzeugbar sind. Diese können mit einem Mausklick eingefügt werden.

==Beispiel zum chemischen Editor==
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
<exercise type="fillIn" domain="chem" editor="palette_chemical_reaction_equation">
...
...
</exercise>
</syntaxhighlight>

In dem Beispiel hat <code>editor</code> den Wert <code>palette_chemical_reaction_equation</code>.

=Allgemeine Hinweise zum Editor=

=== Mischen vom mathematischen und chemischen Formeleditor===
*Eine Mischung der beiden Editoren ist in einer Stage nicht möglich.
*Eine Mischung in verschiedenen Stages einer Aufgabe ist zwar möglich, sollte aber vermieden werden. Die korrekte Anzeige aller gemachten Eingaben ist im Falle einer Mischung nicht möglich.

=== erweitertes Steuern des Editorfeldes===
Der Formeleditor wird nur für ein Inputfeld angezeigt, wenn
:*in der Stage, wie oben beschrieben, ein Editor eingefügt wurde und beim Inputfeld '''nicht''' <code>editor="false"</code> gesetzt wurde.
:*in der Stage, wie oben beschrieben, ein Editor eingefügt wurde und beim Inputfeld <code>editor="true"</code> gesetzt wurde.
:*in der Stage '''kein''' Editor eingefügt wurde und beim Inputfeld <code>editor="true"</code> gesetzt wurde. Hierbei wird die ''palette6'' des mathematischen Editors als Defaultpalette angezeigt.

Für alle Fälle gilt, dass das Inputfeld '''kein''' Dropdownfeld sein darf!

==Weiterführende Links==
* [[Templatepaletten]]
* [[Standardpaletten]]

[[Category:Formeleditor]]

Dynamischer Python Checker (JACK3)

2026-02-03T07:43:43Z

LGlaser:

Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt werden. Diese können z. B. einen erwarteter Wert mit dem tatsächlichen Wert vergleichen. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces aufzeichnen (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Es lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback, programmiert in Python, erzeugen.

{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}

Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pandas.pydata.org/docs/user_guide/index.html pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

== Unterstützte Aufgabenstellungen ==
Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:

* Schreiben Sie eine parameterlose Funktion, die ... zurückgibt.
* Schreiben Sie eine Funktion, die ... erwartet und ... zurückgibt.
* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)

'''Beispiel''': ''Definieren Sie eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">
def add(a, b):
return a + b
</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

=== Statische Tests & Codeanalyse ===
Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul genutzt werden.

== Aufbau eines Testtreibers ==
Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode as s

@Communicator.decorator
def testcase1():
# TODO so something with s ...
pass

@Communicator.decorator
def testcase2():
# TODO so something with s ...
pass

if __name__ == '__main__':
print('Running test case 1...')
testcase1()
print('Running test case 2 ...')
testcase2()
</syntaxhighlight>

===API zum Zurückmelden von Ergebnissen===
Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
def printResult(result: int, feedback: str = None):
"""
Reports a result.

:param result: Points which are reported. Must be between 0 and 100 (both inclusive).
:param feedback: Optional Feedback presented to the user.
"""
pass
</syntaxhighlight>{{Wichtig|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}

=== Schreiben von Testfällen ===
Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.

Ein möglicher Testfall 1 für das obige Beispiel wäre dementsprechend:<syntaxhighlight lang="python3" line="1" start="5">
@Communicator.decorator
def testcase1():
try:
# Berechnen des Ergebnisses mit dem "studentcode":
result = s.add(1, 0)
# zu prüfender Ausdruck:
assert result == 1

# Bei Erfolg: +25 Punkte
Trace.printResult(25)
except Exception:
# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht
Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")
</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde. Zusätzlich wird die Variablenbelegung angezeigt und die ausgeführten Zeilen.

Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

== Ressourcen ==
Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Medium:Tracing-Python-Checker-Dummy.zip|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
* <code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
* <code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
* <code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).
{{Hinweis|Der Dummy arbeitet nicht exakt wie der Checker. Es gibt keine Garantie, dass Testtreiber, die mit dem Dummy funktionieren, auch genau so in JACK funktionieren. Testen Sie die Aufgabe deshalb immer auch in JACK!}}
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Checker]]

Kategorie:Geometry

2026-02-02T17:06:33Z

LGlaser: Navigationsvorlage eingefügt

Eine Auflistung aller Funktionen die mit geometrischen Formen arbeiten.

{{Navigation/Geometriefunktionen}}
[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Evaluatorfunktionenkategorie]]

Vorlage:Navigation/Geometriefunktionen

2026-02-02T17:05:50Z

LGlaser: LGlaser verschob die Seite Vorlage:Navigation/Koordinatenfunktionen nach Vorlage:Navigation/Geometriefunktionen, ohne dabei eine Weiterleitung anzulegen

<onlyinclude>{{Navigation
| TITEL = Geometriefunktionen
| INHALT =
Geometrische Figuren:
[[Coordinate]] •
[[Circle]] •
[[Polygon]] •
[[Rectangle]]

Prüfen von Koordinaten:
[[IsCoordinateInCircle]] •
[[IsCoordinateInPolygon]] •
[[IsCoordinateInRectangle]]

Abrufen von Koordinaten:
[[GetXCoordinate]] •
[[GetYCoordinate]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Koordinatenfunktionen]]

Vorlage:Navigation/Geometriefunktionen

2026-02-02T17:05:02Z

LGlaser: Vervollständigung der Vorlage

Vorlage:Navigation/Numberfunktionen

2026-02-02T17:00:51Z

LGlaser: IsNaN nachgetragen

<onlyinclude>{{Navigation
| TITEL = Numberfunktionen ([[Übersicht Numberfunktionen|Übersicht]])
| INHALT =
[[EvaluatesToNumber]] •
[[IsNumber]] •
[[IsIntegerNumber]] •
[[IsNaturalNumber]] •
[[IsRationalNumber]] •
[[IsRealNumber]] •
[[IsMathematikerRealNumber]] •
[[IsNaN]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Numberfunktionen]]

Dynamischer Python Checker (JACK3)

2026-02-02T16:51:41Z

LGlaser: Hinweis auf statische Codeanalyse

Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt werden. Diese können z. B. einen erwarteter Wert mit dem tatsächlichen Wert vergleichen. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces aufzeichnen (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Es lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback, programmiert in Python, erzeugen.

{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}

Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pandas.pydata.org/docs/user_guide/index.html pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

== Unterstützte Aufgabenstellungen ==
Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:

* Schreiben Sie eine parameterlose Funktion, die ... zurückgibt.
* Schreiben Sie eine Funktion, die ... erwartet und ... zurückgibt.
* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)

'''Beispiel''': ''Definieren Sie eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">
def add(a, b):
return a + b
</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

=== Statische Tests & Codeanalyse ===
Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul genutzt werden.

== Aufbau eines Testtreibers ==
Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">
import Communicator
import Trace
import studentcode as s

@Communicator.decorator
def testcase1():
# TODO so something with s ...
pass

@Communicator.decorator
def testcase2():
# TODO so something with s ...
pass

if __name__ == '__main__':
print('Running test case 1...')
testcase1()
print('Running test case 2 ...')
testcase2()
</syntaxhighlight>

===API zum Zurückmelden von Ergebnissen===
Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
def printResult(result: int, feedback: str = None):
"""
Reports a result.

:param result: Points which are reported. Must be between 0 and 100 (both inclusive).
:param feedback: Optional Feedback presented to the user.
"""
pass
</syntaxhighlight>{{Wichtig|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}

=== Schreiben von Testfällen ===
Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.

Ein möglicher Testfall 1 für das obige Beispiel wäre dementsprechend:<syntaxhighlight lang="python3" line="1" start="5">
@Communicator.decorator
def testcase1():
try:
# Berechnen des Ergebnisses mit dem "studentcode":
result = s.add(1, 0)
# zu prüfender Ausdruck:
assert result == 1

# Bei Erfolg: +25 Punkte
Trace.printResult(25)
except Exception:
# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht
Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")
</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde. Zusätzlich wird die Variablenbelegung angezeigt und die ausgeführten Zeilen.

Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

== Ressourcen ==
Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[index.php?title=Medium:Tracing-Python-Checker-Dummy.zip|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
* <code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
* <code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
* <code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).
{{Hinweis|Der Dummy arbeitet nicht exakt wie der Checker. Es gibt keine Garantie, dass Testtreiber, die mit dem Dummy funktionieren, auch genau so in JACK funktionieren. Testen Sie die Aufgabe deshalb immer auch in JACK!}}
[[Kategorie:Benutzerhandbuch]]
[[Kategorie:Checker]]

Vorlage:Navigation

2025-06-06T07:54:04Z

LGlaser: Vorlagenkategorie

<includeonly><div style="background: #eaf3ff; border: solid 1px #a3caff; padding-left: 10px; padding-right: 10px; line-height: 1.0em; text-align: center;">
{{#if: {{{TITEL|}}} | <div style="font-weight: bold;">
{{{TITEL}}}
</div> | }}
<div style="margin-top: 10px;">
{{{INHALT}}}
</div>
</div></includeonly>
<noinclude>Diese Vorlage bildet eine Navigationsleiste, ähnlich zu der in der [https://de.wikipedia.org/wiki/Vorlage:Navigationsleiste Wikipedia].

'''Benutzung:'''

<pre><nowiki>
{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
[[Erste Seite]]&nbsp;&bull;
[[Zweite Seite]]&nbsp;&bull;
[[Dritte Seite]]&nbsp;&bull;
[[Vierte Seite]]
}}
</nowiki></pre>

Der Parameter <code>TITEL</code> ist optional.

'''Ergibt:'''

{{Navigation
| TITEL = Titel hier einfügen
| INHALT =
Erste Seite • 
Zweite Seite •
Dritte Seite •
Vierte Seite
}}
[[:Kategorie:Navigationsvorlagen|Liste aller Navigationsvorlagen]].

[[Kategorie:Navigationsvorlagen| ]]</noinclude>

Checkliste für Prüfungen mit JACK 3

2025-03-11T08:11:54Z

LGlaser: Hinweis auf PC-Hall konkretisiert

Hier finden Sie eine Checkliste zur erfolgreichen Durchführung von Prüfungen mit JACK3. Um eine möglichst reibungslose Prüfungsdurchführung zu ermöglichen, bitten wir Sie, folgende Punkte abzuarbeiten:

Bis '''zwei Wochen''' vor der Klausur:

* Die Klausur wurde über die [mailto:jack@paluno.uni-due.de Funktionsmail] angemeldet.

* Falls die Prüfung in einer [https://www.uni-due.de/zim/services/pc-pruefungen/pc-hall PC-Hall der Universität Duisburg-Essen] stattfindet: Die Klausur wurde beim [https://www.uni-due.de/zim/klausuranmeldung ZIM] angemeldet.

* Lehrende haben Editierrechte und einen Ordner in [[Verfügbare Kurse (JACK3)|''Verfügbare Kurse'']] auf dem/den Prüfungsserver/n erhalten.

Bis '''eine Woche''' vor der Klausur:

* Die Klausuraufgaben wurden auf den/die Prüfungsserver importiert.

* Alle Bilder in den Aufgaben wurden erneut in der Aufgabe verlinkt.

* Es wurde ein Kurs erstellt, die Aufgaben dort eingefügt und die Punkte für die Aufgaben angepasst.

* Es wurde ein Kursangebot erstellt, der Kurs eingebunden und das Kursangebot konfiguriert.

* Die Klausur wurde aus Studierendensicht auf technische Korrektheit geprüft.

* Die Klausur wurde aus Studierendensicht auf inhaltliche Korrektheit geprüft.

=== Weitere Hinweise ===
* Das JACK-Team übernimmt keine Verantwortung für die Korrektheit der Aufgaben, Kurse und Kursangebote.

* Für neue Kunden wird einmalig ein Mitarbeiter vor Ort für die Betreuung der Klausur in der PC-Hall bereitgestellt.

* Das JACK-Team steht im Zeitraum ''vor'' diesen zwei Wochen stets gerne für Beratungen und Schulungen zu allen Themen zur Verfügung, um eine störungsfreie und erfolgreiche Durchführung der Prüfungen zu gewährleisten.

IsNaN

2025-03-11T08:08:13Z

LGlaser: typo

{{Navigation/Numberfunktionen}}

=== Zugehörige Evaluatoren ===
*'''MathEvaluator'''

=== Beschreibung ===
Die Funktion ''IsNaN'' prüft nach dem IEEE-Standard 754, ob eine Fließkommazahl "[https://de.wikipedia.org/wiki/NaN Not a Number]" ist.

Siehe auch [[Übersicht Numberfunktionen]].

=== Syntax ===
isNaN(a)

=== Parameter ===
* '''a''' - [[Objekt]]

=== Return Value ===
*Gibt True (wahr) oder False (nicht wahr) zurück

=== Beispiele ===
==== Standardfälle ====
isNaN(4) --> returns ''true''

isNaN(-1245) --> returns ''true''

isNaN(2.5) --> returns ''false''

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK3]]

Übersicht Numberfunktionen

2025-03-11T08:07:29Z

LGlaser: /* IsNaN */ typo

{{Navigation/Numberfunktionen}}

== Funktionsweise ==
Im Mathe-Evaluator gibt es sechs verschiedene Funktionen, mit denen getestet werden kann, ob die Eingabe zu einer bestimmten Zahlengruppe gehört:

=== [[IsNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine Zahl ist oder
** sich die Eingabe zu einer Zahl ausrechnen lässt.
* '''Gibt auch für komplexe Zahlen true zurück.'''
=== [[IsIntegerNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe ein Integer ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsNaturalNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine natürliche Zahl oder
** Null ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsRationalNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe eine rationale Zahl ist.
* '''Die Eingabe wird nicht ausgerechnet.'''
=== [[IsRealNumber]] ===
* Gibt <code>true</code> zurück, wenn sich die Eingabe zu einer reellen Zahl ausrechnen lässt und
** es sich um eine ganze oder Fließkomma-Zahl handelt,
** es sich um <code>+/- e</code> oder <code>+/- pi</code> handelt,
** es sich um einen Bruch handelt, bei dem Zähler und Nenner eine ganze Zahl/Fließkommazahl/<code>e</code>/<code>pi</code> sind oder
** es sich um eine Wurzel handelt und der Term unter der Wurzel obigen Kriterien entspricht.
=== [[IsMathematikerRealNumber]] ===
* Gibt <code>true</code> zurück, wenn
** die Eingabe sich nicht zu Unendlich ausrechnen lässt,
** die Eingabe sich zu einer reellen Zahl ausrechnen lässt und
** die Eingabe nicht weiter vereinfacht werden kann.
* Die Eingabe ist vereinfachbar, wenn
** sie mindesten einen Operanten enthält (<code>+, -, *, /, ^, sqrt</code>) und
** sie sich zu einer Ganzzahl ausrechnen lässt.
=== [[IsNaN]] ===
* Gibt <code>true</code> zurück, wenn
** es sich bei der Eingabe um '''keine''' Zahl des [https://de.wikipedia.org/wiki/NaN IEEE-Standard 754] handelt

== Vergleich ==
In folgender Tabelle wird verglichen, welche Rückgabe die Funktionen für verschiedene Eingaben liefern:
{| class="wikitable"
|+ Ausgaben der Funktionen bei verschiedenen Eingaben
|-
! !! $2$ !! $0$ !! $-4$ !! $4.6$ !! $\frac{2}{3}$ !! $\sqrt{\frac{4}{4}}$ !! $1+3$ !! $i$ !! $\infty$
|-
| IsNumber || True || True || True || True || True || True || True || True || style="background-color: silver;" |False
|-
| IsIntegerNumber || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsNaturalNumber || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsRationalNumber || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsRealNumber || True || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|-
| IsMathematikerRealNumber || True || True || True || True || True || style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False|| style="background-color: silver;" |False
|}

[[Kategorie:Math-Evaluatorfunktion]][[Kategorie:Testfunktionen]][[Kategorie:JACK2]][[Kategorie:JACK3]]

Formeleditor (JACK3)

2025-03-06T13:37:24Z

LGlaser: Kleine Korrekturen, '/' zu besonderen Zeichen hinzugefügt

JACK3 bietet die Möglichkeit, [[Fill-In (JACK3)|Fill-In Aufgaben]] um einen Formeleditor zu erweitern. Dieser unterstützt bei der Eingabe von mathematischen und chemischen Ausdrücken.

=== Allgemeine Informationen ===
Zum Einbinden des Formeleditors in einer Aufgabe muss in dem Aufgabenteil unter Formeleditor eine ''Palette'' ausgewählt werden und für das jeweilige Inputfeld in dem Drop-Down Feld ''Formeleditor''.

[[File:FillIn_Felder_Lehrender.JPG|center|thumb|800px|Einbinden des Formeleditors für Fill-In Felder]]{{Hinweis|In einer Aufgabe dürfen die beiden Formeleditoren Mathe und Chemie nicht gemischt werden.|Wichtig}}Der Formeleditor wird nur für ein Inputfeld angezeigt, wenn in dem Aufgabenteil ein Formeleditor ausgewählt wurde und bei dem Inputfeld ''Formeleditor'' gewählt wurde.

Bei beiden, Mathematik und Chemie, kann man sich auch keine Palette anzeigen lassen, aber trotzdem die Funktionen nutzen. Für Mathematik wählt man dafür <code>invisible</code> aus und für Chemie <code>invisibleChem</code>.

=== Mathematik Formeleditor ===
====Mehrere Buchstaben werden zu einer Variable zusammengefasst====
Der Formeleditor erlaubt Variablen mit mehreren Buchstaben. Beispiele:
* Für <code>ca^4</code> wird als die Variable ''ca'' hoch 4 interpretiert.
* <code>x*y^2</code> führt zu <code>x*y*y</code>
* <code>x*yz^2</code> wird als die Variable ''x'' multipliziert mit der Variable ''yz'' hoch 2 interpretiert.
* <code>ab*ab</code> führt zu <code>(ab)^2</code>, wobei <code>ab</code> wieder als '''eine''' Variable erkannt wird.
* <code>abc</code> wird als Variable ''abc'' erkannt. Schreibt man aber <code>a*b*c</code> werden alle drei Buchstaben als einzelne Variablen erkannt.

====Besondere Zeichen====
<code>%</code> und <code>/</code>: Fügt in einem Fill-In-Feld mit Formeleditor einen Bruch ein.

=== Chemie Formeleditor ===
[[File:Formeleditor-Chemie.jpg|thumb|Beispiel mit der Palette "palette_chemical_reaction_equation"]]
Für Chemie stehen die beiden Formeleditoren ''invisibleChem'' und ''palette_chemical_reaction_equation'' zur Verfügung.

Durch Tippen von Großbuchstaben (optional gefolgt durch einen Kleinbuchstaben) können Atome angegeben werden.
* Durch <code>Shift + Pfeil unten</code> kann die Anzahl der Atome in einem Molekül erreicht werden.
* Durch <code>Shift + Pfeil oben</code> kann die Ladung des Moleküls angegeben werden.
* Operatoren <code>+</code> und <code>*</code> stehen zur Verfügung.
* Ganzzahlen können verwendet werden.

Die Palette ''palette_chemical_reaction_equation'' beinhaltet Elemente um Oxidationszahlen anzugeben und die Elemente, die mit <code>Shift + Pfeiltaste</code> erzeugbar sind. Diese können mit einem Mausklick eingefügt werden.

===Weitere Links===
* [[Formeleditor Paletten (JACK3)|Formeleditor-Paletten]]
* [[Fill-In (JACK3)|Fill-In]]

[[Kategorie:Benutzerhandbuch]]

RandomUniqueIntegersBetween

2025-03-04T07:34:43Z

LGlaser: typo

{{Vorlage:Warnung|Warnung=Diese Seite ist beinhaltet eine Evaluatorfunktion für JACK3.}}

===Zugehörige Evaluatoren===
*'''MathEvaluator'''

===Beschreibung===
Die Funktion ''randomUniqueIntegersBetween'' zieht eine vorgegebene Anzahl an zufälligen und unterschiedlichen [[Ganzzahl|Ganzzahlen]] aus einem vorgegebenen Bereich. Es werden keine Zahlen doppelten gezogen. Die gezogenen [[Ganzzahl|Ganzzahlen]] sind dabei inklusiv der unteren Grenze und exklusiv der oberen Grenze. Die Anzahl zu ziehender Zahlen darf nicht größer als der Abstand zwischen der unteren und oberen Grenze sein.

===Syntax===
randomUniqueIntegersBetween(int anzahl, int untereGrenze, int obereGrenze)

===Parameter===
* '''anzahl''' - [[Ganzzahl]] Anzahl an Zufallszahlen
* '''untereGrenze''' - [[Ganzzahl]] untere Grenze (inklusiv)
* '''obereGrenze''' - [[Ganzzahl]] obere Grenze (exklusiv)

===Return Value===
* Gibt eine [[List|Liste]] zurück, welche aus [[Ganzzahl]]en besteht.

===Beispiele===
randomUniqueIntegersBetween(2, 2, 6) --> returns (zum Beispiel) 2, 4

randomUniqueIntegersBetween(3, 1, 10) --> returns (zum Beispiel) 3, 7, 8

randomUniqueIntegersBetween(1, 4, 10) --> returns (zum Beispiel) 9

===Hinweise===
* Weitere Funktionen die zufällig Zahlen ziehen sind: [[random]], [[randomBetween]], [[randomIntegerBetween]].

[[Kategorie:Math-Evaluatorfunktion]]

Vorlage:Navigation/Geometriefunktionen

2025-02-27T10:38:39Z

LGlaser: Reihenfolge geändert

<onlyinclude>{{Navigation
| TITEL = Funktionen mit Koordinaten
| INHALT =
Geometrische Figuren:
[[Coordinate]] •
[[Circle]] •
[[Polygon]] •
[[Rectangle]]

Prüfen von Koordinaten:
[[IsCoordinateInCircle]] •
[[IsCoordinateInPolygon]] •
[[IsCoordinateInRectangle]]
}}</onlyinclude>

[[Kategorie:Navigationsvorlagen|Koordinatenfunktionen]]