Hinweise zur Erstellung von einheitlich strukturierten Aufgaben für das online Testsystem.
============================================================================================


--------------------------------------------------------------------------------------------
Änderungsprotokoll dieser Aufgabenvorlage
--------------------------------------------------------------------------------------------

Version 1.0 vom 06.04.2022:
	Originalversion

Version 1.1 vom 25.04.2022:
	Bei einer numerischen Frage kann nun die Einheit der Antwort vorgeben werden. 

Version 1.2 vom 13.05.2022:
	Bei der Generierung eines Tests versucht das System Aufgaben aus unterschiedlichen Kompetenzbereichen zu wählen, wenn das neue Feld Kompetenzbeachtung auf 'ja' gesetzt wurde.

Version 1.3 vom 04.08.2022:
	Aufgabenvorlage um konkrete Beispiele zum Einbinden von Abbildungen und Formeln ergänzt.

Version 1.4 vom 05.08.2022:
	Aufgabenvorlage um die Angabe eines Lösungswegs pro Frage erweitert.

Version 1.5 vom 04.10.2022:
	Aufgabenvorlage um die Angabe von vorformatierten Konstantschriftblöcken (für Quelltexte etc.) erweitert.
	Beispiel:

	[monoblock]
	function Demo():
		for x in range(1, 10):
		print(x)
	[monoblock]

Version 1.6 vom 04.12.2023:
	Aufgabenvorlage um die Angabe der Aufgabensprache erweitert.
	Namensschema für Aufgabendateien geändert zu <Modul-Nr>_aufgabe-<Aufgabennummer>_<de/en>.zip
	Beispiel: 04-00-0111_aufgabe-2_de.zip

--------------------------------------------------------------------------------------------
Wichtig
--------------------------------------------------------------------------------------------

Im Folgenden wird darauf eingegangen, wie Sie eine Aufgabe als Zip-Datei erstellen.
Damit das System die Aufgaben korrekt einlesen kann, ist es wichtig, dass die Dateien korrekt formatiert sind.
Erstellen Sie daher eine Aufgabe, indem Sie die Vorlagedateien editieren und entsprechend dieser Anleitung in einer Zip-Datei bündeln.

Unter https://aca-system.boris-dreyer.com steht ein Online-Tool bereit, mit dem Sie prüfen können, ob das System Ihre Aufgabe korrekt erkannt hat.


--------------------------------------------------------------------------------------------
Ordnerstruktur
--------------------------------------------------------------------------------------------

Jede Aufgabe ist einzeln als Zip-Datei einzureichen.
Das Namensschema der Zip-Datei ist: "<Modul-Nr>_aufgabe-<Aufgabennummer>_<de/en>.zip".
Sollte die Modul-Nr Buchstaben beinhalten, so sind diese kleinzuschreiben.
Die Aufgabennummer startet mit 1 und ist aufsteigend zu wählen.
Die Aufgabensprache ist mit "de" für Deutsch oder "en" für Englisch anzugeben.

Innerhalb der Zip-Datei befinden sich einfache Textdateien mit den Bestandteilen der Aufgabe, sowie Grafiken, auf die in der Aufgabe verwiesen werden.
Die zu erstellende Textdatei "aufgabe.txt" beinhaltet allgemeine Informationen zur Aufgabe sowie die Aufgabenbeschreibung.
Zusätzlich ist für jede Aufgabenfrage eine weitere Textdatei mit dem Schema "frage-<Fragennummer>.txt" zu erstellen.
Jede Fragedatei beinhaltet sowohl die Frage, als auch ihre korrekte Antwort. 
Bei Single-Choice-Fragen sind ebenfalls die Antwortmöglichkeiten aufgelistet. 
Die Fragennummer startet mit 1 und ist aufsteigend zu wählen.

