Skip to main content

Groups and the layer backlog

Layer Backlog Actions​

The following actions are available for the backlog group and its layers, which are detailed below:

  • Delete All Layers.

  • Move to Groups.

  • Delete Layers.

Delete All Layers​

warning

This action deletes all backlog layers from the server and cannot be undone.

  1. On the Layer Backlog bar, click the More options menu icon , and then click the Clear Backlog option.

  2. Depending on whether data has been silently imported or not:

    • If no silently imported data exists among deleted layers the repository, the Delete Layer window is prompted. Click the OK button to complete this action.

Figure 4-31

Figure 4-31 Delete Layer prompt (for entire repository)

  • If silently imported data exists among deleted layers the repository, the Clear Backlog window is prompted. Next:

(a) If relevant, check the box to delete original data of silently imported layers.

note

Since silently imported data is not copied to a new location, it might be used by some other application. Check this option only if you are certain that this data is not used by any other application other than MapCore™ Map Layer Server applications. When left unchecked, the layer will be removed from the MapCore™ Map Layer Server database but the original data will remain intact.

(b) Click the OK button to complete this action and permanently delete all backlog layer(s) from the server.

Figure 4-32

Figure 4-32 Clear Backlog prompt

Move to Groups​

To attach the specified layer(s) to a group (thereby removing them from the Backlog Group), a target user-created group must exist in the server to which the layer(s) will be attached.

To move backlog layer to specified group(s):

  1. Do either of the following:

    • To move a single layer: on the layer bar, click the More options menu icon .

    • To move multiple layers together: select multiple layers (Refer to Select Multiple Layers for detailed instructions), and then on any of the selected layer bars, click the More options menu icon .

  2. Click the Move to Groups option. The Move to Groups window is displayed.

  3. Open the dropdown list of available user-created groups and click on groups in the list to add or remove them from the selection of groups to which the layer is to be attached. When done, click the dropdown arrow to close the dropdown list.

Figure 4-33 Figure 4-33

Figure 4-33 Select Groups window

  1. Click the OK button.

Delete Layers​

warning

This action deletes the selected backlog layers from the server and cannot be undone.

  1. Do either of the following:

    • To delete a single layer: on the layer bar, click the More options menu icon .

    • To delete multiple layers together: select multiple layers (Refer to Select Multiple Layers for detailed instructions), and then on any of the selected layer bars, click the More options menu icon .

  2. Click the Delete Layer option.

  3. Depending on whether data has been silently imported or not:

    • If no silently imported data exists among deleted layers the repository, the Delete Layer window is prompted depending on layer type. Click the OK button to complete this action:

      • DTM layer:

Figure 4-34

Figure 4-34 Delete Layer prompt [for single DTM layer(s)]

Note that if any Vector 3D Extrusion layers point to the DTM layer being deleted, the DTM layer cannot be deleted without additionally deleting the dependent Vector 3D Extrusion layers.

  • All other layers:

Figure 4-35

Figure 4-35 Delete Layer prompt [for single non-DTM layer(s)]

  • If silently imported data exists among deleted layers the repository, the Delete Layer window is prompted with a warning message. Next:

(a) If relevant, check the box to delete original data of silently imported layers.

note

Since silently imported data is not copied to a new location, it might be used by some other application. Check this option only if you are certain that this data is not used by any other application other than MapCore™ Map Layer Server applications. When left unchecked, the layer will be removed from the MapCore™ Map Layer Server database but the original data will remain intact.

(b) Click the OK button to complete this action and permanently delete the selected backlog layer(s) from the server.

Figure 4-36

Figure 4-36 Delete Layer prompt with warning message regarding silently imported data

The following actions are available for user-created groups:

  • Select Multiple Groups.

  • Add New Layer.

  • View Layers in Group.

  • Preview Group Content.

  • Export Group.

  • Rename Group.

  • Remove Group.

Select Multiple Groups​

