G3W-CLIENT: the cartographic client

Generic aspects

The application has a responsive interface consisting of expandable and reducible sessions.

The color of the interface depends on the type of user logged in.

_images/g3wclient_interface.png

The header contains the following elements:

  • Logo, title and subtitle, deriving from:

    • main title (set at General Data level) or MacroGroup name, according to the settings

    • Cartographic Group name

    • WebGis service title

  • Change map: which allows you to switch from one WebGis service to another (located within the same Cartographic Group) while maintaining extension and display scale

  • User ID: if you have logged in to the system

  • Credits

  • Home: to access the FrontEnd

  • Language: the choice of language is reflected in the individual menus of the map client and on the contents of the access portal. The languages available are those activated by the Administration.

_images/g3wclient_header.png

The Tools panel is located on the left and containing the following objects:

  • Metadata: any content defined in the GetCapabilities of the QGIS Project

  • Print: printing tool based on the layouts defined on the QGIS project

  • Search: with the search tools defined in the Administration session, as well as a free Query Builder like the one present in QGIS

  • Charts: visualization of any graphs created on QGIS with the DataPlotly plugin

  • Spatial Bookmarks: tool for using the Spatial Bookmarks associated with the QGIS project and allowing the user to create new ones for his exclusive use.

  • Tools: session that collects the various tools that may be activated on the WebGis service (including editing tools)

  • WMS: session to add custom WMS services to the map

  • Map: containing:

    • Layers: structured list of layers, defined on the QGIS project

    • Base: choice of the base map from those defined at the creation level of the Thematic Group

    • Legend: graphic legend of the various layers

_images/g3wclient_tool_panel.png

In the event that Themes (Views) are defined in the QGIS project, a specific choice menu will be available in the Layers session of the TOC.

The choice of a Theme will determine the automatic activation of the layers and related styles, defined in the Theme itself.

_images/g3wclient_theme.png

Tools panel

Metadata

The metadata reported in this session derive from those set at the QGIS project level.

This content is divided into three sessions: General, Space Info and Layers.

  • General: reports the metadata defined on the QGIS project in the item: Project   Properties (QGIS Server session, Service Capabilities) In case of login as anonymous user the URL of the WMS service is shown.

  • Spatial: reports the EPSG code of the projection system associated with the QGIS project and the BoundingBox relating to the initial publication extension, defined in the item: Project   Properties (QGIS Server session, WMS Capabilities, Advertised extent)

  • Layers: reports simple metadata associated with the individual layers.

_images/g3wclient_metadata_view.png

Charts

View graphs created using QGIS DataPlotly and activated at the admin session level.

Check the plots in the list and consult them on the rigth panel.

_images/g3wclient_plots.png

The graphs are filterable based on the:

  • _images/g3wclient_plots_map_filter.png features visible on the map

  • _images/g3wclient_plots_selection_filter.png filter based on the selected features

These filters are also reflected on the plots associated to the related data (in 1:N mode) based on the visible and/or selected parent features.

The filter based on the map content can be activated globally on all plots (icon at the top of the panel dedicated to charts) or on only some specific plots (icon placed at the level of the individual plots).

The plots will automatically update after pan and zoom operations on the map

If activated, the filter based on the selected features is automatically activated on all related plots (associated with the same layer and with the 1:N relationed tables)

Appropriate messages at the single plots level will indicate the activation of these filters.

Charts based on 1:N data relation (child layer)

If the chart is linked to a child layer in a 1:N relation, it can also be displayed at the information level of the individual parent features

_images/g3wclient_fomr_1N_plots.png

Print

Printing tool based on layouts defined on QGIS project.

The tool allows you to choose:

  • Template: print layout among those associated with the published QGIS project

  • Scale: print scale

  • DPI: print resolution

  • Rotation: rotation angle

  • Format: print to PDF or JPEG

  • Custom title: using the ItemIDs at the print layout level of the QGIS project it is possible to insert one or more labels with customized content in the print from WebGis

