REGOLAMENTO CE 1224/2009 ARTT. 59, 62 E 63

Transcript

1 Direzione Generale della Pesca Marittima e dell Acquacoltura REGOLAMENTO CE 1224/2009 ARTT. 59, 62 E 63 MANUALE UTENTE GESTIONE DATI OPERATORE ELABORATORE FILE XML NOTE DI VENDITA ASSUNZIONI IN CARICO DOCUMENTI DI TRASPORTO VERSIONE 1.0 DEL 16/04/2015

2 Indice 1.1 Premessa Scopo Campo di applicazione Requisiti software Riferimenti Registro delle modifiche Interfaccia grafica Riga di Comando Finestra di autenticazione utente Gestione file xml Solo Verifica Verifica e Inserisci Cambio Utenza Parametro 0 Interfaccia grafica Parametro 1 Verifica file xml Parametro 2 Verifica e inserimento file xml Parametro 3 Riconoscimento Utenza e Password...12

3 1 Introduzione 1.1 Premessa Il presente manuale descrive le modalità di funzionamento del software fornito, atto ad elaborare i file xml di Note di Vendita, Assunzioni in Carico e Documenti di Trasporto per la Gestione Operatori secondo il Regolamento Ce 1224/ Scopo Il software di elaborazione file xml per Gestione Operatori è un'applicazione a se stante, che coadiuva il sistema di Gestione Operatori, web based, accessibile all'indirizzo Per utilizzare tale applicazione, bisogna essere registrati e approvati sul portale web indicato. L'applicazione è utilizzabile in due modalità: Modalità con interfaccia grafica, in cui tramite una finestra viene permesso il caricamento di file xml, la verifica formale e dei dati in essi contenuti, e l'inserimento a sistema di tali dati. Modalità a riga di comando, in cui si utilizzerà l'applicazione senza interfaccia grafica, utilizzando i parametri per definire le modalità di utilizzo e i file xml che saranno gestiti. L architettura applicativa adotta il modello SOA orientato ai servizi e lo sviluppo è stato realizzato su piattaforma applicativa J2EE. 1.3 Campo di applicazione L applicazione fa parte dell'ambito del progetto Gestione Operatori, operante all'interno del mondo SIPA (Sistema Italiano della Pesca e dell Acquacoltura). Tutte le applicazioni, manuali e informazioni relative al progetto Gestione Operatori sono raggiungibili sul sito Requisiti software I requisiti minimi per utilizzare l applicazione, sono : -Presenza di un collegamento a Internet -Java Se 5.0 installato nel sistema e la possibilità di richiamarlo dal percorso in cui si trova l'applicazione (per Windows, deve essere presente nel path).

4 1.5 Riferimenti Nel presente paragrafo vengono elencati i documenti che concorrono alla determinazione dei requisiti.s Riferimenti normativi italiani N Riferimento Descrizione Piano Strategico Nazionale (PSN) luglio 2007 Il Piano Strategico Nazionale relativo al periodo della pesca italiana, è stato preparato come documento generale, necessario per definire una cornice di riferimento in cui inserire gli assi prioritari previsti dal programma FEP, i campi di applicazione, gli obiettivi ed i risultati attesi. Si tratta di un documento di riferimento su cui attivare tutti gli strumenti, per il perseguimento di una pesca sostenibile, dal punto di vista ecologico e socio-economico, e perché questo settore, inclusa l acquacoltura, raggiunga elevati livelli di responsabilità verso l ambiente e verso i consumatori, secondo i principi del Codice di condotta per la pesca responsabile del Programma Operativo Programma Operativo nazionale, approvato dalla Commissione Europea con Decisione C(2007) 6972 del 19 dicembre 2007 N Riferimento Descrizione Reg. CE 1224/2009 Reg. CE 404/2011 Istituisce un regime di controllo comunitario per garantire il rispetto delle norme della Politica Comune della Pesca, che modifica i regolamenti (CE) n. 847/96, n. 2371/2002, n. 811/2004, n. 768/2005, n. 2115/2005, n. 2166/2005, n. 388/2006, n. 509/2007 n. 676/2007 n. 1098/2007, n. 1300/2008,n. 1342/2008 e che abroga i regolamenti (CEE) n. 2847/93, (CE) n. 1627/94 e (CE) n. 1966/2006. Regolamento recante modalità di applicazione del regolamento (CE) n. 1224/2009 del Consiglio che istituisce un regime di controllo comunitario per garantire il rispetto delle norme della politica comune della pesca 1.6 Registro delle modifiche Tabella Registro delle modifiche N Revisione Descrizione Autore Data Emissione 1.0 Prima emissione 16/04/2015

