STARCheck Manutenzione versione 0.1.0 2011-12-02 aggiornato alla versione 1.0.0 di STARCheck Modifiche 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 ● vdl-errors.properties lista dei codici e dei relativi prototipi di messaggi d’errore relativi all’estensione vdl (visura di lavoro) ● 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 specifiche.ini Lista delle coordinate gestibili dal convertitore di formato. È un file di testo posto alla radice dell’archivio starcheck-x.x.x.jar. 1La configurazione di OpenOffice Base per l’accesso alle basi di dati Derby di STARCheck è spiegata in appendice. 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 vdl-errors.properties Lista dei codici e dei relativi prototipi di messaggi d’errore della validazione con visura di lavoro. È un file di proprietà nel formato standard della tecnologia Java, 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 vdl-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 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 2La 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