QGIS: impostazioni dei progetti cartografici

This section describes how to optimize your QGIS projects to publish as a WebGis service.

Grazie all”integrazione con QGIS Server, tutti gli aspetti di simbologia associati ai singoly layer sono automaticamente riprodotti sul servizio WebGis

Alcuni parametri e opzioni definite a livello di progetto QGIS vanno ad incidere sulla funzionalità e sui contenuti del servizio WebGis, come ad esempio:

  • il nome identificativo del servizio webgis pubblicatoG3W-SUITE

  • i metadati di base associati

  • le capabilities del servizio

  • eventuale esclusione di layout di stampa sul servizio WebGis

  • quali strati dovranno risultare interrogabili e ricercabili tramite WMS

  • which layers to expose with the different OGC services (WMTS, WFS, WCS)

  • which fields (for each vector data) are exposed as WMS and/or WFS

  • the Themes (Views) defined at the project level

  • layer/group management from embedded projects

  • la struttura del query form visible sul servizio WebGis

  • the editing widget, constraints and default values (also based on QGIS expressions) for every fields of vector layers

  • the associated print layouts, report included

Nei paragrafi successivi verranno descritte le impostazioni relative al progetto cartografico QGIS che avranno maggior risvolti in relazione al servizio WebGis pubblicato.

Project property

Dal menù Progetto Proprietà si acceda alla finestra Proprietà del progetto e da qui si accede a tre sottomenù di nostro interesse:

  • Generale

  • Sorgente dei dati

  • QGIS server

Generale

Impostazioni generali

In questa sezione è possibile definire il titolo del progetto e, conseguentemente, il titolo del servizio WebGis.

Il contenuto della voce Titolo del progetto sarà usato a livello di applicazione per identificare univocamente il progetto pubblicato; per questa ragione non sarà possibile assegnare lo stesso titolo a differenti progetti pubblicati su WebGis

N.B. Si sconsiglia l”utilizzo di caratteri speciali o numeri nel titolo del progetto

_images/projecttitle.png

Sorgente dei dati

L”opzione Crae automaticamente transizioni di gruppo quando è possibile è ereditata automaticamente per l”editing on line

Layers Capabilities

This submenu defines the querable and/or searchable layers at the WebGis service level.

  • Check the Identifiable column if you want that the layer will be searchable on the WebGis

  • Check the Searchable column if you want that the layer will be querable on the WebGis

NB: this differentiation is only possible by using the QGIS APIs such as Search URL endpoint. See dedicated paragraph

_images/datasources.png

QGIS Server

Capabilities del servizio

In questa sezione è possibile definire le capabilities del servizio WebGis pubblicato.

Tali informazioni, insieme a quelle associate alla struttura dati dei singoli layer del progetto, verranno visualizzate associate al servizio WebGis nella sessione Metadati.

Vedi anche il paragrafo dedicato

_images/qgisservercapabilities.png

Capabilities WMS – Estensione di pubblicazione

In questa sezione è possibile definire l”estensione geografica visualizzata all”avvio del servizio WebGis.

La procedura più semplice da seguire è quella di impostare sulla mappa la vista geografica desiderata e cliccare poi sul tasto “Imposta all”estensione della mappa”.

_images/qgisserversetmapexpetent.png

Capabilities WMS – Restrizioni SR

In questa sezione è possibile definire i sistemi di proiezioni per cui il progetto è disponibile relativamente ai servizi OGC.

E” chiaramente necessario inserire il sistema di proiezione su cui è stato realizzato il progetto QGIS, il SR in questione è aggiunto cliccando sul tasto “Usato”.

Altri sistemi di riferimento geografico sono implementabili cliccando sul tasto + e scegliendo dalla lista dei sistemi di riferimento.

_images/qgisserversrisrestriction.png

Capabilities WMS – Escludi composizioni

In questa sezione è possibile escludere, dalla disponibilità del servizio WebGis, alcune tra i layout di stampa che sono associati al progetto cartografico.

_images/qgisserverexludecompositions.png

