PROTOCOLLO INFORMATICO

Transcript

1 PROTOCOLLO INFORMATICO WEB SERVICE API MANUALE DI CONFIGURAZIONE Pag. 1 di 44

2 MANUALE CONFIGURAZIONE PROWSAPI REVISIONI DATA MODIFICHE VERSIONE DOCUMENTO REDATTO VERSIONE DEL WEB SERVICE 20/12/2008 PRIMA REDAZIONE 1.0 F. Parise PRO /07/2011 SECONDA REDAZIONE 1.2 V. Grossi PRO /08/2011 TERZA REDAZIONE 1.3 A. Capetta PRO /10/2011 MIGLIORATA SEZIONE CONFIGURAZIONE F. Parise PRO /11/2012 INTEGRAZIONE JIRDE F. Parise PRO /06/2013 ESTENSIONE WS PER GESTIONE MULTICOMPETENZA E MODALITÀ INVIO A. Intropido PRO DESTINATARI Profilo Personale tecnico dell assistenza e sviluppatori per l integrazione di software terzi con protocollo sicraweb. Manuale configurazione ProWSApi Pag. 2 di 44

3 SOMMARIO 1 CONFIGURAZIONE E ATTIVAZIONE PREMESSA CONFIGURAZIONE SICRAWEB Creare l'utente Configurare l'utente Configurare l organigramma CONFIGURAZIONE JBOSS ATTIVARE IL WEB SERVICE (DEPLOY) VERIFICA DELL ATTIVAZIONE VERIFICA DI ACCESSO AL WEB SERVICE COMUNICAZIONI DA EFFETTUARE RISOLUZIONE DEI PROBLEMI (401)Unauthorized abilitare l amministrazione remota dei Web Services namingexception o null locale looking for (namingexception) Password Incorrect/Password Required Qual è la porta in cui è in ascolto Tomcat? SPECIFICHE TECNICHE METODO: REGISTRAPROTOCOLLO Regole di compilazione del messaggio di richiesta Integrazione JIride (Gestione documentale) Vincoli: Esempi Entrata Uscita Interno METODO: INSERTDOCUMENTO (INSERIMENTO DI UN DOCUMENTO) METODO: INFOPROTOCOLLO WSDL XSD registraprotocollo infoprotocollo TAG <MittentiMulti> e <DestinatariMulti> TAG <ModalitaInvio> APPENDICE A (ELENCO DEI CODICI ERRORE) Pag. 3 di 44

4 1 CONFIGURAZIONE E ATTIVAZIONE 1.1 Premessa Questo documento tratta gli aspetti relativi alle funzioni di accesso al sistema di Protocollo Informatico di SicraWeb da parte di applicazioni esterne tramite interfaccia Web Service. Queste funzioni prendono il nome di Protocollo Web Service API. Gli applicativi generici che richiederanno l utilizzo del servizio di protocollazione, potranno accedere al sistema di protocollo mediante l interfaccia applicativa definita attraverso il Web Service: ProWSApi. Per l invocazione del Web Service utilizzare la seguente sintassi: dove: <hostname>: è il nome del Web Server in cui viene installato il web service; <port>: è la porta su cui è in ascolto il web service (porta di Tomcat); se la porta è quella standard HTTP, la 80, allora l indicazione della porta può essere omessa; /client/services/: è il percorso dell applicazione web associata al web service. ProWSApi: è il Web Service vero e proprio che espone le funzionalità di interfaccia verso gli applicativi di gestione del protocollo. Per ottenere il WSDL del web service: Esempio di URL: Pag. 4 di 44

5 1.1 Configurazione SicraWeb Creare l'utente Entrare nella gestione utenti di SicraWeb e creare l'utente che sarà utilizzato per accedere al sistema tramite Web Service. L utente utilizzato dal web service per loggarsi in sicraweb apparirà come utente che ha eseguito l operazione in tutte le registrazioni eseguite dal web service, per cui si consiglia di creare un utente distinto per ogni applicativo esterno che utilizzerà il web service. Per esempio nell ambiente di produzione per una gestione SUAP creiamo un utente come segue: Login: suap Descrizione: Web Service SUAP Password: suap Accedere successivamente nell ambiente di test e creare un utente con le medesime credenziali. Se un altro software dovesse avere la necessità di utilizzare il web service creare un nuovo utente legato al nuovo software e creare una nuova configurazione Configurare l'utente In entrambi gli ambienti, assegnare all utente appena creato i permessi di protocollo denominati Protocollazione in ingresso, Protocollazione in uscita, Assegnazione Configurare l organigramma Se nella chiamata del WS viene trasmesso anche il riferimento all UO a cui assegnare il protocollo in entrata o l UO mittente del protocollo in uscita, è necessario configurare l organigramma. In entrambi gli ambienti, entrare nell organigramma e per le UO che possono interagire con i WS impostare il campo indicando la sigla dell UO che verrà indicata nella chiamata al WS. Pag. 5 di 44

6 1.2 Configurazione JBoss Nel file 'sicraweb.server.config.xml' presente nella cartella JBOSS_HOME\server\default\deploy\sicraweb.ear\ server\signed-jars\conf.ig, nella sezione <logon> inserire una sezione <alias... /> come riportato nel seguente esempio: <logon> <alias name= j2eeusername= sicraweb j2eepassword= sicraweb username= suap password= suap /> <alias name= j2eeusername= sicraweb_test j2eepassword= sicraweb_test username= suap password= suap /> </logon> ATTENZIONE: Controllare che nel file 'sicraweb.server.config.xml' non esista già il tag <logon> </logon>. Se tale tag esiste, aggiungere i nuovi alias all interno dei tag <logon> </logon> già presenti. Solitamente tali tag esistono per Anagrafe on line (AOL). E molto importante che nel file, anche dopo le modifiche, esista un solo tag <logon>. In questo file di configurazione vanno configurate le credenziali da utilizzare per effettuare l'accesso tramite web service. Creare i due alias, uno per l ambiente di produzione ed uno per l ambiente di test. L alias name è il nome con cui il software che chiama il WS del protocollo indica su quale database andare ad inserire le informazioni trasmesse. Il j2eeusername e j2eepassword è la configurazione che viene data dai sistemisti in fase di installazione per identificare il database; la si può recuperare dal file JNLP di avvio di SicraWeb nella seguente sezione (vedi dati evidenziati): <application-desc main-class="it.saga.pubblici.menu.mnucfgmain"> <argument>jboss: sicrawebappserver:50080:1099</argument> <argument>sicraweb</argument> <argument>sicraweb</argument> </application-desc> </jnlp> NOTA: verificare SEMPRE che ci sia corrispondenza tra l utente j2ee indicato nel JNLP di lancio di sicraweb e quello indicato nella sezione <logon>. Lo username e password sono le credenziali dell utente di sicr@web creati nel paragrafo A questo punto per accedere al database di sicraweb con l'utente iride è sufficiente indicare nella connection string il nome dell'alias. Connection String 'suap@sicraweb' Pag. 6 di 44

