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.

If the Show features count function is activated in the QGIS project at vector layer level, the same information will be displayed on the web map.

The number of features updates automatically based on the style associated with the layer.

Spatial Bookmarks¶

In case Spatial Bookmarks are saved at the QGIS project level, they will also be available on the web map.

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

The Temporal Controller functions in QGIS are replicated on the webgis component

Time series functionality works on both vector and raster data, even in multi-layer mode.

Time setting on vector data is limited to the Single Field with Date/Time case

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

Layout di stampa¶

Eventuali layout di stampa associati al progetto QGIS pubblicato saranno automaticamente associati al servizio WebGis pubblicato.

Print layouts can contain more than one Map items and panoramic maps.

You can set also a custom title (definible in the WebGis side) setting an Item ID at a Label item.

Atlas and report are also supported.

Any images present in the print layouts must be placed in the local project_data folder (in any subdirectory) and synchronized on the server.

Vedi anche il paragrafo dedicato Sincronizzazione dati geografici su spazio server.

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