Topic 3.2.1: Overview

  •  Introduction 

  • Conceptually a navigation model is a hierarchically predefined set of map visualizations (Locations) composed of: a map provider, a set of active layers, a default zoom, and a configured location.
  • The panel is divided into three parts. On the left side of the panel there is a list of currently defined navigation models and a set of buttons to perform operations with them. At the center part of the panel there is a tree view that shows the hierarchic distribution of the locations that define a selected navigation model. Finally, on the right side of the panel there is a collection of controls to modify the properties of a selected location of the current navigation model.
  • Navigation Models List
  • Add New: This button allows creating a new navigation model. Upon clicking it a popup window will appear asking the user a name for the new navigation model. Duplicated names are not allowed.Note that only numbers, letters, and the underscore character ‘_’ are valid characters for a name. Invalid characters will be removed from the resultant name.
  • Edit: This button allows editing of a selected navigation model.
  • Duplicate: This button will create a copy of the selected navigation model. The resulting navigation model will be named as the original layer name adding the suffix ‘_Copy’. If a navigation model already exists with that name, an extra incremental numeric suffix will be added.
  • Rename: This button allows changing the name of a selected navigation model.
  • Delete: Clicking this button will delete the selected navigation model and all the locations belonging to it. Before deleting a navigation model the user will be asked for confirmation. This operation cannot be undone.
  • Get Nav. Models: Clicking this button will refresh the list of available navigation models. Usually there is no need to use this button because after performing any operation locally, the list is refreshed automatically.
  • Export Selected Model: This button allows exporting a single selected navigation model with all its locations and properties to a XML file. This is a way to back up a navigation model to be imported later. The file can be edited externally with any text editor.
  • Export All Models: This button allows exporting all the existing navigation models with all its locations and properties into a single XML file.This is a way to back up all the navigation models of a repository to be imported later. The file can be edited externally with any text editor.

  • Import Models: This button allows importing an XML file with previously exported navigation models. Clicking it, the user will be asked to select an XML file within an explorer window. After selecting an XML file, the user will have to choose the way to import the file if a navigation model with the same name is found.
    The import preferences are:

    • Skip – Do not import: If an existing navigation model has the same name as an imported one, the imported one will be ignored and skipped during the importing operation.
    • Rename importing item (numeric append): If an existing navigation model has the same name of an imported one, the one being imported and its locations will be renamed appending an incremental number at the end of its name. The existing navigation model will remain unaffected.
    • Overwrite existing item: If an existing navigation model has the same name of an imported one, the existing one will be overwritten with the one being imported. Configuration of the previously existing navigation model will be lost.
  • Navigation Model Tree

The navigation model tree shows a hierarchical tree view of the locations defined in the navigation model being edited. Except the top one, every node of the tree represents a location.

  • Location Properties

The available location properties can be classified into two groups: Main properties and Layers.

    • Main properties: These are the common properties of the locations, and their controls are located on the right part of the panel.
    • Name: The unique identifier name of the location. There cannot be 2 locations with the same name, even if they belong to different navigation models. This control is only enabled during the process of creating a new location.
    • Map Provider: This combo box allows the selection of the map provider that will be used at the runtime when navigating to the selected location. Note that only enabled map providers can be selected. Map provider cannot be left empty.
    • Coordinates: This textbox shows the coordinates (latitude and longitude) of the map that will be centered at the runtime when navigating to the selected position. The coordinates can be easily selected by clicking the Select Coord. button. It will open a new window with a GISIZE GEOSpatial control. Left clicking the map to set the coordinates. The default value is 0,0.
    • Marker/Shape: This is an alternative method to the coordinates. User can type the name of an existing marker or shape instance and the map will be centered at the runtime over the item when navigating to the selected location. The item can be easily selected by clicking the Select Item button. It will open a new window with a list of the currently existing marker and shape instances. The default value is empty.
    • Zoom: Indicates the zoom of the map that will be applied at the runtime when navigating to the selected location.
    • Location Icon: This control allows the association of an image to the location. This image will be shown at the runtime in the Navigation Models Tab. Clicking the Control button will open an explorer window to select an image. If the location has a previously associated image, it will be shown inside the control.
    • Layers
      Located at the right-bottom side of the panel, there is a tree view that contains the current layers accessible by the previously selected map provider. Each node of the tree (except the very top one) represents a layer.Note that even if a children layer is marked as enabled by a certain map provider, if the parent layer is not enabled, the children node will not appear in the tree view, thus making it not selectable.

Last modified: Thursday, 16 April 2020, 12:06 PM