IGRUE
Alimentazione dati di attuazione
Manuale Utente
v. 1.0
Link.it – Monitoraggio Applicativo
1/24
Indice
1. Introduzione......................................................................................................................3
1.1 Modulo di Spedizione dei Dati di Attuazione...............................................................4
1.2 Modulo di Raccolta degli Eventi..................................................................................5
1.3 Modulo di Raccolta degli Esiti......................................................................................5
1.4 Modulo di Raccolta delle Tabelle di Contesto.............................................................5
1.5 Notifica via mail............................................................................................................5
2. Installazione e Configurazione..........................................................................................6
3. Guida all'uso......................................................................................................................7
3.1 via Web UI...................................................................................................................7
3.1.1 Gestione delle Trasmissioni.................................................................................7
3.1.2 Visualizzazione e Recupero delle Tabelle di Contesto......................................10
3.1.3 Richiesta Codice di Attivazione..........................................................................11
3.1.4 Ricerca e Visualizzazione degli Eventi...............................................................11
3.1.5 Configurazione e Consultazione degli Avvisi e-mail..........................................12
3.2 via Web Service.........................................................................................................13
3.2.1 Trasmissione Dati di Attuazione.........................................................................13
3.2.2 Recupero esiti per trasmissione.........................................................................13
3.2.3 Recupero eventi.................................................................................................13
3.2.4 Recupero Tabella di Contesto............................................................................14
3.2.5 Richiesta Codice di Attivazione..........................................................................14
3.2.6 Servizio Applicativo di Esempio.........................................................................14
Trasmissione Dati di Attuazione.................................................................................14
Recupero esiti per trasmissione.................................................................................15
Recupero eventi.........................................................................................................15
Recupero Tabelle di Contesto....................................................................................15
Richiesta Codice di Attivazione..................................................................................15
3.3 via Data Layer............................................................................................................15
3.3.1 Trasmissione Dati di Attuazione.........................................................................15
3.3.2 Recupero esiti, eventi e Tabelle di Contesto.....................................................15
4. Organizzazione del Data Layer.......................................................................................16
4.1 Dati di trasmissione...................................................................................................16
4.2 Dati delle Tabelle di Contesto....................................................................................17
5. Appendice A: Codici delle mail di notifica.......................................................................17
6. Appendice B: Esempi di messaggi XML.........................................................................19
6.1 Trasmissione Dati di Attuazione................................................................................19
6.2 Recupero Esiti per Trasmissione...............................................................................20
6.3 Recupero Eventi........................................................................................................21
6.4 Recupero Tabella di Contesto...................................................................................22
6.5 Richiesta Codice di Attivazione.................................................................................23
Link.it – Monitoraggio Applicativo
2/24
1. Introduzione
Per interfacciarsi con i servizi IGRUE, il MEF propone alle altre Amministrazioni
un’applicazione J2EE denominata “Sender” che unifica le funzioni di proxy applicativo e di
Porta di Dominio SPCoop (PdD).
I sistemi applicativi locali, invocando i Web Service esposti dal Sender, attivano processi
asincroni che gestiscono l’invio del file di attuazione verso il sistema centrale, la raccolta
degli esiti dell’invio del file, lo scarico dei dati delle tabelle di contesto.
Il Sender semplifica l’interfaccia del Servizio IGRUE per i Sistemi Locali dell’Ente, rispetto
all’uso diretto dei servizi esposti dal sistema centrale. Il Sender espone infatti solo le
operazioni di invio dei file di attuazione, di richiesta degli eventi e di assegnazione di un
codice di attuazione. Sono trasparenti al sistema locale tutte le operazioni correlate alla
spedizione e alla ricezione dei risultati:
1. Salvataggio dei Dati di Attuazione su File System
2. Richiesta di un Ticket da assegnare alla trasmissione
3. Trasmissione dei Dati di Attuazione
4. Recupero e salvataggio dei risultati su File System
In questo modo l’invocazione di un unico Web Service permette di evitare le 6
comunicazioni SPCoop richieste per la comunicazione diretta verso il sistema centrale
(Prenotazione del Ticket, Trasmissione dei Dati di Attuazione, Recupero dei 4 esiti).
L’architettura del Sender è descritta in figura:
Architettura del Sender del servizio IGRUE
Tuttavia l’uso del Sender presenta una serie di limitazioni:
• Il Sender non è integrabile alla PdD ufficiale dell'Ente in quanto incorpora le funzioni
di cooperazione SPCoop assumendo anche il ruolo di PdD.
• Dipendenza dal Database Oracle 10g e dalla PdD Oracle.
• Dipendenza dall’application server WebSphere 6.1 o da JBoss <= 4.0.2.
• Il Sistema Locale deve implementare i client dei Web Service del Sender.
Per questo motivo si è ritenuto opportuno implementare il servizio sulla base di un nuovo
proxy applicativo alternativo al Sender, che chiameremo ProxyIGRUE, in grado di
replicarne i vantaggi superandone però le limitazioni.
Link.it – Monitoraggio Applicativo
3/24
Le linee guida progettuali per lo sviluppo del ProxyIGRUE sono le seguenti:
• Il ProxyIGRUE basa la sua logica applicativa sulla consultazione del File System e
di una Base di Dati.
• Il ProxyIGRUE integra una Web UI per la spedizione, ricezione e consultazione dei
dati tramite browser.
• Il ProxyIGRUE espone le operazioni attraverso Web Service per l'integrazione di
servizi applicativi di terze parti.
• Il ProxyIGRUE è configurabile per integrarsi con qualsiasi PdD.
L’architettura del ProxyIGRUE è mostrata nella figura che segue.
Architettura del Proxy Applicativo IGRUE
I vantaggi di questa nuova soluzione sono i seguenti:
• Ambiente di riferimento Open Source:
• Database PostgreSQL
• Application Server JBoss 4.x/5.x
• Porta di Dominio OpenSPCoop
• Il sistema locale non è obbligato ad implementare applicazioni per interagire con i
Web Service come dovrebbe usando il Sender, ma può limitarsi a trasferimenti di
file via file transfer o tramite la Web UI fornita a corredo.
• Le applicazioni esterne possono interfacciarsi tramite i Web Service esposti, senza
interagire direttamente con il Data Layer
Più nel dettaglio, il Gestore Protocollo di Colloquio IGRUE e' composto dai seguenti
moduli:
•
•
•
•
Modulo di Spedizione dei Dati di attuazione
Modulo di Raccolta Esiti
Modulo di Raccolta degli Eventi
Modulo di Raccolta delle Tabelle di Contesto
1.1 Modulo di Spedizione dei Dati di Attuazione
Secondo il Protocollo Applicativo di Alimentazione dei Dati di Attuazione, l'invio di un File
di Colloquio dei Dati di Attuazione deve essere precedentemente prenotato tramite la
richiesta di un ticket al Sistema Centrale. E' compito del Modulo di Spedizione dei Dati di
Attuazione farsi carico della gestione di questa procedura, oltre alla gestione di eventuali
errori di processamento o di rete.
Link.it – Monitoraggio Applicativo
4/24
1.2 Modulo di Raccolta degli Eventi
Il Sistema Centrale per comunicare con gli enti usa un servizio di emissione di eventi. Gli
eventi possono essere divisi in due categorie:
•
Eventi relativi all'elaborazione di un File di Colloquio.
•
Eventi relativi ad un aggiornamento delle Tabelle di Contesto.
Il Modulo di Raccolta degli Eventi si occupa di recepire, archiviare ed eliminare gli eventi
dal Sistema Centrale.
1.3 Modulo di Raccolta degli Esiti
Il Sistema Centrale, a fronte della sottomissione di un File di Colloquio, produce alcuni
documenti chiamati esiti. Esistono quattro tipi di esiti e, per ciascuna trasmissione,
possono essere prodotti uno o piu' di essi:
•
StatisticheElaborazioni
•
StatisticheScarti
•
EsitoElaborazionePerAnagraficaDiRiferimento
•
LogDegliErrori.
Il Modulo di Raccolta degli Esiti si occupa del recupero e dell'archiviazione degli esiti di
tutte le trasmissioni. La ricezione degli esiti conclude il ciclo di vita di una Trasmissione.
1.4 Modulo di Raccolta delle Tabelle di Contesto
Questo modulo si occupa di recuperare e tenere aggiornate le tabelle contenenti i dati di
contesto da utilizzare per la trasmissione dei dati di attuazione al Sistema Centrale.
1.5 Notifica via mail
Il ProxyIGRUE implementa un servizio di messaggistica per notificare malfunzionamenti o
eventi di rilievo tramite l'invio di e-mail. Per ogni trigger è possibile configurare se notificare
o meno l'evento ed i destinatari dell'eventuale e-mail.
Alcuni esempi di trigger sono:
•
Spedizione di Dati di Attuazione.
•
Ricezione di Eventi.
•
Ricezione di Esiti.
•
Aggiornamento di una Tabella di Contesto.
•
Errori di rete.
•
Ricezione di messaggi malformati.
L'Appendice A: Codici delle mail di notifica contiene una lista esaustiva delle mail inviate,
dell'evento che le attiva e del codice ad esse associato.
Link.it – Monitoraggio Applicativo
5/24
2. Installazione e Configurazione
Editare il file build.xml e modificare la proprietà appServer_deploy_dir impostando
il path della cartella di deploy di JBoss.
Creare un database ed inizializzarlo con lo script sql deploy/sql/igrue.sql e
modificare il datasource in deploy/xml/igrue­ds.xml
Il file di configurazione deploy/properties/igrue.properties definisce alcune
proprietà di funzionamento dell'applicazione:
Nome Proprietà
igrue.folder.inbox
Descrizione
Richiesto
Path locale dove verranno salvati i dati di
elaborazione dei dati di attuazione
Si
igrue.folder.outbox
Path dove verranno cercati i dati di
attuazione da inviare
Si
igrue.folder.contesto
Path dove verranno salvati i dati delle
tabelle di contesto
Si
igrue.pd.url
Url della porta delegata per invocare i
servizi di Igrue
Si
igrue.pd.username
igrue.pd.password
Credenziali per l'invocazione della porta
delegata specificata in igrue.pd.url
Si
igrue.db.jndiName
Nome jndi per il datasource
Si
igrue.eventi.delay
igrue.azioni.delay igrue.tabelle.delay igrue.spedizione.delay
Timeout in secondi per il polling dei dati
(in secondi, default 30 secondi)
No
igrue.contesto.history
Tenere o meno uno storico delle tabelle di No
contesto (default false)
igrue.spedizione.poolsize Numero di thread per i pool (default 5)
igrue.esiti.poolsize
No
igrue.email.notification. Booleano, abilita o disabilita l'invio di mail
error
in caso di errori di elaborazione. (default
true)
No
igrue.email.notification. Booleano, abilita o disabilita l'invio di mail No
event
in caso di ricezione di eventi. (default true)
igrue.email.smtp
igrue.email.sender
igrue.email.receiver
Configurazione per l'invio delle email. Se
l'invio delle notifiche sono entrambe
disabilitate, questi parametri sono
opzionali.
Si, se le
notifiche
sono
abilitate
Creare le cartelle specificate nel file di configurazione verificando che l'utente di JBoss
abbia i diritti di scrittura e lettura.
Link.it – Monitoraggio Applicativo
6/24
Il file per modificare il logging dell'applicazione si trova sotto
deploy/properties/log4j.properties.
Compilare e deployare l'applicazione eseguendo il comando ant deploy.
3. Guida all'uso
Sono possibili molteplici modalità di utilizzo del ProxyIGRUE:
•
via Web UI: tramite Interfaccia Utente fruibile via browser
•
via Web Service: tramite Web Service per l'integrazione con Servizi Applicativi
•
via Data Layer: operando direttamente su File System e Database.
3.1 via Web UI
Il ProxyIGRUE espone una console che semplifica notevolmente la gestione dei dati inviati
e ricevuti dal sistema centrale.
La console per l'infrastruttura di test è raggiungibile all'indirizzo
http://<hostname>:<port>/Igrue/ e le credenziali di default per l'accesso sono
test/test
3.1.1 Gestione delle Trasmissioni
Eseguito il login, la schermata che ci si propone è la lista delle trasmissioni inviate dal
sistema
•
File: identificativo assegnato dal sistema locale alla trasmissione tramite
Link.it – Monitoraggio Applicativo
7/24
assegnazione di un codice di attivazione.
•
Ticket: identificativo assegnato dal sistema centrale
•
Data: data dell'ultimo tentativo di invio
•
Stato elaborazione: ultimo evento ricevuto per questa trasmissione.
Per ogni trasmissione si possono vedere le informazioni in dettaglio cliccando sulla lente di
ingrandimento alla sinistra di ciascuna di esse:
Il riquadro di Riepilogo propone le stesse informazioni della lista delle trasmissioni vista
in precedenza, mente quello delle Operazioni consente di analizzare i dati che
riguardano la trasmissione in oggetto.
La prima operazione, “Visualizza File di Colloquio” è quella che ci viene
proposta nella pagina di apertura dei dettagli e mostra, in forma tabellare, il contenuto del
file di colloquio spedito in questa trasmissione.
Tramite l'analisi del Log degli Errori, se presente, vengono mostrati i campi che il sistema
centrale ha reputato errati. Tali campi sono visualizzati con una sottolineatura rossa e,
passandoci sopra con il cursore, appare una caption con l'errore riscontrato.
Oltre ai dati di colloquio si possono visionare gli eventi ricevuti a fronte della trasmissione:
Per ogni evento sono mostrati:
Link.it – Monitoraggio Applicativo
8/24
•
Data: data di emissione dell'evento
•
Codice: tipo dell'evento
•
Descrizione
•
Motivo: causale dell'evento, se il sistema centrale ne ha data una.
Oltre agli eventi si possono esaminare anche gli esiti, se presenti:
Per ognuno dei quattro esiti possibili, se ricevuti, sono rese disponibili le operazioni di
visualizzazione e download. Selezionando le visualizzazione, viene mostrato il contenuto
dell'esito nella tabella sottostante, formattate per una facile consultazione.
Oltre alla consultazione delle trasmissioni, la console fornisce anche la funzione di “Nuova Trasmissione”:
Selezionando Sfoglia si seleziona l'archivio contenente i dati di attuazione da inviare,
mentre con Upload si spediscono. Se l'invio dei dati viene completato con successo,
Link.it – Monitoraggio Applicativo
9/24
viene fornito l'identificativo assegnato alla trasmissione.
3.1.2 Visualizzazione e Recupero delle Tabelle di Contesto
Selezionando Lista nel meno delle Tabelle di Contesto, ci vengono mostrate tutte
le Tabelle di Contesto disponibili per la consultazione:
per ogni tabella sono mostrati codice, descrizione, data dell'ultimo aggiornamento e le
operazioni di visualizzazione e download.
Ogni tabella viene visualizzata con una formattazione adeguata per facilitarne la
consultazione:
Link.it – Monitoraggio Applicativo
10/24
3.1.3 Richiesta Codice di Attivazione
L'operazione Richiesta di Codice di Attivazione permette di ricevere dal Sistema Centrale
un nuovo Codice di Attivazione. Se la richiesta viene elaborata senza errori, vengono
visualizzati i dettagli del Codice di Attivazione ricevuto.
3.1.4 Ricerca e Visualizzazione degli Eventi
Selezionando l'operazione Lista per Eventi, ci vengono proposti tutti gli eventi ricevuti dal
Proxy Igrue:
Per ogni evento sono specificati:
•
Id: identificativo dell'evento
•
Data: data di emissione dell'evento
Link.it – Monitoraggio Applicativo
11/24
•
Parameter­Id: Ticket della trasmissione o Codice della tabella di contesto a cui
l'evento si riferisce.
•
Descrizione: breve descrizione dell'evento
•
Motivo: descrizione in dettaglio della motivo di emissione dell'evento
Per facilitare la ricerca degli eventi c'è la possibilità di filtrare gli eventi per descrizione.
3.1.5 Configurazione e Consultazione degli Avvisi e-mail
Il ProxyIGRUE, a fronte di situazioni rilevanti, avvisa gli utenti con delle email.
Dall'interfaccia è possibile consultare lo storico delle mail inviate:
Ogni avviso, oltre all'oggetto, la data di inoltro e i destinatari del messaggio, consente di
visualizzarne il contenuto selezionando la lente d'ingrandimento:
Per selezionare i destinatari degli avvisi si procede alla pagina di configurazione dove, per
ogni tipo di avviso, si possono inserire gli indirizzi separati da punto e virgola (“;”):
Link.it – Monitoraggio Applicativo
12/24
3.2 via Web Service
Per integrare servizi applicativi al ProxyIGRUE viene esposta un'interfaccia Web Service.
Il WSDL del servizio è disponibile in deploy/wsdl/Igrue.wsdl ed un client di esempio
è implementato in org.govmix.proxy.igrue.test.Client. Vediamo in dettaglio le
operazioni esposte dal Web Service. Nell'Appendice B: Esempi di messaggi XML sono
riportati dei messaggi scambiati con il Web Service esposto.
3.2.1 Trasmissione Dati di Attuazione
Questa operazione ci permette di inviare i dati di attuazione al sistema che provvederà ad
inserirlo nel file system con un identificativo univoco.
● sendDatiAttuazione:
○ richiesta: messaggio con i dati di attuazione in allegato
○ risposta: l'identificativo associato ai dati di attuazione
3.2.2 Recupero esiti per trasmissione
Questa operazione ci permette di ricevere gli esiti della trasmissione dei dati di
trasmissione corrispondenti all'identificativo precisato nella richiesta
● getEsiti
○ richiesta: l'intero che identifica i dati di attuazione per cui si richiedono gli esiti
○ risposta: le informazioni sull'elaborazione degli esiti e un allegato per ogni esito
(statistiche elaborazioni,statistiche scarti, esito elaborazione per anagrafica di
riferimento e log degli errori). Se uno o più esiti non esistono, l'allegato
corrispondente sarà vuoto.
3.2.3 Recupero eventi
Questa operazione ci permette di ricevere gli eventi successivi alla data specificata nella
richiesta
Link.it – Monitoraggio Applicativo
13/24
● getEventi
○ richiesta: la data a partire della quale si vogliono ricevere gli eventi
○ risposta: la lista degli eventi richiesti.
3.2.4 Recupero Tabella di Contesto
Richiedere una tabella di constesto specificandone il nome
● getTabellaContesto
○ richiesta: il nome della tabella che si desidera ricevere (T1, T2, ..., T54,
Complessivo)
○ risposta: la tabella, se esiste, in allegato in formato compresso.
3.2.5 Richiesta Codice di Attivazione
Operazione per farsi assegnare un codice procedura di attivazione
● getCodiceAttivazione
○ richiesta: vuota
○ risposta: i dati del codice di attivazione assegnato.
3.2.6 Servizio Applicativo di Esempio
Il progetto include un semplice Servizio Applicativo che fruisce delle operazioni esposte
dal Proxy tramite i Web Services esposti.
Dopo aver prodotto le librerie del ProxyIGRUE con il comando “ant compile”, editare il
file /deploy/wsdl/Igrue.wsdl inserendo il corretto address location all'elemento
service.
Adesso è possibile eseguire il servizio applicativo con il comando
ant run ­Dargs="[­option value]"
sostituendo ad [­option value] una o più delle seguenti opzioni:
­c,­­codice Richiede un nuovo codice di procedura attuazione ­d,­­dati <arg> Dati di Attuazione da inviare ­e,­­eventi <arg> Richiede gli eventi posteriori alla data specificata ­o,­­output <arg> Cartella di output (default: /tmp/igrue )
­r,­­esiti <arg> Richiede gli esiti della trasmissione specificata ­t,­­tabella <arg> Richiede la tabella di contesto specificata Trasmissione Dati di Attuazione
Eseguendo il comando con l'opzione:
ant run ­Dargs="­d /path/to/dati.zip"
svengono inviati i dati all'applicativo che, in assenza di errori, risponderà con il progressivo
assegnato alla trasmissione. Con questo valore potremo poi richiedere gli esiti relativi.
Link.it – Monitoraggio Applicativo
14/24
Recupero esiti per trasmissione
Il comando:
ant run ­Dargs="­r 1234 ­o /tmp/esiti/1234"
richiede al sistema gli esiti della trasmissione specificata. Il risultato della richiesta vene
memorizzato nella cartella /tmp/esiti/1234 specificata con l'opzione ­o, o nella
cartella /tmp/igrue se non viene impostata.
Recupero eventi
Con il comando:
ant run ­Dargs="­e 2009­09­01T12:00:00­05:00 ­o /tmp/eventi/2009­
09/"
si richiedono al sistema gli eventi posteriori alla data specificata. Gli eventi ricevuti
verranno memorizzati nella cartella /tmp/eventi/2009­09/. Se l'opzione ­o non viene
specificata, gli eventi saranno memorizzati nella cartella /tmp/igrue.
Recupero Tabelle di Contesto
Eseguendo il comando:
ant run ­Dargs="./client.sh ­t T35 ­o /tmp/tabelle/"
viene tichiesta la tabella di contesto T35. Se esiste e non ci sono errori, viene
memorizzata nella cartella specificata con l'opzione ­o, altrimenti nella cartella di default /
tmp/igrue.
Richiesta Codice di Attivazione
Eseguendo il comando con l'opzione:
ant run ­Dargs="­c"
viene richiesto un nuovo codice di procedura di attivazione. Se non ci sono errori sarà
mostrato a video l'esito della richiesta.
3.3 via Data Layer
Come detto nell'introduzione, il ProxyIGRUE basa la sua logica applicativa sulla
consultazione del File System e del Database. E' quindi possibile operare direttamente sul
Data Layer per interagire con il ProxyIGRUE.
3.3.1 Trasmissione Dati di Attuazione
Nella cartella di Outbox, impostata in fase di configurazione, copiare i Dati di Attuazione
rinominandoli con un numero intero non usato per altre trasmissioni, ad es. 1234.zip. Il
ProxyIGRUE si occupera' della gestione del processo di trasmissione.
3.3.2 Recupero esiti, eventi e Tabelle di Contesto
Tutti i dati prodotti dal sistema centrale a fronte di una trasmissione, ovvero eventi, esiti,
ticket ed aggiornamenti delle tabelle di contesto, sono automaticamente raccolti dal
Link.it – Monitoraggio Applicativo
15/24
ProxyIGRUE e organizzati su File System come specificato nel capitolo 4.
4. Organizzazione del Data Layer
4.1 Dati di trasmissione
I dati necessari ad una trasmissione sono costituiti dai Dati di Attuazione compressi in un
File di Colloquio. I File di Colloquio in attesa di essere trasmessi al Sistema Centrale di
Monitoraggio (Igrue) sono memorizzati nella cartella igrue.folder.outbox nella forma
[X].zip, dove [X] è un identificativo univoco interno al sistema.
Il ProxyIGRUE si occupa di prelevare i File di Colloquio dalla cartella
igrue.folder.outbox, fargli assegnare un ticket dal Sistema Centrale di Monitoraggio
e spedirlo. Inviati i dati, il File di Colloquio [X].zip viene spostato dalla cartella
igrue.folder.outbox nella cartella igrue.folder.inbox/[X] dove saranno
memorizzati tutte le informazioni correlate alla trasmissione.
I dati di una trasmissione saranno organizzati secondo la seguente struttura:
● igrue.folder.inbox
○ [X]
■ [X].zip
■ info.txt
■ RISULTATI
● statisticheelaborazioni.zip
● statisticheelaborazioni.txt
● statistichescarti.zip
● statistichescarti.txt
● esitoelaborazioneperanagraficadiriferimento.zip
● esitoelaborazioneperanagraficadiriferimento.txt
● logdeglierrori.zip
● logdeglierrori.txt
■ EVENTI
● xxx.txt
● yyy.txt
○ [Y]
■ ...
[X].zip è una copia del File di Colloquio inviato.
Info.txt contiene l'id del ticket assegnato alla trasmissione.
Link.it – Monitoraggio Applicativo
16/24
RISULTATI/*.zip sono gli esiti, qualora esistano, dell'elaborazione del File di Colloquio
dei Dati di Attuazione. I corrispondenti file .txt contengono le informazioni sul
processamento degli esiti.
EVENTI/*.xml sono gli eventi, in formato xml, ricevuti per questa trasmissione.
4.2 Dati delle Tabelle di Contesto
Il sistema ricerca automaticamente, ad intervalli impostati in configurazione, esiti, eventi ed
aggiornamenti delle tabelle di contesto.
Le tabelle di contesto recuperate sono memorizzate nella cartella
igrue.folder.contesto in formato compresso. Se l'opzione
igrue.contesto.history è impostata a true, viene tenuto uno storico delle tabelle
di contesto, altrimenti viene memorizzata solo la più aggiornata.
Gli eventi riguardanti aggiornamenti delle tabelle di contesto sono memorizzati nella
cartella igrue.folder.contesto/EVENTI.
5. Appendice A: Codici delle mail di notifica
DAT_CNT_01
Errore di accesso a database durante la fase di acquisizione delle
tabelle di contesto.
DAT_CNT_02
Errore tecnico sollevato durante la fase di acquisizione delle tabelle di
contesto
DAT_CNT_03
Errore di I/O durante la fase di acquisizione delle tabelle di contesto
DAT_CNT_04
Errore di comunicazione durante la fase di acquisizione delle tabelle
di contesto
DAT_CNT_05
Errore tecnico durante la fase di acquisizione delle tabelle di contesto
DAT_CNT_06
Dati di contesto aggiornati con successo
GST_EVN_01
Errore di accesso al database durante l'acquisizione di eventi.
GST_EVN_02
Errore di I/O durante la gestione degli eventi.
GST_EVN_03
Errore di accesso al database durante la fase di cancellazione degli
eventi.
GST_EVN_04
Errore tecnico durante la cancellazione degli eventi.
GST_EVN_05
Errore ci connessione con il sistema informativo durante la gestione
degli eventi.
GST_EVN_06
Errore ci connessione con il sistema informativo durante la gestione
degli eventi.
GST_EVN_07
Errore durante la fase di acquisizione degli eventi.
GST_EVN_08
Errore durante la fase di cancellazione degli eventi.
Link.it – Monitoraggio Applicativo
17/24
INV_FIL_01
Errore di comunicazione durante l'invio dei dati di contesto.
INV_FIL_02
Tentativi di invio dei dati di contesto esauriti.
INV_FIL_03
Errore di I/O durante il processamento dei dati di contesto.
INV_FIL_04
Nessun evento ricevuto entro i tempi previsti.
INV_FIL_05
Errore di accesso al database durante l'invio dei dati di contesto.
INV_FIL_06
Errore tecnico durante l'invio dei dati di contesto.
INV_FIL_07
Errore ricevuto dal sistema informativo durante l'invio dei dati di
contesto.
INV_FIL_08
Ricevuto esito non positivo a seguito di un invio dei dati di contesto.
INV_FIL_09
Dati di attuazione inviati con successo.
INV_FIL_10
Dati di attuazione già inviati.
RIC_EVN_01
Ricevuto evento “File Ricevuto”.
RIC_EVN_02
Ricevuto evento “File Scartato”.
RIC_EVN_03
Ricevuto evento “Elaborazione con Successo”.
RIC_EVN_04
Ricevuto evento “Elaborazione con Errore”.
RIC_EVN_05
Ricevuto evento “Elaborazione con Scarto Totale”.
RIC_EVN_06
Ricevuto evento “Elaborazione Respinta”.
RIC_EVN_07
Ricevuto evento “Errore Invio”.
RIC_EVN_08
Ricevuto evento “Errore Scarico Risultato”.
RIC_EVN_09
Ricevuto evento “Delta Tipologiche”.
RIC_TCK_01
Errore di comunicazione durante la richiesta di un ticket.
RIC_TCK_02
Errore durante l'accesso a database durante la richiesta di un ticket.
RIC_TCK_03
Ricevuto esito non positivo durante la richiesta di un ticket.
RIC_TCK_04
Errore tecnico durante la richiesta di un ticket.
SCR_RIS_01
Errore di comunicazione durante l'acquisizione degli esiti.
SCR_RIS_02
Errore di accesso a File System durante l'acquisizione degli esiti.
SCR_RIS_03
Errore di I/O durante l'acquisizione degli esiti.
Link.it – Monitoraggio Applicativo
18/24
SCR_RIS_04
Errore di accesso a database durante l'acquisizione degli esiti.
SCR_RIS_05
Errore tecnico durante l'acquisizione degli esiti.
SCR_RIS_06
Errore segnalato dal sistema informatico durante l'acquisizione degli
esiti.
STR_SYS_01
Errore di avvio del sistema. Configurazione non corretta.
STR_SYS_02
Errore di avvio del sistema. Database non raggiungibile.
6. Appendice B: Esempi di messaggi XML
6.1 Trasmissione Dati di Attuazione
Esempio di messaggio di richiesta:
Content­Type: multipart/related; ....
SOAPAction: "" ­­boundary
Content­Type: application/xop+xml; type="text/xml"; Content­Transfer­Encoding: binary Content­ID: start­boundary
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:sendDatiAttuazione xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<Dati/>
</ns2:sendDatiAttuazione>
</soap:Body>
</soap:Envelope>
­­boundary
Content­Type: application/zip
Content­Transfer­Encoding: binary
Content­ID: ......
[binary data]
Esempio di messaggio di risposta
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:sendDatiAttuazioneResponse xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<idAssegnato>1234</idAssegnato>
Link.it – Monitoraggio Applicativo
19/24
</ns2:sendDatiAttuazioneResponse>
</soap:Body>
</soap:Envelope>
6.2 Recupero Esiti per Trasmissione
Esempio di messaggio di richiesta:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getEsiti xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<idAssegnato>1234</idAssegnato>
</ns2:getEsiti>
</soap:Body>
</soap:Envelope>
Esempio di messaggio di risposta
Content­Type: multipart/related; ....
SOAPAction: "" ­­boundary
Content­Type: application/xop+xml; type="text/xml"; Content­Transfer­Encoding: binary Content­ID: start­boundary
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getEsitiResponse xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<EsitoResponse>
<file>37</file>
<statisticheelaborazioni>0</statisticheelaborazioni>
<statisticheelaborazionidescrizione>OK ­ Statistiche delle elaborazioni non trovate. Per questa trasmissione non vi sono record acquisiti</statisticheelaborazionidescrizione>
<statistichescarti>0</statistichescarti>
<statistichescartidescrizione>OK ­ Statistiche Scarti non trovate. Per questa trasmissione non vi sono record con errore</statistichescartidescrizione>
<esitoelaborazioneperanagraficadiriferimento>0</esitoelaborazioneperana
graficadiriferimento>
<esitoelaborazioneperanagraficadiriferimentodescrizione>OK ­ Esito Anagrafica riferimento non trovato per ticket: 4039. La lista dei Progetti per questo ID Ticket è stata cancellata poichè è scaduto il tempo massimo di permanenza</esitoelaborazioneperanagraficadiriferimentodescrizione>
<logdeglierrori>0</logdeglierrori>
<logdeglierroridescrizione>OK ­ Log degli Errori non trovato per ticket: 4039. Il log degli errori è assente poichè la trasmissione relativa non ha Link.it – Monitoraggio Applicativo
20/24
riscontrato errori</logdeglierroridescrizione>
<dataultimocontrollo>2009­08­
31T13:18:46.068+02:00</dataultimocontrollo>
</EsitoResponse>
</ns2:getEsitiResponse>
</soap:Body>
</soap:Envelope>
­­boundary
Content­Type: application/zip
Content­Transfer­Encoding: binary
Content­ID: ......
[binary data]
­­boundary
Content­Type: application/zip
Content­Transfer­Encoding: binary
Content­ID: ......
[binary data]
­­boundary
Content­Type: application/zip
Content­Transfer­Encoding: binary
Content­ID: ......
[binary data]
­­boundary
Content­Type: application/zip
Content­Transfer­Encoding: binary
Content­ID: ......
[binary data]
6.3 Recupero Eventi
Esempio di messaggio di richiesta:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getEventi xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<startdate>2009­09­01T12:00:00­05:00</startdate>
</ns2:getEventi>
</soap:Body>
</soap:Envelope>
Esempio di messaggio di risposta
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
Link.it – Monitoraggio Applicativo
21/24
<soap:Body>
<ns2:getEventiResponse xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<Eventi>
<evento>
<enddate>2009­09­08T11:21:30.339+02:00</enddate>
<eventtype_code>2</eventtype_code>
<id>15020</id>
<owner_idamministrazione>BO</owner_idamministrazione>
<owner_idsistema>1</owner_idsistema>
<parameterid>4422</parameterid>
<startdate>2009­09­04T17:44:32.204+02:00</startdate>
</evento>
<evento>
<enddate>2009­09­04T17:44:32.204+02:00</enddate>
<eventtype_code>2</eventtype_code>
<id>15022</id>
<owner_idamministrazione>BO</owner_idamministrazione>
<owner_idsistema>1</owner_idsistema>
<parameterid>4404</parameterid>
<startdate>2009­09­04T17:45:09.739+02:00</startdate>
</evento>
</Eventi>
</ns2:getEventiResponse>
</soap:Body>
</soap:Envelope>
6.4 Recupero Tabella di Contesto
Esempio di messaggio di richiesta:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getTabellaContesto xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<nometabella>Complessivo</nometabella>
</ns2:getTabellaContesto>
</soap:Body>
</soap:Envelope>
Esempio di messaggio di risposta
Content­Type: multipart/related; ....
SOAPAction: "" ­­boundary
Link.it – Monitoraggio Applicativo
22/24
Content­Type: application/xop+xml; type="text/xml"; Content­Transfer­Encoding: binary Content­ID: start­boundary
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getTabellaContestoResponse xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<dataaggiornamento>2009­08­31T14:44:07.145+02:00</dataaggiornamento>
</ns2:getTabellaContestoResponse>
</soap:Body>
</soap:Envelope>
­­boundary
Content­Type: application/zip
Content­Transfer­Encoding: binary
Content­ID: ......
[binary data]
6.5 Richiesta Codice di Attivazione
Esempio di messaggio di richiesta:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getCodiceProceduraAttivazioneRequest xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<CodiceProceduraAttivazione/>
</ns2:getCodiceProceduraAttivazioneRequest>
</soap:Body>
</soap:Envelope>
Esempio di messaggio di risposta
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:getCodiceProceduraAttivazioneResponse xmlns:ns2="http://ws.igrue.proxy.govmix.org">
<CodiceProceduraAttivazione>
<dataAssegnazione>2009­08­31T14:44:07.145+02:00</dataAssegnazione>
<idAmministrazione>...</idAmministrazione>
<idProceduraAttivazione>PATT2041</idProceduraAttivazione>
<idSistema>...</idSistema>
</CodiceProceduraAttivazione>
</ns2:getCodiceProceduraAttivazioneResponse>
</soap:Body>
Link.it – Monitoraggio Applicativo
23/24
</soap:Envelope>
Link.it – Monitoraggio Applicativo
24/24
