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 lo strumento integrato del plugin (vedi: Controllo delle dipendenze del plugin) oppure tramite il plugin per QGIS QPIP (da installare separatamente).

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

In alternativa, se si è sicuri di aver installato correttamente la JRE ma questa non viene rilevata dal plugin, è possibile impostare manualmente il percorso della cartella di installazione di Java nelle impostazioni (vedi: Impostazioni di MzS Tools).

Controllo ed installazione delle dipendenze del plugin

Installazione librerie Python

Per installare le librerie Python richieste è possibile utilizzare lo strumento integrato Controllo delle dipendenze del plugin.

../_images/plugin_deps_02.png

Questo strumento consente di rilevare ed installare automaticamente le librerie mancanti, oltre ad effettuare un controllo della corretta installazione della Java Runtime Environment.

../_images/plugin_deps_04.png

Per maggiori dettagli sull’utilizzo dello strumento, vedere la sezione Controllo delle dipendenze del plugin.

Installazione librerie Python con QPIP

In alternativa allo strumento integrato, è possibile utilizzare il plugin per QGIS QPIP.

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, utilizzare lo strumento «Run dependencies check» di QPIP per 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.