Guida a ComputoXPWE

di Paolo Murru – versione 1.0.4, novembre 2026

Dai dati di QGIS al computo metrico, e ritorno, con il formato di scambio XPWE (usato da diversi programmi di computo e contabilità lavori). Questa guida spiega cosa fa ogni strumento, cosa mettere in ogni campo e perché.

Il plugin è pensato per la contabilità lavori fatta direttamente in cantiere, su infrastrutture lineari (canali, condotte, strade, reti) e puntuali (idranti, pozzetti, pali). Va abbinato a un progetto GIS di gestione dell'opera, pensato per essere caricato e sincronizzato in campo con QField, Mergin Maps o QGIS su tablet: le misure prese in cantiere, elemento per elemento, arrivano nel computo XPWE senza essere ricopiate.

1Cosa fa il plugin

Per cosa è pensato

ComputoXPWE è pensato per la contabilità lavori fatta direttamente in cantiere, su infrastrutture lineari (canali, condotte, strade, reti) e puntuali (idranti, pozzetti, pali, manufatti).

Per questo va abbinato a un progetto GIS di gestione dell'opera, in cui ogni elemento (un tratto, un punto, un'area) è un oggetto sulla mappa. Il progetto è pensato per essere caricato e sincronizzato in campo con QField, Mergin Maps o QGIS su un tablet: chi è in cantiere tocca l'elemento e registra le lavorazioni eseguite con le loro misure; in ufficio quelle misure, elemento per elemento, arrivano nel computo XPWE senza essere ricopiate. Il capitolo 12 spiega come impostare il lavoro.

Cosa fa e cosa non fa

Cosa faPorta in QGIS il computo di progetto, prepara la tabella per registrare in campo le lavorazioni eseguite su ogni elemento, e trasforma quelle misure in un computo XPWE organizzato, da aprire nel programma di computo e contabilità.
Cosa non faNon sostituisce il programma di contabilità: libretto delle misure, registro di contabilità, stati di avanzamento firmati e responsabilità del direttore dei lavori restano nel programma di contabilità e nelle procedure previste. ComputoXPWE porta le misure, non tiene la contabilità ufficiale.
ArrotondamentiSegue le regole di arrotondamento dei programmi di computo (dimensioni, righe, arrotondamento commerciale). Nelle prove il totale è risultato uguale a quello del programma di computo; su voci con quantità con molti decimali (es. pesi in kg) si possono avere differenze di pochi centesimi. Fa fede il totale del programma di computo.
CompatibilitàCollaudato con computi XPWE salvati da un programma di computo commerciale. Altri programmi dichiarano di leggere o scrivere XPWE: con un programma nuovo fai una prova prima di usarlo in un lavoro.
SegnalazioniSegnalazioni e suggerimenti sono benvenuti.
PrerequisitiServe un progetto GIS dell'opera fatto bene (elementi disegnati e divisi come verranno contabilizzati) e un minimo di pratica con QGIS.

I quattro strumenti

Il plugin ha quattro strumenti: due per lo scambio con i programmi di computo e due per controllare la contabilità in QGIS.

Esporta

Da QGIS al computo. Prende un layer o una tabella e crea un file .xpwe che il programma di computo apre come computo metrico. Ogni elemento della tabella diventa una riga di misura.

Importa

Dal computo a QGIS. Legge un file .xpwe e lo trasforma in tabelle di QGIS, per analizzarlo, confrontarlo o collegarlo alla mappa.

Visualizzatore contabilità

Dentro QGIS. Mostra quantità e importi della contabilità per periodo e per gruppo, con ricerca, e trova sulla mappa gli elementi di ogni voce (capitolo 10).

Confronto progetto / contabilità

Dentro QGIS. Voce per voce, quanto prevedeva il computo di progetto e quanto è già stato contabilizzato, con barre di avanzamento e residuo (capitolo 11).

Il formato XPWE e i programmi compatibili

XPWE è un formato di scambio dei computi metrici: un file XML leggibile, che diversi programmi di computo e contabilità lavori sanno leggere e scrivere.

Cosa è stato verificatoComputoXPWE è stato collaudato confrontando i suoi file con computi XPWE salvati da un programma di computo commerciale (stessa struttura e, nelle prove, stessi totali). Con un programma diverso conviene fare una prova prima di usarlo in un lavoro.

I formati propri dei programmi di computo invece sono chiusi e non si possono leggere: per passare un computo a QGIS, nel programma si salva in XPWE (di solito File → Salva con nome).

