Installazione

Per installare MzS Tools è necessario selezionare, tramite il menu plugin, la voce «Gestisci e installa plugin…».

Importante

Il plugin è compatibile esclusivamente con QGIS versione 3.26 o successive. E' consigliabile scaricare (ed aggiornare regolarmente) l’ultima versione LTR (long term release) disponibile sul sito ufficiale.

Successivamente cliccare sulla scheda «Non Installati» e digitare, all’interno della barra di ricerca, il nome del plugin: «MzS Tools». QGIS mostrerà una lista dei plugin presenti con le parole chiavi digitate: selezionare «MzS Tools» all’interno dell’elenco e premere il pulsante «Installa Plug-in».

Componenti aggiuntive

Le funzionalità di importazione ed esportazione dati di MzS Tools da/verso database Microsoft Access (database «CdI_Tabelle.mdb» definito dagli Standard MS), richiedono l’installazione di alcune componenti aggiuntive:

  • una release recente di Java runtime environment (JRE o JDK versione 11 o successiva) a 64 bit installata sul sistema operativo;

  • driver JDBC per Access (UcanAccess) (incluso nel plugin);

  • librerie Python (JayDeBeApi) per l’accesso alle funzionalità Java, installate tramite il plugin per QGIS QPIP.

Installazione di Java

Per abilitare le funzionalità del plugin che richiedono l’accesso ai database in formato Microsoft Access, è necessario installare una versione recente di Java Runtime Environment (JRE o JDK) a 64 bit sul sistema operativo.

Attenzione

La versione 8 di Java disponibile sul sito www.java.com NON è compatibile con il driver JDBC UcanAccess, che dalla versione 5.1.0 richiede Java 11 o superiore. Si consiglia di scaricare una versione recente di OpenJDK (free ed open source) tramite ad esempio il sito Adoptium, oppure la JDK Oracle (licenza NFTC).

Dopo aver installato la JDK o JRE, potrebbe essere necessario impostare la variabile di ambiente di sistema JAVA_HOME con il percorso della cartella di installazione (ad es. C:\Program Files\Eclipse Adoptium\jre-25.0.0.36-hotspot\).

Durante l’installazione dei pacchetti per Windows scaricati da Adoptium, è possibile selezionare un’opzione per l’impostazione automatica della variabile di ambiente JAVA_HOME:

../_images/jdk_install_01.png

Installazione librerie Python con QPIP

Per installare le librerie Python necessarie per l’accesso alle funzionalità Java, è possibile utilizzare il plugin per QGIS QPIP.

Durante l’installazione di MzS Tools, QGIS richiederà di installare le dipendenze necessarie per il corretto funzionamento:

../_images/qpip_01.png

Controllare nel gestore dei plugin di QGIS che il plugin QPIP sia installato e attivo.

Suggerimento

Dopo aver installato QPIP potrebbe essere necessario riavviare QGIS.

Al riavvio, QPIP chiederà automaticamente di installare le librerie Python richieste da MzS Tools.

../_images/qpip_02.png

Installazione versione di sviluppo

E' possibile installare l’ultima versione di sviluppo di MzS Tools utilizzando il repository definito all’indirizzo:

https://cnr-igag.github.io/mzs-tools/plugins.xml

Nel gestore dei plugin di QGIS:

  • selezionare la voce «Impostazioni»;

  • abilitare la voce «Mostra anche Plugin Sperimentali»;

  • cliccare sul pulsante «Aggiungi…»;

  • inserire un nome per il repository (ad es. «MzS Tools dev»), la URL indicata sopra e premere «OK».

Attenzione

La versione di sviluppo potrebbe contenere funzionalità non ancora completamente testate e potenzialmente instabili. Si consiglia di utilizzare la versione di sviluppo solo per test.