On the map, a light rectangular area will allow you to define the print area.

_images/g3wclient_print_tool.png

If an Atlas type print layout is associated in the QGIS project, the layout reference will be available. The cards to be printed are defined by referring to the atlas identifier defined in the print layout.

_images/g3wclient_print_tool_atlas.png

WMS

Through this tool the user can add custom WMS layers to the WebGis service.

The user can add one or more WMS service by defining:

  • custom title

  • WMS URL

_images/g3wclient_wms_add.png

After that, using the + key it is possible to view the list of maps associated with the service, choose which one to load by defining:

  • the position (top or buttom) with respect to the other layers of the project

  • the layer to load

  • the projection system to be associated

  • a custom name

_images/g3wclient_wms_tool.png

When the first custom WMS is added, a new tab (WMS) appears in the TOC; here you can switch on/off or delete the individual added WMS layers.

_images/g3wclient_wms_tool_layer.png

The added WMS layer cannot not be queried.

The list of WMS services and the specific WMS layers added will remain available to the user until the browser cache is cleared.

Search and Query Builder

A classic Query Builder is present at the Search menu level. Through this tool it is possible to:

  • carry out alphanumeric searches on geometric layers

  • save the query to reuse it until the end of the work session

  • edit a previously saved query

The saved query will be available until the browser cache is cleared

NB: fields not exposed as QGIS project-level WMS are not available for query building.

_images/g3wclient_querybuilder.png

The Search menu contains the list of search tools defined through the Administration panel and custom searches created with the Query Builder.

_images/g3wclient_searc_list.png

You choose the search you are interested in, fill in the required fields and click on the Search button.

The panel with the list of results will open on the right side of the client, for each result the first three fields of the associated table will be displayed.

By positioning on the individual results, the corresponding features will be highlighted on the map; clicking on the individual results you can consult all the attributes.

Zoom to features and download icons are available for results (single or cumulative)

_images/g3wclient_search_example.png

Map

This session has three tabs:

  • Layers: structured list of layers, defined on the QGIS project

  • Base: choice of the base map from those defined at the Cartographic Group creation level

  • Legend: graphic legend

Layers

This tab shows the layers prepared on QGIS projects with the same organization the groups and subgroups.

If the Show features count function is activated in the project, the layer will show the number of total features and based on the subdivision linked to the symbology.

In case of multi-style associated with the layer, the number of geometries reported will vary following the passage from one style to another.

_images/g3wclient_features_count.png

In the list of layers, right click on the name of the single layer shows the following items:

  • Name and kind of geometry of the layer

  • Metadata: descriptive information inherited from what has been defined, at QGIS project level, in the ‘Abstract’ form of the ‘QGIS Server’ session of the ‘Layer Properties’

  • Styles: to choose the style to be applied to the layer, in the case of multi-style layers

  • Abstract: a text (also html) defined in the Layer Properties, Metadata session, Identification tab, Abstract form.

  • Zoom to layer: to zoom in on the extension of the layer

  • Open attribute table: to consult the associated attribute table

  • Download shapefile: to download the layer as a shapefile; function activatable from the administration panel

  • Download GEOTIFF: to download a raster in GeoTiff format, full layer or clipped to the extent of the canvas; function activatable from the administration panel

  • Download GeoPackage: to download the layer as a GeoPackage; function activatable from the administration panel

  • Download CSV: to download the layer as a CSV; function activatable from the administration panel

  • Download XLS: to download the layer as a XLS; function activatable from the administration panel

  • WMS/WFS URL: URL of the WMS/WFS service relative to the project or URL of the external WMS

_images/g3wclient_layer_function.png

Double clicking on the layer or Layer Group zooms to the extent of the layer or Group content.

It is possible to hide, automatically, layers from the TOC when they have no records.

Useful when using filters on layers or geographic views.