To select multiple groups, do either of the following:

  • Press the Shift key while clicking on two group bars to select the range of groups between the two selected groups.

  • Press the Ctrl key while clicking on group bars to select non-adjacent groups.

It is possible to combine these two modes of multiple group selection. Once any two or more groups have been selected, press both the Ctrl and Shift keys while clicking on groups to additionally select a range of adjacent groups.

To deselect groups, do either of the followng:

  • Press the Ctrl key while clicking on groups bars to deselect individual groups.

  • Click on any item in the Content Repository to deselect all selected groups.

note

When a mix of groups and layers is selected, fewer options are available on the More options menu. Refer to Figure 4-12 More options menu for layer for details.

note

When selecting one or more groups, all layers of those groups are also marked as selected. Refer to Select Multiple Layers for detailed instructions on selecting and deselecting layers.

Add New Layer​

The following information must be supplied for every new layer being added:

  • Existing user-created group through which the layer will be imported.

  • Layer source files including geographical mapping information.

  • EPSG code of the layer's coordinate system for those layer types that do not have the coordinate system embedded within their data.

  • Desired tiling scheme (the method used to attach map tiles to a geo-positioned, scale-sensitive grid).

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

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

For all layer types, the process of adding a new layer is identical as detailed in Upload Layer Content from Folder. The process differs only in the parameters required when defining a new layer. Refer to Define layer parameters per layer type for details pertaining to each type of layer.

Upload Layer Content from Folder​

  1. On the group bar to which you wish to append the layer, click the More options menu icon , and hover over the Add Layer option to show its submenu.
note

Clicking the Add Layer option rather than hovering over it will close the menu.

  1. From the Add Layer submenu, click the desired layer type to open the Add Layer upload window. The Add Layer window is displayed.

Figure 4-37

Figure 4-37 Layer types submenu

  1. Drag the folder containing the desired layer and drop it over this window or click the upload cloud icon at the center of the window to open the file browser and navigate to the target folder. Once a folder is selected, the prompt will change per specific layer type.

Figure 4-38

Figure 4-38 Add Layer upload window

  1. Define layer parameters according to layer type. Refer to Define layer parameters per layer type for detailed description of parameters available for each layer type. When done, click the OK button to start the upload process. The upload status and progress are shown in the Action Display area of the screen.

Refer to Action Display for a detailed explanation about the Running Process display and colors. Refer to Reset Upload Counters for detailed instructions on resetting the counters.

When completed, the result is documented in the Log Display area of the screen.

warning

The upload process will fail with the lack of required data (fields marked by a red asterisk: *).

Define layer parameters per layer type​

Once a folder has been dropped over the upload window or selected through the browser, the relevant window as per the selected layer type is displayed. Enter data on both the main screen and the advanced screen where available. Mandatory fields are marked by a red asterisk (*). Use the following table to refer to details on layer-specific parameters.

Table 4-12 Layer parameter index

Layer typeSection in which parameters are described
Native4.8.2.2.1 Native Layer
RawRaster4.8.2.2.2 Raw Raster Layer
RawDTM (Elevation)4.8.2.2.3 Raw DTM (Elevation)
RawVector4.8.2.2.4 Raw Vector Layer
RawS-574.8.2.2.5 Raw S-57 Layer
Raw3D model4.8.2.2.6 Raw 3D Model Layer
RawVector 3D Extrusion4.8.2.2.7 Raw 3D Vector Extrusion Layer

It is recommended that you enter as much data as possible, however, you may access this information later through the Edit Layer option (refer to Edit Layer Parameters for detailed instructions).

Native Layer​

Because native layers are native to MapCore™ Map Layer Server, there is no need to supply any layer-specific information. MapCore™ Map Layer Server recognizes the type of layer being uploaded and presents the appropriate dialog box. Depending on layer type, parameters available or required for this type of layer are accessible through the parameter form. A detailed explanation of layer parameters is found in Section Table 3-6 MapLayerConfig parameters unless otherwise specified. The exact location for the description of each parameter is referenced in the table below.

