PROGETTO PROTOCOLLO B2

Request for comments:
Del: 08/03/2007 
Categoria: Applicativa
Destinatari: Regione Toscana, Comuni, Amministrazioni locali
Area tematica: visure di protocollo

Indice
======
1. Contesto di riferimento	
2. Obiettivi	
3. Analisi 
4. Bibliografia


1. Contesto di riferimento
==========================
Il servizio di richiesta di visure di protocollo nell'ambito di un sistema di interoperabilità
di protocollo informatico

2. Obiettivi
============

L'obiettivo principale è quello di poter effettuare in modo automatico una richiesta
di visura di protocollo; più precisamente la possibilità da parte di un sistema di protocollo
mittente, di automatizzare il processo amministrativo di visura per ottenere tutte le 
informazioni riguardanti il/i protocollo/i registrato/i dal sistema destinatario 
in termini di numero, data registrazione ecc..


3. Analisi
==========
Il servizio di visura (esposto come web-service [1]) realizza il seguente caso d'uso :
l'utilizzatore chiama il servizio destinatario fornendo i dati del soggetto
(CodiceAmministrazione, CodiceAOO, NumeroRegistrazione DataRegistrazione) ed eventualmente un
range di date di ricerca); essendo il sistema di protocollo informatico non obbligato ad 
inserire il numero di protocollo e/o la data di protocollo del mittente in fase di registrazione
potrebbe non avere un mapping dei dati sulla base dei dati di richiesta per cui dovrà seguire il
seguente flusso:

1) Controlla se per l'AOO mittente descritta da CodiceAmministrazione/CodiceAOO esiste un 
   protocollo avente un certo numero (NumeroRegistrazione) e/o una certa data (DataRegistrazione)
   In caso positivo risponde fornendogli tutti i dati associati
   
2) Ne caso in cui per l'AOO mittente non esiste nessun protocollo avente un certo numero e/o data
   di registrazione relativi alla richiesta, il servizio di visura dovrà controllare tutte le 
   registrazioni di protocollo per quell'AOO mittente avvenute in un range di date

I messaggi di trasporto relativi alla visura di protocollo vengono instradati tramite 
l'infrastruttura di Cooperazione Applicativa CART. Il messaggio di trasporto scambiato per la
visura dei dati di protocollo composto esclusivamente da un messaggio SOAP, nella cui body part
contenuto l'XML dei dati. Lo schema dei dati di scambio rappresentante il contratto tra il 
mittente e il destinatario su un servizio di visura è descritto nel DTD di seguito riportato 
(visureprotocollo.dtd):

<?xml version="1.0" encoding="ISO-8859-1"?>
<!-- L'elemento "RichiestaServizio" identifica la radice -->
<!-- Il DTD viene utilizzato per comunicare al sistema richiedente le informazioni sulla visura (numero di protocollo di registrazione di un documento su altro sistema)  -->
<!ELEMENT RichiestaServizio (Richiedente, Rispondente, Documento)>

<!-- Denominazione del sistema  informatico locale che avanza la richiesta di visura -->
<!ELEMENT Richiedente (CodiceAmministrazione, CodiceAOO, IntervalloDate?)>

<!-- Denominazione del sistema informatico locale al quale viene avanzata la richiesta di visura -->
<!ELEMENT Rispondente (CodiceAmministrazione, CodiceAOO)>

<!-- Codice Amministrazione dell'AOO -->
<!ELEMENT CodiceAmministrazione (#PCDATA)>
<!-- Codice AOO -->
<!ELEMENT CodiceAOO (#PCDATA)>

<!-- Intervallo di date per il quale si stanno richiedendo i dati di protocollo -->
<!ELEMENT IntervalloDate (dataregistrazioneDA, dataregistrazioneA)>

<!-- Data di inizio per la ricerca delle informazioni di visura dei protocolli registrati
<!ELEMENT dataregistrazioneDA (#PCDATA)>
<!-- Data di fine per la ricerca delle informazioni di visura dei protocolli registrati
<!ELEMENT dataregistrazioneA (#PCDATA)>

<!-- Dati del documento di protocollo per il quale è avanzata la richiesta di visura -->
<!ELEMENT Documento (protocolloC, Registrazioni)>

<!-- Dati con i quali il documento è stato registrato sul sistema richiedente -->
<!ELEMENT protocolloC (numeroC, dataregistrazioneC)>
<!-- Numero di protocollo con il quale è stato registrato il documento sul sistema richiedente -->
<!ELEMENT numeroC (#PCDATA)>
<!-- Data con la quale è stato registrato il documento di protocollo sul sistema richiedente -->
<!ELEMENT dataregistrazioneC (#PCDATA)>

<!-- Dati delle informazioni di registrazioni del protocollo sul sistema informatico locale al quale
     è avanzata la richiesta di visura 
-->
<!ELEMENT Registrazioni (protocolloS*)>

<!-- Dati con i quali il documento è stato registrato sul sistema al quale viene avanzata la richiesta di visura -->
<!ELEMENT protocolloS (numeroS, dataregistrazioneS, Oggetto)>
<!-- Numero di protocollo con il quale è stato registrato il documento sul sistema al quale viene avanzata la richiesta -->
<!ELEMENT numeroS (#PCDATA)>
<!-- Data con la quale è stato registrato il documento di protocollo sul sistema al quale viene avanzata la richiesta -->
<!ELEMENT dataregistrazioneS (#PCDATA)>

<!--
 L'elemento Oggetto contiene la descrizione testuale dell'oggetto del messaggio.
 La descrizione testuale contenuta nell'elemento Oggetto dovrebbe essere significativa
 e dovrebbe avere una lunghezza congrua, tipicamente almeno 30 caratteri.
-->
<!ELEMENT Oggetto (#PCDATA)>


4. Bibliografia
===============
[1] Web Services Description Language (WSDL) 1.1 http://www.w3.org/TR/wsdl
[2] Latest SOAP versions http://www.w3.org/TR/soap/
[3] Apache Axis http://ws.apache.org/axis/
[4] Normativa registrazione Protocollo Informatico http://protocollo.gov.it/