Attribute table

The attribute table (resizable) is equipped with paging function, highlight function and zooming to the associated features.

In the case of links to multimedia content, the previews of the images and/or the Open button will be displayed for consultation of different types of content.

The window is resizable.

_images/g3wclient_table_view.png

A generic filter, positioned at the top right, is applied generically to the contents of all the fields, and it will allow you to filter the list of displayed records.

Filters based on the contents of the individual fields are available at the top of each column.

The Show features visible on the map icon _images/g3wclient_mapfilter_table.png allows you to filter the records of the table according to the features visible in the map.

It is possible to select the features of the individual layers and apply filters that will affect:

  • on the map content

  • on the attribute table content

  • on the contents of the plots

  • on print contents

  • on the editable geometries

The selection of features can be made:

  • at the attribute table level (through the checkboxes on the left of each records)

  • on the results of a query (add / remove from current selection)

  • on the results of a query (add / remove from current selection)

At the same time, additional icons appear:

  • on the layer attribute table

  • to the right of the layer on the TOC

  • at the level of the relevant plots

Aggiungi immagine: g3wclient_selection.png The icons in the attribute table allow you to:

  • _images/g3wclient_selection_table_clear.png Clear selection

  • _images/g3wclient_selection_table_invert.png Invert selection

  • _images/g3wclient_selection_table_filter.png Add/Remove filter

The icons to the right of the layer on the TOC allow you to:

  • Clear selection

  • Add/Remove filter

_images/g3wclient_selection_icon_toc.png

When one or more features are selected, they appear highlighted in red on the map. Activation of the filter is reflected:

  • on the map content

  • on the attribute table content

  • on the data displayed by plots

  • on the print contents (only with QGIS 3.18)

Filter users based

On the client you can select (highlight) and filter a subset of vector layer geometries.

It is possible to activate a filter on a layer starting from:

  • query results

  • search results

  • attribute table management

To be filtered, the geometries object of the filter must first be selected.

Following activation of the filter, a logged in user (not AnonymosUser) will be able to save this filter to be recalled in subsequent work sessions.

Saving the filter occurs via the dedicated icon present at layer level in the legend and in the results form.

_images/filter_save.png

The saved filters can be recovered via the dedicated menu that can be viewed by right-clicking on the name of the layer

_images/filter_load.png

The presence of an active filter on the layer is highlighted by the red icon next to the layer name.

To deactivate an active filter, simply click on the icon itself.

_images/filter_loaded.png

We remind you that activating a filter affects:

  • geometries visible on the map

  • records visible on attribute table

  • editable geometries

  • features underlying the graphs

  • print contenent

Base layer

The list shows the active base layers at the cartographic group level.

If the user has created base layers starting from cached layers, these may also be present.

Legend

If at the publication level of the QGIS project, the Legend position option i setted as TOC, this panel will be not present and the legend will be rendered inside layers TOC.

If the option is activated on the QGIS project, the legend is filtered on the map content.

Time series

NB: the Time Series function is only available with a QGIS Server version >= 3.26

This version of G3W-SUITE manages the temporal aspects for both vector and raster layers but with limitations:

  • vector layers: limited to the Single field with Date/Time configuration

  • raster layers: Mesh layer

  • WMS-T

It is possible to create animations based on multiple temporal layers both raster and vector.

If in the QGIS project a temporal vector/raster layer on which the Dynamic temporal control property has been activated is present, the client will show an additional panel called Time series.

This panel will allow you to:

  • define the start/end date of the time series

  • define the step of the animation

  • start and manage the temporal animation

_images/g3wclient_timeseries_tool.png

The modification of the start date of the series will determine the updating of the map with the visualization of the layer in coherence with the chosen date.

Pay attention: to use the Time series function for raster data, it must also be activated at the level of the G3W-ADMIN layer properties.

_images/g3wclient_timeseries_admin.png