5 2 Modalità di colloquio In questo capitolo sono descritte le modalità di utilizzo dell applicazione oggetto del presente manuale. Si fa presente che tale applicazione è adeguata alla vigente normativa in materia di accessibilità. L'applicazione è utilizzabile in due modalità,di seguito descritte: Interfaccia grafica Riga di Comando 2.1 Interfaccia grafica Nell'archivio contenente l'applicazione è presente un file launch.bat che, eseguito con un doppio click, permette l'apertura dell'applicazione in modalità interfaccia grafica. Una prima maschera chiederà l'autenticazione tramite utenza e password. Tale utenza sarà quella con cui si è registrati in precedenza sul portale Una volta autenticati si aprirà la seconda maschera di gestione file xml. L'autenticazione effettuata tramite utenza e password verrà salvata su un file di configurazione all'interno della cartella dell'applicazione e servirà a ricordare l'utente nelle esecuzioni successive, senza reinserire ogni volta le credenziali di accesso. 2.2 Riga di Comando L'applicazione può essere utilizzata anche a riga di comando all'interno di una finestra di prompt (in Windows eseguire il programma standard cmd ). Al file launch.bat andranno passati due parametri, il primo per scegliere le modalità di lavoro e il secondo relativo alla modalità scelta.

6 3 Modalità con Interfaccia Grafica La modalità grafica presenterà delle finestre tramite le quali interagire con il software per scegliere le modalità di elaborazione prevista. Eseguendo il software, si aprirà, oltre alla maschera di gestione, anche una finestra prompt di comandi, dove appariranno i messaggi relativi alle elaborazioni selezionate. Tale finestra rimarrà sullo sfondo e verrà chiusa automaticamente nel momento in cui si chiuderà il software. 3.1 Finestra di autenticazione utente Eseguendo il file launch.bat si aprirà la maschera di autenticazione utente, dove andranno indicate l'utenza e la password ottenuta tramite registrazione sul portale di Gestione Operatori. Qualora fosse inserita un'utenza e password non registrata o errata, apparirà il il messaggio di utenza e password non riconosciuta.

7 A fronte di un inserimento di utenza e password corrette, il sistema salverà tale utenza in un file di configurazione, in modo da evitare l'autenticazione nei successivi utilizzi dell'applicazione, e verrà aperta la maschera di gestione file xml. 3.2 Gestione file xml La maschera di elaborazione file xml indicherà, in alto a destra, l'utente con cui si sta lavorando. In questa maschera c'e' la possibilità di scegliere, tramite tasto Browse, il file xml da elaborare. Una volta scelto il file, il software provvederà a riconoscere il tipo di documento inserito, se Nota di Vendita, o Assunzione in Carico oppure Documento di Trasporto. Qualora non fosse un file xml, verrà mostrato il messaggio di errore scegliere solo files xml

8 Qualora il file sia correttamente un xml, ma non sia riconoscibile nei tre documenti gestiti, verrà mostrato il messaggio File non riconosciuto. Una volta scelto un file xml corretto, il sistema provvederà ad analizzarlo e a stabilire il tipo di documento presente nello stesso. Verrà mostrata una riga con il percorso del file scelto, una riga con il tipo di documento passato e la quantità di record presenti al suo interno. Il terzo box mostrerà il file xml per intero. I due pulsanti in basso saranno resi disponibili e cliccabili e abiliteranno le due possibilità di Solo verifica e Verifica e Inserisci 3.3 Solo Verifica La funzionalità di Solo Verifica, abilitata solo in caso di scelta di un file xml corretto e riconosciuto, provvederà ad analizzare il file scelto, sia formalmente che nei dati contenuti, e restituirà l'esito di tale elaborazione nel campo sottostante Esito elaborazione. Questa funzionalità NON provvederà ad inserire alcun dato sul server principale del SIPA.