Capabilities WMS – Aspetti generici

Due aspetti ulteriori sono gestibili relativamente alle capabilities WMS

  • in generale si consiglia di utilizzare l”opzione Usa gli id dei layer come nomi al fine di velocizzare le operazioni di interrogazione e ricerca

  • per poter rendere attivo sul WebGis la funzione di **zoom ai risultati di una ricerca o a quelli di un interrogazione occorre attivare l”opzione Aggiungi la geometria alla risposta dell'oggetto

_images/qgisservergeneralaspects.png

WMTS Capabilities

In this section it is possible to define which layers are exposed as WMTS services defining the various options

Capabilities WFS

In questa sezione è possibile definire le quali layer siano esposti come WFS

Il servizio WFS è necessario nel caso si vogliono utilizzare le seguenti modalità di interrogazione:

  • query bybox

  • query bypolygon

E sufficiente spuntare la check box relativa alla colonna Pubblicato

_images/qgisservergeneralaspectswfs.png

WCS Capabilities

In this section it is possible to define which rasters are exposed as WCS services

General aspects

Themes (Views)

The creation of Themes (combination of off / on layers and differentiated simbology styles) is managed at the WebGis service level.

A specific menu on the webgis will allow you to choose the Theme to be displayed.

The views will be parameterizable at the URL level of the related webgis service.

Layer order

The option to define the layer order different from the order in the TOC on the QGIS project is automatically supported.

Legend

The activation of the Filter legend by Map content option on the QGIS project is automatically applied to the derived WebGis service.

Mutually exclusive groups

The activation on the QGIS project of the Mutually exclusive group option for the layers groups is automatically applied to the derived WebGis service.

1:N and N:M relations

ATTENTION: to correctly manage these types of relations it is NECESSARY to insert the reference to the relations in the customized form

images/manual/qgislayerproperties_displayform_relations.png

Embedded project

It is possible to publish QGIS projects that contain layers or groups of layers deriving from embedded projects. It is clearly necessary to publish the embedded project first and then those derived from it. An update of the embedded project will result in a consequent modification of all derived projects. The request to delete the basic embedded project causes a warning message as this operation will cause problems on all derived projects.

Layers properties

Simbologia

La vestizione associata ai singoli layer viene replicata autonomamente sul servizio WebGis.

The suite allows the switching on/off of the individual categories linked to the various simbolgy methods (categorized, graduated, by rules …).

images/manual/g3wsuite_simbology_onoff.png

Nel caso di utilizzo di icone SVG esterne (aggiunte a quelle base di QGIS, tramite il menù Impostazioni Opzioni  Sistema -> Percorsi SVG), queste devono essere caricate sul server per poter essere utilizzate da QGIS-Server.

Gestire icone SVG personalizzate

Nella procedura di installazione dell”applicativo G3W-SUITE viene creata sul server una directory nominata svg che nasce per ospitare le icone SVG personalizzate.

All”interno di tale directory è possibile quindi ospitare icone SVG, anche organizzate in subdirecory.

Nel pannello di Amministrazione l”icona Configurazioni posta nell”angolo in alto a destra permette di accedere ad un menù che comprende la voce File Manager.

_images/g3wclient_icon_config.png

_images/g3wsuite_administration_configuration_menu.png

Tramite tale strumento è possibile gestire le icone SVG sul server in modo semplice ed intuitivo.

_images/g3wsuite_administration_file_manager.png

La cartella SVG sul server deve riflettere la struttura in sottocartelle della directory dedicata a raccogliere le icone SVG extra da parte di QGIS

NB: il nome di questa directory viene definito dalle impostazioni di base impostate durante l”installazione della suite. Vedi paragrafo dedicato

NB: si ricorda che lo strumento File Manager permette di gestire anche la sincronizzazione dei dati geografici (nel caso di utilizzo di file fisici) e la gestione dei file multimediali.

Vedi anche il paragrafo dedicato

Multi-style layer

The suite manages the presence of multiple styles associated with a layer.

It will be possible to dynamically choose the style on the cartographic client.

It will be possible to manage the styles associated with a layer from the Administration component, also by loading .qml file styles and setting the default style among those present.

Definizione dei campi consultabili per ogni layer

All”interno del progetto di QGIS è possibile anche definire, per ogni vettore, quali siano i campi disponibili in seguito ad interrogazione WMS sul servizio WebGis.

Per definire queste impostazioni si accede alle proprietà di uno dei vettori definiti precedentemente come interrogabili e si sceglie il sottomenù Campi Sorgente nella finestra Proprietà vettore.

In tale sottomenù è riportato l”elenco dei campi del vettore in esame.

La spunta del chek box della colonna WMS definisce se i valori contenuti in tale campo saranno disponibili o meno in seguito all”interrogazione sul servizio WebGis.

_images/qgislayerproperties_wmsfields.png

Definizione del form di visualizzazione degli attributi

Per ogni layer è possibile definire la struttura del form degli attributi associato alla visualizzazione dei risultati in seguito ad operazioni di interrogazione.

Su QGIS è infatti possibile andare a costruire una maschera di inserimento (query form) personalizzato creando Schede e Gruppi tematici e definendo la distribuzione dei singoli campi ed i loro alias all”interno di essi.

Tale organizzazione strutturale sarà replicata direttamente sul query form sul servizio WebGis come riportato nell”immagine precedente

The current version of QGIS also handles conditional forms and cascade drill-downs

Layer basic information

If you set a descriptive information in the Abstract form of the QGIS Server session of the Layer Properties, this information will be associated with the layer at the webgis level.

Temporal settings

This functionality is only available using QGIS Server >= 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 filed with Date/Time configuration

  • raster layers: only for NetCDF file upload as raster (no Mesh)

images/manual/qgislayerproperties_displayform_relations.png

Visualizzazione di contenuti multimediali

Contenuti multimediali (immagini, pdf, URL web…) possano essere visualizzati in modo interattivo sul client cartografico in seguito a pubblicazione del progetto come servizio WebGis.

Nel caso di link web è sufficiente riportarli (preceduti dal prefisso http:// o https://) all’interno del campo degli attributi dedicato

Per il caso di file multimediali è invece necessario:

  • caricare il file multimediale nell’apposita cartella media_user (cartella esposta su web) presente nella sessione File Manager del Pannello di Amministrazione della suite

  • inserire, nel campo degli attributi dedicato, il link web a tale file

Il link al file può essere ricavato nel seguente modo:

  • dominio applicativo + media_user + path di eventuali sottocartelle + nome del file

Esempio:

  • dominio applicativo: https://dev.g3wsuite.it

  • file scheda_A.pdf situato nella cartella /media_user/schede/

  • link web: https://dev.g3wsuite.it/media_user/schede/scheda_A.pdf

In seguito ad interrogazione del layer in oggetto attraverso il client cartografico, in base al tipo di contenuto multimediale, avremmo i seguenti casi:

  • immagine: visualizzazione dell’anteprima nel form, click sull’anteprima per la visualizzazione in sovraimpressione dell’immagine a dimensioni reale

  • link web o file multimediali: visualizzazione di tasto arancione con la scritta Apri per permettere la consultazione del contenuto

_images/qgis_form_attribute.png

_images/qgislayerproperties_displayform.png

Ottimizzazione delle prestazioni

Regole obbligatorie

  • PostGreSQL/PostGis, SQLite/Spatialite and GeoPKG layers must have a primary key

  • the primary key field and all fields involved in search, join, 1:n or N:M relations or editing function have to be published as WMS

  • don”t use commas for aliases associated with layers

  • style settings defined at the auxiliary data level are not supported

Suggerimenti

  • quando si utilizza la vestizione categorizzata/basata su regole, creare indici sulle colonne coinvolte nell”espressione della regola

  • avviare il progetto con solo pochi layer attivati di default

  • non superare i tre livelli di annidamento nei gruppi di layer definiti nella TOC