Guida alla manutenzione - WebTelemaco

STARCheck
Manutenzione
versione 4.0.0
2016-05-02
aggiornato alla versione 3.8.5-6.8 di STARCheck
Modifiche
4.0 (3.8.5-6.8 2016-05-02)
Corretto errore di documentazione (validazione pratica con vdl)
0.1.0 (1.0.0 2011-11-30)
Primo rilascio del documento.
Introduzione
Questo documento descrive le modalità di accesso alle risorse di STARCheck per eventuali
interventi diretti successivi all’installazione da parte dell’installatore o dell’utente. Si noti che un
intervento tecnico di questo tipo può provocare il malfunzionamento dell’applicazione.
Le risorse accessibili e modificabili contenute nel pacchetto di distribuzione sono in parte
esterne alle librerie ed in parte interne; le risorse esterne sono:
● addressBook base di dati Derby per la verifica della normalità degli indirizzi
● dict dizionario per il controllo ortografico secondo le specifiche Fedra
● FORM50 prototipi per la visura a quadri su piattaforma win32, forniti da InfoCamere
le risorse interne sono:
● errors.properties lista dei codici e dei relativi prototipi di messaggi d’errore della
validazione
● specifiche.ini lista delle coordinate previste nelle specifiche 6.5
● codicefiscale.js script di controllo del codice fiscale fornito da InfoCamere
● lookuptables base di dati Derby delle cosiddette “tabelle di lookup”
Nel seguito sarà descritta la tipologia e la modalità di accesso per ognuna delle risorse
elencate.
addressBook
La base dati degli indirizzi normali è disponibile nel percorso /db/addressBook ma può
essere spostata a seconda delle necessità del cliente. È una base di dati Derby che può essere
gestita con OpenOffice Base1 secondo la seguente procedura:
1. aprire OpenOffice base
2. creazione guidata database
a. seleziona database
i. scegliere opzione "Collega a un database esistente"
ii. selezionare "JDBC" dalla lista
b. configura connessione JDBC
i. URL della sorgente dati "jdbc:derby:[percorso assoluto del database]"
ii. classe driver JDBC "org.apache.derby.jdbc.EmbeddedDriver"
dict
È il dizionario nel formato di Hunspell per il controllo ortografico secondo le specifiche Fedra,
contenuto nel percorso /dict (ma può essere spostata a seconda delle necessità del cliente).
Il dizionario è costituito da file di testo.
FORM50
Prototipi per la visura a quadri forniti da InfoCamere, contenuti nel percorso /FORM50 (ma può
essere spostata a seconda delle necessità del cliente) e gestibili come file di testo.
errors.properties
Lista dei codici e dei relativi prototipi di messaggi d’errore della validazione. È un file di proprietà
nel formato standard della tecnologia Java, posto alla radice dell’archivio starcheckx.x.x.jar.
Per accedervi, seguire la procedura:
1. espandere in una cartella il jar con un decompressore che gestisca archivi in formato zip
2. il file errors.properties è alla radice della cartella espansa; è un file di testo
3. ricomprimere la cartella in formato zip e assegnare all’archivio lo stesso nome di
partenza
1
La configurazione di OpenOffice Base per l’accesso alle basi di dati Derby di STARCheck è
spiegata in appendice.
specifiche.ini
Lista delle coordinate gestibili dal convertitore di formato. È un file di testo posto alla radice
dell’archivio starcheck-x.x.x.jar.
Per accedervi, seguire la procedura:
1. espandere in una cartella il jar con un decompressore che gestisca archivi in formato zip
2. il file specifiche.ini è alla radice della cartella espansa; è un file di testo
3. ricomprimere la cartella in formato zip e assegnare all’archivio lo stesso nome di
partenza
codicefiscale.js
Script per il controllo del codice fiscale, fornito da InfoCamere. È un file in formato ECMAScript
posto nella libreria check-cf.x.x.x.jar. Per accedervi, seguire la procedura:
1. espandere in una cartella il jar con un decompressore che gestisca archivi in formato zip
2. il file codicefiscale.js è, partendo dalla radice della cartella espansa, nel percorso
/it/digicamere/ri/utils/codicefiscale/; è un file di testo
3. ricomprimere la cartella in formato zip e assegnare all’archivio lo stesso nome di
partenza
lookuptables
La base dati delle tabelle di lookup è contenuta nella libreria derby-lookup-tables-x.x.x.jar, e al
suo interno nel percorso /db/lookuptables. È una base di dati Derby che può essere
gestita, previa decompressione, con OpenOffice Base2 secondo la seguente procedura:
1. espandere in una cartella il jar con un decompressore che gestisca archivi in formato zip
2. aprire OpenOffice base
3. creazione guidata database
a. seleziona database
i. scegliere opzione "Collega a un database esistente"
ii. selezionare "JDBC" dalla lista
b. configura connessione JDBC
i. URL della sorgente dati "jdbc:derby:[percorso assoluto del database]"
ii. classe driver JDBC "org.apache.derby.jdbc.EmbeddedDriver"
4. ricomprimere la cartella in formato zip e assegnare all’archivio lo stesso nome di
partenza
2
La configurazione di OpenOffice Base per l’accesso alle basi di dati Derby di STARCheck è
spiegata in appendice.
Appendice
Configurazione di OpenOffice per l’accesso ai database Derby
Per accedere con OpenOffice ai database distribuiti con STARCheck è necessario usare
almeno la versione 2.0 della suite.
Per configurare OpenOffice Base si segua la procedura:
1. selezionare la voce di menù "Strumenti"->"Opzioni...": si aprirà la finestra "Opzioni";
2. nella finestra “Opzioni”, selezionare dall'albero “OpenOffice.org"->"Java": si mostrerà il
pannello "Opzioni Java";
3. premere il pulsante "Classpath...": si aprirà la finestra "Classpath";
4. nella finestra “Classpath”, premere "Aggiungi archivio...": si aprirà la finestra di selezione
dei file;
5. nella finestra, selezionare il file:
[installazione di STARCheck]\lib\derby-10.6.2.1.jar