STARCheck Struttura e funzionamento versione 1.0 2011-03-20 aggiornato alla versione 2.1.0 di STARCheck
Modifiche 1.0 (2.1.0-6.5 2011-03-20) aggiunta della libreria vtd-xml-2.10 0.6.0 (2.0.0-6.5 2011-03-06) aggiornamento delle librerie address-normalizer, derby-lookup-tables aggiunta delle librerie addressbook-service, lookuptables-service, derby-addressbook 0.5.0 (1.0.0 2011-11-30) eliminazione della libreria u3t-codec aggiunto il riferimento bibliografico agli schemi del U3T.XML, del rapporto di validazione e della visura di lavoro aggiunta funzionalità di esportazione della dichiarazione IVA per l Agenzia delle Entrate 0.4.0 (0.14.0 2011-10-11) eliminazione delle librerie jaxb-api-2.0, jsr173_api-1.0 e activation-1.1 aggiunta delle librerie saxon-8.7, fop-1.0 e delle librerie necessarie a quest ultima 0.3.0 (0.13.2 2011-09-30) aggiornamento della libreria check-cf, sostituita da una soluzione multipiattaforma aggiunta della libreria U3TStampaPdfAE-1.0.0.jar (fornita da IC, al netto del numero di versione, il 15/09/2011 15.36), che potrebbe sostituire anche la libreria u3t-codec- 0.2.0.jar 0.2.0 (0.12.5 2011-08-31) Notificata presenza del rapporto di validazione in formato HTML Aggiunta delle librerie address-normalizer, xml-utils Aggiornamento delle librerie check-cf, derby-lookup-tables Aggiunta la descrizione dei tipi di notifiche del rapporto di validazione 0.1.0 (0.7.2 2011-05-24) Prima stesura del documento, unitamente al rilascio della versione 0.7.2 del prodotto.
Introduzione STARCheck è un componente software sviluppato in tecnologia Java che esegue diverse operazioni sulle pratiche già preparate per il registro imprese nei formati previsti: U3T, U3X, U3T.XML (lo schema di U3X e U3T.XML è in bibliografia). Nelle sezioni seguenti sono descritti i contenuti, i casi d uso e le funzionalità del componente. Contenuti Dispiegamento STARCheck è distribuito come libreria Java (jar) funzionante con JVM 1.6.0 e successive, insieme alle librerie e alle risorse da cui dipende: starcheck-2.1.0.jar componente principale, utilizzabile anche come applicazione indipendente da linea di comando e con interfaccia grafica address-normalizer-1.0.0.jar libreria per la normalizzazione degli indirizzi postali addressbook-service-1.0.0.jar libreria che definisce il servizio per i provider per la normalizzazione degli indirizzi postali check-cf-1.0.0.jar libreria per il controllo del codice fiscale commons-math-2.2.jar libreria per i calcoli matematici derby-address-book-1.0.0.jar provider Derby per l indirizzario del normalizzatore di indirizzi postali derby-lookup-tables-1.0.0-6.5.jar libreria e database delle tabelle di lookup fedra-spellchecker-0.2.0.jar libreria per il controllo ortografico fop-1.0.jar libreria per la produzione di documenti PDF lookuptables-service-1.0.0.jar libreria che definisce il servizio per i provider per l accesso alle tabelle di lookup saxon-8.7.jar libreria per le trasformazioni XML vqbuilder-0.8.0.jar libreria per la produzione della visura a quadri U3TStampaPdfAE-1.0.0.jar libreria per la creazione e visualizzazione in PDF del modulo IVA dell Agenzia delle Entrate (fornita da IC come U3TStampaPdfAE.jar datato 15/09/2011 15.36 su \\svilfedraplus.mi.cciaa.net\stampaae) vtd-xml-2.10.jar libreria per l interrogazione di XML xml-utils-2.2.0.jar libreria per la gestione di XSLT Altre librerie richieste indirettamente, incluse nella distribuzione, sono: avalon-framework-api-4.3.1.jar richiesta da fop-1.0 avalon-framework-impl-4.3.1.jar richiesta da fop-1.0
batik-anim-1.7.jar richiesta da fop-1.0 batik-awt-util-1.7.jar richiesta da fop-1.0 batik-bridge-1.7.jar richiesta da fop-1.0 batik-css-1.7.jar richiesta da fop-1.0 batik-dom-1.7.jar richiesta da fop-1.0 batik-ext-1.7.jar richiesta da fop-1.0 batik-extension-1.7.jar richiesta da fop-1.0 batik-gvt-1.7.jar richiesta da fop-1.0 batik-js-1.7.jar richiesta da fop-1.0 batik-parser-1.7.jar richiesta da fop-1.0 batik-script-1.7.jar richiesta da fop-1.0 batik-svg-dom-1.7.jar richiesta da fop-1.0 batik-svggen-1.7.jar richiesta da fop-1.0 batik-transcoder-1.7.jar richiesta da fop-1.0 batik-util-1.7.jar richiesta da fop-1.0 batik-xml-1.7.jar richiesta da fop-1.0 commons-dbutils-1.3.jar richiesta da address-normalizer-0.8.0 e derby-lookup-tables-0.3.3 commons-io-1.3.1.jar richiesta da fop-1.0 commons-io-1.3.2.jar richiesta da fedra-spellchecker-0.2.0 commons-logging-1.0.4.jar richiesta da fop-1.0 derby-10.6.2.1.jar richiesta da address-normalizer-0.8.0 e derbylookup-tables-0.3.3 hunspell-1.1.12-2-java-13.jar richiesta da fedra-spellchecker- 0.2.0 jna-1.1.12-2-java-13.jar richiesta da fedra-spellchecker-0.2.0 xalan-2.6.0.jar richiesta da fop-1.0 xml-apis-1.3.04.jar richiesta da fop-1.0 xml-apis-ext-1.3.04.jar richiesta da fop-1.0 xmlgraphics-commons-1.4.jar richiesta da fop-1.0 Risorse Le risorse dell applicazione sono in parte dispiegate esternamente ai jar e in parte al loro interno. Le risorse esterne sono: db/addressbook base di dati Derby 1 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 DISTPDF.EXE eseguibile win32, fornito da InfoCamere, utilizzato per la produzione della visura a quadri in PDF Le risorse interne accessibili sono: in starcheck-2.0.0-6.5.jar 1 le modalità di accesso alle basi di dati Derby sono descritte in bibliografia.
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) in check-cf-1.0.0.jar it/digicamere/ri/utils/codicefiscale/codicefiscale.js script di controllo del codice fiscale fornito da InfoCamere in derby-lookup-tables-1.0.0-6.5.jar db/lookuptables base di dati Derby delle cosiddette tabelle di lookup Casi d uso I casi d uso del componente sono descritti nel seguente diagramma. Esso può essere utilizzato da un applicazione (web o locale) oppure direttamente da un umano tramite la sua interfaccia utente. Le funzionalità esposte sono descritte nelle sezioni seguenti.
Funzionalità Validazione pratica L attività della funzionalità di validazione è descritta nel seguente diagramma. La lettura della pratica è affidata a un insieme di filtri, in grado di riconoscere se la pratica selezionata dal Client è ben formata e valida. Il concetti di ben formato e valido sono qui usati nella stessa accezione della tecnologia xml, ma sono estesi al formato U3T. Nel caso del formato U3T i controlli sono delegati alla libreria U3TStampaPdfAE-1.0.0, fornita da InfoCamere. Una pratica che non sia ben formata e valida causa un errore di lettura, con conseguente segnalazione di errore al client. La informazioni utili alla verifica della sequenza dei moduli della pratica e le regole di validazione per ogni elemento della pratica sono contenute in un database XML (validationrules.xml) contenuto in STARCheck-x.x.x.
Durante la visita dei moduli della pratica, tutte le regole relative a tutti gli elementi interni allo schema dei moduli, anche se non presenti nella pratica reale, sono applicate. L eventuale fallimento di una regola è registrato come remark (avviso) associato all elemento di pratica analizzato. I remark possono avere quattro livelli: FAILURE: difetto di STARCheck nella valutazione di una regola di validazione; ERROR: l applicazione della regola segnala un errore bloccante; WARNING: l applicazione della regola segnala un errore non bloccante; UNASSESSABLE: la regola non è valutabile per la mancanza di almeno un dato necessario; non è bloccante. Validazione con visura di lavoro La validazione può essere estesa o completata fornendo informazioni aggiuntive sull impresa mediante la cosiddetta visura di lavoro 2, estratta dal Registro delle Imprese. La visura di lavoro consente al sistema di conoscere la forma giuridica dell impresa (informazione spesso non contenuta nella pratica e da essa non inferibile), le persone e le loro cariche all interno dell impresa e le unità locali della stessa. Queste informazioni consentono di eseguire alcuni controlli normalmente UNASSESSABLE e di aggiungerne di ulteriori. Rapporto di validazione Quando tutta la pratica è stata analizzata, è creato un rapporto XML o HTML che riflette la struttura della pratica e contiene anche i remark associati ai nodi che rappresentano gli elementi della pratica. I remark dei controlli aggiuntivi sulla visura di lavoro sono marchiati con l autore vdl per distinguerli dai controlli standard. Gli errori e i corrispondenti prototipi di messaggi d errore sono elencati in appendice. Conversione dei formati di pratica La conversione dei formati di pratica è delegata interamente alla libreria U3TStampaPdfAE- 1.0.0. Una pratica che non sia ben formata e valida causa un errore di lettura, con conseguente segnalazione di errore al client. Visura a quadri La creazione della visura a quadri utilizza modalità diverse per i diversi formati: XML: costruita con una funzionalità interna a STARCheck, secondo lo schema validation-report.xsd, descritto in bibliografia; PDF: modalità selezionabile: IC: delegata alla libreria vqbuilder-x.x.x 3 FOP: funzionalità interna a STARCheck 2 Gli schemi sono nei riferimenti bibliografici. 3 vqbuilder-x.x.x contiene e controlla una libreria per Windows 32 bit, VQStarcheck.dll, compilata dal codice fornito da InfoCamere, e un programma eseguibile per Windows 32 bit, DISTPDF.EXE, fornito da InfoCamere. Nella cartella FORM50 sono contenute le risorse per la produzione del documento finale in formato testo o PDF.
TXT: delegata alla libreria vqbuilder-x.x.x Esportazione dichiarazione IVA per l Agenzia delle Entrate La funzione di produzione della dichiarazione IVA per l Agenzia delle Entrate è delegata alla libreria U3TStampaPdfAE-1.0.0, che, a partire da una pratica che contiene un modulo IVA, produce in formato PDF la dichiarazione IVA per l Agenzia delle Entrate; il documento prodotto è in formato PDF.
Bibliografia Schema di U3X e U3T.XML: u3t.xsd Schema del rapporto di validazione e della visura a quadri: validation-report.xsd Schema della visura di lavoro: BlocchiImpresa.xsd e DatiIdentificativi.xsd Modalità di accesso alle risorse: STARCheckmanutenzione.pdf