Format der CSV-Datei

Owned by Lena Zeifang
Last updated: Sept 12, 2024
2 min read

  • Es muss in der Datei mindestens eine Frage vorhanden sein.

  • Die Datei muss zwingend eine Titelzeile mit den vorgegebenen Titeln enthalten (siehe Beispiel).

  • Es sind keine zusätzlichen Spalten erlaubt.

  • Die Spalte Fragenummer und Sprache sind bei einsprachigen Lernpaketen optional und bei mehrsprachigen Lernpaketen zwingend erforderlich.

Definition des CSV-Formats

Die folgende Tabelle definiert die Vorgaben an die Spalten der CSV-Datei. Die Vorgaben für die gelb markierten Spalten sind abhängig vom Fragetyp und im nächsten Abschnitt erläutert.

Spalte

Notwendigkeit

Wert

Fragetyp

erforderlich

  • Vorgegebener Wert:

    • SingleTextChoice

    • TrueFalse

    • MultipleTextChoice

    • FreeText

    • ReflectionFreeText

Fragenummer

erforderlich

  • Nummer

  • Dieselbe Frage in einer unterschiedlichen Sprache hat dieselbe Fragenummer

  • Fragen in derselben Sprache dürfen nicht dieselbe Fragenummer haben.

Sprache

erforderlich

Die Sprache muss in Format einer Locale angegeben werden (Landeskürzel-Sprachkürzel). Beispiele: de-CH oder en-US

Frage

erforderlich

  • Text

  • maximal 1'000 Zeichen

Fragebild URL

optional

URL die mit https:// startet

Fragemedia URL

erforderlich wenn Fragemedia Typ definiert

URL die mit https:// startet

Fragemedia Typ

erforderlich wenn Fragemedia URL definiert

  • Vorgegebener Wert:

    • Audio

    • Film

    • Webseite

Antwort A

Abhängig vom Fragetyp

  • Text

  • maximal 1'000 Zeichen

Korrektheit A

Abhängig vom Fragetyp

  • Vorgegebener Wert:

    • korrekt

    • falsch

Erklaerung A

Abhängig vom Fragetyp

  • Text

  • maximal 3'000 Zeichen

Antwort B

Abhängig vom Fragetyp

siehe Antwort A

Korrektheit B

Abhängig vom Fragetyp

siehe Korrektheit A

Erklaerung B

Abhängig vom Fragetyp

siehe Erklaerung A

Antwort C

Abhängig vom Fragetyp

siehe Antwort A

Korrektheit C

Abhängig vom Fragetyp

siehe Korrektheit A

Erklaerung C

Abhängig vom Fragetyp

siehe Erklaerung A

Antwort D

Abhängig vom Fragetyp

siehe Antwort A

Korrektheit D

Abhängig vom Fragetyp

siehe Korrektheit A

Erklaerung D

Abhängig vom Fragetyp

siehe Erklaerung A

Antwort E

Abhängig vom Fragetyp

siehe Antwort A

Korrektheit E

Abhängig vom Fragetyp

siehe Korrektheit A

Erklaerung E

Abhängig vom Fragetyp

siehe Erklaerung A

Erklaerung

Abhängig vom Fragetyp

  • Text

  • maximal 3'000 Zeichen

Erklaerungsbild URL

optional

URL die mit https:// startet

Erklaerungsmedia URL

erforderlich wenn Erklaerungsmedia Typ definiert

URL die mit https:// startet

Erklaerungsmedia Typ

erforderlich wenn Erklaerungsmedia URL definiert

  • Vorgegebener Wert

    • Audio

    • Film

    • Webseite

Quellen-URL

optional

URL die mit https:// startet

Quellenbezeichnung

erforderlich wenn Quellen-URL definiert

  • Text

  • maximal 100 Zeichen

Tags

optional

Tag 1, Tag 2

Fragetypspezifische Vorgaben

Fragetyp SingleTextChoice

  • Es müssen mindestens 3 Antworten und die entsprechende Korrektheit angegeben werden (Antwort A, Antwort B, Antwort C).

    • Für definierte Antworten kann die Erklaerung X optional angegeben werden.

  • Es dürfen maximal 5 Antworten definiert werden (bis und mit Antwort E).

  • Die Spalte Erklaerung wird beim Import ignoriert (bzw. soll nicht angegeben werden).

  • Antworten müssen unterschiedliche Werte enthalten.

  • Es darf nur eine Antwort den Wert korrekt enthalten.

Fragetyp MultipleTextChoice

  • Es müssen mindestens 3 Antworten und die entsprechende Korrektheit angegeben werden (Antwort A, Antwort B, Antwort C).

    • Die Erklaerung X für die definierte Antworten wird ignoriert (bzw. soll nicht angegeben werden).

  • Es dürfen maximal 5 Antworten definiert werden (bis und mit Antwort E).

  • Die Spalte Erklaerung wird importiert.

  • Antworten müssen unterschiedliche Werte enthalten.

  • Es muss mindestens eine Antwort den Wert korrekt enthalten.

Fragetyp FreeText

  • Antwort A muss definiert werden.

    • Die Spalten Korrektheit X und Erklaerung X werden beim Import ignoriert.

  • Es dürfen maximal 5 Antworten definiert werden (bis und mit Antwort E).

    • Ab Antwort B werden die Antworten als Antwortalternativen importiert.

  • Die Spalte Erklaerung wird importiert.

  • Antworten müssen unterschiedliche Werte enthalten.

Fragetyp TrueFalse

  • Antwort A muss den Wert richtig enthalten.

  • Antwort B muss den Wert falsch enthalten.

  • Je eine der Antworten A und B muss im Feld Korrektheit den Wert korrekt und falsch haben.

  • Es dürfen keine weiteren Antworten definiert werden.

  • Die Erklaerung X für die definierte Antworten wird ignoriert (bzw. soll nicht angegeben werden).

  • Die Spalte Erklaerung wird importiert.

Fragetyp ReflectionFreeText

  • Es dürfen keine Antworten angegeben werden (bzw. werden diese ignoriert).

Beispiel-Datei

Hier findest du ein beispielhaftes Exemplar einer CSV-Datei, die den Aufbau zeigt und du als Vorlage verwenden und herunterladen kannst:

Â