9 Nel caso non siano presenti errori, il sistema restituirà il messaggio Il file xml risulta CORRETTO Errori Riconosciuti: Errore formale di costruzione file XML I file xml previsti da tale sistema devono seguire le specifiche del file WSDL sipaacqui.wsdl presente nell'archivio dell'applicazione (come se si trattasse di un web service). Qualora non sia stata rispettata la costruzione del file, rispetto alle specifiche presenti nel WSDL verrà restituito il messaggio Errore File XML mal formato, con relative indicazioni sulla mal formazione. XML mal formato Errore nei dati contenuti nel file XML I dati presenti nel file xml verranno verificati sia formalmente (ad es. la correttezza dei campi numerici) che rispetto alla banca dati del Sipa (ad es. l'esistenza del natante indicato). Qualora sia riscontrato un errore relativo ai dati, verrà indicato il messaggio Il file presenta ERRORI: e l'elenco degli stessi. Errore nei dati Nel messaggio contenente i dettagli degli errori, verrà specificato il numero del record in cui si trova l'errore, il campo che ha generato l'errore e il valore che contiene tale campo.

10 3.4 Verifica e Inserisci La funzionalità Verifica e Inserisci, abilitata solo in caso di scelta di un file xml corretto e riconosciuto, provvederà ad effettuare una verifica sui dati, nelle stesse modalità illustrate nel passo precedente, e conseguentemente, in caso di file corretto, proseguirò con l'inserimento nella banca dati del SIPA, dei record presenti nel file xml. In caso di inserimento eseguito con successo, verranno indicati i numeri univoci relativi ai documenti inseriti. Tali documenti possono essere visualizzabili ed eventualmente eliminabili, entro 4 giorni dall'inserimento, nella pagina di Gestione Dati Operatore, presente sul portale previo accesso tramite utenza e password. 3.5 Cambio Utenza Il riconoscimento dell'utenza, viene richiesto solo una prima volta. A fronte di un accesso corretto, tali dati vengono salvati in un file di configurazione in modo che non vengano più richiesti, per consentire un utilizzo più rapido dell'applicazione. Qualora si abbia necessità di cambiare utenza, bisognerà cancellare il file user.properties contenuto nella cartella config dell'applicazione.

11 4 Modalità a Riga di Comando Le stesse funzionalità proposte in modalità grafica, è possibile richiamarle anche via prompt di comando. Per individuare le diverse modalità operative, andranno passati, di seguito al file launch.bat alcuni parametri utili all'elaborazione. Di seguito i dettagli dei parametri: launch.bat 0 - Aprirà il software in modalità interfaccia grafica. launch.bat 1 file.xml - Solo Verifica del file xml. launch.bat 2 file.xml - Verifica e Inserimento del file xml. launch.bat 3 utenza:password - autenticazione dell'utenza 4.1 Parametro 0 Interfaccia grafica Eseguendo da riga di comando launch.bat 0, si aprirà l'interfaccia grafica con le modalità operative indicate in questo manuale, al capitolo Parametro 1 Verifica file xml Eseguendo da riga di comando launch.bat 1 file.xml, verrà analizzato il file indicato come secondo parametro, seguendo le stesse modalità e restituendo gli stessi messaggi indicati nel paragrafo precedente Solo Verifica 3.3. Il file, completo di percorso, dovrà essere passato tra virgolette. Ad es. launch.bat 1 C:\documenti_xml\nota_di_vendita.xml Tale elaborazione non andrà a buon fine se non si è acceduto con utenza e password, almeno una volta, tramite l'interfaccia grafica oppure utilizzando il pametro 3 (successivo paragrafo 4.4) Come indicato nel paragrafo 3.3, anche in questo caso non verrà inserito alcun dato a sistema.

12 4.3 Parametro 2 Verifica e inserimento file xml Eseguendo da riga di comando launch.bat 2 file.xml, verrà prima analizzato il file indicato come secondo parametro e successivamente verrà inserito tutto il suo contenuto nel sistema SIPA, seguendo le stesse modalità e restituendo gli stessi messaggi indicati nel paragrafo precedente Verifica e Inserisci 3.4. Il file, completo di percorso, dovrà essere passato tra virgolette. Ad es. launch.bat 2 C:\documenti_xml\nota_di_vendita.xml Tale elaborazione non andrà a buon fine se non si è acceduto con utenza e password, almeno una volta, tramite l'interfaccia grafica oppure utilizzando il pametro 3 (successivo paragrafo 4.4) 4.4 Parametro 3 Riconoscimento Utenza e Password Eseguendo da riga di comando launch.bat 3 utenza:password, verrà autenticato l'utente passato come parametro, se registrato sul portale Controllo Pesca, con le stesse modalità indicate nel paragrafo 3.1 A fronte di un accesso positivo, i dati relativi all'utenza, verranno salvati in una cartella contenuta all'interno dell'applicazione e da quel momento sarà possibile lavorare sia tramite riga di comando che con interfaccia grafica, senza ulteriori richieste di autenticazione. Il secondo parametro, contenente utenza e password, andrà passato tutto attaccato, con i due campi separati dai due punti. Qualora si abbia necessità di cambiare utenza, bisognerà cancellare il file user.properties contenuto nella cartella config dell'applicazione, così come indicato nel paragrafo 3.5