Skip to main content

The web GUI

Scope​

This page provides information required to operate the MapCore™ Map Layer Server via GUI in browser. The chapter describes the GUI controls and functions and provides detailed instructions on how to operate the server using GUI.

This page is intended for operators who are authorized to manage the MapCore™ Map Layer Server.

Start the GUI Client​

  1. If not already running, start the MapCore™ Map Layer Server. Refer to Server Start for detailed instructions.

  2. Using any of the supported browsers (see Minimum System Requirements), navigate to the following URL:

http://<server>:<port>

Where:

  • <server> is either:

    • localhost, when the GUI client and the MapCore™ Map Layer Server are running on the same machine,

    • Server’s DNS name or IP address when the GUI client and the MapCore™ Map Layer Server are running different machines.

  • <port> is the port on which the server is running. Refer to Server Execution Parameters for details.

For example:

http://localhost:6767

This section is divided into two high-level aspects of the GUI:

  • User Interface Structure, which describes the structure and use of each area of the MapCore™ Map Layer Server graphic interface.

  • User Interface Controls, which describes the purpose and manner of use of controls found in the different interface areas.

Refer to Server actions in the web GUI, Groups and the layer backlog and Layers in the web GUI for detailed instructions on how to perform different tasks using the MapCore™ Map Layer Server graphic interface.

User Interface Structure​

The GUI window consists of the following components as detailed in Figure 4-1 User interface structure below. Each of these sections further described below. Controls available for each component on the screen are detailed and explained in User Interface Controls while instructions for achieving any goal using the graphical interface are detailed in Server actions in the web GUI, Groups and the layer backlog and Layers in the web GUI.

Figure 4-1

Figure 4-1 User interface structure

Where:

  1. Content repository search box.

  2. Preview controls, when applicable.

  3. Action display.

  4. Content repository.

  5. Log display.

This field is used to search for layers within both the Map Layer Repository and the Layer Backlog group. Typing in the field results in a filtered list in the Content Repository area, displaying only groups and layers matching the string present in the search box. Refer to the Content Repository for more details on the group and layer display as well as the Layers Backlog.

Figure 4-2 Figure 4-2

Figure 4-2 Layers and their groups displayed as per searched string

Preview Perspective​

Preview controls are only displayed when the Preview area is active.

Figure 4-3

Figure 4-3 Preview controls

The preview controls are used to toggle between different preview perspective modes: map, 3D, and DTM.

Where:

  • Map displays a 2D perspective of the previewed map.

  • 3D displays a 3D perspective of the previewed map.

  • DTM displays DTM information terrain altitudes in colors (from blue for the lowest values through green, yellow, and orange to brown for the highest values). Available for both 2D and 3D previews but only when the group contains 3D information.

Content Repository​

The Content Repository is a tree-like formation of all groups and layers present on the server. It is divided into two separate parts: the Layers Backlog and the Map Layer Repository, both of which are always present in the Content Repository display. The layer backlog contains only layers and no groups. In the Map Layer Repository, layers must be associated with a group. The hierarchical formation holds the following elements, which are further detailed below:

Figure 4-4

Figure 4-4 Hierarchical view of the Content Repository area

Where:

  • The number next to each group’s name represent the number of layers associated with that group

  • The More Options (three dots) menu at the end of each row allows access specific actions relevant for that type of entity.

Layer Backlog​

The first group displayed in the Map Layer Repository is always the Layer Backlog group. This group contains layers that will not be visible to client applications but exist in the server's repository and can be managed by an operator. The Layer Backlog group can contain layers of any type. Deleting a layer from this group permanently removes the layer from the server.

Refer to the Layer Backlog for a detailed explanation of the layer backlog.

Refer to Layer Backlog Controls for further details on controls available for this group.

Refer to Layer Backlog Actions for detailed instruction how to perform operations related to this group.

Map Layer Repository Bar​

This is the top hierarchy in the tree-like formation of the Content Repository area. It allows access to server-related operations.

Refer to Server Controls for further details on controls available in this section of the GUI display.

Refer to Server-related Actions for detailed instruction how to perform server-related operations.

User-created layer groups​

A group is a container of layers managed by the server and reflected in client applications. Groups are used to organize layers and preview grouped layers, so layers should be grouped based on shared characteristics such as geographic location. For grouped layers to be previewed properly together, all layers in the group must share a common area of interest, their target coordinate system, and their tiling scheme.

Refer to Group for a detailed explanation of groups.

Refer to Coordinate System for detailed information on the layer’s coordinate system.

Refer to Tiling Scheme for detailed information on the tiling scheme and its relationship to the layer’s coordinate system.

Refer to Group Controls and Group and Layer Preview Controls for further details on controls available to groups and their preview option.

Refer to Group-related Actions for detailed instruction on how to perform operations related to groups.

Layers​

Layers are the building blocks of all maps and must be associated with a layer group. As such, layers can only be added via the user-created group actions. When a group is removed, layers of that group are moved to the Layer Backlog group.

Refer to the Basic Concepts for a detailed explanation of layers and their different types.

Refer to Layer Controls and Group and Layer Preview Controls for further details on controls available to groups and their preview option.

Refer to Layer-related Actions for detailed instruction on how to perform operations related to individual layers.

Action Display​

The Action Display area displays two different functions, as detailed below:

  • Running processes

  • Map preview

Running processes​

Used to display process status and counters when processes are run.

Figure 4-5

Figure 4-5 Running processes display

The layer progress bars show the upload progression of the specified layer. Each status of the progress bar triggers a different counter in matching color as detailed in the following table:

Table 4-1 Layer upload progress bar and counters

ColorProgress barCounterDescription
YellowUpload in progressIn ProgressShows the number of layers that are currently being added to the server.
GreenUpload successfully completedCompletedShows the number of successfully added layers out of the total number of upload attempts since the last counter reset.
RedUpload failedFailedShows the number of layers that had failed to upload since the last counter reset.
Post processRaw layer post-processing in progressPost processShows the number of post-upload processes in progress, such as raw to native layer conversion in progress.

All past uploads are displayed in the Action Display area and the counters until counter reset. Refer to Reset Upload Counters for detailed instructions on resetting the counters. Process-related activities are documented in the MapCore™ Map Layer Server’s log file, which is displayed on the graphic user interface for convenience. Refer Section to for detailed information.

Map preview​

Used to display single layers or the combined image of the grouped layers being previewed. Refer to Preview Layer on preview actions.

Figure 4-6

Figure 4-6 Map preview

Log Display​

Highlights of activities that are performed through the Action Display are recorded in the Log Display area, capturing the following information:

  • Layer-related actions successfully completed, such as successful upload or successful deletion.

  • Warning messages reflecting partial process failure (such as partial import of multiple layers).

  • Error messages reflecting essential process failure such as missing critical data.

Figure 4-7

Figure 4-7 When activity is complete, log is displayed

The GUI log may be exported into a text file via the Log Display. The exported file will capture all log messages currently displayed in the Log Display. Log files exported through the GUI are found in your browser’s download folder and are saved with the file name: logs_<timestamp>.txt where timestamp is presented in this format: YYYY_MM_DD_HH_MM_SS (such as: logs_2023_11_21_09_34_28.txt).

note

The GUI log file is a concise version of the full server log file and does not affect the server session log file. Refer to Server Log File for details on the server log file.

Refer to Log Display Actions for detailed instructions regarding all actions available for the Log Display.

User Interface Controls​

Below are described controls and menu options available in the different contexts of the MapCore™ Map Layer Server:

  • Server Controls

  • Layer Backlog Controls

  • Group Controls

  • Layer Controls

  • Group and Layer Preview Controls

  • Layer and Server Parameter Controls

  • Log Display Controls

Server Controls​

The More options menu on the Map Layer Repository allows access to the server as detailed in the table below.

Figure 4-8

Figure 4-8 Map Layer Repository More options menu

Where:

Table 4-2 Map Layer Repository More options menu elements

ElementAllows you to….
Add GroupAdd a new group to Layer Map Repository. Refer to Add New Group for detailed instructions.
Import MC PackageAllows to import a group of layers or any type of individual layer that had been previously exported from MapCore™. Refer to Import MC Package for detailed instructions.
Export RepositoryExport entire contents of the Map Layer Repository as an MC Package. Refer to Export Group and Export Layer for instructions on exporting only some groups and layers. Refer to Export Repository for detailed instructions.
Server ConfigurationDisplay and edit key server configuration data. Refer to Change Server Configuration for detailed instructions.
Preview ConfigurationConfigure preview options. for current browser on current device. Refer to Configure Preview Options for detailed instructions.
AboutDisplay software versions of both: ž MapCore Map Layer Server ž MapCore viewer Refer to View MapCore™ Server Version Number for detailed instructions.

Layer Backlog Controls​

The only option available from the Layer Backlog More options menu is to clear the backlog as detailed in the table below.

Figure 4-9

Figure 4-9 More options menu for Layer Backlog

The Layers Backlog group contains only layers and no groups. The More options menu for layers within the Layers Backloggroupallows access to management and preview options as detailed in the table below. Options in this menu vary depending on whether the operation applies to a single layer or a selection of multiple layers.

note

It is impossible to export layers that have been moved to the Layer Backlog. To export such layers, it would first be necessary to associate them with a group, after which they may be exported via the Group or Layer bars.

Refer to Move to Groups for instructions on associating backlog layers with groups.

Refer to Export Group andExport Layer for instructions on exporting layers.

Figure 4-10

Figure 4-10 More options menu for layers in the Layer Backlog group

Where:

Table 4-3 Layer Backlog and backlog layer More options menu options

ElementAllows you to….
Clear BacklogRemove all unused layers from the server. WARNING This action deletes all backlog layers from the server and cannot be undone. Refer to Delete All Layers for detailed instructions.
Move to GroupsAttach layers to one or more groups. Refer to Move to Groupsfor detailed instructions.
Delete LayersRemove layers from the server. WARNING This action deletes the specified layer from the server and cannot be undone. Refer to Delete Layers for detailed instructions.

Refer to Layer Backlog Actions for detailed instructions regarding all actions available for the Layers Backlog.

Group Controls​

The group More options menu allows access to group management and preview options as detailed in the table below. Options in this menu vary depending on whether the group is empty or already has associated layers.

| --- | --- | --- | --- | | Figure 4-11 | Figure 4-11 | Figure 4-11 | Figure 4-11 | | (a) More options menu of an empty group | (b) More options menu of a populated group | (c) More options menu of populated group in multi-group selection | (d) More options menu of non-populated group in multi-group selection |

Figure 4-11 More options menu for group

note

Groups can only be added through the Map Layer Repository bar. Refer to Add New Group for detailed instructions.

Table 4-4 Group More options menu options

Menu optionAllows you to….
PreviewPreview all the layers in the group together. Refer to Preview Group Content for detailed instructions.
Add LayerAdd a new layer to the group. Refer to Add New Layerfor detailed instructions.
Export GroupExport the group layers. Refer to Export Group for detailed instructions.
Rename GroupChange the group’s name. Refer to Rename Group for detailed instructions.
Remove GroupRemove group(s) from the Map Layer Repository. All group layers, including those that are associated with other groups, will be moved to the Layer Backlog group and will not be available to the client applications. Refer to Remove Group for detailed instructions.

Refer to Group-related Actions for detailed instructions on all actions available for user-created groups.

Layer Controls​

The layer More options menu allows access to layer management and preview options as detailed in the table below. Options in this menu vary depending on whether the operation applies to a single layer or a selection of multiple layers. The layer controls for the Layer Backlog group are described in Layer Backlog Controls.

| --- | --- | --- | | Figure 4-12 | Figure 4-12 | Figure 4-12 | | (a) More options menu of a single layer (options may vary based on layer type) | (b) More options menu of layer in a selection of multiple layers | (c) More options menu of layer in a mixed selection of groups and layers |

Figure 4-12 More options menu for layer

note

Layers can only be added through the group bar to which they appended. Refer to Add New Layer.

Table 4-5 Layer More options menu options

Menu optionAllows you to….
Build search indexesRelevant for vector layer types only (i.e., raw vector, raw S-57), Refer to Build Search Indexesfor detailed instructions.
PreviewPreview selected layer(s). Refer to Preview Layer for detailed instructions. To preview all layers of a selected group(s), refer to Preview Group Content for detailed instructions.
Edit LayerEdit editing-enabled layer information. Refer to Edit Layer Parameters for detailed instructions.
Export LayerExport the layer into a package. Refer to Export Layer for detailed instructions. This action may be applied to a selection of multiple layers. Refer to Select Multiple Layers.
Select GroupsAttach the layer to one or more groups, including the option to disattach from current group. Refer to Attach Layer to Different Group(s) for detailed instructions.
Remove LayerMove the layer to Layer Backlog. Refer to Remove Layer from user-created group for detailed instructions. This action may be applied to a selection of multiple layers. Refer to Select Multiple Layers.

Group and Layer Preview Controls​

A map preview may be manipulated at two different levels as detailed below:

  • Preview mode.

  • Preview content.

Preview mode​

Four preview options are available for previewed maps as detailed below.

Figure 4-13

Figure 4-13 Preview controls

Where:

Table 4-6 Preview controls

Menu optionAllows you to….
Display 2D map. In this mode, the observer is always looking down at the terrain.
Display 3D map. In this mode, the topographical details are displayed.
Display DTM information overlay where present.
Close preview.

The Preview Perspective display will alter according to the chosen preview mode.

Figure 4-14

Figure 4-14 Preview Perspective display per perspective mode

Preview content​

The observer’s perspective of the previewed content may be controlled using the mouse and keyboard as described in the following table.

Table 4-7 Image controls

Mouse controlAction in 2D modeAction in 3D mode
Wheel scrollTurn wheel forward and backward to respectively zoom in and out.Turn wheel forward and back to respectively move the observer forward and backward.
Shift + wheel scrollTurn wheel forward and back to respectively zoom in and out in big strides.Turn wheel forward and backwards to respectively move the observer forward and backward in big strides.
Ctrl + wheel scrollAs wheel scroll above.Turn wheel forward and back to respectively decrease or increase the observer‘s altitude.
Wheel click and dragDrag left and right to rotate the map around the clicking point.Drag to rotate the observer around the clicking point.
Left button click and dragMove the map.Drag to change the observer’s orientation: right and left rotate yaw (around y axis); up and down rotate pitch (around z axis).
Ctrl + left button click and dragRotate the map around the center of the viewport (preview window)Drag left or right to respectively move the observer in those directions; drag up or down to respectively move the observer forward and backward.

Layer and Server Parameter Controls​

The following table details different field types in the layer and server parameter forms and how they may be handled.

Table 4-8 Image controls

VisualField typeHow to enter data
MandatoryFields marked with a red asterisk (*) are required and cannot be left empty.
InformationClick the ⓘ icon by the field name to display the field’s description.
String (empty)Click the empty field and type the new value.
String (suggested value)Use the auto-populated value as an example of the value expected in the field. To override the default value, select the text and type the new value. Unless deleted, the default value is used.
NumberType the number or use the up and down arrows to navigate to the desired number.
BooleanUse the dropdown arrow to open the list of valid values, which are either True or False.
More…Click the sideways arrow to open more options related to this parameter.
CheckboxClick the checkbox to toggle between checked (selected) and unchecked (unselected) states.
ListUse the dropdown arrow to open the list of valid values. Some list fields have a descriptive title within the list: Figure 4-15 Figure 4-15 List field with title Some lists allow you to type a value while filtering list entries: Figure 4-16 Figure 4-16 List field entries filtered by entered string Lists in which a multiple selection of values is permitted have a built-in option to clear all selected value by clicking on the x option: Figure 4-17 Figure 4-17 Multiple-selection list field with option to clear value(s)

Log Display Controls​

The Log Display More options menu allows access to log management options as detailed in the table below.

Figure 4-18

Figure 4-18 More options menu for Log Display

Table 4-9 Log Messages More options menu options

Menu optionAllows you to….
Clear Log WindowClear log window display. This does not affect the server log file. Refer to Clear Log Window for detailed instructions.
Export LogExport information in log window display. More robust information, however, is found in the log file. Refer to Export Log for detailed instructions. Refer to Log Displayfor information on the log file and its location.

Refer to Log Display Actions for detailed instructions on all actions available for the Log Display.

This section provides detailed instructions for achieving all tasks that may be completed using the MapCore™ Map Layer Server graphic interface.

Refer to User Interface Controls for more information on control purpose and behavior.

Any action may be aborted without completion. Refer to Aborting GUI Actions for detailed instructions.

Reset Upload Counters​

Upload counters are aggregated in each session of the MapCore™ Map Layer Server as is the display of past upload progress bars. To reset the counters and the display within the current MapCore™ Map Layer Server session, click the Clear option next to the counter. Refer to Action Display for a detailed explanation about the Running Process display and colors.

Figure 4-19

Figure 4-19 Resetting upload counters

Aborting GUI Actions​

Process may be aborted without completion in of two ways:

  • Clicking the Cancel button.

Figure 4-20

Figure 4-20 The Cancel button

  • Clicking the at the top right corner of the window.
note

Some process terminations may prompt a warning message to confirm process termination without completion (click the OK button to confirm).

Log Display Actions​

The following actions are available for the Log Display:

  • Clear Log Window

  • Export Log

Clear Log Window​

On the Log Display bar, click the More options menu icon , and then click the Clear Log Window option. All data will be deleted from the log display. This does not affect the server log file. Refer to Log Display for detailed information about the log file and its location.

Export Log​

On the Log Display bar, click the More options menu icon , and then click the Export Log option. All current data in the log display will be exported into a new log file found under your browser’s downloads folder. This does not affect the server log file. Refer to Log Display for detailed information about the log file and its naming convention.

Verified against MapCore 12.5.0