Scenari Layer Utente

Il presente documento descrive il rilascio della funzionalità Scenari Layer Utente (sigla SV.0026.017) per il widget Layout 2D del prodotto Geoweb.

Il documento è rivolto al team di implementazione e ai responsabili tecnici del progetto; ha lo scopo di descrivere in modo esaustivo le modifiche apportate al framework, le dipendenze tecniche e le istruzioni di installazione.

FiberCop utilizza Geoweb per l'analisi territoriale effettuata da un gruppo ristretto di utenti (4-5 persone). Le analisi si basano sulla sovrapposizione di più layer cartografici, alcuni dei quali non sono pre-caricabili in quanto prodotti dinamicamente (es. simulazioni della protezione civile).

Nel framework Geoweb non esiste alcuno strumento gestibile dall'utente per la definizione di scenari di visualizzazione. I layer della mappa sono definiti staticamente tramite strumenti esterni; non esiste alcun meccanismo per salvare e richiamare rapidamente una specifica combinazione di layer accesi/spenti.

Con questo rilascio l'utente finale può definire, salvare e richiamare scenari di layer: una combinazione nominata di layer della mappa in cui ciascun layer è impostato come acceso o spento per rappresentare una determinata situazione o punto di vista.

Gli scenari sono accessibili direttamente dalla scheda mappa 2D tramite una nuova toolbar integrata nel tab legenda. Gli scenari sono condivisi tra tutti gli utenti con accesso alla mappa. I permessi di creazione, modifica ed eliminazione sono governati dal meccanismo DACL di Geoweb.

La funzionalità è complementare a SV.0026.016 (Layer Utente WMS e Shapefile): gli scenari fotografano lo stato di tutti i layer in legenda — layer di prodotto, layer dinamici, layer WMS utente e layer Shapefile utente — indipendentemente dalla loro origine.

È stata introdotta una nuova classe Geoweb per la gestione degli scenari:

La gestione della classe avviene nella funzione applicativa “Gestione Layer Utente e Scenari” (evoluzione della funzione SV.0026.016), con accesso a lista e dettaglio standard. I metadati della classe si trovano in DR/metadata/ e vanno importati tramite il Webadmin Geoweb.

Attore: Utente Finale

La lista mostra tutti gli scenari configurati per tutte le mappe, con i campi anagrafici (nome, mappa, date).

Fig. 1 — Lista scenari (classe gwd_mg_scenario)

Dal dettaglio di classe è possibile creare un nuovo scenario impostando solo il nome e la mappa. Il campo legend_state_json non è editabile manualmente; viene popolato dalla toolbar della mappa al momento del salvataggio.

Fig. 2 — Dettaglio classe: nuovo scenario (vuoto)

Il dettaglio mostra i campi anagrafici dello scenario (nome, mappa, descrizione, date). Il campo legend_state_html mostra in forma readonly la lista dei layer inclusi nello scenario con il relativo stato acceso/spento.

Fig. 3 — Dettaglio scenario esistente: campi anagrafici

Il widget HTML readonly generato dal trigger Groovy mostra in forma leggibile il contenuto dello snapshot della legenda.

Fig. 4 — Dettaglio scenario esistente: preview HTML del legend_state

Attore: Utente Finale

La toolbar scenari è integrata nel tab legenda del widget Layout 2D. Si inizializza solo dopo che tutti i layer (di prodotto, dinamici, WMS utente e Shapefile utente) sono stati caricati completamente.

Fig. 5 — Toolbar scenari nel tab legenda del widget Layout 2D

La toolbar contiene: select scenario (filtra per mappa corrente, include “Nessuno scenario impostato”), pulsante Nuovo, pulsante Salva, pulsante Edita Nome, pulsante Elimina.

Fig. 6 — Dettaglio pulsanti della toolbar scenari

L'Utente Finale preme Nuovo: appare un input per il nome dello scenario. Alla conferma, il sistema fotografa lo stato corrente della legenda e crea il nuovo scenario.

Fig. 7 — Dialogo creazione nuovo scenario da mappa: input nome

Dopo la selezione dalla select, la legenda si aggiorna accendendo e spegnendo i layer secondo lo snapshot salvato. Il nome dello scenario corrente è evidenziato nella toolbar.

Fig. 8 — Scenario applicato: legenda aggiornata coerentemente

L'Utente Finale preme Edita Nome: appare un input con il nome corrente, editabile. Alla conferma il nome viene aggiornato senza modificare il legend_state_json.

Fig. 9 — Dialogo modifica nome scenario

L'Utente Finale preme Elimina: il sistema chiede conferma esplicita. Alla conferma, lo scenario viene eliminato; la mappa mantiene lo stato corrente; la select torna a “Nessuno scenario impostato”.

Fig. 10 — Dialogo conferma eliminazione scenario

La toolbar scenari viene inizializzata dopo che tutti i layer della legenda sono pronti. La sequenza garantita è:

1. apertura mappa Layout 2D
2. caricamento layer di prodotto e dinamici
3. caricamento layer utente WMS e Shapefile (SV.0026.016)
4. costruzione albero della legenda completo
5. inizializzazione toolbar scenari
6. applicazione eventuale dello scenario precedentemente selezionato

Questa sequenza è vincolante: inizializzare gli scenari prima che la legenda sia completa produrrebbe snapshot incompleti o applicazioni parziali.

Il client confronta continuamente lo stato corrente della legenda con lo snapshot dello scenario applicato (confronto su id layer + flag visibilità). Se rileva una differenza, attiva l'indicatore “modificato non salvato” rendendo attivo il pulsante Salva e disattivando il richiamo automatico.

Se un layer presente nello snapshot non è disponibile nella legenda corrente (es. layer utente eliminato), il sistema non blocca l'applicazione dello scenario: continua su tutti gli altri layer presenti, ignorando silenziosamente quelli mancanti.

Le operazioni sugli scenari utilizzano le API JS standard di classe di Geoweb:

• insertGwClassRecord() — creazione scenario
• updateGwClassRecord() — aggiornamento stato / nome
• deleteGwClassRecord() — eliminazione scenario

Il backend filtra sempre per gw_map_name, garantendo che ogni mappa veda solo i propri scenari.

Il trigger Groovy di classe genera il campo legend_state_html a partire da legend_state_json. Il widget HTML prodotto mostra in forma readonly la lista dei layer inclusi nello scenario con il relativo stato acceso/spento. Questo campo è di sola lettura nel dettaglio di classe: non è prevista né supportata la modifica manuale di legend_state_json dall'interfaccia.

Gli scenari non hanno conoscenza del tipo di layer; si limitano a fotografare e applicare la visibilità di ciò che la legenda espone. Il caricamento dei layer WMS utente e Shapefile utente è onere di SV.0026.016. La sequenza esecutiva garantisce che gli scenari vedano sempre la legenda completa, inclusi i layer utente.

Script DDL per la creazione della tabella applicativa gwd_mg_scenario. Eseguire prima di importare i metadati.

data_script_postgres.sql

-- SV.0026.017 - Layout 2D: Scenari Layer Utente
-- PostgreSQL DDL
-- Redattore: GSC  Data: 2026-06-26
 
-- Table: test_gw48data.gwd_mg_scenario
 
-- DROP TABLE IF EXISTS test_gw48data.gwd_mg_scenario;
 