Verweisen Textblöcke wie Aufgabenbeschreibung/Aufgabenfragen/Aufgabenantworten auf Grafiken, so sind diese im Verzeichnis "img" als Datei im jpeg- oder png-Format zu hinterlegen.
Dateinamen von Grafikdateien dürfen nur aus alphanumerischen Zeichen, Unterstrichen (_) und Minuszeichen (-) zusammengesetzt sein.
Grafikdateien dürfen keine Leerzeichen enthalten.
Innerhalb der Aufgabe wird auf eine Grafik mittels der Sequenz "[Abbildung: <Dateiname>]" verwiesen.
Das System ersetzt diese Sequenz bei der Darstellung der Aufgabe durch "Abb. <Nummer>" mit aufsteigender Nummer im Fließtext und platziert die Grafik in die Nähe des Textblocks.
Mathematische Gleichungen können mittels LaTeX oder durch einen Verweis auf eine Grafik eingebunden werden, welche die Gleichung beinhaltet.

Beispiel:
	Die Einreichung von Aufgabe 2 aus dem Modul Mathematik III könnte so aussehen:

	Zip-Datei "04-00-0111_aufgabe-2_de.zip"
		Datei "aufgabe.txt"
		Datei "frage-1.txt"
		Datei "frage-2.txt"
		Datei "frage-3.txt"	
		Verzeichnis: img
			Datei "kubische-parabel.jpg"
			Datei "quadratische-parabel.png"

	Im Verzeichnis "beispiel" ist ein abgabefertiges Beispiel dieser Einreichung als Zip-Datei zu finden.
	Ebenso ein PDF, welches zeigt, wie diese Aufgabe dem Bewerber präsentiert wird.

Vorlage:
	Das Verzeichnis "vorlage" beinhaltet eine Vorlage zur Erstellung der Datei "aufgabe.txt" sowie eine Vorlage zur Erstellung einer 
	Single-Choice-Frage "frage-1.txt" und einer numerischen Frage "frage-2.txt".
	Erstellen Sie eine Aufgabe, indem Sie Kopien dieser Dateien editieren, um eine korrekte Formatierung zu erhalten.
	Auf den Inhalt dieser Dateien wird nun im Folgenden eingegangen.


--------------------------------------------------------------------------------------------
Formatierung der Datei "aufgabe.txt"
--------------------------------------------------------------------------------------------

Vorlage:
	|---------------------------------------------------
	|-- Kontakt
	|---------------------------------------------------
	|
	|Autor: [Einfache Textzeile]
	|Fachgebiet: [Einfache Textzeile]
	|E-Mail-Adresse: [Einfache Textzeile]
	|
	|
	|---------------------------------------------------
	|-- Informationen
	|---------------------------------------------------
	|
	|Modul-Nr: [Einfache Textzeile]
	|
	|Aufgabennummer: [Zahl]
	|Aufgabentitel: [Einfache Textzeile]
	|Aufgabensprache: [de/en]
	|Kompetenzbereich: [Einfache Textzeile]
	|Kompetenzbeachtung: [ja/nein]
	|Gesamtpunktzahl: [5/10]
	|
	|
	|---------------------------------------------------
	|-- Aufgabenbeschreibung
	|---------------------------------------------------
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|

Beispiel:
	|---------------------------------------------------
	|-- Kontakt
	|---------------------------------------------------
	|
	|Autor: Max Mustermann
	|Fachgebiet: Mustersysteme
	|E-Mail-Adresse: max@mustermann.de
	|
	|
	|---------------------------------------------------
	|-- Informationen
	|---------------------------------------------------
	|
	|Modul-Nr: 04-00-0111
	|
	|Aufgabennummer: 2
	|Aufgabentitel: Lösen einer Gleichung
	|Aufgabensprache: de
	|Kompetenzbereich: Einfache Mathematik
	|Kompetenzbeachtung: ja
	|Gesamtpunktzahl: 5
	|
	|
	|---------------------------------------------------
	|-- Aufgabenbeschreibung
	|---------------------------------------------------
	|
	|Diese Aufgabe behandelt die Gleichung: $$y = {x^2 + \sqrt{5a} \over 3b}$$
	|