7 1.3 Attivare il Web Service (deploy) Per attivare il web service è sufficiente aprire la maschera presente in GESTIONE CONFIGURAZIONE SISTEMA WEB SERVICES. Se la voce di menù non è attiva, significa che l utente che si sta usando è privo del permesso di configurazione dei Web Services: Una volta aperta la maschera di configurazione dei WS La riga evidenziata sopra del ProWSApi normalmente sarà in stato disattivato, contraddistinto quindi dall icona. Cliccando su tale pulsante viene attivato il WS (il messaggio chiede se si vuole fare il deploy). Al termine del deploy, che normalmente impiega qualche istante, l icona indicherà lo stato attivo del WS. Pag. 7 di 44

8 Per disattivare il WS cliccare sull icona di stato attivo e dopo qualche istante il WS verrà disattivato. N.B. L attivazione del WS da un qualsiasi ambiente di sicraweb, attiva il WS anche per le altre installazioni. Di conseguenza il WS si può attivare indifferentemente loggandosi dall ambiente di produzione o dall ambiente di test. 1.4 Verifica dell attivazione Si può verificare se il web service è attivo aprendo un browser e digitando l indirizzo seguente si avrà un risultato del tipo Digitando invece l indirizzo si potrà verificare che il server restituisca le specifiche del WS Pag. 8 di 44

9 1.5 Verifica di accesso al web service Una volta che il web service è stato attivato bisogna verificare che la configurazione e le credenziali che andremo a comunicare alla società utilizzatrice siano corrette. Si può utilizzare il software soapui per testare la chiamata al WS (si consiglia di testare la chiamata ad infoprotocollo). (Download: Comunicazioni da effettuare Una volta che il web service è attivato, vanno comunicati alla società che ha chiesto l attivazione, i dati per connettersi e per effettuare le chiamate in maniera corretta. Si riporta l elenco delle informazioni da trasmettere Per ambiente di produzione: alias per chiamata = suap@sicraweb username login sicraweb = suap password login sicraweb = suap nome dell UO = per esempio Sportello Unico Imprese codice dell UO = per esempio SUAP Nome Amministrazione = Comune di xxxxx Codice amministrazione = xxxxx Codice AOO = xxxxx Assegnazione obbligatoria per competenza = SI/NO Classificazione obbligatoria = SI/NO Mittenti/Destinatari obbligatori da AN1 = SI/NO Numero livelli titolario = 1/2/3/4/5 Per ambiente di test: alias per chiamata = suap@sicraweb_test username login sicraweb = suap password login sicraweb = suap nome dell UO = per esempio Sportello Unico Imprese codice dell UO = per esempio SUAP Nome Amministrazione = Comune di xxxxx Codice amministrazione = xxxxx Codice AOO = xxxxx Assegnazione obbligatoria per competenza = SI/NO Classificazione obbligatoria = SI/NO Mittenti/Destinatari obbligatori da AN1 = SI/NO Numero livelli titolario = 1/2/3/4/5 I primi tre parametri sono stati impostati nel file 'sicraweb.server.config.xml' come indicato nel paragrafo 1.2, gli altri parametri sono indicati nei parametri di configurazione del protocollo e dell AOO. Pag. 9 di 44

10 1.7 Risoluzione dei problemi (401)Unauthorized abilitare l amministrazione remota dei Web Services Quando eseguendo il deploy o l undeploy di un web service da un errore di autorizzazioni (ad es. (401)Unauthorized), il problema può essere legato al fatto che AXIS non è stato configurato per essere amministrato da remoto. Soluzione: Aprire il file $JBOSS_HOME\server\default\deploy\sicraweb.ear\sicraweb.war\WEB-INF\server-config.wsdd Nella sezione relative all AdminService di Axis: <service name="adminservice" provider="java:msg"> <parameter name="allowedmethods" value="adminservice"/> <parameter name="enableremoteadmin" value="false"/> <parameter name="classname" value="org.apache.axis.utils.admin"/> <namespace> </service> Modificare il parametro enableremoteadmin" portandolo a "true". Riavviare JBoss per rendere esecutiva la modifica namingexception o null locale looking for (namingexception) Nel logon descriptor è stato specificato un utente J2EE errato Password Incorrect/Password Required Nel logon descriptor è stato specificato un utente sicraweb o un utente J2EE con errate credenziali di accesso (login/password) Qual è la porta in cui è in ascolto Tomcat? Aprire il file $JBOSS_HOME \server\default\deploy\jbossweb-tomcat50.sar\server.xml <Connector port="8080" address="${jboss.bind.address}" maxthreads="200" minsparethreads="25" maxsparethreads="45" enablelookups="false" redirectport="8443" acceptcount="40" connectiontimeout="2000" disableuploadtimeout="true"/> oppure si può cercare nel log di JBoss la seguente riga: Starting Coyote HTTP 10:39:30,601 INFO [Tomcat5] Saw org.jboss.system.server.started notification, starting connectors 10:39:30,618 INFO [Http11Protocol] Starting Coyote HTTP/1.1 on http Pag. 10 di 44

11 2 SPECIFICHE TECNICHE 2.1 Metodo: registraprotocollo L invocazione del metodo di protocollazione assegna una coppia numpg/annopg ad uno ( documento principale) o più documenti (documento principale + allegati) precedentemente inseriti nel sistema di protocollo mediante il metodo di inserimento. I parametri necessari all invocazione del metodo sono: - connectionstring: identificativo delle credenziali di connessione - <file_xml>: è il file che contiene i dati di profilazione del documento (come attachment SOAP). I dati restituiti dal metodo di protocollazione sono di seguito riportati: - lngnumpg: è il numero di protocollo assegnato dal sistema di protocollo - lngannopg: è l anno di protocollo - error_number: è l identificativo dell errore (0 in caso di esito positivo). Per ulteriori dettagli sulla gestione degli errori, consultare l Appendice A, intitolata Elenco dei codici di errore ; - error_description: è la descrizione dell errore (0 in caso di esito positivo). Di seguito si riporta la tabella di dettaglio del metodo in oggetto. Metodo registraprotocollo Descrizione Esegue la protocollazione di un documento e dei suoi eventuali allegati. Parametri in input Tipo Descrizione connectionstring String identificativo delle credenziali di connessione predefinito. objdocumentinfo Attachment DIME/MIME Il file XML che contiene le informazioni necessarie per la protocollazione di un documento principale e dei suoi allegati. Sia il file documento principale che gli allegati devono essere stati precedentemente inseriti con il metodo di inserimento Parametri in output Tipo Descrizione lngnumpg Long Numero di protocollo lngannopg Long Anno di protocollo lngerrnumber strerrstring Long Identificativo di errore (0 in caso positivo, altrimenti il codice di errore generato dall applicativo di protocollo). String La descrizione dell'errore (assente in caso positivo, altrimenti la descrizione dell'errore generata dall applicativo di protocollo). Pag. 11 di 44

