Export course data as XML dialog
Previous Topic  Next Topic 

From this dialog, you can export course data as XML (eXtended Markup Language) format files.  The format has been specified in the IOF Interface Standards project, and you can find more information on the IOF home page at http://www.orienteering.org under the menu IOF / IT Commission / Interface Standards project.

The output from the dialog is a file which contains information on control locations, courses, and classes.  For each course is listed the classes that run the course, and the controls that the course visits.  Also, information on leg lengths is included.

This information can be imported into event administration software for easier punch checking.  Also, this information can be imported into various split time analysis programs.

When you click "Export", Condes will prompt you for a file name for the file to which the exported data should be saved.

File Type

Choose between "IOF Version 1.0", "IOF Version 2.0", and "IOF Version 3.0".   IOF Version 5.0 is recommended.  IOF Version 1.0 and 2.0 are available only for backwards compatibility.

Encoding

Choose between "ISO-8859-1" and "UTF-8".  This is the character encoding of texts in the file.  UTF-8 is available only when Condes is running in Unicode mode, and is recommended, as this encoding can handle the 16-bit character values used by the Unicode standard.  ISO-8859-1 is the standard Windows character set, and files using this encoding may depend on the character set used on the computer that is used to generate the file.

Canvas (for control co-ordinates)

The "controls" section of the exported file contains co-ordinate pairs for each control.   These co-ordinates are in units of millimeters on the printed map. 

The exported file can contain only one set of co-ordinates for controls.

Therefore, for an event with multiple maps, it is important to choose the a canvas to use in order to get the correct set of co-ordinates for the controls.

Omit "CourseIDs" (IOF XML version 2 only)

For IOF XML version 2 only: Some event administration software packages depend on having a Course ID number associated with each course in the exported data.   If needed, Condes can include this number in the exported file - just make sure to uncheck this box.

Be aware that the Course ID number that Condes assigns to each course will follow the course through the lifetime of the event file. 

Pitfall:  If you rename a course to a different name, it will keep the existing Course ID number.  This will still happen, even when you rename a course, then create a new course with the old name.  When you then export, there will be a different Course ID associated with the name, because it is really a new course.  This is a potential pitfall, if the receiving event administration software expects a course with the same name always to keep the same Course ID number.

Relay courses

For IOF XML version 3, the file contains complete variations.  For each course the file will have a list of all (selected) course variations.  Each variation will be "a course" with all the controls on the course.  The variations will be tagged with a CourseFamily object indicating the Course they belong to.

For IOF XML version 2, there are four options: