10. Handing on: IOF XML for OE

export passes the courses to scoring software that reads IOF XML 3.0:

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

The program writes all individual and score courses of the event to the file: controls with map position, the control order of each course, leg lengths, climb, the position of the control numbers and the assignment of courses to classes. It replaces an existing file only once the new one is completely written. Without --iof-xml, export does nothing and exits with code 2.

Things to know:

• The event title goes into Event/Name. A date that was set with event set is written as Event/StartTime/Date and an organizer as Event/Organiser/Name, in the order the schema demands. Without them the file has neither element.
• Team and relay courses are not written. The program names each skipped course with its kind.
• A score course is written with the value of each control in CourseControl/Score. The schema has no element for the time limit, the penalty per started minute or the mandatory links, so the course carries them in an Extensions element in the namespace https://github.com/HenryJobst/freemapper-courseplan/ns/score/1 (ScoreCourse with timeLimitMin, penaltyPerMin and one Link per pair). The penalty is the resolved one, the default included. Programs that do not know the namespace ignore it. The rule that the faster runner wins on equal points is not part of the file; it stands on the evaluation sheet (see Score courses).
• If the target is the project file or the map, export stops with an error and leaves both untouched.
• If the map is georeferenced, start, controls and finish carry latitude and longitude with six decimals. Without georeferencing, or with a coordinate system the program does not support, the file has map positions only, and export says so. OE, OCAD and Condes have not been tested with these positions.
• Taped legs are missing for now. The map extent is written as 0/0 mm.
• The time createTime is UTC and carries the marker Z. It does not affect the courses.
• The example course-data.xml validates against the IOF schema, and a test reads the export back through the IOF reader of freemapper-course (freemapper-print's). An import into OE, Purple Pen or Condes has not been tested, because nobody on the project has OE. If you import the file there, please report what arrives.
• Purple Pen, OCAD and Condes write the y axis upward, against the standard. This export follows the schema (y downward). If a program shows the controls mirrored, tell us which one.

The AI assistant has the tool export_iof_xml for this, with project and path; the path must end in .xml. The decisions behind it are in ADR 0033.