CREATE TABLE IF NOT EXISTS test_gw48data.gwd_mg_scenario
(
    id_gwd_mg_scenario INTEGER NOT NULL,
    gw_map_name CHARACTER VARYING COLLATE pg_catalog."default" NOT NULL,
    scenario_name CHARACTER VARYING COLLATE pg_catalog."default" NOT NULL,
    scenario_descr CHARACTER VARYING COLLATE pg_catalog."default",
    legend_state_json jsonb,
    created_at TIMESTAMP WITHOUT TIME zone,
    created_by CHARACTER VARYING COLLATE pg_catalog."default",
    updated_at TIMESTAMP WITHOUT TIME zone,
    updated_by CHARACTER VARYING COLLATE pg_catalog."default",
    legend_state_html CHARACTER VARYING COLLATE pg_catalog."default",
    CONSTRAINT gwd_mg_scenario_pkey PRIMARY KEY (id_gwd_mg_scenario),
    CONSTRAINT unique_scenario_name UNIQUE (scenario_name)
)
WITH (
    OIDS = FALSE
)
TABLESPACE pg_default;
 
ALTER TABLE IF EXISTS test_gw48data.gwd_mg_scenario
    OWNER TO test_gw48data;

data_script_oracle.sql

-- SV.0026.017 - Layout 2D: Scenari Layer Utente
-- Oracle DDL
-- Redattore: GSC  Data: 2026-06-26
 
-- ============================================================
-- Tabella: GWD_MG_SCENARIO
-- ============================================================
 
CREATE TABLE GWD_MG_SCENARIO
(
    ID_GWD_MG_SCENARIO   NUMBER(10)     NOT NULL,
    GW_MAP_NAME          VARCHAR2(500)  NOT NULL,
    SCENARIO_NAME        VARCHAR2(500)  NOT NULL,
    SCENARIO_DESCR       VARCHAR2(2000),
    LEGEND_STATE_JSON    CLOB,
    LEGEND_STATE_HTML    CLOB,
    CREATED_AT           TIMESTAMP,
    CREATED_BY           VARCHAR2(200),
    UPDATED_AT           TIMESTAMP,
    UPDATED_BY           VARCHAR2(200),
    CONSTRAINT GWD_MG_SCENARIO_PK        PRIMARY KEY (ID_GWD_MG_SCENARIO),
    CONSTRAINT UNIQUE_SCENARIO_NAME      UNIQUE (SCENARIO_NAME)
);

data_script_mssqlserver.sql

-- SV.0026.017 - Layout 2D: Scenari Layer Utente
-- SQL Server DDL
-- Redattore: GSC  Data: 2026-06-26
 
-- ============================================================
-- Tabella: GWD_MG_SCENARIO
-- ============================================================
 
IF OBJECT_ID(N'dbo.GWD_MG_SCENARIO', N'U') IS NULL
BEGIN
    CREATE TABLE dbo.GWD_MG_SCENARIO
    (
        ID_GWD_MG_SCENARIO   INT             NOT NULL,
        GW_MAP_NAME          NVARCHAR(500)   NOT NULL,
        SCENARIO_NAME        NVARCHAR(500)   NOT NULL,
        SCENARIO_DESCR       NVARCHAR(2000),
        LEGEND_STATE_JSON    NVARCHAR(MAX),
        LEGEND_STATE_HTML    NVARCHAR(MAX),
        CREATED_AT           DATETIME2,
        CREATED_BY           NVARCHAR(200),
        UPDATED_AT           DATETIME2,
        UPDATED_BY           NVARCHAR(200),
        CONSTRAINT GWD_MG_SCENARIO_PK    PRIMARY KEY (ID_GWD_MG_SCENARIO),
        CONSTRAINT UNIQUE_SCENARIO_NAME  UNIQUE (SCENARIO_NAME)
    );
END
GO

Eseguire i passi nell'ordine indicato:

1. Eseguire DR/script/<dbms>/data_script.sql — crea la tabella gwd_mg_scenario
2. Importare i file XML da DR/metadata/ tramite il Webadmin Geoweb (Import/Export metadati):
   • gw_exp.classes gwd_mg_scenario.xml
   • gw_exp.projects mg_user_layer.xml
   • gw_exp.themes MAPGUIDE USER LAYER E SCENARIO.xml
3. Verificare che il trigger Groovy di classe sia configurato e generi correttamente legend_state_html
4. Prerequisito: SV.0026.016 deve essere già installato nell'ambiente