A native layer may also be uploaded as a single 3TZ archive file (*.3tz), in which case the layer is created over the archive.

Refer to section 4.4.6 Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Table 4-13 Native layer parameters, pool of possible parameters

FieldClick on parameter name to jump to description
Layer IDLayerId
TitleTitle
Group NameGroup
Draw PriorityDrawPriority

Refer to section 4.4.6 Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Raw Raster Layer​

Parameters available or required for this type of layer are accessible through both the main and advanced parameter forms. A detailed explanation of layer parameters is found in RawLayerInfo Parameters unless otherwise specified. The exact location for the description of each parameter is referenced in the tables below.

Refer to section 4.4.6 Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Figure 4-39

Figure 4-39 Raster layer parameters, main form

Figure 4-40

Figure 4-40 Raw raster layer parameters,advanced form

Where:

Table 4-14 Raw raster layer parameters, main form

FieldClick on parameter name to jump to description
Main form
Layer IDLayerId
TitleTitle
Group NameGroup
Coordinate SystemSince conversion between coordinate systems is prohibited for this layer type, coordinate system supplied in this field is used to override information embedded in the layer's data or supply information if none exists in the layer’s data. Refer to Coordinate System for details on coordinate system.
Draw PriorityDrawPriority
Advanced form
Enhance Border OverlapEnhancedBorderOverlap
Resolve Overlap ConflictsResolveOverlapConflicts
Image Coordinate SystemIsImageCoordSys
Transparent ColorCheck to use this option and enable its R, G, B and Precision parameters.Refer to TransparentColor for details on this option and its parameters (the next four parameters).
Ignore Raster PaletteIgnoreRasterPalette
Highest ResolutionHighestResolution
Fill Empty Tiles by Lower Resolution TilesFillEmptyTilesByLowerResolutionTiles
Max Scale (m/pixel)MaxScale NOTE: This parameter differs from the MaxScale parameter contained in the Vector layer information.
Raw DTM (Elevation)​

Parameters available or required for this type of layer are accessible through the parameter form. A detailed explanation of layer parameters is found in RawLayerInfo Parameters unless otherwise specified. The exact location for the description of each parameter is referenced in the tables below.

Refer to section 4.4.6 Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Figure 4-41

Figure 4-41 Raw DTM (elevation) parameters form

Where:

Table 4-15 Raw DTM (elevation) parameters

FieldClick on parameter name to jump to description
Layer IDLayerId
TitleTitle
Group NameGroup
Coordinate SystemSince conversion between coordinate systems is prohibited for this layer type, coordinate system supplied in this field is used to override information embedded in the layer's data or supply information if none exists in the layer’s data. Refer to Coordinate System for details on coordinate system.
Draw PriorityDrawPriority
Max Scale (m/pixel)MaxScale NOTE: This parameter differs from the MaxScale parameter contained in the Vector layer information.
Raw Vector Layer​

Parameters available or required for this type of layer are accessible through both the main and advanced parameter forms. A detailed explanation of layer parameters is found in RawLayerInfo Parameters unless otherwise specified. The exact location for the description of each parameter is referenced in the tables below.

Refer to Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Figure 4-42

Figure 4-42 Raw vector layer parameters, main form

Figure 4-43

Figure 4-43 Raw vector layer parameters, advancedform

Where:

Table 4-16 Raw vector layer parameters