12 2.1.1 Regole di compilazione del messaggio di richiesta Dato Tipo O/F Default Descrizione Intestazione Complesso O Sezione in cui si descrivono i metadati del protocollo da inserire Oggetto Stringa O Oggetto del protocollo da inserire. Massimo 2000 caratteri Identificatore Complesso O Sezione in cui si riportano id dati che identificano l applicativo chiamante. CodiceAmministrazione Stringa F Indicazione relativa al codice amministrazione indicato nel sw chiamante CodiceAOO Stringa F Ambito dell applicazione chiamante, usato solo nelle note. NumeroRegistrazione Stringa O Numero con cui la registrazione è contraddistinta nel sw chiamante DataRegistrazione Stringa O Data con cui la registrazione è contraddistinta nel sw chiamante. Deve essere in formato ISO 8601 esteso aaaa-mm-gg oppure gg/mm/aaaa Flusso Stringa O Indicazione della direzione del flusso: E = Entrata. U = Uscita I = Interno Mittente Complesso O Identifica il soggetto mittente di una protocollazione in entrata oppure l ente stesso nel caso di una protocollazione in uscita. Pag. 12 di 44

13 Persona Complesso F Presente solo per flussi in entrata. Rappresenta i dati anagrafici del soggetto mittente. L elemento può contenere un attributo id nel quale indicare eventuale codice fiscale o partita iva del soggetto mittente. Nome Stringa F Nome del soggetto mittente Cognome Stringa F Cognome del soggetto mittente Denominazione Stringa F Denominazione completa del soggetto mittente. Obbligatorio se nome e cognome non sono stati valorizzati IndirizzoTelematico Stringa F Presente solo per flussi in ingresso Indirizzo del soggetto mittente. IndirizzoPostale Complesso F Presente solo per flussi in entrata. Rappresenta i dati di recapito del soggetto mittente. Denominazione Stringa F Indirizzo completo del recapito del soggetto mittente CAP Stringa F CAP relativo al recapito del soggetto mittente Comune Stringa F Denominazione del comune relativo al recapito del soggetto mittente Provincia Stringa F Sigla della provincia relativa al recapito del soggetto mittente Amministrazione Complesso F Presente solo per flussi in uscita o interni. Rappresenta i dati distintivi del mittente del protocollo in uscita, ovvero dell ente stesso. Denominazione Stringa F Denominazione dell ente Pag. 13 di 44

14 stesso CodiceAmministrazione Stringa F Codice amministrazione dell ente stesso UnitaOrganizzativa Complesso O Rappresenta i dati distintivi dell ufficio dell ente al cui interno ha avuto origine il protocollo in uscita o interni. L elemento deve essere qualificato dall attributo id che identifica il codice ufficio assegnato alla unità organizzativa nell organigramma di sicraweb. Aoo Complesso F Presente solo per flussi in uscita. Rappresenta i dati distintivi della AOO dell ente mittente del protocollo in uscita, ovvero dell ente stesso. Denominazione Stringa F Denominazione della AOO dell ente mittente del protocollo in uscita, ovvero dell ente stesso. CodiceAOO Stringa O Codice IPA dell AOO mittente del protocollo in uscita, ovvero dell ente stesso. MittentiMulti Stringa F Indica la presenza di mittenti multipli. MittenteMulti Complesso F Identifica il soggetto mittente di una protocollazione in entrata. La struttura è la stessa dell elemento Mittente. Destinatario Complesso O Identifica il soggetto destinatario di una protocollazione in uscita oppure l ente stesso nel caso di una protocollazione in entrata. Amministrazione Complesso F Presente solo per flussi in entrata o interni. Rappresenta i dati distintivi del destinatario del Pag. 14 di 44

15 protocollo in entrata, ovvero dell ente stesso. Denominazione Stringa F Denominazione dell ente stesso CodiceAmministrazione Stringa O Codice amministrazione dell ente stesso UnitaOrganizzativa Complesso F Rappresenta i dati distintivi dell ufficio destinatario. L elemento deve essere qualificato dall attributo id identifica il codice ufficio assegnato alla unità organizzativa nell organigramma di sicraweb. Aoo Complesso F Presente solo per flussi in entrata o interni. Rappresenta i dati distintivi della AOO dell ente destinatario del protocollo in entrata, ovvero dell ente stesso. Denominazione Stringa F Denominazione della AOO dell ente destinatario del protocollo in entrata, ovvero dell ente stesso. CodiceAOO Stringa O Codice IPA dell AOO destinataria del protocollo in entrata, ovvero dell ente stesso. Persona Complesso F Presente solo per flussi in uscita. Rappresenta i dati anagrafici del soggetto destinatario. L elemento può contenere un attributo id nel quale indicare eventuale identificativo con cui il soggetto in questione è contraddistinto nel programma chiamante. Nome Stringa F Nome del soggetto destinatario Pag. 15 di 44

16 Cognome Stringa F Cognome del soggetto destinatario Denominazione Stringa F Denominazione completa del soggetto destinatario. Obbligatorio se nome e cognome non sono stati valorizzati IndirizzoTelematico Stringa F Presente solo per flussi in uscita Indirizzo del soggetto destinatario. ModalitaInvio Stringa F In sua assenza il valore di default è Cartaceo. Valori ammessi: Cartaceo Interoperabile InterPRO PEC IndirizzoPostale Complesso F Presente solo per flussi in uscita. Rappresenta i dati di recapito del soggetto destinatario. Denominazione Stringa F Indirizzo completo del recapito del soggetto destinatario CAP Stringa F CAP relativo al recapito del soggetto destinatario Comune Stringa F Denominazione del comune relativo al recapito del soggetto destinatario Provincia Stringa F Sigla della provincia relativa al recapito del soggetto destinatario DestinatariMulti Stringa F Indica la presenza di destinatari multipli DestinatarioMulti Stringa F Identifica il soggetto destinatario di una protocollazione in uscita. La struttura è la stessa dell elemento Destinatario. Pag. 16 di 44

17 Classifica Complesso F Classifica del protocollo CodiceTitolario Stringa O Codice titolario (vedi apposito campo nella classidicazione) o codice di classifica completo (es ) della voce di classifica a cui collegarsi. Fascicolo Complesso F Attributi: - numero : numero del fascicolo sicraweb - anno : anno fascicolo Descrizione Complesso O Sezione in cui si descrivono i file da associare al protocollo Documento Complesso F Rappresenta la definizione del documento principale che si intende associare al protocollo. L elemento deve contenere un attributo nome nel quale indicare il nome del file fisico e un elemento id nel quale indicare l identificativo restituito dal servizio insertdocumento. Allegati Complesso F Rappresenta la definizione degli allegati che si intendono associare al protocollo Documento Complesso O Rappresenta la definizione del documento principale che si intende associare al protocollo. L elemento può contenere un attributo nome nel quale indicare il nome del file fisico e un elemento id nel quale indicare l identificativo restituito dal servizio insertdocumento Integrazione JIride (Gestione documentale) Dalla versione di Protocollo Informatico il web service supporta anche la creazione di protocolli con l integrazione tra protocollo e gestione documentale. Pag. 17 di 44

18 Nel caso in cui l applicazione protocollo sia integrata con la gestione documentale (JIride) è necessario che l utente utilizzato dal webservice sia associato ad uno ed unico ufficio in modo tale che l ufficio mittente interno venga valorizzato nei protocolli registrati via ProWSApi. Se l'utente non è associato a nessuna U.O. il mittente interno rimarrà vuoto, con conseguenti problemi nella modifica assegnazione. Pag. 18 di 44

19 Struttura del file XML <?xml version="1.0" encoding="iso "?> <Segnatura versione=" " xml:lang="it"> <Intestazione> <Oggetto>PROTOCOLLO IN ENTRATA DA MARIO ROSSI A UFFICIO RAGIONERIA</Oggetto> <Identificatore> <CodiceAmministrazione>p_bo</CodiceAmministrazione> <CodiceAOO>AOO-BO</CodiceAOO> <NumeroRegistrazione> </NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>E</Flusso> </Identificatore> <Mittente> <Persona id="rssmra54p16f205n"> <Nome>MARIO</Nome> <Cognome>ROSSI</Cognome> <CodiceFiscale>RSSMRA54P16F205N</CodiceFiscale> <Denominazione>ROSSI MARIO</Denominazione> </Persona> <IndirizzoPostale> <Denominazione>VIALE CERTOSA 11 C</Denominazione> <CAP>20100</CAP> <Comune>MILANO</Comune> <Provincia>MI</Provincia> </IndirizzoPostale> </Mittente> <Destinatario> <Amministrazione> <Denominazione>Provincia di Bologna</Denominazione> <CodiceAmministrazione>p_bo</CodiceAmministrazione> </Amministrazione> <AOO> <Denominazione>DOC AREA2</Denominazione> <CodiceAOO>AOO-BO</CodiceAOO> </AOO> </Destinatario> </Intestazione> <Descrizione> <Documento nome="richiesta.doc" id="32483"> <DescrizioneDocumento>Richiesta concessione occupazione suolo</descrizionedocumento> </Documento> <Allegati> <Documento nome="vebale.doc" id="32487"> <DescrizioneDocumento>Allegato A - Richiesta concessione occupazione suolo</descrizionedocumento> </Documento> </Allegati> </Descrizione> </Segnatura> Il documento da protocollare ed i suo eventuali allegati devono essere stati precedentemente inseriti nel sistema di protocollo mediante il metodo di inserimento. Gli ID univoci restituiti dall invocazione del metodo di inserimento per il documento principale e i suoi allegati devono essere specificati nell apposite sezioni del file di profilazione. Dato un documento principale, inserito nel sistema di protocollo con id=327824, e un allegato, inserito nel sistema di protocollo con id=327873, un abstract del documento di profilazione che mostra l utilizzo di questi identificativi è il seguente. Pag. 19 di 44

20 <Descrizione> <Documento nome="riunione_26_04_2005.doc.p7m" id="327824"> <DescrizioneDocumento>Verbale di riunione</descrizionedocumento> <TipoDocumento>Verbale</TipoDocumento> </Documento> <Allegati> <Documento nome="testo_unico.doc" id="327873"> <DescrizioneDocumento>Testo unico in materia di...</descrizionedocumento> <TipoDocumento>Trattato</TipoDocumento> </Documento> </Allegati> </Descrizione> Vincoli: - Non c è più il vincolo legato ad un solo mittente o ad un solo destinatario: se si utilizzano i tag <MittentiMulti> <MittenteMulti> e <DestinatariMulti> <DestinatarioMulti> si possono indicare più elementi. Rimangono disponibili i tag <Mittente> e <Destinatario> e il loro utilizzo è invariato. - Non è gestita l integrazione con l indice generale Esempi Entrata Esempio1 <?xml version="1.0" encoding="iso "?> <Segnatura versione=" " xml:lang="it"> <Intestazione> <Oggetto>OGGETTO DEL PROTOCOLLO IN ARRIVO DI PROVA PER DOCUMENTAZIONE PROWSAPI</Oggetto> <Identificatore> <CodiceAmministrazione>XXX</CodiceAmministrazione> <CodiceAOO>XXX</CodiceAOO> <NumeroRegistrazione>11</NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>E</Flusso> </Identificatore> <Mittente> <Persona id="grsvsk74h60d704f"> <Nome/> <Cognome></Cognome> <Denominazione>GROSSI VERUSKA </Denominazione> </Persona> <IndirizzoPostale> <Denominazione>VIA NINO BIXIO 15</Denominazione> <CAP>47121</CAP> <Comune>FORLI</Comune> <Provincia>FO</Provincia> </IndirizzoPostale> </Mittente> <Destinatario> <Amministrazione> <Denominazione>Comune di XXX</Denominazione> <CodiceAmministrazione>c_XYZ</CodiceAmministrazione> <UnitaOrganizzativa tipo="" id="proto"></unitaorganizzativa> </Amministrazione> <AOO> <Denominazione>aoo comune di XXX</Denominazione> <CodiceAOO>AOO1</CodiceAOO> </AOO> Pag. 20 di 44

21 </Destinatario> <Classifica> <CodiceTitolario>10.10</CodiceTitolario> </Classifica> <Fascicolo numero="1" anno="2011"/> </Intestazione> <Descrizione> <Documento nome="principalee.doc" id="17899"></documento> <Allegati> <Documento nome="allegatoe.txt" id="17900"></documento> </Allegati> </Descrizione> </Segnatura> Esempio2 <?xml version="1.0" encoding="iso "?> <Segnatura versione=" " xml:lang="it"> <Intestazione> <Oggetto>PROTOCOLLO IN ENTRATA DA MARIO ROSSI A UFFICIO RAGIONERIA</Oggetto> <Identificatore> <CodiceAmministrazione>p_bo</CodiceAmministrazione> <CodiceAOO>AOO-BO</CodiceAOO> <NumeroRegistrazione> </NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>E</Flusso> </Identificatore> <Mittente> <Persona id="rssmra54p16f205n"> <Nome>MARIO</Nome> <Cognome>ROSSI</Cognome> <CodiceFiscale>RSSMRA54P16F205N</CodiceFiscale> <Denominazione>ROSSI MARIO</Denominazione> </Persona> <IndirizzoPostale> <Denominazione>VIALE CERTOSA 11 C</Denominazione> <CAP>20100</CAP> <Comune>MILANO</Comune> <Provincia>MI</Provincia> </IndirizzoPostale> </Mittente> <Destinatario> <Amministrazione> <Denominazione>Provincia di Bologna</Denominazione> <CodiceAmministrazione>p_bo</CodiceAmministrazione> </Amministrazione> <AOO> <Denominazione>DOC AREA2</Denominazione> <CodiceAOO>AOO-BO</CodiceAOO> </AOO> </Destinatario> <Classifica> <CodiceTitolario>1.1.1</CodiceTitolario> </Classifica> <Fascicolo numero='53' anno='2010'/> </Intestazione> <Descrizione> <Documento nome="richiesta.doc" id="32483"> <DescrizioneDocumento>Richiesta concessione occupazione suolo</descrizionedocumento> <TipoDocumento>Richiesta</TipoDocumento> </Documento> <Allegati> <Documento nome="vebale.doc" id="32487"> <DescrizioneDocumento>Allegato A - Richiesta concessione occupazione suolo</descrizionedocumento> <TipoDocumento>Allegato</TipoDocumento> Pag. 21 di 44 Classificazione Fascicolo

22 </Documento> </Allegati> </Descrizione> </Segnatura> Esempio3 (MultiMittenti) <Segnatura xml:lang="it"> <Intestazione> <Oggetto>PROTOCOLLO ENTRATA MULTIPLA</Oggetto> <Identificatore> <CodiceAmministrazione>AMM.MAGG1</CodiceAmministrazione> <CodiceAOO>AOO.MAGG1</CodiceAOO> <NumeroRegistrazione> </NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>E</Flusso> </Identificatore> <Mittente> <Persona> <Denominazione>ABETE PINO, MARIO ROSSI</Denominazione> </Persona> </Mittente> <MittentiMulti> <MittenteMulti> <TipoMittente>Principale</TipoMittente> <Persona id="btapni80b03g702n"> <Nome>PINO</Nome> <Cognome>ABETE</Cognome> <CodiceFiscale>BTAPNI80B03G702N</CodiceFiscale> <Denominazione>ABETE PINO</Denominazione> </Persona> </MittenteMulti> <MittenteMulti> <TipoMittente>Principale</TipoMittente> <Persona> <Denominazione>MARIO ROSSI</Denominazione> </Persona> <IndirizzoPostale> <Denominazione>VIA DANTE</Denominazione> <CAP>56100</CAP> <Comune>PISA</Comune> <Provincia>PI</Provincia> </IndirizzoPostale> </MittenteMulti> </MittentiMulti> <Destinatario> <Amministrazione> <Denominazione>Coda 1 per Maggioli</Denominazione> <CodiceAmministrazione>AMM.MAGG1</CodiceAmministrazione> </Amministrazione> <AOO> <Denominazione>Coda 1 per Maggioli</Denominazione> <CodiceAOO>AOO.MAGG1</CodiceAOO> </AOO> </Destinatario> </Intestazione> <Descrizione/> </Segnatura> Uscita Esempio1 <?xml version="1.0" encoding="iso "?> Pag. 22 di 44

23 <Segnatura versione=" " xml:lang="it"> <Intestazione> <Oggetto>OGGETTO DEL PROTOCOLLO IN PARTENZA DI PROVA PER DOCUMENTAZIONE PROWSAPI</Oggetto> <Identificatore> <CodiceAmministrazione>XXX</CodiceAmministrazione> <CodiceAOO>XXX</CodiceAOO> <NumeroRegistrazione>12</NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>U</Flusso> </Identificatore> <Mittente> <Amministrazione> <Denominazione>Comune di XXX</Denominazione> <CodiceAmministrazione>c_XYZ</CodiceAmministrazione> <UnitaOrganizzativa tipo="" id="proto"></unitaorganizzativa> </Amministrazione> <AOO> <Denominazione>aoo comune di XXX</Denominazione> <CodiceAOO>AOO1</CodiceAOO> </AOO> </Mittente> <Destinatario> <Persona id="grsvsk74h60d704f"> <Nome/> <Cognome></Cognome> <Denominazione>GROSSI VERUSKA </Denominazione> </Persona> <IndirizzoPostale> <Denominazione>VIA NINO BIXIO 15</Denominazione> <CAP>47121</CAP> <Comune>FORLI</Comune> <Provincia>FO</Provincia> </IndirizzoPostale> </Destinatario> <Classifica> <CodiceTitolario>10.10</CodiceTitolario> </Classifica> <Fascicolo numero="1" anno="2011"/> </Intestazione> <Descrizione> <Documento nome="principaleu.doc" id="17899"></documento> <Allegati> <Documento nome="allegatou.txt" id="17900"></documento> </Allegati> </Descrizione> </Segnatura> Esempio2 <?xml version="1.0" encoding="iso "?> <Segnatura versione=" " xml:lang="it"> <Intestazione> <Oggetto>PROTOCOLLO IN USCITA DALL'UFFICIO RAGIONERIA A MARIO ROSSI</Oggetto> <Identificatore> <CodiceAmministrazione>p_bo</CodiceAmministrazione> <CodiceAOO>AOO-BO</CodiceAOO> <NumeroRegistrazione> </NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>U</Flusso> </Identificatore> <Mittente> <Amministrazione> <Denominazione>Provincia di Bologna</Denominazione> <UnitaOrganizzativa tipo="permanente"> <Denominazione>RAGIONERIA-000</Denominazione> <Identificativo>1-E000</Identificativo> Pag. 23 di 44

