LTO-Dateiformat

Das .lto-Format ist das XML-Austauschformat von LeTTo für Fragen und Fragesammlungen. Es lehnt sich an Moodle-XML an, enthält aber alle LeTTo-spezifischen Daten (Teilfragen, Datensätze, Maxima-Berechnungen, Einheiten, Plugins, eingebettete Bilder). Exportiert und importiert werden .lto-Dateien vom Export-Service.

• Export: Fragesammlung → Rechtsklick auf einen Ordner → „Kategorie exportieren“ (alle Fragen und Unterordner, siehe Ordnerverwaltung)
• Import: Rechtsklick auf den Zielordner → „Daten importieren“ → .lto-Datei wählen

Diese Seite beschreibt das Format Version 1 (<letto mode="101">) vollständig. Sie richtet sich an alle, die .lto-Dateien mit eigenen Programmen oder mit KI-Unterstützung erzeugen oder auswerten wollen.

Downloads

Prüfen einer Datei:

python validate_lto.py meine-fragen.lto
xmllint --noout --schema lto-v1.xsd meine-fragen.lto

Aufbau

<?xml version="1.0" encoding="UTF-8"?>
<letto mode="101" databaseinfo="sql">       Wurzel, genau EIN Kindelement:
   <category>                                 Ordner mit Fragen und Unterordnern   oder
   <question type="MoodleClozeCalc">          eine einzelne Frage                  oder
   <subquestion>                              eine einzelne Teilfrage
</letto>

category
├─ name
├─ question*
│  ├─ Einzelfelder (id … changeLogMap, questionCommentMsg, questionCommentIcon)
│  ├─ text*            Fragetext und Feedbacks, je mit inhalt und file*
│  ├─ subquestion*     Teilfragen (Lücken) mit answer*
│  └─ dataset*         Datensätze (Zufallsvariablen)
└─ category*           Unterordner

Allgemeine Regeln:

• Kodierung UTF-8. Zeichen 0x01–0x08, 0x0B, 0x0C, 0x0E–0x1F werden beim Import entfernt.
• Reihenfolge: LeTTo schreibt alle Elemente in einer festen Reihenfolge (siehe Tabellen und Schema). Der Import liest die Einzelfelder einer Frage, Teilfrage, Antwort und eines Datensatzes unabhängig von der Reihenfolge, Erzeuger sollten sich aber an das Schema halten.
• CDATA-Pflicht: Alle Felder vom Typ Text (CDATA) liest der Import ausschließlich aus einem <![CDATA[...]]>-Abschnitt. <name>Test</name> ergibt einen leeren Namen. Leere Felder werden als <feld/> geschrieben. Ausnahme ist category/name, das auch ohne CDATA gelesen wird.
• Zahlen, Booleans und Enum-Werte stehen ohne CDATA im Element. Booleans: true/false (der Import akzeptiert auch 1/0). Enum-Werte schreibt LeTTo als Zahl, der Import akzeptiert auch den Namen.
• IDs (id, idUser, Attribut id) stammen aus der Quelldatenbank und werden beim Import neu vergeben. Für neu erzeugte Dateien 0 verwenden.

Wurzelelement letto

Der Import liest nur das erste Kindelement. Neben category, question und subquestion wird beim Import auch test akzeptiert und wie category behandelt; LeTTo exportiert dieses Element nicht.

Kategorie category

Beim Einlesen der Datei werden gleichnamige Unterordner desselben Ordners zusammengeführt, identische Fragen nur einmal übernommen und gleichnamige Fragen eindeutig gemacht, indem -1 angehängt bzw. die Endnummer erhöht wird (Name-1, Name-2, …). Das betrifft nur den Inhalt der Datei; welche Fragen und Ordner tatsächlich in den Zielordner übernommen werden, wird im Import-Dialog festgelegt.

Frage question

Das Attribut type enthält den Fragetyp als Namen (z.B. MoodleClozeCalc) und dient nur der Lesbarkeit; maßgeblich ist das Element questionType. Die Einzelfelder in Exportreihenfolge:

Text text

<text art="Questiontext" id="0" format="html">
   <inhalt><![CDATA[<p>Berechnen Sie $I = $ [Q0]</p>]]></inhalt>
   <file …>…</file>
</text>

Die Texte werden über ihre Position zugeordnet; das Attribut art ist nur informativ und wird beim Import ignoriert:

LeTTo exportiert immer die ersten sechs Texte. Attribute: id (Ganzzahl), format (html oder leer). Der Inhalt inhalt ist HTML in CDATA. Die Syntax des Fragetexts ist im Editor für den Angabetext beschrieben; die wichtigsten Elemente:

Datei file

Eine eingebettete Datei (meist ein Bild) gehört zu dem Text, in dem sie steht.

Inhalt ist genau eines der Elemente:

• base64 – Dateiinhalt Base64-codiert in CDATA (so exportiert LeTTo)
• webPath – URL in CDATA, von der die Datei beim Import geladen wird
• inhalt – veraltete Schreibweise für base64

Ein file ohne Inhalt (beim Export, wenn die Datei am Server fehlt) wird beim Import verworfen.

Teilfrage subquestion

Eine Teilfrage ist eine Lücke im Fragetext und wird dort über [Name] platziert.

Antwort answer

Alle Textfelder in CDATA. Die Bedeutung von text, answer und maxima hängt vom Modus der Teilfrage ab (siehe Lösung der Antwort):

Belegung je Modus (aus LeTTo-Exporten):

Datensatz dataset

Ein Datensatz ist eine Zufallsvariable der Frage, siehe Datensätze definieren.

Aufzählungen

Fragetyp questionType

LeTTo verwendet praktisch nur die Mehrfachberechnungsfrage 22; die Art jeder Lücke bestimmt der Teilfragen-Modus. Siehe auch Fragetypen.

Teilfragen-Modus mode

Der Import akzeptiert auch die Namen; SHORTANSWER wird als TEXT gelesen.

Lückentextmodus single

0 MultipleChoice, 1 SingleChoice, 2 Texteingabe, 3 DragAndDrop, 4 RegularExpression, 5 CaseSensitive.

Antworten mischen shuffleAnswers

0 Nicht_mischen, 1 Mischen, 2 Nur_links_mischen, 3 Nur_rechts_mischen (2 und 3 für Zuordnungen), 4 Normal, 5 Streng, 6 Mild (4–6 für Bildabgaben).

Bewertungsmodus schwierigkeit

0 Normal, 1 Streng, 2 Mild, 3 HundertProz – Bedeutung je Fragetyp siehe Beispielsammlung editieren.

Beispiele

Alle Beispiele sind gültig nach Schema und Prüfskript und können direkt importiert werden:

• 01-berechnung-ohmsches-gesetz.lto – Mehrfachberechnungsfrage mit zwei Datensätzen, Maxima-Feld und Einheiten
• 02-auswahl-und-text.lto – Single-Choice, Multiple-Choice mit negativer Bewertung und Texteingabe in einer Frage
• 03-kategorie-mit-unterordner.lto – Fragesammlung mit Unterordner

KI-Unterstützung

Für das automatische Erzeugen von Fragen mit KI gibt es eine kompakte Formatbeschreibung als Skill im offenen Agent-Skills-Format: letto-lto-skill.zip. Das Archiv enthält den Ordner letto-lto mit SKILL.md (Anleitung und Regeln), den Beispielen, dem Schema und dem Prüfskript.

Danach genügt eine Anfrage wie „Erstelle 5 LeTTo-Rechenaufgaben zum Ohmschen Gesetz für die 1. Klasse HTL als .lto-Datei“. Erzeugte Fragen werden mit dem Kommentarstatus „in Bearbeitung“ importiert und sollten in der Fragen-Vorschau geprüft werden.

Bekannte Abweichungen im Code

Diese Punkte betreffen das Verhalten von Export und Import, nicht das Format. Die ersten vier sind in letto-export (Branch version-1.3) nach Revision 7045 behoben; Server mit älterem Export-Service zeigen das beschriebene Verhalten noch:

• penalty: Der Export schreibt den Abzug als <penalty>, ältere Importe lesen nur <abzug>. Der Abzug geht dort bei Export und erneutem Import verloren. Jetzt werden beide Elemente gelesen.
• Fehlende break im Import: Ab creationDate fehlten in XmlImport.parseQuestion die break-Anweisungen. Jedes dieser Felder wurde zusätzlich in die nachfolgenden Felder gelesen. Fehlt questionCommentMsg, entsteht bei älteren Importen ein Kommentar mit dem Inhalt von changeLogMap (meist {}) und dem Status PROCESSING.
• Datum: creationDate und lastChange wurden immer leer exportiert (XmlExport.XMLDate verwarf das formatierte Datum).
• licenceKey: wurde als <licenceKey > mit Leerzeichen geschrieben; das ist gültiges XML und wird korrekt gelesen.
• Kompetenzen der Teilfragen (ExportKompetenzSubquestionV1) sind im DTO vorhanden, werden aber nicht exportiert.

Quelle

Das Format ist im Projekt letto-export definiert:

• exportservice/…/service/threads/XmlExport.java – Schreiben
• exportservice/…/service/threads/XmlImport.java – Lesen
• exportservice/…/xml/XMLfileLTO.java – Wurzelelement und Formaterkennung
• exportclient/…/dto/questions/*.java – Datenklassen
• tools/…/enums/*.java (LeTTo-Server) – Aufzählungen

Das Schema wurde gegen 132 reale LeTTo-Exporte mit 1091 Fragen geprüft.