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 aggiuntivi

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

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

  • la presenza di un driver JDBC per Access (UcanAccess) (incluso nel plugin);

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

Installazione di Java

E' necessario installare una versione recente di Java runtime environment (JRE o JDK) 64 bit sul sistema operativo.

Attenzione

La versione 8 di Java disponibile sul sito Oracle NON è compatibile con il driver JDBC UcanAccess. Si consiglia di scaricare una versione recente di OpenJDK (free ed open source) tramite ad esempio il sito Adoptium.

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.