Track import and export exports the structure of a track. It does not export the surveys themselves. These are expected to exist already at both the export and import location.

Also the current version does not export “Appointment filters”. If the track uses “Appointment filters” for automatic appointment linking and / or track creation you will have to manually transfer the filters. We expect to solve this in a future version.

To export a track, select the track in “Trackbuilder” ⇒ “Tracks” and choose “Export”.

The first screen allows you to choose which fields and rounds to export. You can also check or uncheck “Organization export”.

Organization export does not export the organisations in the source GemsTracker installation, but just their names. The organisations existing with the same name the import installation will selected as active for the track during import.

If your track export contains surveys, the next screen will as you to provide export codes for them. Export codes are special survey codes that are only used for track import and export. They are used because the survey can have a different name at the import location. All other possible identifiers can also change from system to system so we need some method to link a survey on the source system and the target system.

Of course if the target system is the source system you will need to enter these codes only during the export. If both systems are different the importer will have to select which survey to link to which export code. If the name of the survey exists on both systems this will be very straightforward, otherwise the right survey can be chosen from a drop-down list.

Survey export codes are stored at the survey level and one survey can have only one survey export code. If you need to change that code edit the survey in the Track Builder.

After setting the export codes (if any was empty) the download of the track definition starts automatically.

The track definition is stored in a tabbed text file with the extension .track.txt. You can edit this file using any text editor, e.g. Notepad.

The definition files contain four type of lines:

1. Identification lines: these lines contain no tab character and identify the type of data, e.g. version, track, fields or rounds.
2. Import field definition lines: the first tabbed line after an identification line, this line contains the names of the imported fields on the next line. Only when exporting track fields every other line is an import field definition line as different types of track fields have different types of import fields.
3. Data line: any tabbed line that is not a import field definition line.
4. Empty lines: these are ignored.

To import a track choose import in the Trackbuilder ⇒ Tracks.