FieldClick on parameter name to jump to description…
Main form
Layer IDLayerId NOTE: The OK button is only enabled if the value entered in the field is indeed unique.
TitleTitle
Group NameGroup NOTE: in the GUI, this is a read-only field.
Draw PriorityDrawPriority
Data SourceDataSource
Source Coordinate SystemCoordinate system supplied in this field is used to override information embedded in the layer's data or supply information if none exists in the layer’s data. Refer to Coordinate System for details on source and target coordinate system.
Target Coordinate SystemCoordinate system supplied in this field is the final coordinate system for the layer and is used for conversion from the Source Coordinate System specified in this form (see above). This is an optional parameter. Refer to Coordinate System for details on source and target coordinate system.
Min Scale (m/pixel)MinScale
Max Scale (m/pixel)MaxScale NOTE: This parameter differs from the MaxScale parameter specified in the Raster layer information.
Default Point ImagePointTextureFile
Version compatibilityVersionCompatibility
Locale (Language)Locale
Advanced form
Max Vertices per TileMaxVerticesPerTile
Optimization of Hiding ObjectsEnable or disable the following three parameters.
Optimization Min ScaleOptimizationMinScale
Max Visible Points per TileMaxVisiblePointsPerTile
Min Size for Object VisibilityMinSizeForObjVisability
Raw S-57 Layer​

Parameters available or required for this type of layer are accessible through both the main and advanced parameter forms. A detailed explanation of layer parameters is found in RawLayerInfo Parameters unless otherwise specified. The exact location for the description of each parameter is referenced in the tables below.

Refer to Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Figure 4-44

Figure 4-44 Raw S-57 layer parameters form

Figure 4-45

Figure 4-45 Raw S-57 layer parameters advanced form

Where:

Table 4-17 Raw S-57 layer parameters

FieldClick on parameter name to jump to description
Main form
Layer IDLayerId
TitleTitle
Group NameGroup
Draw PriorityDrawPriority
Locale (Language)Locale
Target Coordinate SystemCoordinate system supplied in this field is the final coordinate system for the layer and is used for conversion from the Source Coordinate System which is always the default for this layer type (and hence not specified in the form). This is an optional parameter. Refer to Coordinate System for details on source and target coordinate system.
Version compatibilityVersionCompatibility
Advanced form
Max Vertices per TileMaxVerticesPerTile
Max Visible Points per TileMaxVisiblePointsPerTile
Min Size for Object VisibilityMinSizeForObjVisability
Optimization Min ScaleOptimizationMinScale
Raw 3D Model Layer​

Parameters available or required for this type of layer are accessible through the parameter form. A detailed explanation of layer parameters is found in RawLayerInfo Parameters unless otherwise specified. The exact location for the description of each parameter is referenced in the tables below.

The uploaded folder must contain the model in 3D Tiles format, either as files or as a single 3TZ archive file (*.3tz). The model is served to client applications as is (static content); it is neither tiled nor reprojected by the server. Therefore, the Target Coordinate System, Orthometric Heights, and Target Highest Resolution parameters are ignored.

Refer to Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Figure 4-46

Figure 4-46 3D model layer parameter form

Where:

Table 4-18 3D model layer parameters

FieldClick on parameter name to jump to description
Layer IDLayerId
TitleTitle
Group NameGroup
Target Coordinate SystemIgnored: the model is served as is, in the coordinate system of its source data. Refer to Coordinate System for details on source and target coordinate system.
Orthometric HeightsOrthometricHeights (ignored)
Target Highest ResolutionTargetHighestResolution (ignored)
Raw 3D Vector Extrusion Layer​

Parameters available or required for this type of layer are accessible through the parameter form. A detailed explanation of layer parameters is found in RawLayerInfo Parameters unless otherwise specified. The exact location for the description of each parameter is referenced in the tables below.

Refer to Layer and Server Parameter Controls for instructions on entering data in parameter fields.

Figure 4-47

Figure 4-47 Raw 3D vector extrusion layer parameters

Table 4-19 Raw 3D vector extrusion layer parameters

FieldClick on parameter name to jump to description
Layer IDLayerId
TitleTitle
Group NameGroup
Data SourceDataSource
Source Coordinate SystemCoordinate system supplied in this field is used to override information embedded in the layer's data or supply information if none exists in the layer’s data. Refer to Coordinate System for details on source and target coordinate system.
Target Coordinate SystemCoordinate system supplied in this field is the final coordinate system for the layer and is used for conversion from the Source Coordinate System specified in this form (see above). Refer to Coordinate System for details on source and target coordinate system.
DTM Layer IDDtmLayerId
Height ColumnCheck the checkmark in order to provide database column for this field. Refer to HeightColumn for assumptions.
Object ID ColumnObjectIDColumn
Roof TextureFile containing image used as texture for rendering building tops.
Side TextureFile containing image used as texture for rendering building walls.
Use Spatial IndexingUseSpatialIndexing

