Tool: 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:

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:

Computed Fields

These fields are computed and depend on other fields:

Other Fields

Editing for these fields is currently not supported:

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:

1. 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.
   
   
2. 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

	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

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.

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.