10. Weitergeben: IOF-XML für OE

Mit export gibst du die Bahnen an Auswertungsprogramme weiter, die IOF-XML 3.0 lesen:

freemapper-courseplan export rummelsburg-sprint.courseplan.toml --iof-xml course-data.xml

Das Programm schreibt alle Einzel- und Score-Bahnen der Veranstaltung in die Datei: Posten mit Kartenposition, die Postenfolge jeder Bahn, Streckenlängen, Anstieg, die Lage der Postennummern und die Zuordnung der Bahnen zu Kategorien. Eine vorhandene Datei ersetzt es erst, wenn die neue vollständig geschrieben ist. Ohne --iof-xml tut export nichts und endet mit Fehlercode 2.

Was du wissen solltest:

• Der Titel der Veranstaltung steht in Event/Name. Ein Datum, das du mit event set gesetzt hast, schreibt das Programm als Event/StartTime/Date, einen Veranstalter als Event/Organiser/Name, in der Reihenfolge, die das Schema verlangt. Ohne beide fehlen die Elemente.
• Mannschafts- und Staffelbahnen schreibt das Programm nicht. Es nennt jede übersprungene Bahn mit ihrer Art.
• Eine Score-Bahn steht mit dem Wert jedes Postens in CourseControl/Score. Für das Zeitlimit, den Abzug je angefangene Minute und die Pflichtverbindungen hat das Schema kein Element. Die Bahn trägt sie deshalb in einem Extensions-Element im Namensraum https://github.com/HenryJobst/freemapper-courseplan/ns/score/1 (ScoreCourse mit timeLimitMin, penaltyPerMin und je Paar ein Link). Der Abzug ist der aufgelöste, der Standard eingeschlossen. Programme, die den Namensraum nicht kennen, übergehen ihn. Die Regel, dass bei gleicher Punktzahl die schnellere Läuferin oder der schnellere Läufer gewinnt, steht nicht in der Datei, sondern auf dem Auswertungsbogen (siehe Score-Bahnen).
• Nennst du als Zieldatei die Projektdatei oder die Karte, bricht export mit einem Fehler ab und lässt beide unberührt.
• Ist die Karte georeferenziert, tragen Start, Posten und Ziel Breite und Länge mit sechs Nachkommastellen. Fehlt die Georeferenzierung oder nutzt die Karte ein Koordinatensystem, das das Programm nicht kennt, enthält die Datei nur Kartenpositionen, und export sagt das. OE, OCAD und Condes sind mit diesen Positionen nicht getestet.
• Abgeflaggte Strecken fehlen noch. Die Kartenausdehnung steht als 0/0 mm in der Datei.
• Die Uhrzeit createTime ist UTC und trägt das Zeichen Z. Für die Bahnen spielt sie keine Rolle.
• Das Beispiel course-data.xml ist gegen das IOF-Schema geprüft, und ein Test liest den Export mit dem IOF-Leser von freemapper-course (dem von freemapper-print) wieder ein. Ein Import in OE, Purple Pen oder Condes ist nicht getestet, weil im Projekt niemand OE hat. Wer die Datei dort importiert, soll melden, was ankommt.
• Purple Pen, OCAD und Condes schreiben die y-Achse nach oben, entgegen dem Standard. Dieser Export folgt dem Schema (y nach unten). Zeigt ein Programm die Posten gespiegelt, sag bitte, welches.

Der KI-Assistent hat dafür das Werkzeug export_iof_xml mit project und path; der Pfad muss auf .xml enden. Die Entscheidungen dahinter stehen in ADR 0033.