Spezifikation des CSV Formates zu Importieren und Exportieren von Fragen

Transkript

1 Spezifikation des CSV Formates zu Importieren und Exportieren von Fragen Dieses Dokument spezifiziert das CSV Format zum Im /Export von Hörsaalfragen. Für dieses Projekt sind die folgenden Fragetypen zum Im und Exportieren gefordert: Multiple Choice (MC) Single Choice (SC) Text (Txt) Ja/Nein Fragen (YN) Angaben zu Fotoimports, Links zu andere Seiten oder Fragen sind nicht gefordert und finden hier keine Beachtung. Spezifikation Question Type Question Subject Question Right MC * * * * * * 1,2,... SC ** * * * * * * 1 TXT + + YN + + y n Legende Pflichtfelder: + Optionale Felder: * Felder die nicht belegt werden dürfen: ** ARSnova nutzt hier als Fragetyp abcd statt sc Allgemein Die Reihenfolge der Felder darf nicht vertauscht werden, da der Parser stets von einer Korrekten Reihenfolge ausgeht. Es ist nicht möglich anhand der Semantik eines Textes eine Aussage zu treffen ob es sich um ein Fragenüberschrift (Question Subject), eine Frage (Question) oder eine Antwort handelt. Nachfolgend werden die einzelnen Fragetypen und die dazugehörige Belegung der einzelnen Felder erläutert. Erläuterung der einzelnen Spalten Spalte: Question Type Definiert den Typ einer Frage. Bisher wurde drei Typen für den Im und Export definiert. Multiple Choice (MC), Single Choice (SC), Text (Txt), Ja/Nein Fragen (YN). Der Fragentyp wird, wie in obiger Tabelle dargestellt durch sein entsprechendes Kürzel angeben. Die

2 Angabe der Kürzel ist nicht Case Sensitiv, d. h. es können klein und/oder Großbuchstaben verwendet werden. Spalte: Question Subject Die Überschrift zu einer Frage. Spalte: Question Der Fragetext. Spalte(n): s (1-8) Diese Spalten sind nur bei Multiple Choice, Single Choice und Freitextfragen von belang. Die Belegung wird bei der Beschreibung der einzelnen Zeilen erläutert. Spalte: Right Wird bei allen Fragetypen außer den Freitextfragen (TXT) verwendet und dient bei Singleund Multiple Choice Fragen der Angabe der richtigen Antworten sowie bei Ja/Nein Fragen der Angabe ob eine Frage richtig (Y) oder falsch ist (N). Erläuterung der einzelnen Zeilen Multiple Choice (MC) Die Felder Question Type, Question Subject, Question, mindestens zwei Antworten () sowie das Feld Right s sind verpflichtend auszufüllen. In Right s muss mindestens eine Antwort als richtige Antwort angegeben werden. Dies geschieht durch Angabe der Aufgabennummer. Bei mehreren richtigen werden die entsprechenden Nummern durch Kommata getrennt angegeben. Sind alle Fragen richtig, so kann der Wildcard Character * benutzt werden Ein Beispiel: Die Fragen eins und fünf sind richtig: Im Feld Right s wird 1,5 eingetragen. Alle Fragen sind richtig: Im Feld Right s wird * eingetragen. Single Choice (SC) Die Felder Question Type, Question Subject, Question, mindestens zwei Antworten () sowie das Feld Right s sind verpflichtend auszufüllen. In Right s muss genau eine Antwort als richtige Antwort angegeben werden. Text Hier sind lediglich die Felder Question Subject und Question auszufüllen. Ja / Nein Fragen Hier sind die Felder Question Subject, Question und Right auszufüllen. In Right wird ein richtige bzw. falsche Frage mit Y bzw. N angegeben. Auch hier wird nicht zwischen Groß und Kleinschreibung unterschieden.

3 Spezifikation des JSON Formats Folgende Felder müssen beim Export einer CSV Datei aus der Datenbank geholt werden. Multiple Choice Single Choice questiontype : " sc" questionsubject : " aaaaa " question : " ashdashdk " answer1 : " xxxxx " answer2 : " yyyyy " Right : " 1, 2" questiontype : " mc ", questionsubject : " aaaaa ", question : " ffffff ", answer1 : " xxxxx ", answer2 : " yyyyy ", Right : " 1"

4 Text questiontype : " txt ", questionsubject : " aaaaa ", question : " bbbbb ", answer1: "" //Right : " y " //odern Yes/No questiontype : " yn ", questionsubject : " aaaaa ", question : " bbbbb ", answer1: "" Right : " y " //odern Anhang: Nachfolgend die Attribute (aus einem Question Objekt), welche für den Im /Export von CSV Dateien benötigt werden. Diejenigen Attribute die mit *** gekennzeichnet sind, werden nur zum Import benötigt. (Für die sehenden Gruppenmitglieder sind die Felder zusätzlich noch eingefärbt. Rot: nur Import, Grün: Export (und Import)

5 Multiple choice data: possibles: correct: true text: "blahblah",, correct: false, text: "testfr2" //... max. 8 Fragen questiontype: "mc", subject: "test blah", type: "skill_question" ***

6 Single Choice data: possibles: correct: false, id: "A", text: "A: blah1", correct: true, id: "B", text: "B: blah2", correct: false, id: "C", text: "C: blah3" //... max. 8 Fragen, es darf nur eien richtig sein! questiontype: "abcd", subject: "test blah", type: "skill_question" ***

7 Yes / No data: possibles: correct: true, text: "Yes", correct: false text: "No" questiontype: "yesno", subject: "test blah", type: "skill_question" *** Free Text data: questiontype: "freetext", subject: "test blah", type: "skill_question" ***