24 <IndirizzoPostale> <Denominazione>via Delle Mareggiate, 12/A</Denominazione> </IndirizzoPostale> </UnitaOrganizzativa> </Amministrazione> </Mittente> <Destinatario> <Persona id="rssmra54p16f205n"> <Nome>MARIO</Nome> <Cognome>ROSSI</Cognome> <CodiceFiscale>RSSMRA54P16F205N</CodiceFiscale> <Denominazione>ROSSI MARIO</Denominazione> </Persona> <IndirizzoTelematico <IndirizzoPostale> <Denominazione>VIALE CERTOSA 11 C</Denominazione> <CAP>20100</CAP> <Comune>MILANO</Comune> <Provincia>MI</Provincia> </IndirizzoPostale> </Destinatario> </Intestazione> <Descrizione/> </Segnatura> Esempio3 (DestinatariMulti) <Segnatura xml:lang="it"> <Intestazione> <Oggetto>PROTOCOLLAZIONE IN USCITA</Oggetto> <Identificatore> <CodiceAmministrazione>AMM.MAGG1</CodiceAmministrazione> <CodiceAOO>AOO.MAGG1</CodiceAOO> <NumeroRegistrazione> </NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>U</Flusso> </Identificatore> <Mittente> <Amministrazione> <Denominazione>Coda 1 per Maggioli</Denominazione> <CodiceAmministrazione>AMM.MAGG1</CodiceAmministrazione> <UnitaOrganizzativa tipo="permanente" id="4"> <Denominazione>Protocollo1</Denominazione> <Identificativo>4</Identificativo> <IndirizzoPostale> <Denominazione>via del commercio 11</Denominazione> </IndirizzoPostale> <IndirizzoTelematico tipo="smtp">provamail_silmagg1@regionetoscana.it</indirizzotelematico> </UnitaOrganizzativa> </Amministrazione> <AOO> <Denominazione>Coda 1 per Maggioli</Denominazione> <CodiceAOO>AOO.MAGG1</CodiceAOO> </AOO> </Mittente> <Destinatario> <Persona> <Denominazione>GIUSEPPE VERDI, MARIO ROSSI, COMUNE DI CAMISANO</Denominazione> </Persona> </Destinatario> <DestinatariMulti> <DestinatarioMulti> <TipoDestinatario>Principale</TipoDestinatario> Pag. 24 di 44

25 <Persona id="pppplt80r10m082k"> <Nome>GIUSEPPE</Nome> <Cognome>VERDI</Cognome> <CodiceFiscale>GSPVRD80R10M082K</CodiceFiscale> <Denominazione>GIUSEPPE VERDI</Denominazione> </Persona> <IndirizzoTelematico <ModalitaInvio>PEC</ModalitaInvio> <IndirizzoPostale> <Denominazione>VIA MANZONI</Denominazione> <CAP>56100</CAP> <Comune>PISA</Comune> <Provincia>PI</Provincia> </IndirizzoPostale> </DestinatarioMulti> <DestinatarioMulti> <TipoDestinatario>Principale</TipoDestinatario> <Persona> <Denominazione>MARIO ROSSI</Denominazione> </Persona> <IndirizzoTelematico <ModalitaInvio>PEC</ModalitaInvio> <IndirizzoPostale> <Denominazione>VIA MONTALE</Denominazione> <CAP>56100</CAP> <Comune>PISA</Comune> <Provincia>PI</Provincia> </IndirizzoPostale> </DestinatarioMulti> <DestinatarioMulti> <TipoDestinatario>Principale</TipoDestinatario> <Amministrazione> <Denominazione>Comune di Camisano</Denominazione> <CodiceAmministrazione>c_b484</CodiceAmministrazione> <Persona> <Denominazione>COMUNE DI CAMISANO</Denominazione> </Persona> <IndirizzoPostale> <Denominazione>PIAZZA MAGGIORE, 1</Denominazione> <CAP>26010</CAP> <Comune>CAMISANO</Comune> <Provincia>CR</Provincia> </IndirizzoPostale> <IndirizzoTelematico <ModalitaInvio>Interoperabile</ModalitaInvio> </Amministrazione> <IndirizzoTelematico <ModalitaInvio>Interoperabile</ModalitaInvio> <IndirizzoPostale> <Denominazione>PIAZZA MAGGIORE, 1</Denominazione> <CAP>26010</CAP> <Comune>CAMISANO</Comune> <Provincia>CR</Provincia> </IndirizzoPostale> </DestinatarioMulti> </DestinatariMulti> </Intestazione> <Descrizione/> </Segnatura> Pag. 25 di 44

26 Interno Esempio1 <?xml version="1.0" encoding="iso "?> <Segnatura versione=" " xml:lang="it"> <Intestazione> <Oggetto>OGGETTO DEL PROTOCOLLO INTERNO DI PROVA PER DOCUMENTAZIONE PROWSAPI</Oggetto> <Identificatore> <CodiceAmministrazione>XXX</CodiceAmministrazione> <CodiceAOO>XXX</CodiceAOO> <NumeroRegistrazione>10</NumeroRegistrazione> <DataRegistrazione> </DataRegistrazione> <Flusso>I</Flusso> </Identificatore> <Mittente> <Amministrazione> <Denominazione>Comune di XXX</Denominazione> <CodiceAmministrazione>c_XYZ</CodiceAmministrazione> <UnitaOrganizzativa tipo="" id="proto"></unitaorganizzativa> </Amministrazione> <AOO> <Denominazione>aoo comune di XXX</Denominazione> <CodiceAOO>AOO1</CodiceAOO> </AOO> </Mittente> <Destinatario> <Amministrazione> <Denominazione>Comune di XXX</Denominazione> <CodiceAmministrazione>c_XYZ</CodiceAmministrazione> <UnitaOrganizzativa tipo="" id="proto"></unitaorganizzativa> </Amministrazione> <AOO> <Denominazione>aoo comune di XXX</Denominazione> <CodiceAOO>AOO1</CodiceAOO> </AOO> </Destinatario> <Classifica> <CodiceTitolario>10.10</CodiceTitolario> </Classifica> <Fascicolo numero="1" anno="2011"/> </Intestazione> <Descrizione> <Documento nome="principalei.doc" id="17899"></documento> <Allegati> <Documento nome="allegatoi.txt" id="17900"></documento> </Allegati> </Descrizione> </Segnatura> Pag. 26 di 44

