Tour Editor
Capabilities for the tour editor:
- modify data for a tour
- edit/delete time slices
- create/edit/delete markers
- reference tours can be created in the Tour Chart view
New Implementation
The tour editor is completly new implemented in version 8.11 and works total different than the previous versions. One of the big differences is, there is only ONE tour editor and not multiple as before.
Content shortcuts
Open Editor
Display Tour
Edit Tour
Modify Tour Externally
Actions
Toggle Row/Column Mode
Create New Tour/Event
Out of Synch Error
Open Editor
The tour editor 
can be opened
- in the context menu within views, where a tour is displayed or can be selected
- in the application toolbar
- in the menu Views/Tour Editor
Display Tour
The tour editor displays the tour which is selected in a view, e.g. Tour Import view, Tour Book view, Statistics view, ...
When a tour is modified and another tour is selected somewhere else, the tour editor is still displaying the modified tour until the tour is saved or discarded. The header in the tour editor displays a message when another tour is selected.
The data for the tour are displayed in 4 tabs:
|
Tour
|
Marker
|
Time Slices
|
Info
|
Marker
The markers are displayed also in the marker view 
which is synchronized with the marker tab when markers are modified.
Edit Tour
All saved tours can be edited. When a tour is selected in the Tour Import view 
and is not saved, editing is disabled.
Editable Fields
All fields can be edited which are not computed and which are available in the imported data.
When a field is edited, the modification will be displayed immediatedly in other views where this tour is also displayed. There is one exception, the Statistics view shows only data which are saved in the database.
These fields can be modified:
| Tour |
title, description, start/end location, date, time, tags, tour type |
| Time Slices |
altitude, heartbeat, temperature, cadence, latitude, longitude |
| Marker Table |
label |
Personal Details
| Rest Pulse | a field which can be used to keep track of your pulse during rest (e.g. just after waking up in the morning of the trip) |
Weather
| Wind direction | the average wind direction in degrees: North is 0°, East is 90°, South is 180°, West is 270° |
| Wind speed | the average wind speed during the trip |
| Clouds | an informal description of the weather experienced during the trip |
| Temperature | the average temperature of the trip |
Computed Fields
These fields are computed and depend on other fields:
| Tour |
distance |
| Time Slices |
speed, pace, gradient, altimeter |
Other Fields
Editing for these fields is currently not supported:
| Time Slices |
time, distance |
Modify Tour Externally
When the tour editor is opened, it always displays the selected tour. When modifications are done in other views, e.g. setting the tour type in the tour book view, there are two cases:
- Tour in the tour editor IS already modified
Modification which are done in other views will not be saved, they must be saved in the tour editor, modifications can also be discarded. - Tour in the tour editor IS NOT modified
Modifications which are done in other views, are saved directly into the database when the value is applied, these modifications cannot be discarded.
Actions
Toolbar Actions
 |
Save Tour |
saves the modifications into the database, the action is enabled when the tour is modified |
 |
Undo All Modifications |
discards all modifications which are done in the tour editor, by reloading the tour from the database. this action is intentionally concealed to press it not accidently, it is available in the view menu |
 |
Toggle Read/Edit Mode | toggles the editor between read and edit mode in the read mode, it is easier to select the markers or time slices with the mouse without putting a cell into edit mode |
 |
Toggle Row/Column Mode |
see below |
| |
Edit Marker |
opens marker dialog |
 |
Adjust Altitude |
opens adjust altitude dialog |
 |
Create New Tour/Event |
see below |
Marker Actions
available in the context menu for the marker table
| |
Edit Marker |
edits the selected marker in the marker dialog |
 |
Delete Marker |
deletes the selected marker |
Time Slice Actions
available in the context menu for the time slice table
 |
Create Marker |
creates a marker for the selected time slice a marker can also be created by entering the label in the marker cell, the corresponding marker is automatically created |
| |
Edit Marker |
edits the selected marker in the marker dialog, when the selected time slice does not contain a marker, the first marker is selected in the dialog |
| |
Delete Time Slices and Remove Time |
deletes the selected time slices, the time and distance for the deleted time slices are also removed this action can also be done by pressing the DEL key |
| |
Delete Time Slices and Keep Time |
deletes the selected time slices, the time and distance for the deleted time will not be removed |
| Set Start Distance to 0.000 km/mi |
this action sets the start distance to 0 and subtracts the distance difference in all time slices. This action is enabled when a tour do not start at the distance of 0.000 km/mi | |
| Remove all Distance Values... |
sets the tour distance to 0 km/mi and deletes all distance values from the time slices, this action can be used when recorded distance values are completely wrong, which can happen :-( and why this action exists |
|
| Compute distance Values from Geo Positions... |
computes distance values from the geo locations and overwrites existing distance values |
|
| Split Tour... |
this action is enabled when one time slice is selected, the action is described here... |
|
| Extract Tour... |
this action is enabled when multiple time slices are selected, the action is described here... |
|
| Export Tour |
exports a tour, in the export dialog only the selected time slices can be exported, the action is described here... | |
| Export Time Slices in CSV Format... |
selected time slices can be exported as csv file but this file cannot be imported into MyTourbook because it contains only time slices and not required tour data |
Deleting Time Slices
When a tour contains a reference tour, deleting time slices is currently not supported because this can modify the reference tours.
Toggle Row/Column Mode
Time slices and markers can be edited directly in the table.
When clicking with the mouse into an editable field, the value can modified, this can be done in the row or column mode.
Column Mode
The editable cells can be navigated with the keyboard.
| Key |
Action |
| Enter |
cell is selected: switch to edit mode |
|
Ctrl-Enter |
when a cell is in edit mode: |
| Tab Shift-Tab |
when a cell is in edit mode: Tab edits the next editable cell Shift-Tab edits the previous editable cell |
Row Mode
When multiple rows are selected, the selection is visible. Using the column mode, only one cell is displayed as selected, however other rows could also be selected but are not visible.
This is the reason why the row mode is required when time slices or markers are deleted.
Create New Tour/Event
The action in the tour editor toolbar creates a tour manually, this can also be used to create an event. The tour type can be used, to distinguisch an event and a tour.
A created tour will be saved for the person which is selected in the main toolbar.
The computed values for imported tours like distance or tour time, can be edited in manually created tours. These tours do not have markers or time slices, therefore the corresponding tabs are empty.
Out of Synch Error
Implementing the tour editor required a lot of restructuring the application internally.
The tour editor displays always the currently selected tour, but sometimes, depending on the actions which are done, the tour editor contains the wrong data for the same tour.
It really took a lot of time to get this fixed, but there are so many situations. Hopefully you will never see this error and all cases are covered.
This message box is displayed when the error occures and it explains what can be done.