2Installare il plugin

  1. Salva il file computoxpwe_….zip sul computer. Non estrarlo.
  2. In QGIS: menu Plugin → Gestisci e installa plugin…
  3. Nella colonna a sinistra clicca Installa da ZIP.
  4. Clicca i tre puntini …, scegli lo ZIP e premi Installa plugin. Se compare un avviso di sicurezza, rispondi Sì.
  5. In alto compaiono le icone di ComputoXPWE. Se non le vedi: Visualizza → Barre degli strumenti → ComputoXPWE.

Gli strumenti si trovano anche nel menu Plugin → ComputoXPWE e nel pannello Strumenti di Processing, gruppo ComputoXPWE.

3Preparare i dati

La regola di base è una sola: una riga della tabella = una riga di misura nel computo. Prima di esportare, chiediti quindi: “ogni riga della mia tabella è una misura?”.

CasoCome devono essere i datiEsempio
Una voce per elementoIl layer stesso: ogni elemento ha il suo codice tariffa in un campo.Condotte: ogni tratto ha il campo codice = tipo di tubo.
Più voci per elemento, sempre le stesse regoleIl layer + una tabella regole (capitolo 5).Ogni tratto: tubo + scavo + ripristino.
Più voci per elemento, diverse caso per casoUna tabella delle lavorazioni, con una riga per ogni voce eseguita e un campo che la collega all'elemento.Idranti: tabella CONTABILITA, una riga per ogni voce su ogni idrante.

Se le informazioni stanno in due tabelle (per esempio lavorazioni e idranti), si uniscono prima con un join o con un layer virtuale: vedi l'esempio al capitolo 11.

Il prezzarioDescrizioni, unità di misura e prezzi possono stare nella stessa tabella delle misure, oppure in una tabella prezzario separata (CSV, Excel o layer) con codice, descrizione, unità di misura, prezzo e, se vuoi, capitolo. Il prezzario separato è più comodo e si riusa.

4Esportare il computo, campo per campo

Clicca l'icona con la freccia arancione: si apre la finestra di esportazione, divisa in sei passi elencati a sinistra (Dati, Voci e quantità, Raggruppamenti e testo, Prezzi, SAL e periodo, Salva ed esegui). Passa da un passo all'altro con Avanti o cliccando sul passo; quando hai compilato quello che serve, premi Anteprima e salva…: si apre l'anteprima del computo così come apparirà nel programma di computo (gruppi, voci, righe di misura, totali per gruppo ed elenco prezzi, con una casella di ricerca). Se va bene premi Salva il computo, altrimenti Torna indietro e correggi: finché non confermi non viene salvato nessun file. Se manca qualcosa, la finestra ti dice quale passo completare. Nel passo 3 l'anteprima ti mostra gruppi e testo calcolati sul primo elemento. La tabella seguente spiega ogni campo. Ogni campo accetta il nome di una colonna oppure un'espressione di QGIS, che si scrive con il pulsante ε accanto al campo. I campi non obbligatori si possono lasciare vuoti.