27 2.2 Metodo: insertdocumento (inserimento di un documento) Il metodo di inserimento è finalizzato all invio di un file; esso restituisce all applicativo chiamante un identificativo univoco per il singolo file oggetto della transazione. Tale identificativo deve essere utilizzato nell invocazione del metodo di protocollazione specificandolo nelle apposite sezioni <Documento> del file xml di profilazione. I parametri necessari all invocazione del metodo di inserimento sono: - connectionstring: identificativo delle credenziali di connessione - <file_binario>: è il file elettronico da inserire nel sistema (come attachment SOAP). I dati restituiti dal metodo di inserimento sono di seguito riportati: - docnumber: è l identificativo univoco del documento che è stato inserito (questo dato dovrà essere memorizzato localmente negli applicativi che utilizzano il web service al fine di riutilizzarlo per la successiva invocazione del metodo di protocollazione); - error_number: è l identificativo dell errore (0 in caso di esito positivo). Per ulteriori dettagli sulla gestione degli errori, consultare l Appendice A, intitolata Elenco dei codici di errore ; - error_description: è la descrizione dell errore (0 in caso di esito positivo). Di seguito si riporta la tabella di dettaglio del metodo in oggetto. Metodo insertdocumento Descrizione Acquisisce il file elettronico e gli attribuisce un identificativo da utilizzare nel invocazione del metodo di protocollazione. Parametri in input Tipo Descrizione connectionstring String Il nome dell'utente che vuole iniziare la sessione di lavoro (è un utente predefinito ad esempio ut_xxxxx). objdocument Attachment DIME/MIME Il file elettronico oggetto della transazione. Parametri in output Tipo Descrizione lngdocid Long Identificativo univoco del documento inserito lngerrnumber strerrstring Long Identificativo di errore (0 in caso positivo, altrimenti il codice di errore generato dall applicativo di protocollo). String La descrizione dell'errore (assente in caso positivo, altrimenti la descrizione dell'errore generata dall applicativo di protocollo). Pag. 27 di 44

28 2.3 Metodo: infoprotocollo Ritorna la descrizione di un protocollo sotto forma di file XML. I parametri necessari all invocazione del metodo sono: - connectionstring: identificativo delle credenziali di connessione - numprot: è il numero di protocollo assegnato dal sistema di protocollo - annoprot: anno di protocollo - aoo: codice che identifica l'area Organizzativa Omogenea (AOO); se l'ente ha una sola AOO può anche essere omesso (passando un NULL), mentre diventa obbligatorio nel caso l'ente gestisca più AOO. Bisogna indicare il codice della AOO che è indicato nella maschera di configurazione della AOO e dovrebbe corrispondere al codice AOO presente nell'indice delle Pubbliche Amministrazioni (è possibile indicare anche l'id interno della AOO indicandolo con questa sintassi: "id=id interno della AOO"). I dati restituiti dal metodo di protocollazione sono di seguito riportati: - desprotocollo: è un XML che contiene i dati di profilazione del documento Di seguito si riporta la tabella di dettaglio del metodo in oggetto. Metodo infoprotocollo Descrizione Ritorna la descrizione di un protocollo sotto forma di file XML. Parametri in input Tipo Descrizione connectionstring String identificativo delle credenziali di connessione numprot Long Numero di protocollo annoprot Long Anno di protocollo aoo String Codice che identifica l'area Organizzativa Omogenea (AOO); se l'ente ha una sola AOO può anche essere omesso (passando un NULL), mentre diventa obbligatorio nel caso l'ente gestisca più AOO. Bisogna indicare il codice della AOO che è indicato nella maschera di configurazione della AOO e dovrebbe corrispondere al codice AOO presente nell'indice delle Pubbliche Amministrazioni (è possibile indicare anche l'id interno della AOO indicandolo con questa sintassi: "id=id interno della AOO") Parametri in output Tipo Descrizione desprotocollo String un XML che contiene i dati di profilazione del documento Pag. 28 di 44

29 2.4 WSDL <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace="urn:prowsapi" xmlns=" xmlns:apachesoap=" xmlns:impl="urn:prowsapi" xmlns:intf="urn:prowsapi" xmlns:soapenc=" xmlns:tns1=" xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" targetnamespace=" xmlns=" namespace=" name="inserimentoret"><sequence><element name="lngdocid" type="xsd:long"/><element name="lngerrnumber" type="xsd:long"/><element maxoccurs="1" minoccurs="0" name="strerrstring" nillable="true" type="xsd:string"/></sequence></complextype><complextype name="protocollazioneret"><sequence><element name="lngnumpg" type="xsd:long"/><element name="lngannopg" type="xsd:long"/><element name="lngerrnumber" type="xsd:long"/><element maxoccurs="1" minoccurs="0" name="strerrstring" nillable="true" type="xsd:string"/></sequence></complextype></schema></wsdl:types> <wsdl:message name="insertdocumentoresponse"> <wsdl:part name="insertdocumentoreturn" type="tns1:inserimentoret"/> </wsdl:message> <wsdl:message name="insertdocumentorequest"> <wsdl:part name="connectionstring" type="xsd:string"/> <wsdl:part name="documentname" type="xsd:string"/> <wsdl:part name="documentdescription" type="xsd:string"/> </wsdl:message> <wsdl:message name="registraprotocolloresponse"> <wsdl:part name="registraprotocolloreturn" type="tns1:protocollazioneret"/> </wsdl:message> <wsdl:message name="infoprotocollorequest"> <wsdl:part name="connectionstring" type="xsd:string"/> <wsdl:part name="numprot" type="xsd:long"/> <wsdl:part name="annoprot" type="xsd:long"/> <wsdl:part name="aoo" type="xsd:string"/> </wsdl:message> <wsdl:message name="registraprotocollorequest"> <wsdl:part name="connectionstring" type="xsd:string"/> </wsdl:message> <wsdl:message name="infoprotocolloresponse"> <wsdl:part name="infoprotocolloreturn" type="xsd:string"/> </wsdl:message> <wsdl:porttype name="prowsapi"> <wsdl:operation name="infoprotocollo" parameterorder="connectionstring numprot annoprot aoo"> <wsdl:input message="impl:infoprotocollorequest" name="infoprotocollorequest"/> <wsdl:output message="impl:infoprotocolloresponse" name="infoprotocolloresponse"/> </wsdl:operation> <wsdl:operation name="registraprotocollo" parameterorder="connectionstring"> <wsdl:input message="impl:registraprotocollorequest" name="registraprotocollorequest"/> <wsdl:output message="impl:registraprotocolloresponse" name="registraprotocolloresponse"/> </wsdl:operation> <wsdl:operation name="insertdocumento" parameterorder="connectionstring documentname documentdescription"> <wsdl:input message="impl:insertdocumentorequest" name="insertdocumentorequest"/> <wsdl:output message="impl:insertdocumentoresponse" name="insertdocumentoresponse"/> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="prowsapisoapbinding" type="impl:prowsapi"> <wsdlsoap:binding style="rpc" transport=" <wsdl:operation name="infoprotocollo"> <wsdlsoap:operation soapaction=""/> <wsdl:input name="infoprotocollorequest"> Pag. 29 di 44

30 <wsdlsoap:body encodingstyle=" namespace="urn:prowsapi" use="encoded"/> </wsdl:input> <wsdl:output name="infoprotocolloresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:prowsapi" use="encoded"/> </wsdl:output> </wsdl:operation> <wsdl:operation name="registraprotocollo"> <wsdlsoap:operation soapaction=""/> <wsdl:input name="registraprotocollorequest"> <wsdlsoap:body encodingstyle=" namespace="urn:prowsapi" use="encoded"/> </wsdl:input> <wsdl:output name="registraprotocolloresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:prowsapi" use="encoded"/> </wsdl:output> </wsdl:operation> <wsdl:operation name="insertdocumento"> <wsdlsoap:operation soapaction=""/> <wsdl:input name="insertdocumentorequest"> <wsdlsoap:body encodingstyle=" namespace="urn:prowsapi" use="encoded"/> </wsdl:input> <wsdl:output name="insertdocumentoresponse"> <wsdlsoap:body encodingstyle=" namespace="urn:prowsapi" use="encoded"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="prowsapiservice"> <wsdl:port binding="impl:prowsapisoapbinding" name="prowsapi"> <wsdlsoap:address location=" </wsdl:port> </wsdl:service> </wsdl:definitions> Pag. 30 di 44

31 2.5 XSD registraprotocollo <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" xmlns:xml=" <xs:import namespace=" <xs:element name="unitaorganizzativa"> <xs:attribute name="tipo" type="xs:string" use="required"/> <xs:attribute name="id" type="xs:string" use="required"/> <xs:element name="segnatura"> <xs:element ref="intestazione"/> <xs:element ref="descrizione"/> <xs:attribute ref="xml:lang" use="required"/> <xs:attribute name="versione" type="xs:date" use="required"/> <xs:element name="provincia" type="xs:string"/> <xs:element name="persona"> <xs:element ref="nome"/> <xs:element ref="cognome"/> <xs:element ref="denominazione"/> <xs:attribute name="id" type="xs:string" use="required"/> <xs:element name="oggetto" type="xs:string"/> <xs:element name="numeroregistrazione" type="xs:int"/> <xs:element name="nome" type="xs:string"/> <xs:element name="mittente"> <xs:element ref="persona" minoccurs="0" maxoccurs="1"/> <xs:element ref="indirizzopostale" minoccurs="0" maxoccurs="1"/> <xs:element ref="amministrazione" minoccurs="0" maxoccurs="1"/> <xs:element ref="aoo" minoccurs="0" maxoccurs="1"/> <xs:element name="intestazione"> <xs:element ref="oggetto"/> <xs:element ref="identificatore"/> <xs:element ref="mittente"/> <xs:element ref="destinatario"/> <xs:element ref="classifica"/> <xs:element ref="fascicolo"/> <xs:element name="indirizzopostale"> Pag. 31 di 44

32 <xs:element ref="denominazione"/> <xs:element ref="cap"/> <xs:element ref="comune"/> <xs:element ref="provincia"/> <xs:element name="identificatore"> <xs:element ref="codiceamministrazione" minoccurs="0" maxoccurs="1"/> <xs:element ref="codiceaoo" minoccurs="0" maxoccurs="1"/> <xs:element ref="numeroregistrazione"/> <xs:element ref="dataregistrazione"/> <xs:element ref="flusso"/> <xs:element name="flusso"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:enumeration value="e"/> <xs:enumeration value="u"/> <xs:enumeration value="i"/> </xs:restriction> </xs:simpletype> <xs:element name="fascicolo"> <xs:attribute name="numero" type="xs:string" use="required"/> <xs:attribute name="anno" type="xs:short" use="required"/> <xs:element name="documento"> <xs:attribute name="nome" type="xs:string" use="required"/> <xs:attribute name="id" type="xs:int" use="required"/> <xs:element name="destinatario"> <xs:element ref="persona" minoccurs="0" maxoccurs="1"/> <xs:element ref="indirizzopostale" minoccurs="0" maxoccurs="1"/> <xs:element ref="amministrazione" minoccurs="0" maxoccurs="1"/> <xs:element ref="aoo" minoccurs="0" maxoccurs="1"/> <xs:element name="descrizione"> <xs:element ref="documento"/> <xs:element ref="allegati"/> <xs:element name="denominazione" type="xs:string"/> <xs:element name="dataregistrazione" type="xs:date"/> <xs:element name="comune" type="xs:string"/> <xs:element name="cognome" type="xs:string"/> <xs:element name="codicetitolario" type="xs:string"/> <xs:element name="codiceamministrazione" type="xs:string"/> <xs:element name="codiceaoo" type="xs:string"/> <xs:element name="classifica"> Pag. 32 di 44

33 <xs:element ref="codicetitolario"/> <xs:element name="cap" type="xs:int"/> <xs:element name="amministrazione"> <xs:element ref="denominazione"/> <xs:element ref="codiceamministrazione"/> <xs:element ref="unitaorganizzativa"/> <xs:element name="allegati"> <xs:element ref="documento"/> <xs:element name="aoo"> <xs:element ref="denominazione"/> <xs:element ref="codiceaoo"/> </xs:schema> infoprotocollo <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" xmlns:xml=" <xs:import namespace=" <xs:element name="titolodocumento" type="xs:string"/> <xs:element name="unitaorganizzativa"> <xs:element ref="denominazione" minoccurs="0"/> <xs:element ref="identificativo" minoccurs="0"/> <xs:attribute name="tipo" type="xs:string" use="required"/> <xs:attribute name="id" type="xs:string" use="optional"/> <xs:element name="segnatura"> <xs:element ref="intestazione"/> <xs:element ref="descrizione"/> <xs:attribute ref="xml:lang" use="required"/> <xs:attribute name="versione" type="xs:date" use="required"/> <xs:element name="persona"> <xs:element ref="nome" minoccurs="0"/> <xs:element ref="cognome" minoccurs="0"/> Pag. 33 di 44

34 <xs:element ref="codicefiscale" minoccurs="0"/> <xs:element ref="denominazione" minoccurs="0"/> <xs:attribute name="id" type="xs:string" use="optional"/> <xs:element name="oggetto" type="xs:string"/> <xs:element name="numeroregistrazione" type="xs:byte"/> <xs:element name="nome" type="xs:string"/> <xs:element name="cognome" type="xs:string"/> <xs:element name="codicefiscale" type="xs:string"/> <xs:element name="mittente"> <xs:element ref="amministrazione" minoccurs="0"/> <xs:element ref="aoo" minoccurs="0"/> <xs:element ref="persona" minoccurs="0"/> <xs:element ref="indirizzopostale" minoccurs="0"/> <xs:element name="intestazione"> <xs:element ref="oggetto"/> <xs:element ref="identificatore"/> <xs:element ref="mittente"/> <xs:element ref="destinatario"/> <xs:element name="identificatore"> <xs:element ref="codiceamministrazione"/> <xs:element ref="codiceaoo"/> <xs:element ref="numeroregistrazione"/> <xs:element ref="dataregistrazione"/> <xs:element ref="flusso"/> <xs:element name="flusso" type="xs:string"/> <xs:element name="documento"> <xs:element ref="titolodocumento"/> <xs:attribute name="tiporiferimento" use="required"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:enumeration value="mime"/> </xs:restriction> </xs:simpletype> </xs:attribute> <xs:attribute name="nome" type="xs:string" use="required"/> <xs:attribute name="id" type="xs:short" use="required"/> <xs:element name="destinatario"> <xs:element ref="amministrazione" minoccurs="0"/> <xs:element ref="aoo" minoccurs="0"/> <xs:element ref="persona" minoccurs="0"/> Pag. 34 di 44