View Layers in Group​

  • Double-click a closed layer group to expand the display and show the layers in that group.

  • Double-click an open layer group to collapse the display and hide the layers in that group.

Figure 4-48 Figure 4-48

Figure 4-48 Expanded vs. collapsed group in the Content Repository area

Preview Group Content​

When previewing group content, all group layers are previewed simultaneously.

warning

For the proper function of the group preview, all layers in the group must share a common area of interest, their coordinate system, and their tiling scheme.

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

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

warning

For the proper function of the group preview, only one DTM (Elevation) layer may be included in a group when previewing the group.

Three actions are available when previewing group content, all of which are detailed below:

  • Activate the preview display.

  • Toggle between 2D, 3D, and DTM preview modes.

  • Manipulate preview perspective.

Activate the preview display​

  1. On the group bar, click the More options menu icon , and then click the Preview option.

  2. The combined group preview is displayed in **Map (**2D) perspective.

Figure 4-49

Figure 4-49 Default Preview Perspective display

Toggle between Map (2D), 3D, and DTM preview perspective​

Refer to Preview mode for detailed instructions.

Manipulate preview perspective​

Refer to Preview content for detailed instructions.

Export Group​

Exports all layers of selected group(s) as an mcpkg file for backup purposes or future import. Group hierarchy is maintained in the exported file and will be recreated upon import. Refer to Import MC Package for detailed instructions on importing the exported file.

note

Depending on the size of exported data and the number of layers, the export process may be a lengthy one.

To export group(s) in their entirety:

  1. Do either of the following:

    • To export a single group: on the group bar, click the More options menu icon .

    • To export multiple groups together: select multiple groups (Refer to Select Multiple Layers for detailed instructions), and then on any of the selected group bars, click the More options menu icon .

  2. Click the Export Group option. The export window will be displayed, showing the total number of layers that are about to be exported.

Figure 4-50

Figure 4-50 Export window

  1. Click the Export button to complete the export. The export preparation prompt is displayed at the bottom right corner of the screen.

  2. If desired, dismiss the export preparation prompt by clicking the X option. If no action is taken, the prompt will disappear when the preparation process is complete.

note

During the export process, temporary files are saved in the Export folder which is located under the server data repository folder. Refer to System Folders and Configuration Files for detailed information on MapCore™ Map Layer Server folders and their locations. When the import process is complete, the export file is moved to the downloads folder.

  1. Locate the mcpkg file that was just created in your download folder in order to transfer it to another location.
note

Refer to Import MC Package for details on file location and naming convention of the exported mcpkg file.

Rename Group​

  1. On the group bar, click the More options menu icon , and then click the Rename Group option. The rename group window is displayed.

  2. Enter the new group name in the field New group name and click the OK button.

note

The OK button will only be enabled if the name is indeed changed.

Figure 4-51

Figure 4-51 Rename group window

warning

Group names must be unique for the OK button to be enabled.

Remove Group​

  1. Do either of the following:

    • To remove a single group: on the group bar, click the More options menu icon .

    • To remove multiple groups together: select multiple groups (Refer to Select Multiple Layers for detailed instructions), and then on any of the selected group bars, click the More options menu icon .

  2. Click the Remove Group option. The Remove Group warning message is displayed.

  3. Click the OK button to confirm group removal.

Figure 4-52

Figure 4-52 Remove group window

note

All layers attached to a removed group are removed from any groups to which they were attached and moved to the Layer Backlog group. These layers will no longer be available for client applications.

Verified against MapCore 12.5.0