Hinweise:
	Die Informationen zum Kontakt dienen für Rückfragen und werden im Testsystem nicht den Bewerbern präsentiert.
	Es ist darauf zu achten, dass die Aufgabennummer mit der Angabe im Namen der Zip-Datei übereinstimmt.
	Der Aufgabentitel ist kurz und prägnant zu wählen.
	Bei der Generierung eines Tests versucht das System Aufgaben aus unterschiedlichen Kompetenzbereichen zu wählen, wenn Kompetenzbeachtung auf 'ja' gesetzt wurde. Bei 'nein' werden Kompetenzbereiche nicht berücksichtigt.
	Im Beispiel wurde eine Gleichung mittels LaTeX eingebunden, indem diese mit zwei $-Zeichen vor und nach der Gleichung markiert wurde. Auf diese Art eingebundene Gleichungen werden alleinstehend und zentriert in der darauffolgenden Textzeile dargestellt.
	Alternativ hätte die Gleichung auch als Grafik eingebunden werden können.


--------------------------------------------------------------------------------------------
Formatierung der Datei "frage-X.txt" als Single-Choice-Frage
--------------------------------------------------------------------------------------------

Struktur:
	|---------------------------------------------------
	|-- Informationen
	|---------------------------------------------------
	|
	|Punkte: [Zahl]
	|Fragentyp: SC
	|Antworten: [Zahl]
	|
	|
	|---------------------------------------------------
	|-- Aufgabenfrage
	|---------------------------------------------------
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort: [korrekt/inkorrekt]
	|---------------------------------------------------
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort: [korrekt/inkorrekt]
	|---------------------------------------------------
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort: [korrekt/inkorrekt]
	|---------------------------------------------------
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|
	|
	|---------------------------------------------------
	|-- Lösungsweg
	|---------------------------------------------------
	|
	|Einen Lösungsweg anzugeben ist optional und dient der internen Dokumentation. Hat die Aufgabenfrage keinen komplexen Lösungsweg kann dieser Abschnitt leer gelassen werde.
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|

Beispiel 1:
	|---------------------------------------------------
	|-- Informationen
	|---------------------------------------------------
	|
	|Punkte: 1
	|Fragentyp: SC
	|Antworten: 3
	|
	|
	|---------------------------------------------------
	|-- Aufgabenfrage
	|---------------------------------------------------
	|
	|Was trifft auf die Gleichung zu, wenn x=4, a=5 und b=1 gilt?
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort: inkorrekt
	|---------------------------------------------------
	|
	|y ist größer als 7.
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort: korrekt
	|---------------------------------------------------
	|
	|y = 7.
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort: inkorrekt
	|---------------------------------------------------
	|
	|Es gibt für y keine Lösung.
	|
	|
	|---------------------------------------------------
	|-- Lösungsweg
	|---------------------------------------------------
	|
	|In diesem einfachen Beispiel wird die Angabe eines Lösungswegs nicht benötigt. Entsprechend würde dieser Abschnitt leer gelassen.
	|

Beispiel 2:
	|---------------------------------------------------
	|-- Informationen
	|---------------------------------------------------
	|
	|Punkte: 1
	|Fragentyp: SC
	|Antworten: 3
	|
	|
	|---------------------------------------------------
	|-- Aufgabenfrage
	|---------------------------------------------------
	|
	|Welchen Verlauf hat die Funktion f(x)=y, mit a=0, \(b={1 \over 3}\) ?
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort:  inkorrekt
	|---------------------------------------------------
	|
	|Der Verlauf entspricht angenähert [Abbildung: kubische-parabel.jpg].
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort:  korrekt
	|---------------------------------------------------
	|
	|Der Verlauf entspricht angenähert [Abbildung: quadratische-parabel.png].
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort:  inkorrekt
	|---------------------------------------------------
	|
	|Die Funktion hat keinen Verlauf.
	|
	|
	|---------------------------------------------------
	|-- Lösungsweg
	|---------------------------------------------------
	|
	|In diesem einfachen Beispiel wird die Angabe eines Lösungswegs nicht benötigt. Entsprechend würde dieser Abschnitt leer gelassen.
	|