CampoCosa mettereEsempio
Tabella / layer delle misureLa tabella in cui ogni riga è una misura.contabilita_dettaglio
FiltroQuali righe esportare. Vuoto = tutte."stato" <> 'Stralciato'
Codice tariffaIl campo con il codice della voce (deve esistere nell'elenco prezzi del computo). Vuoto solo se usi la tabella regole."codice"
Tabella regoleSolo per generare più voci dallo stesso elemento (capitolo 5).regole_condotte
Data della misura, DAL, ALPer i SAL (capitolo 6)."data"
QuantitàLa quantità, se non usi le dimensioni."quantita", 1, round($area,2)
Gruppo 1 → Super CategoriaIl primo livello di raggruppamento nel computo.azienda, lotto, comune
Gruppo 2 → CategoriaIl secondo livello.stato dei lavori, via
Gruppo 3 → Sub CategoriaIl terzo livello.tipologia
Testo della riga di misuraCosa leggere accanto a ogni misura nel computo. Per aggiungere le note solo quando ci sono: || coalesce(' - ' || "Note", '')."comune" || ' - Idrante ' || "idrante"
Ordina le righe perL'ordine delle righe dentro ogni voce. Vuoto = per testo."comizio"
DimensioniParti uguali × lunghezza × larghezza × H/peso, come nei programmi di computo. Su ogni riga: se le dimensioni sono compilate, la quantità è il loro prodotto (quelle vuote non contano); se sono tutte vuote, vale la Quantità. Così nella stessa tabella convivono scavi (1 × 2,00 × 1,20 × 1,50) e flange (quantità 1). Accettano anche formule come 3+2.lunghezza round($length,2)
Descrizione, unità di misura, prezzoSolo se non usi un prezzario separato."descrizione"
Prezzario e i suoi campiLa tabella prezzario e quali colonne contengono codice, descrizione, u.m., prezzo, capitolo.PREZZIARIO
Riunisci le righeAttivo: le righe con lo stesso codice nello stesso gruppo diventano una sola voce con tante righe di misura.lasciare attivo
Salva il file inClicca i tre puntini … → Salva in file. Scegli cartella e nome.SAL2_idranti.xpwe
Al termine apri il fileApre il computo nel programma associato ai file .xpwe (il programma di computo che usi).attivo

Dopo il salvataggio, nel riquadro in basso del passo 6 leggi quante righe, voci e gruppi sono stati creati, il totale stimato e, in rosso, gli eventuali problemi: righe senza codice, quantità vuote, codici che mancano nel prezzario.

5Più voci per lo stesso elemento: la tabella regole

Una condotta non è solo il tubo: c'è anche lo scavo, il rinterro, il ripristino. La tabella regole dice al plugin quali voci generare per ogni elemento e come calcolarne la quantità. Si prepara una volta per tipo di lavoro e si riusa.

Ogni riga è una voce. Le colonne sono:

ColonnaSignificato
codiceIl codice tariffa, fisso (CON.01), oppure preso da un campo con il segno uguale davanti (="codice").
filtroFacoltativo: la voce si applica solo agli elementi che lo rispettano.
quantitaLa quantità, se non usi le dimensioni.
parti_ug, lunghezza, larghezza, hpesoLe dimensioni della riga di misura.
testoFacoltativo: il testo della riga per questa voce.

Esempio (si trova in Plugin → ComputoXPWE → Apri la cartella degli esempi):

codicefiltroparti_uglunghezzalarghezzahpeso
="codice"1round($length,2)
CON.01round($length,2)"larg_scavo""prof_scavo"
PAV.01"via" LIKE 'Via%'round($length,2)"larg_scavo" + 0.4

Risultato: per ogni tratto, la tubazione del suo tipo, lo scavo in m³ e, solo sulle vie urbane, il ripristino dell'asfalto.

Come caricare la tabella regoleSe è un CSV: Layer → Aggiungi layer → Aggiungi layer testo delimitato, separatore punto e virgola, Nessuna geometria, e togli la spunta a “Riconosci i tipi di campo”, altrimenti QGIS prova a leggere le espressioni come numeri. Va bene anche una tabella Excel o una tabella dentro un GeoPackage.

6SAL e periodi

Per esportare solo le misure di un periodo serve un campo con la data della misura. Il consiglio è di aggiungerlo alla tabella delle lavorazioni con valore predefinito now(), così ogni riga nuova prende la data del giorno.

  1. Nel campo Data della misura scegli il campo data.
  2. Imposta DAL e AL (estremi compresi). Vuoti significano “dall'inizio” e “fino a oggi”.
  3. Esegui. Nel Log leggi quante misure sono state escluse perché fuori periodo, e quante non hanno data.
Cosa vuoiDALAL
Solo le misure del 2° SALgiorno dopo il 1° SALdata del 2° SAL
Situazione cumulativa al 2° SALvuotodata del 2° SAL
Tutto il lavorovuotovuoto

Due caselle decidono se la data arriva nel computo, e dove:

  • Scrivi la data nel campo data della misura: ogni voce riceve come data la più recente delle sue righe.
  • Scrivi la data in fondo al testo: la data compare accanto a ogni riga, per esempio “Idrante 2 - del 20/05/2026”.

Togliendo entrambe le spunte la data serve solo a scegliere il periodo e non compare nel computo. Lasciando vuoto il campo data, la data non viene usata affatto.

7Aprire il computo nel programma

  1. Se hai lasciato attivo “Al termine apri il file”, il computo si apre da solo. Altrimenti, nel programma di computo: File → Apri (o Importa) e scegli il file .xpwe.
  2. Per vedere i gruppi come titoli, nel programma di computo attiva il raggruppamento per Super Categorie (di solito nelle opzioni di visualizzazione).
  3. Salva nel formato del programma (di solito con File → Salva con nome).
Ogni esportazione crea un file nuovo e completoIl plugin non aggiorna un computo già modificato a mano nel programma. Le correzioni vanno fatte in QGIS, poi si esporta di nuovo.

8Importare un computo e preparare la contabilità

  1. Nel programma di computo salva il computo in formato XPWE (di solito File → Salva con nome, tipo file XPWE).
  2. In QGIS clicca l'icona con la freccia blu.
  3. Scegli il file .xpwe.
  4. Scegli dove metterle: in un GeoPackage (consigliato, restano salvate; il nome viene proposto da solo) oppure come tabelle temporanee.
  5. Premi Anteprima e importa…: vedi il computo con totale, gruppi, voci e righe prima di importarlo. Controlla che il totale sia uguale a quello del programma di computo, poi premi Importa in QGIS. Le tre tabelle compaiono nel pannello Layer, in un gruppo con il nome del computo.
Le tabelle temporanee spariscono alla chiusura di QGISLe riconosci dall'icona accanto al nome. Per tenerle: tasto destro → Rendi permanente.

Preparare la contabilità (opzionale)

Nella stessa finestra puoi spuntare “Prepara anche la contabilità”: il plugin crea, a partire dal computo di progetto, le tabelle per contabilizzare in campo e le collega ai layer degli elementi.

  1. Nella tabella dei layer indica uno o più layer da contabilizzare: per esempio i tratti di un canale (linee), i pali (punti) e le aree di ripristino (poligoni). Con + Aggiungi layer ne aggiungi altri. Finiscono tutti nella stessa contabilità e nello stesso SAL.
  2. Per ogni layer: Campo UUID (vuoto = il plugin lo aggiunge e lo compila), Campi da vedere in CONTABILITA (pochi, proposti da soli) e il campo da usare come Super Categoria nel computo (es. Lotto o Azienda). Se nessun layer indica la Super Categoria, si usano quelle del computo.
  3. Colonne in più: colonne tue, separate da virgola (es. Matricola, N_Modulo).
  4. Proponi lunghezza o superficie dalla mappa: vedi sotto.
  5. Premi Anteprima e importa…, poi salva il progetto (Ctrl+S).

Nel pannello Layer trovi il gruppo “Contabilità – …” con le due tabelle di lavoro; le tabelle del computo restano in un sottogruppo chiuso, solo per consultazione.

TabellaColonne
PREZZIARIOTariffa, Descrizione, Um, Prezzo (dal computo)
CONTABILITAuuid_esec (l'elemento), id_tariffa (la voce, dal menu), Quantita, Parti_uguali, Lunghezza, Larghezza, H_peso, Data_misura, Note, Descrizione, Um, Prezzo, le colonne in più e i campi scelti di ogni layer

Misura proposta dalla mappa

Quando aggiungi una lavorazione a misura (unità m, m², m³) su un elemento:

  • su una linea (tratto di canale, di strada, di condotta), la Lunghezza si compila da sola con la lunghezza del tratto;
  • su un poligono (area di ripristino), la Lunghezza si compila con la superficie dell'area.

Tu aggiungi il resto (parti uguali, larghezza, spessore o altezza). Se hai lavorato solo su una parte del tratto, scrivi la lunghezza vera: il valore scritto a mano non viene più toccato. Per le voci a numero (cadauno) o a peso (kg) la lunghezza resta vuota. Le misure sono nelle unità del sistema di riferimento del layer: usa un sistema in metri (es. Gauss-Boaga, UTM).

Il modulo della contabilità

Quando apri un elemento (con lo strumento Informazioni o in QField / Mergin Maps), nel suo modulo c'è la scheda Contabilità, con le lavorazioni già registrate e il pulsante Aggiungi (+). Il plugin la aggiunge anche se il layer ha un modulo personalizzato, senza toccare le altre schede; se il modulo è quello automatico di QGIS, i campi dell'elemento vanno in una scheda Dati. Se prepari la contabilità più volte sullo stesso layer, la scheda resta una sola. La nuova lavorazione si compila in tre riquadri, nell'ordine in cui si lavora:

RiquadroCampiCome si compilano
VoceVoce di tariffa, Descrizione, Unità di misura, Prezzo unitarioScegli la voce dal menu a tendina; descrizione (per intero, su più righe), unità di misura e prezzo arrivano dal prezziario e non si possono modificare.
MisureParti uguali, Lunghezza, Larghezza, H/peso, Quantità, ImportoSe compili le dimensioni (anche solo le parti uguali), la quantità si calcola da sola e si aggiorna quando cambi una misura. Per i pezzi lasci vuote le dimensioni e scrivi la quantità. Sui tratti e sulle aree la lunghezza o la superficie sono già proposte dalla mappa. L'importo (quantità × prezzo) si calcola da solo.
Data e noteData della misura, Note, colonne in piùLa data è già quella di oggi; la cambi se registri lavori di un altro giorno.

Il collegamento all'elemento (il codice UUID) è automatico e non compare nel modulo: la lavorazione appartiene all'elemento da cui l'hai aggiunta.

Quanto costa ogni elemento

Nella scheda Contabilità del modulo di ogni elemento, sotto l'elenco delle lavorazioni e in basso a destra, c'è una riga di testo non modificabile: Totale lavorazioni di questo elemento: … €. È la somma degli importi di tutte le lavorazioni registrate su quell'idrante, tratto o palo. In QGIS si aggiorna appena aggiungi, cambi o salvi una lavorazione; in QField e Mergin Maps si aggiorna riaprendo l'elemento. Le altre schede del modulo (come “Progetto”) restano come le avevi fatte.

Lo stesso totale è nella tabella attributi del layer, nella colonna Totale lavorazioni (€): puoi ordinare gli elementi per costo, filtrarli o usarlo per colorare la mappa (per esempio gli elementi ancora a 0 €).

Il totale è calcolato: sta solo nel progetto QGIS e non aggiunge colonne ai dati del layer. È un valore indicativo, utile per controllare il lavoro: somma gli importi riga per riga, mentre il programma di computo arrotonda per voce, quindi su molte righe ci possono essere pochi centesimi di differenza. Per gli importi del SAL vale il visualizzatore o il programma di computo.

Il plugin prepara anche il profilo di esportazione (per ogni SAL scegli solo DAL e AL) e il visualizzatore, già collegato a tutti i layer.

PrezziDescrizione, unità di misura e prezzo vengono ricopiati dal computo ogni volta che la riga viene modificata. Se cambi un prezzo nell'elenco prezzi, le righe modificate dopo prenderanno il nuovo prezzo.

9Perché tre tabelle, e a cosa servono

Un computo non è una tabella sola: è fatto di tre livelli, uno dentro l'altro. Il plugin crea una tabella per livello, così ogni informazione sta in un posto solo e i conti tornano.

Elenco prezzi

il listino: una riga per ogni voce di tariffa
  • codice
  • descrizione, u.m.
  • prezzo
  • capitolo

Voci di computo

il computo: una riga per ogni voce usata
  • n_voce, codice
  • quantità totale
  • importo
  • super categoria, categoria, data

Righe di misura

il dettaglio: una riga per ogni misura
  • n_voce, codice
  • testo
  • dimensioni e formule
  • quantità, tipo

Le tabelle sono collegate dal codice (con l'elenco prezzi) e dal n_voce (tra voci e righe).

Un esempio: la voce CBSC.01 “Rimozione apparecchiature” compare una volta nell'elenco prezzi (prezzo 37,96 €), una volta per azienda nelle voci (azienda Rossi, quantità 33, importo 1.252,68 €) e 33 volte nelle righe di misura, una per ogni idrante. Se fosse tutto in una tabella sola, il prezzo e il totale si ripeterebbero 33 volte e sommando si sbaglierebbe.

Quale usare per cosa

Ti serve…Usa
Totali, importi, statistiche per azienda, categoria o lottoVoci di computo (es. con “Statistiche per categorie”)
Ritrovare sulla mappa gli elementi di un computo, controllare misura per misuraRighe di misura, collegate al layer con un join sul testo o su un codice
Il prezzario del progetto da riusare, per esempio come prezzario nell'esportazioneElenco prezzi
Confrontare progetto e contabilitàLe Voci dei due computi, affiancate per codice

Il campo “tipo” nelle righe di misura

tipoCosa èSi somma?
misuraUna misura vera, con dimensioni o quantità.Sì
vedi voceUna misura che richiama la quantità di un'altra voce.Sì
parzialeUn subtotale calcolato dal programma di computo.No, altrimenti conti due volte
titoloSolo testo, usato come intestazione.No (non ha quantità)
vuotaRiga di spaziatura.No

Per sommare le righe correttamente, filtra con "tipo" IN ('misura','vedi voce').

10Visualizzatore contabilità

Il terzo pulsante, con la lente verde, apre il visualizzatore: mostra la contabilità direttamente in QGIS, senza creare file. Serve a rispondere in un attimo a domande come “quanto abbiamo fatto questo mese?”, “a che punto è l'azienda Rossi?”, “dove abbiamo messo le flange DN100?”.

La prima volta: scheda “Origine dei dati”

Il visualizzatore riconosce da solo la tabella di contabilità e i suoi campi: codice (anche se è un menu a tendina verso il prezzario), quantità, prezzo, descrizione, unità di misura, data, e il collegamento al layer degli elementi tramite la relazione del progetto o un campo UUID. Controlla che sia tutto giusto:

CampoEsempio con gli idranti
TabellaCONTABILITA
Codice tariffarepresent_value("id_tariffa"): mostra CBSC.01 invece del numero
Quantità / Prezzo / Data"Quantita'" / "Prezzo" / "Data_misura"
Layer degli elementiIDRANTI_CUAA
Chiave nelle misure / nel layeruuid_esec / UUID
Nome dell'elemento"Comune" || ' - Comizio ' || "Comizio" || ' - Idrante ' || "Idrante"

Se la tabella delle misure ha già la geometria (per esempio un layer di tratti con le loro quantità), scegli “La tabella delle misure ha già la geometria”. Le impostazioni restano salvate nel progetto.

Ogni giorno: scheda “Vista”

  1. Periodo: spunta Dal e/o Al, oppure usa i pulsanti rapidi (Tutto, Questo mese, Mese scorso, Quest'anno).
  2. Raggruppa per: fino a tre livelli, scelti tra i campi degli elementi (azienda, comune, stato…), i campi delle misure, il codice tariffa, il mese o l'anno. Sotto l'ultimo livello ci sono sempre le voci di tariffa, con quantità, prezzo e importo; con “Mostra le singole misure” vedi anche ogni elemento con la sua data.
  3. Filtri: per esempio, sugli elementi, "Stato_contatore" NOT LIKE 'Stralciato%'.
  4. Premi Aggiorna.

In alto leggi importo totale, numero di misure, elementi e voci. Sotto, in grigio, quante misure sono fuori periodo o escluse dai filtri e, in rosso, i problemi: misure senza data, senza codice o non collegate a nessun elemento (le trovi cercando “elemento non trovato”).

Cercare

Nella casella Cerca scrivi un'azienda, un codice, un comizio, un idrante, una data: l'albero mostra solo quello e, accanto, il totale filtrato.

Trovare sulla mappa, e viceversa

  • Clicca una riga, una voce, un'azienda o un gruppo (anche più righe con Ctrl) e premi Trova sulla mappa, oppure fai doppio clic: gli elementi vengono selezionati, la mappa zooma su di essi e li fa lampeggiare.
  • Al contrario: seleziona degli elementi sulla mappa e spunta Solo elementi selezionati in mappa. Il visualizzatore mostra solo le loro misure e si aggiorna da solo ogni volta che cambi la selezione. È il modo più veloce per sapere “quanto vale questa zona”.

La finestra può restare aperta mentre lavori sulla mappa.

Esportare il riepilogo

Esporta riepilogo… salva quello che vedi (rispettando la ricerca) in un file CSV che si apre con Excel.

11Confronto tra progetto e contabilità

Il quarto pulsante, Confronto progetto / contabilità, apre una finestra che fa solo questo: mette accanto, voce per voce, quello che prevedeva il computo di progetto e quello che è stato contabilizzato, con una barra di avanzamento. Risponde a domande come “quanto manca per finire il calcestruzzo?” o “quali voci abbiamo già superato?”.

Il computo di progetto è la tabella Voci di computo creata dall'importazione (nel gruppo “Computo di progetto”): contiene ogni voce con quantità e importo di progetto e resta nel GeoPackage, quindi i dati di progetto sono conservati anche dopo mesi di contabilità. Se hai preparato la contabilità con l'importazione, la finestra la trova da sola e mostra subito i numeri; altrimenti la scegli nella scheda “Origine dei dati”, riquadro Computo di progetto. La scheda “Origine dei dati” è la stessa del visualizzatore: se hai già impostato il visualizzatore, qui non c'è niente da rifare.

Cosa vediSignificato
In altoImporto di progetto, contabilizzato, avanzamento in percentuale e residuo, con una barra grande per tutto il lavoro.
AvanzamentoImporto contabilizzato diviso importo di progetto. La barra è verde fino al 100 % e arancione oltre: la voce ha superato la quantità di progetto (possibile perizia di variante).
Residuo €Quanto resta da contabilizzare rispetto al progetto. Se è negativo è in arancione.
Fuori progettoVoce contabilizzata che nel computo di progetto non c'è (o non c'è in quel gruppo). Il suo importo è compreso nel contabilizzato.
  • Confronta per: “Voce di tariffa” (tutto il lavoro) oppure “Gruppo, poi voce”. Il gruppo si sceglie a sinistra, nel riquadro Gruppo (azienda, lotto…), e si abbina per nome alle Super Categorie del computo di progetto. Il nome può essere anche solo l'inizio: “ROSSI MARIO” va con “ROSSI MARIO - CUAA 0123…”, se nel progetto c'è un solo gruppo che comincia così.
  • Mostra: tutte le voci, solo quelle iniziate, quelle non ancora iniziate, quelle oltre il progetto o quelle fuori progetto. Con la casella Cerca filtri per codice, descrizione o gruppo.
  • Trova sulla mappa (o doppio clic) seleziona gli elementi su cui è stata contabilizzata quella voce: per esempio, dove è stato messo tutto l'acciaio che ha superato il progetto.
  • Esporta confronto… salva la tabella in CSV, con la percentuale e lo stato di ogni voce.

Il contabilizzato segue il periodo e i filtri scelti a sinistra: con “Tutto” vedi l'avanzamento complessivo, con un periodo vedi quanto ha fatto quel SAL rispetto al progetto.

Quanto è affidabileIl confronto usa gli importi di progetto così come sono nel computo importato e calcola il contabilizzato con gli stessi arrotondamenti del visualizzatore. Serve per seguire l'andamento del lavoro; varianti, prezzi nuovi e importi ufficiali restano nel programma di contabilità.

12Lavorare in campo con QField o Mergin Maps

Il punto di forza del metodo è contabilizzare in campo e ritrovare le misure nel programma di computo senza ricopiarle. Il plugin serve solo in ufficio; in campo si usa QField o Mergin Maps sul tablet o sul telefono.

  1. In ufficio, prima: prepara i layer degli elementi, importa il computo con “Prepara anche la contabilità”, salva il progetto.
  2. Sincronizza il progetto con QFieldCloud / QFieldSync oppure con Mergin Maps. Tutto deve stare in GeoPackage nella cartella del progetto: layer degli elementi, CONTABILITA e PREZZIARIO.
  3. In campo: tocchi un elemento → si apre il suo modulo → sezione Contabilità → + → scegli la voce → scrivi quantità o dimensioni (la lunghezza dei tratti è già proposta) → salvi. Data, descrizione, unità di misura e prezzo si compilano da soli.
  4. Sincronizza di nuovo, anche da più tablet: il collegamento tramite UUID (e non tramite il numero della riga) evita conflitti tra dispositivi.
  5. In ufficio, dopo: controlli con il Visualizzatore (per periodo, lotto, layer; trova sulla mappa) ed esporti il SAL con il profilo pronto.

Come dividere l'opera

La regola è una: ogni elemento è un pezzo che contabilizzerai separatamente.

LavoroLayer consigliatiEsempio di misura
Canale in clsTratti (linee) da 25–50 m o per sezione omogenea, con Tratto, Progressive, Lotto; pali o manufatti (punti)Demolizione pareti: 2 × 30,00 × 0,15 × 1,20 m³
StradaTratti (linee) per scavo, fondazione, binder, tappeto; caditoie e pozzetti (punti); ripristini (poligoni)Tappeto: 1 × 120,00 × 6,50 × 0,04 m³ oppure 120,00 × 6,50 m²
Reti (idranti, contatori)Punti di consegnaFlangia DN100: quantità 2

Per dividere una linea in tratti: in QGIS, Processing → Dividi linee per lunghezza massima. Le progressive si calcolano con il calcolatore di campi.

13Salvare le impostazioni di un lavoro

La finestra di esportazione ricorda da sola le ultime impostazioni usate nel progetto. Per conservare quelle di un lavoro preciso usa i profili:

  1. Compila la finestra.
  2. In basso a sinistra premi Salva profilo e dagli un nome, per esempio “Idranti per azienda”.
  3. Salva il progetto QGIS (Ctrl+S): i profili sono conservati dentro il progetto.
  4. La volta successiva scegli il profilo dal menu Profilo: la finestra si ricompila da sola, e cambi solo le date del SAL.

Chi usa gli strumenti dal pannello Strumenti di Processing (gruppo ComputoXPWE) può invece salvare le impostazioni con Avanzate → Copia come JSON e richiamarle con Incolla impostazioni.

14Esempio completo: contabilità idranti per azienda

Situazione: un layer di idranti (IDRANTI_CUAA) con azienda, CUAA, comizio e stato; una tabella CONTABILITA con una riga per ogni voce eseguita su ogni idrante, collegata all'idrante dal campo uuid_esec; una tabella PREZZIARIO.

Passo 1. Unire le tabelle con un layer virtuale

Layer → Aggiungi layer → Aggiungi/Modifica layer virtuale, nome contabilita_dettaglio, “Nessuna geometria”, con questa query:

SELECT i.AZIENDE_IN_DOMANDA AS azienda, i.CUAA, i.Comune, i.Comizio, i.Idrante, i.Stato_contatore AS stato, p.Tariffa AS codice, c.Descrizione AS descrizione, c."Quantita'" AS quantita, c.Um, c.Prezzo, c.Data_misura AS data FROM CONTABILITA c JOIN IDRANTI_CUAA i ON i.UUID = c.uuid_esec LEFT JOIN PREZZIARIO p ON p.fid = c.id_tariffa WHERE i.Stato_contatore NOT LIKE 'Stralciato%'

Il layer si aggiorna da solo ogni volta che modifichi CONTABILITA: non va rifatto.

Passo 2. Esportare

CampoValore
Tabella delle misurecontabilita_dettaglio
Codice tariffa"codice"
Quantità"quantita"
Data, DAL, AL"data" e le date del SAL
Gruppo 1"azienda" || ' - CUAA ' || "CUAA"
Testo"Comune" || ' - Comizio ' || "Comizio" || ' - Idrante ' || "Idrante"
Descrizione / U.m. / Prezzo"descrizione" / "Um" / "Prezzo"

Passo 3. Nel programma di computo

Raggruppamento per Super Categorie: ogni azienda è un titolo con il “+”. Sotto ci sono le sue voci con la descrizione e, sotto ogni voce, una riga per ogni idrante.

15Problemi frequenti

All'apertura di un elemento QGIS chiede di abilitare le macro Python, o dice che “la funzione init di python … non è stata trovata”

Succedeva con i progetti preparati con le versioni dalla 0.16 alla 1.0.3, che mettevano nel modulo una funzione Python. Dalla 1.0.4 non serve più: quando apri il progetto il plugin la toglie da solo (salva il progetto per renderlo definitivo) e il totale delle lavorazioni si aggiorna lo stesso. Se la domanda compare ancora, rispondi No e controlla di avere installato l'ultima versione del plugin.

Nel menu “Codice tariffa” non trovo il campo del codice

Nel primo campo, “Tabella / layer delle misure”, hai scelto il layer sbagliato. Per esempio il layer dei punti, che non ha il codice, invece della tabella delle lavorazioni.

Nel computo i codici sono numeri (1, 19…) invece di CBSC.01

Nella tabella delle lavorazioni il codice è salvato come numero e QGIS mostra il testo solo a video, con un widget “Relazione valore”. Dalla versione 0.9.1 il plugin se ne accorge e esporta da solo il codice mostrato (CBSC.01). Se serve, puoi scriverlo tu come represent_value("id_tariffa").

Nel computo le righe di misura sono vuote

Il campo Testo della riga di misura (passo 3) è vuoto. Scrivi per esempio "Comune" || ' - Comizio ' || "Comizio" || ' - Idrante ' || "Idrante"; se usi direttamente la tabella CONTABILITA con il join, i campi si chiamano "IDRANTI_CUAA_Comune", "IDRANTI_CUAA_Comizio", "IDRANTI_CUAA_Idrante". Il plugin lo propone da solo quando scegli la tabella, e ti avvisa se resta vuoto.

“Nessuna riga da esportare”

Il messaggio dice quante righe sono state escluse dal filtro, quante sono fuori dal periodo e quante non hanno data. Se il filtro usa un campo che non esiste nella tabella, il plugin lo dice con il nome del campo e l'elenco delle colonne disponibili. Per filtrare sullo stato dell'idrante senza averlo nel join: attribute(get_feature('IDRANTI_CUAA', 'UUID', "uuid_esec"), 'Stato_contatore') NOT LIKE 'Stralciato%'.

Nel testo compare NULL quando la nota è vuota

In QGIS, unendo testi con ||, un pezzo vuoto rende vuoto tutto. Usa coalesce(' - ' || "Note", '') invece di || "Note".

Il file finisce in una cartella temporanea

Nel campo “Salva il computo in” clicca i tre puntini … → Salva in file… e scegli cartella e nome.

Il Log segnala “Quantità vuota (messa a 0)”

Quella riga nella tabella non ha la quantità. Il Log indica elemento, codice e testo: correggila in QGIS ed esporta di nuovo.

Il Log segnala “Codice non trovato nel prezzario”

Il codice della misura non esiste nel prezzario scelto, oppure è scritto diversamente (spazi, punti, maiuscole). Per quel codice vengono usati descrizione e prezzo della tabella delle misure, se ci sono.

Il totale del programma di computo è diverso di qualche centesimo da quello del Log

Il plugin usa gli arrotondamenti dei programmi di computo. Piccole differenze possono venire da impostazioni dei decimali diverse nel tuo programma. Fa fede il totale del programma di computo.

La tabella regole dà errori sulle espressioni

Il CSV è stato caricato con il riconoscimento dei tipi attivo, oppure con il separatore sbagliato. Ricaricalo con separatore punto e virgola e senza riconoscimento dei tipi.

Ho il computo in un altro formato, non in .xpwe

I formati propri dei programmi di computo sono chiusi e non si possono leggere. Apri il computo nel suo programma e salvalo come XPWE (di solito File → Salva con nome).

ComputoXPWE – Paolo Murru – Licenza GNU GPL v2 o successiva.