Hinweis:
	Es muss immer exakt eine Antwortmöglichkeit korrekt sein.
	In Beispiel 2 befinden sich eine Gleichung in der Frage, die mittels LaTeX eingebunden wurde und im Fließtext dargestellt wird. Hierzu wurde die Gleichung mit der Zeichenfolge "\(" und "\)" umschloßen.
	In Beispiel 2 befinden sich zwei Verweise auf Grafiken in den Antwortmöglichkeiten, die im Verzeichnis "img" abgelegt sein müssen.
	Einen Lösungsweg anzugeben ist optional und dient der internen Dokumentation.


--------------------------------------------------------------------------------------------
Formatierung der Datei "frage-X.txt" als numerische Frage
--------------------------------------------------------------------------------------------

Struktur:
	|---------------------------------------------------
	|-- Informationen
	|---------------------------------------------------
	|
	|Punkte: [Zahl]
	|Fragentyp: Num
	|
	|
	|---------------------------------------------------
	|-- Aufgabenfrage
	|---------------------------------------------------
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort
	|---------------------------------------------------
	|
	|Einheit: [Geforderte Einheit mit Einheitenpräfix oder leer lassen]
	|Lösung:  [Zahl]
	|Min:     [Zahl]
	|Max:     [Zahl]
	|
	|Das Testsystem betrachtet alle Antworten im Bereich 
	|[Min, Max] als korrekt, außerhalb als inkorrekt.
	|
	|
	|---------------------------------------------------
	|-- Lösungsweg
	|---------------------------------------------------
	|
	|Einen Lösungsweg anzugeben ist optional und dient der internen Dokumentation. Hat die Aufgabenfrage keinen komplexen Lösungsweg kann dieser Abschnitt leer gelassen werde.
	|
	|Textblock mit Verweisen auf Grafiken z.b. "... dargestellt in [Abbildung: diagramm.jpg].", Formeln in LaTeX z.B. alleinstehend $$\sqrt{x}$$ oder inline \(\sqrt{x}\) und vorformatierten Konstantschriftblöcken z.B.:
	|
	|[monoblock]
	|function Demo():
	|	for x in range(1, 10):
	|		print(x)
	|[monoblock]
	|

Beispiel:
	|---------------------------------------------------
	|-- Informationen
	|---------------------------------------------------
	|
	|Punkte: 3
	|Fragentyp: Num
	|
	|
	|---------------------------------------------------
	|-- Aufgabenfrage
	|---------------------------------------------------
	|
	|Welchen Wert hat y, wenn für die Gleichung \(x=4\,V\), \(a=5\,V^4\) und \(b=1\,V\) gilt?
	|
	|
	|---------------------------------------------------
	|-- Aufgabenantwort
	|---------------------------------------------------
	|
	|Einheit: mV
	|Lösung:  7000,00
	|Min:     6500,00
	|Max:     7500,00
	|
	|
	|---------------------------------------------------
	|-- Lösungsweg
	|---------------------------------------------------
	|
	|In diesem einfachen Beispiel wird die Angabe eines Lösungswegs nicht benötigt. Entsprechend würde dieser Abschnitt leer gelassen.
	|

Hinweis:
	Im Beispiel wird gefordert, dass die Antwort vom Bewerber in Millivolt anzugeben ist.
	Hat das Ergebnis keine Einheit oder wurde in der Aufgabenfrage bereits die Einheit des Ergebnisses festgelegt, so ist kein Text einzutragen, d.h. die Zeile lautet schlicht "Einheit: ".
	Nachkommastellen von Zahlen sind mittels Komma zu trennen.
	Tausendertrennzeichen sind nicht zu verwenden.
