SPECIFICHE TECNICHE DEI SERVIZI DI VERSAMENTO

Транскрипт

1 SPECIFICHE TECNICHE DEI SERVIZI DI VERSAMENTO Servizi di versament in mdalità sincrna Nme Servizi Descrizine Servizi Versine Servizi VersamentSync Servizi versament di SIP dell Unità dcumentaria 1.4 AggiuntaAllegatiSync Servizi di versament di SIP del Dcument 1.4 Servizi di versament in mdalità asincrna Nme Servizi InviOggettPreIngest NtificaTrasferimentFile Descrizine Servizi Servizi di versament di SIP da nrmalizzare in mdalità asincrna Servizi di Ntifica dell avvenut trasferiment via FTP dell Oggett Versine Servizi Data Cdice dcument ParER_SpecificheServiziVersament Versine 2.0 Redatt da Apprvat da Pala Ugltti e Cristian Casagni Cristian Casagni

2 Il presente dcument è rilasciat stt la licenza Attribuzine-Nn cmmerciale delle Creative Cmmns.

3 Indice INDICE 3 STORIA DELLE MODIFICHE APPORTATE AL DOCUMENTO... 5 ELENCO DEGLI XSD DESCRITTI NEL PRESENTE DOCUMENTO... 9 DOCUMENTI DI RIFERIMENTO INTRODUZIONE Premessa Avvertenze sulle mdifiche apprtate al presente dcument rispett alla versine precedente Glssari 12 SEZ. 1 MODELLI DI PACCHETTI DI VERSAMENTO (SIP) SIP di Unità dcumentaria Indice del SIP di Unità dcumentaria Metadati di <UnitàDcumentaria> Metadati di Dcument (<Dcument principale>, <Allegati>, <Annessi> e <Anntazini>) Metadati di <Cmpnenti> Esempi di Indice SIP di Unità dcumentaria Packaging Infrmatin SIP (PI SIP) Struttura dati del PI SIP Esempi di PI SIP SIP di Dcument Indice del SIP di Dcument Metadati di <Dcument> Metadati di <Cmpnenti> Esempi di Indice SIP di Dcument SIP di Metadati Esempi di Indice SIP di Metadati relativ all annullament di una registrazine di prtcll SIP di Unità archivistica (Fascicl) SIP nn nrmalizzati SEZ. 2 SERVIZI DI VERSAMENTO IN MODALITÀ SINCRONA L architettura per l scambi dei messaggi Struttura della chiamata dei servizi di versament sincrn Descrizine del servizi di versament sincrn Struttura della chiamata Esempi di invcazine della chiamata del web service Nta relativa alle cdifiche XML e HTTP Cntrlli sul SIP Cntrlli sull Indice SIP Cntrlli sui file (Oggetti-dati) Cntrlli sulla firma digitale... 75

4 Cntrlli sulla marca temprale Cntrlli sui frmati Il Rapprt di versament Esempi di Rapprt di versament di Unità dcumentaria Esempi di Rapprt di versament di Dcument L Esit versament (rispsta alla chiamata) Esempi di Esit versament di Unità dcumentaria cn esit generale POSITIVO Esempi di Esit versament di Unità dcumentaria cn esit generale NEGATIVO Esempi di Esit versament di Unità dcumentaria cn esit generale negativ e cdice errre UD Esempi di Esit versament di Dcument cn esit generale POSITIVO Esempi di Esit versament di Dcument cn esit generale NEGATIVO Metadati generati dal Sistema sugli ggetti versati Metadati di identificazine degli ggetti versati nel Sistema Metadati descrittivi del file Gestine degli errri Annullament del versament di una Unità dcumentaria Servizi di versament sincrn di Unità dcumentaria (VersamentSync) Versine Struttura della chiamata al servizi VersamentSync Cntrlli sul SIP di Unità dcumentaria Cntrlli semantici sull Indice SIP Cntrlli fiscali Rispsta alla chiamata (Esit versament) Servizi di versament sincrn di aggiunta Dcument (AggiuntaAllegatiSync) Versine Struttura della chiamata al servizi AggiuntaAllegatiSync Cntrlli sul SIP di Dcument L Esit versament in rispsta alla chiamata del servizi AggiuntaAllegatiSync Servizi di versament per l aggirnament dei metadati SEZ. 3 SERVIZI DI VERSAMENTO IN MODALITÀ ASINCRONA Il prcess di versament asincrn Stati assunti da un Oggett nel prcess di versament in mdalità asincrna Infrmazini per attivare i servizi di versament asincrn Infrmazini sul Versatre asincrn Tiplgie di Oggett Dati specifici della tiplgia di Oggett Tiplgie di file gestite per l specific Oggett Descrizine del prcess di versament in mdalità asincrna Chiamata del web service InviOggettPreIngest Indice del SIP da nrmalizzare Esit chiamata al servizi InviOggettPreIngest Trasferiment FTP File system area FTP Chiamata del servizi NtificaTrasferimentFile Fasi successive del prcess di Preacquisizine SEZ. 4 SCENARI DI UTILIZZO Versament di un Unità dcumentaria Aggiunta di un Dcument ad un Unità dcumentaria già presente nel Sistema Aggirnament dei metadati di un Unità dcumentaria già presente nel Sistema Annullament di un Unità dcumentaria già versata nel Sistema CASO 1: Annullament mediante mdifica metadati CASO 2: Annullament mediante prduzine di un dcument cn stessa Chiave CASO 3: Annullament mediante prduzine di un dcument cn Chiave diversa

5 Stria delle mdifiche apprtate al dcument VERSIONE Variazini Data VersamentSync 1.0 Prima emissine 29/07/ : Intrduzine del tag <Versine> : Metadat IDDcument ra bbligatri : Indicazine della versine di riferiment nei metadati specifici : Metadat Ordine presentazine ra è bbligatri e presente anche nel Sttcmpnente : Riferiment temprale: la data va espressa secnd l standard ISO 8601 VersamentSync : Aggiunt nell esempi i tag <Versine>, <VersineDatiSpecifici> e <Ordine Presentazine> (a livell dei Sttcmpnenti) ed eliminat il tag <Dati specifici> in Allegati, Annessi e Anntazini e aggirnat l esempi cn il frmat ISO 8601 per i campi <RiferimentTemprale> 14/09/ : Aggirnat l esempi cn i nuvi tag e relativi frmati (vedi punt precedente) : Aggirnati i cntrlli semantici cn l aggiunta di quell di versine e dell User_id 7: Aggirnata la struttura della rispsta al servizi di versament che ra prevede anche la versine del file XSD e i parametri di cnfigurazine della struttura versante : Nelle tabelle riepilgative dei tag previsti dall XML di versament sn state inserite le clnne Dimensine Massima 5.1.1: Inserit il cntrll di nn nullità nei campi pzinali VersamentSync : nei Metadati di Cnfigurazine è stat intrdtt il tag <SimulaSalvataggiDatiInDB> 31/05/ : nei metadati riferiti al Prfil Unità Dcumentaria è stat intrdtt il tag <Cartace> e 5.2.4: Aggirnat l esempi cn i nuvi tag : Aggirnati i cntrlli semantici cn l aggiunta di quell di rdinament e del cntrll registr Specifiche tecniche dei servizi di versament [ 5 ]

6 4.2: Gestine della Retrcmpatibilità 5.1.1: Metadat TipCnservazine può assumere il valre Migrazine : Intrdtt il Metadat <SistemaDiMigrazine> 5.1.1: Intrdtti i Metadati Specifici riferiti all Unità Dcumentaria e al Cmpnente 5.1.1: Intrdtti i Metadati Specifici di Migrazine : Metadat <TipStruttura> ra nn è bbligatri (previst un valre di default in cas di assenza) VersamentSync :Metadati<UtilizzDataFirmaPerRifTemp>,<Rife rimenttemprale>, <DescrizineRiferimentTemprale> ra nn sn bbligatri (previst un valre di default in cas di assenza del metadat UtilizzDataFirmaPerRifTemp) 04/07/ : Metadat <TipCmpnente> ra nn è bbligatri (previst un valre di default in cas di assenza) : Metadat < TipSupprtCmpnente > ra nn è bbligatri (previst un valre di default in cas di assenza) Aggirnat l esempi cn i nuvi tag : Intrdtt il cntrll di validità (verifica della Data di Istituzine e della Data di Sprressine degli elementi indicati nell xml rispett alla Data di versament) 7.1: Intrdtt esempi di rispsta : Intrdtta tabella riepilgativa degli errri restituiti dal WS di Versament 2.1: Variazine nelle tiplgie di Tip supprt Cmpnente : Mdifica del Metadat <TipSupprtCmpnente> (sia per i Cmpnenti che per i Sttcmpnenti): VersamentSync 1.3 Errata Crrige la tiplgia di supprt da utilizzare nel cas in cui il Cmpnente sia un riferiment a un Cmpnente precedentemente versat viene rinminata in RIFERIMENTO (al pst di METADATI ) 08/11/2012 intrdtta una nuva tiplgia di supprt, denminata METADATI,da utilizzare nel cas il Cmpnente nn abbia un file Specifiche tecniche dei servizi di versament [ 6 ]

7 : Mdifica del Metadat <Riferiment>: il tag risulta bbligatri nel cas in cui il Tip Supprt Cmpnente sia pari a RIFERIMENTO 5.2.2: Intrdtt scenari di Annullament UD 5.2.3: Intrdtt scenari di Mdifica Metadati UD 7.2.2: Mdifiche ai messaggi di errre a seguit delle mdifiche nel Tip SupprtCmpnente 4.3: inserit paragraf su cdifiche XML e HTTP 5: struttura del file XML: viene deprecat il tag <DatiFiscali> 5.3.3: eliminazine del tag <DatiFiscali> dall esempi di XML di versament : Inseriment cntrll di validità del registr nell ann indicat nella chiave della UD versata : Revisine della gestine dei dati fiscali VersamentSync 1.3 rev01 7: Rispsta al servizi di versament: revisine delle infrmazini restituite dal servizi di versament 7.2.1: Richiesta Versament UD già versata: tale richiesta prduce un Errre e nn un Warning cme precedentemente descritt 17/10/ Errri restituiti dal WS di Versament : eliminazine del ; la descrizine degli errri è stata spstata in un appsit allegat Metadati dell Unità Dcumentaria Metadati Specifici: inserite linee guida per trattazine di metadati specifici strutturati e multipli AggiuntaAllegatiSync : eliminata la distinzine tra Allegat/Anness/Anntazine generic e tipizzat Prima emissine 12/01/2012 AggiuntaAllegatiSync 1.3 Intrduzine del tag <FrzaAccettazine>, <FrzaCnservazine> e <TipCnservazine> Aggirnati gli esempi di Chiamata e di Rispsta 29/06/ : Mdifica del Metadat <TipSupprtCmpnente> (sia per i cmpnenti che per i sttcmpnenti): AggiuntaAllegatiSync 1.3 rev01 la tiplgia di supprt da utilizzare nel cas in cui il cmpnente sia un riferiment a un cmpnente precedentemente versat viene rinminata in RIFERIMENTO (al pst di METADATI ) 26/11/2012 intrdtta una nuva tiplgia di supprt, Specifiche tecniche dei servizi di versament [ 7 ]

8 denminata METADATI, da utilizzare nel cas il cmpnente nn abbia un file 1.2: Mdifica del Metadat <Riferiment>: il tag risulta bbligatri nel cas in cui il Tip Supprt Cmpnente sia pari a RIFERIMENTO VersamentSync 1.3 rev02 Revisine cmpleta del dcument per allinearl al Manuale di cnservazine. Tra le nvità più rilevanti: unificazine in un unic dcument di tutte le specifiche tecniche dei servizi di versament sincrni e asincrni, definizine dei Mdelli di SIP, pubblicazine dei servizi di versament in mdalità asicnrna. Inltre: : Inserit paragraf relativ a Rapprt di versament 14/10/ : Esit versament: aggiunta gestine tag relativ al Rapprt di versament : Dettagli degli identificativi calclati dal Sistema (Urn UD, Urn Dcument, Urn Cmpnente) Revisine cmpleta del dcument per allinearl al Manuale di cnservazine. Tra le nvità più rilevanti: unificazine in un unic dcument di tutte le specifiche tecniche dei servizi di versament sincrni e asincrni, definizine dei Mdelli di SIP, pubblicazine dei servizi di versament in mdalità asicnrna. Inltre: : Integrazine dei valri accettati dal tag <TipCnservazine> 2.0 2: Aggirnata versine (1.4) web service di versament sincrni 14/10/ : Inserit paragraf relativ a Rapprt di versament : Esit versament: aggiunta gestine ulteriri warning ed errri e tag relativ al Rapprt di versament : Dettagli degli identificativi calclati dal Sistema (Urn UD, Urn Dcument, Urn Cmpnente) Specifiche tecniche dei servizi di versament [ 8 ]

9 Elenc degli XSD descritti nel presente dcument Titl e nme file Vers. Indirizz pubblicazine XSD Indice SIP Unità dcumentaria WSRequestUnic1_4.xsd XSD Indice SIP di Dcument WSRequestUnic1_4.xsd Packaging Infrmatin SIP (PI SIP) WSRequestMM.xsd XSD Indice SIP da nrmalizzare WSRequestInviOggettPreIngest.xsd Rapprt di versament RapprtVersament.xsd Esit versament WSEsitUnic.xsd Specifiche tecniche dei servizi di versament [ 9 ]

10 Dcumenti di riferiment Titl e nme file Manuale di Cnservazine Schema di Disciplinare tecnic Mdelli di AIP Specifiche tecniche dei servizi di recuper Cdifiche Errri Indirizz pubblicazine Specifiche tecniche dei servizi di versament [ 10 ]

11 Intrduzine Premessa Il presente dcument ha l scp di descrivere le specifiche dei servizi di versament espsti dal Sistema di cnservazine (Sistema) del Pl archivistic dell Emilia-Rmagna (ParER). Per eventuali apprfndimenti in merit al prcess di cnservazine e alla descrizine del Sistema, si rinvia al Manuale di Cnservazine di ParER, dispnibile sul sit di ParER ( Il dcument è articlat nel md seguente: Sezine 1 - Mdelli di SIP: sn descritti i Mdelli di SIP nrmalizzati, vver quei SIP che pssn essere versati direttamente nel Sistema. Per la descrizine dei SIP da nrmalizzare si rinvia ai singli Disciplinari tecnici; Sezine 2 - Servizi di versament in mdalità sincrna: sn illustrate le specifiche tecniche dei servizi di versament sincrni, da utilizzare per versare nel Sistema i SIP nrmalizzati descritti alla Sezine 1. In questa sezine sn descritti anche alcuni dcumenti prdtti dal Sistema nel crs del prcess di cnservazine (Rapprt di versament ed Elenc di versament), cn le relative strutture dati; Sezine 3 Servizi di versament in mdalità asincrna: sn illustrati i servizi di versament asincrni, utilizzati per versare nel Sistema i SIP da nrmalizzare; Sezine 4 - Scenari di utilizz: sn descritti alcuni dei più tipici scenari d us legati all utilizz dei servizi di versament. Avvertenze sulle mdifiche apprtate al presente dcument rispett alla versine precedente Rispett alle versini precedenti, il presente dcument ha una struttura cmpletamente diversa e dei cntenuti più ampi e articlati, ma nella sstanza le differenze relative al funzinament del servizi di versament sn minime. Per essere più precisi, le uniche mdifiche apprtate riguardan il web service VersamentSync: nella chiamata sn stati aggiunti due nuvi valri (VERSAMENTO_ANTICIPATO e VERSAMENTO_IN_ARCHIVIO) cn cui pter valrizzare il metadat TipCnservazine, mentre nella rispsta (EsitVersament) sn stati aggiunti i nuvi tag RapprtVersament (che cntiene in frma di stringa il Rapprt di versament) e WarningUlteriri ed ErrriUlteriri (che cntengn gli eventuali ulteriri errri warning rispett a quell principale rilevati dal Sistema in sede di cntrll del pacchett versat). Specifiche tecniche dei servizi di versament [ 11 ]

12 Quest cmprta che, per quanti hann già sviluppat client di versament in mdalità sincrna, le mdifiche da apprtare per adeguarsi alla versine 1.4 dei servizi di versament in mdalità asincrna sn minime, limitandsi agli interventi appena citati. Per il rest, infatti, le differenze riguardan principalmente la struttura del dcument. I due dcumenti precedenti che cntenevan le specifiche tecniche dei servizi di versament di unità dcumentaria e di aggiunta dcument, sn entrambi cnfluiti nel presente: la Sezine 1 reinterpreta la cstruzine dell XML di chiamata (di entrambi i servizi) definendl, in accrd cn le nuve Regle tecniche, cme Indice del pacchett di versament; la Sezine 2 si fcalizza invece sul funzinament dei web service che, cme dett, in questa nuva versine nn vede cambiamenti significativi rispett alle versini precedenti. Inltre, la Sezine 3 riprta le specifiche dei servizi di versament in mdalità asincrna (alla lr prima pubblicazine), mentre la Sezine 4 cntiene i casi d us prima cntenuti nei dcumenti di specifiche dei singli servizi. In tutt il dcument, infine, è stata effettuata una revisine generale della terminlgia per adeguarla sia alle nuve Regle tecniche, sia al Manuale di cnservazine di ParER. Glssari Per i termini utilizzati nel presente dcument si rimanda al Glssari di cui all Allegat 1 delle Regle Tecniche, alle definizini del D.Lgs. 82/2005 e del DPR 445/2000 e lr successive mdificazini e integrazini e al Glssari del Manuale di cnservazine. Le definizini riprtate nella presente sezine riguardan i termini specifici utilizzati nel presente dcument. Termine Applicativ versante Migrazine Oggett Sggett versante Struttura versante UML Versatre Descrizine Sistema sftware utilizzat dal Versatre per versare i SIP nel Sistema Trasferiment nel Sistema di un Unità dcumentaria prveniente da un altr sistema di cnservazine Cmpnente bbligatria del SIP da nrmalizzare Vedi Versatre Articlazine rganizzativa del Prduttre del Versatre. Ove presente crrispnde all Area Organizzativa Omgenea. Nell Indice SIP è identificat dal metadat <Struttura> in <Versatre>. Unified Mdeling Language: linguaggi grafic usat nell'ambit della prgettazine sftware, per prgettare e dcumentare un'applicazine a diversi livelli di dettagli e per diverse prspettive. Il sggett che versa materialmente i SIP nel Sistema. Generalmente cincide cn il Prduttre, ma può essere anche un sggett divers. Nei SIP nrmalizzati è identificat da un specific set di metadati. Specifiche tecniche dei servizi di versament [ 12 ]

13 XSD XML Web service Una "XML Schema Definitin" (XSD) è un esempi (instance) di schema XML scritt in linguaggi XML Schema. Una XSD definisce il tip di un dcument XML in termini di vincli Extensible Markup Language: frmat definit dal Wrld Wide Web Cnsrtium per l interscambi di dcumenti e dati strutturati su Internet. Sistema sftware prgettat per supprtare l'interperabilità tra diversi sistemi in una medesima rete ppure in un cntest distribuit. (Fnte: Wikipedia) Specifiche tecniche dei servizi di versament [ 13 ]

14 Sez. 1 Mdelli di Pacchetti di versament (SIP) I SIP si dividn in due macr categrie: SIP nrmalizzati e SIP nn nrmalizzati. I SIP nrmalizzati sn gli unici SIP accettati direttamente dal Sistema e sn versati utilizzand i Servizi di versament sincrni descritti nella Sez. 2. Devn rispettare una determinata struttura dati valida per tutte le tiplgie dcumentarie e sn cmpsti da da due elementi: INDICE SIP: un dcument XML che cntiene le infrmazini descrittive dell ggett versat (Metadati di identificazine, Metadati di struttura, Metadati di prfil archivistic, Metadati di prfil generali, Metadati di prfil specifici) e i Parametri di versament. Nel cas in cui il SIP sia versat dal Sistema al termine del prcess di Preacquisizine, ltre all Indice SIP è versat anche il PI SIP (Packaging infrmatin SIP), un dcument XML che cntiene le infrmazini per il Sistema sulla cllcazine degli Oggetti-dati da assciare all Indice SIP; OGGETTO-DATI: una sequenze di bit (tipicamente in frma di file) da sttprre a cnservazine. È sempre trasmess cntestualmente all Indice SIP, tranne nel cas in cui il SIP è versat a seguit di nrmalizzazine al termine della fase di Preacquisizine: in quest cas gli Oggetti-dati nn sn versati cntestualmente all Indice SIP ma sn recuperati dal Sistema sulla base delle infrmazini frnite nel PI SIP. A secnda del mdell di SIP utilizzat e delle sue caratteristiche, il SIP ptrebbe essere cmpst sl dall Indice SIP, e quindi l Oggett-dati ptrebbe nn essere presente pacchett di versament. I SIP nn nrmalizzati sn SIP che il Prduttre trasmette al Sistema quand, per ragini tecniche d rganizzative, nn è in grad di prdurre e versare SIP nrmalizzati. Questi SIP, le cui strutture dati pssn differire mlt tra lr e per quest devn essere cncrdate di vlta in vlta cn il Prduttre, per essere versati nel Sistema devn essere rielabrati per essere trasfrmati in SIP nrmalizzati. Tale prcess di rielabrazine è chiamat nrmalizzazine ed è eseguit durante la fase di Preacquisizine del prcess di cnservazine (per ulteriri infrmazini vedi la Sezine 4 del Manuale di cnservazine). Sn versati utilizzand i servizi di versament asincrni. Sia per i SIP nrmalizzati che per quelli nn nrmalizzati, sn previsti diversi Mdelli di Pacchett di versament, definiti in base agli ggetti da prtare in cnservazine, alle caratteristiche dei sistemi del Prduttre che li gestiscn e alle mdalità di versament utilizzate. Un inquadrament generale sulla struttura dei SIP da nrmalizzare è cntenuta nel paragraf 1.5, mentre i vari mdelli di SIP da nrmalizzare sn descritti nel dettagli nel singli Disciplinare tecnici, dve ne sn illustrate sia le caratteristiche specifiche, sia le perazini di nrmalizzazine cui sn sttpsti. Specifiche tecniche dei servizi di versament [ 14 ]

15 I Mdelli di SIP nrmalizzati, descritti nei paragrafi seguenti, a secnda dell ggett cntenut, sn i seguenti: SIP di Unità Dcumentaria; SIP di Dcument; SIP di Metadati; SIP di Unità Archivistica. Per una descrizine dei cncetti di Unità archivistica, Unità dcumentaria e Dcument si rimanda al Manuale di cnservazine (in particlare al Glssari e alla Sezine 3) SIP di Unità dcumentaria Il SIP di Unità dcumentaria è il pacchett di versament che cntiene un Unità dcumentaria da versare nel Sistema. È cmpst dall Indice SIP e da un più Oggetti-dati, anche se ci sn casi particlari in cui il SIP può nn cntenere Oggetti-dati (ad esempi, Unità dcumentaria di cui esiste sl l riginale cartace), per cui il SIP è cmpst unicamente dall Indice. Più in dettagli, gli elementi che cmpngn il SIP di un Unità dcumentaria sn i seguenti: Element del SIP Indice SIP Oggett-dati PI SIP Descrizine È un dcument in frmat XML prdtt stt la respnsabilità del Prduttre che cntiene i metadati dell Unità dcumentaria, nnché i parametri di versament. La descrizine dettagliata dell Indice e la sua struttura dati sn riprtate nel paragraf del presente dcument È la sequenza di bit, nrmalmente in frma di file, che cstituisce l ggett della cnservazine. È descritt nell Indice SIP a livell di Cmpnente dell Unità dcumentaria. È un dcument in frmat XML prdtt e versat dal Sistema che cntiene le Infrmazini sull impacchettament (Packaging Infmatin) Nte È sempre presente Nel SIP pssn essere presenti un più Oggetti-dati, ma in alcuni casi l Oggett-dati può nn essere presente (ad esempi, se il SIP cntiene sl metadati, cme nel cas di un Unità dcumentaria esistente sl in riginale cartace) È presente sl in cas di versament dei SIP nrmalizzati nel prcess Specifiche tecniche dei servizi di versament [ 15 ]

16 relativi ai SIP versati nel Sistema al termine del prcess di Preacquizine in mdalità asincrna. La descrizine dettagliata del PI SIP e la sua struttura dati sn riprtate nel paragraf del presente dcument. di Preacquisizine La seguente figura illustra in un diagramma UML la struttura del SIP di Unità dcumentaria. Il SIP di Unità dcumentaria è versat nel Sistema: Specifiche tecniche dei servizi di versament [ 16 ]

17 dal Prduttre/Versatre utilizzand i Servizi di versament sincrni, descritti alla Sez. 2; dal Sistema stess al termine del prcess di Preacquisizine, qualra il SIP sia stat generat a seguit di nrmalizzazine Indice del SIP di Unità dcumentaria L Indice del SIP di Unità dcumentaria è un dcument in frmat XML creat stt la respnsabilità del Prduttre. Cntiene i metadati che descrivn cntenut e struttura dell Unità dcumentaria, che, secnd quant riprtat nel paragraf 3.3 del Manuale di cnservazine, pssn essere suddivisi nelle seguenti categrie: Metadati di identificazine: identifican univcamente le Unità dcumentarie e includn i dati identificativi del Prduttre e i dati di registrazine riginari, nnché gli identificativi specifici di gni element dell Unità dcumentaria (Dcumenti e Cmpnenti); Metadati di struttura: descrivn la struttura dell Unità dcumentaria indicand il numer e la tiplgia di Allegati, Annessi e Anntazini che la cmpngn, nnché, per gnun di essi, il numer e la tiplgia dei Cmpnenti; Metadati di prfil archivistic: descrivn il Fascicl e più in generale la cllcazine dell Unità dcumentaria nel cntest dell archivi del Prduttre. Ricmprendn anche i metadati che cllegan l Unità dcumentaria ad altre Unità dcumentarie cnservate nel sistema (Cllegamenti); Metadati di prfil generali: individuan gli elementi descrittivi essenziali cmuni a tutte le tiplgie di Unità dcumentarie e relativi elementi; Metadati di prfil specifici: individuan elementi descrittivi ulteriri rispett a quelli previsti nel prfil generale. Sn definiti per gni tiplgia di Unità dcumentaria e per gni Prduttre; Metadati di cnservazine: qualra l Unità dcumentaria prvenga da altri sistemi di cnservazine frniscn le infrmazini relative al prcess di cnservazine di cui le Unità dcumentarie sn state ggett prima di essere versate nel Sistema. L Indice SIP, inltre, cntiene i c.d. Parametri di versament, un set di infrmazini finalizzate a determinare le mdalità cn cui il Sistema accetta i SIP versati in funzine degli esiti dei cntrlli effettuati al mment del versament, nnché l specific prcess di cnservazine a cui devn essere sttpste le Unità dcumentarie versate. La struttura dati dell Indice del SIP di Unità dcumentaria riflette la struttura dell Unità dcumentaria quale unità minima cstituente l archivi del Prduttre. L Unità dcumentaria è cmpsta da un più Dcumenti. Tali Dcumenti cstituiscn gli Elementi di cui si cmpne l Unità dcumentaria, definiti in base alla funzine che svlgn: Dcument principale: cstituisce il cntenut primari dell Unità dcumentaria. È un e deve essere sempre bbligatriamente presente; Specifiche tecniche dei servizi di versament [ 17 ]

18 Allegat: integra le infrmazini cntenute nel Dcument principale. Pssn essercene più di un ma la lr presenza è facltativa; Anness: frnisce ulteriri infrmazini a crred del Dcument principale e generalmente è prdtt in un mment successiv. Pssn essercene più di un ma la lr presenza è facltativa; Anntazine: riprta gli elementi identificativi dell Unità dcumentaria e del su iter dcumentale (ad esempi, la segnatura di prtcll). Pssn essercene più di un ma la lr presenza è facltativa. A sua vlta, gni Dcument (Principale, Allegat, Anness, Anntazine) può cntenere varie Strutture. Ogni Struttura ha un prpri Tip Struttura che definisce semantica, natura e articlazine del Dcument in Cmpnenti. In altre parle, gni Dcument è cstitut da un più Cmpnenti il cui numer, natura e semantica è definita da un specific Tip struttura. I Cmpnenti descrivn l Oggett delle cnservazine, che nrmalmente è digitale (Oggettdati), ma che in determinati casi può nn essere presente nel SIP in quant nn digitale, cme nel cas, ad esempi, di un dcument presente nell archivi del Prduttre sl in riginale cartace (in questi casi il Cmpnente descrive un c.d. Oggett materiale 1 ). Ogni Cmpnente può cntenere un più Sttcmpnenti che descrivn Oggetti-dati (tipicamente file) strettamente crrelati al Cmpnente (ad esempi una marca temprale una firma digitale detached). Ogni Cmpnente è descritt da una serie di attributi: Tip Supprt: iidentifica il supprt del Cmpnente. I supprti individuati sn: FILE: indica che la sequenza di bit dell Oggett-dati è un file; METADATI: indica che il SIP è cstituit sl dall Indice SIP (nn ci sn Oggettidati) RIFERIMENTO: indica che l Oggett-dati descritt nel Cmpnente è estern all Unità dcumentaria e che deve essere indicat il riferiment (Chiave) per accedervi; Tip Cmpnente: identifica la natura dell Oggett-dati. I valri attualmente utilizzati sn: Cntenut: indica che il Cmpnente il Sttcmpnente è riferit al file del cntenut del dcument; Firma: indica che il Sttcmpnente è riferit al file che cntiene la firma (detached); Marca: indica che il Sttcmpnente è riferit al file che cntiene la marca temprale (detached); Rappresentazine: indica che il Cmpnente il Sttcmpnente è riferit al file cntiene una rappresentazine del cntenut del dcument; 1 Cfr. ISO 14721:2012: Space data and infrmatin transfer systems - Open archival infrmatin system - Reference mdel, OAIS (Open Archival Infrmatin System), Sistema infrmativ apert per l'archiviazine Specifiche tecniche dei servizi di versament [ 18 ]

19 Fgli di trasfrmazine: indica che il Cmpnente il Sttcmpnente è riferit al file che cntiene il fgli di trasfrmazine, da utilizzare per rappresentare il cntenut del dcument; Frmat: se il Tip Supprt è FILE, il file presente nel Cmpnente avrà un prpri frmat, che cstituisce parte dell Infrmazine sulla rappresentazine; Tip rappresentazine: identifica la mdalità che permette di rappresentare l Oggett-dati versat. Di seguit sn descritti alcuni esempi di Cmpnenti. Struttura A Questa struttura si cmpne di un sl Cmpnente C1 di tip file che rappresenta il cntenut. In quest cas nn è necessari indicare il tip di rappresentazine Cmpnenti Tip Supprt C1 File Cntenut pdf Tip Cmpnente Frmat File Tip Rappresentazine Struttura B Questa struttura si cmpne di un Cmpnente C1 di tip file che rappresenta il cntenut e di un Cmpnente C2 di tip Rappresentazine che indica che tale Cmpnente è una rappresentazine del cntenut del Cmpnente C1. Anche in quest cas nn è necessari indicare il tip di rappresentazine Cmpnenti Tip Supprt C1 File Cntenut xml C2 File Rappresentazine pdf Tip Cmpnente Frmat File Tip Rappresentazine Struttura C Questa struttura si cmpne di un Cmpnente C1 che rappresenta il cntenut, di un Cmpnente C2 (Sttcmpnente) di tip dati che cnsente di referenziare il file cntenut al relativ cnvertitre (versat in precedenza). Nell esempi è stat inltre inserit un terz Cmpnente C3 di tip firma, cntenente una firma detached del file del Cmpnente C1. Cmpnenti Tip Supprt Tip Cmpnente Frmat File Tip Rappresentazine C1 File Cntenut XML Trasfrmazine XML cn XSLT C2 (Sttcmpnente) C3 (Sttcmpnente) Riferiment Fgli di - - trasfrmazine File Firma p7s - Specifiche tecniche dei servizi di versament [ 19 ]

20 Struttura D Questa struttura si cmpne di un Cmpnente C1 la cui rappresentazine del file XML risulta embedded al file XML stess. È inltre presente un Cmpnente C2 che rappresenta un Sttcmpnente cntenente una marca temprale riferita al Cmpnente C1. Cmpnenti Tip Supprt Tip Cmpnente Frmat File Tip Rappresentazine C1 File Cntenut XML Trasfrmazine XML cn XSLT C2 (Sttcmpnente) File Marca tsr - Struttura E In quest esempi viene versat sia il Cmpnente C1 di tip cntenut, indicand che per la rappresentazine ccrre utilizzare il Cmpnente C2 Cmpnenti Tip Supprt Tip Cmpnente Frmat File Tip Rappresentazine C1 File Cntenut XML Trasfrmazine XML cn XSLT C2 (Sttcmpnente) File Fgli di trasfrmazine XSLT - L Unità Dcumentaria è identificata univcamente nel Sistema dalla terna di valri TIPO REGISTRO-ANNO-NUMERO (es.: DELIBERE ), mentre i Dcumenti sn identificati univcamente nel Sistema cn una chiave generata a partire da quella dell Unità dcumentaria cui appartengn, alla quale viene aggiunt un suffiss indicante l Element (PRINCIPALE, ALLEGATO, ANNESSO ANNOTAZIONE) e il prgressiv all intern di tale Element. A lr vlta i Cmpnenti sn identificati cn una cppia di cifre che definiscn la Struttura (1 sta a indicare la StrutturaOriginale, vver la struttura utilizzata dal Prduttre nel versare il SIP in cnservazine) e l Ordine di presentazine del Cmpnente (che definisce in quale rdine i Cmpnenti del Dcument devn essere rappresentati). Nella tabella seguente riprtiam a m di esempi la struttura dell Unità dcumentaria della Delibera n. 45 del 2011 (cn i Dcumenti cmpsti tutti da un unic Cmpnente ad eccezine dell Anness 1 che ne ha due) e dei relativi identificativi univci dei Dcumenti e dei Cmpnenti utilizzati nel Sistema. Element Dcument principale Identificativ Dcument Numer d rdine Cmpnente DELIBERE PRINCIPALE 1 Allegat 1 DELIBERE ALLEGATO-1 1 Identificativ Cmpnente DELIBERE PRINCIPALE:1:1 DELIBERE ALLEGATO-1:1:1 Specifiche tecniche dei servizi di versament [ 20 ]

21 1 Anness 1 DELIBERE ANNESSO-1 2 Anntazine 1 DELIBERE ANNOTAZIONE-1 1 DELIBERE ANNESSO-1:1:1 DELIBERE ANNESSO-1:1:2 DELIBERE ANNOTAZIONE-1:1:1 Nella figura seguente è riprtat il diagramma della struttura dell Indice SIP di un Unità dcumentaria. Nella tabella seguente è descritta la macrstruttura dell Indice SIP di Unità dcumentaria. La prima clnna riprta la denminazine dei macr tag nell schema XML dell Indice, la secnda la descrizine, la terza il livell della struttura dell Indice SIP cui il macr tag afferisce (Unità dcumentaria, Dcument, Cmpnente) e l ultima il riferiment alla categria di metadati descritte in precedenza. Schema XML Descrizine Livell struttura Indice SIP Categria di metadati Specifiche tecniche dei servizi di versament [ 21 ]

22 <Intestazine> </Intestazine> <Cnfigurazine> </Cnfigurazine> <PrfilArchivistic> </PrfilArchivistic> <PrfilUnitaDcumentaria> </PrfilUnitaDcumentaria> <DatiSpecifici> </DatiSpecifici> <DatiSpecificiMigrazine> </DatiSpecificiMigrazine> <DcumentiCllegati> </DcumentiCllegati> <Numer_Allegati> </Numer_Allegati> <Numer_Annessi> </ Numer_Annessi> <Numer_Anntazini> </Numer_Anntazini> <IDDcument> </IDDcument> <TipDcument> </TipDcument> Metadati che permettn di identificare univcamente il Sggett Versante, la Chiave e la tiplgia dell Unità dcumentaria versata. Parametri che permettn di determinare le mdalità (frzature) cn cui il Sistema accetta le Unità dcumentarie e il particlare prcess di cnservazine a cui sttprle Metadati che cnsentn di descrivere il cntest archivistic dell Unità Dcumentaria Metadati descrittivi cmuni a tutte le tiplgie di Unità dcumentaria Metadati descrittivi specifici per una data tiplgia di Unità Dcumentaria Metadati specifici per una data tiplgia di Unità dcumentaria che frniscn infrmazini relative al prcess di cnservazine cui è stata sttpsta in precedenza Metadati che descrivn gli eventuali cllegamenti esistenti tra l Unità dcumentaria ggett di versament e altre Unità dcumentaria (che pssn essere men già presenti nel Sistema). Numer di dcumenti Allegati dell Unità dcumentaria Numer di dcumenti Annessi dell Unità dcumentaria Numer di dcumenti Anntazini dell Unità dcumentaria Identificativ del Dcument (Principale, Allegat, Anness e Anntazine). Unità dcumentaria Unità dcumentaria Unità dcumentaria Unità dcumentaria Unità dcumentaria Unità dcumentaria Unità dcumentaria Unità dcumentaria Unità dcumentaria Unità dcumentaria Dcument Identificazine Parametri di versament Prfil archivistic Prfil generali Prfil specifici Cnservazine Prfil archivistic Struttura Struttura Struttura Identificazine Tiplgia del dcument. Dcument Identificazine Specifiche tecniche dei servizi di versament [ 22 ]

23 <PrfilDcument> </PrfilDcument> Metadati descrittivi cmuni a tutte le tiplgie di Dcument Dcument Prfil generale <DatiSpecifici> </DatiSpecifici> Metadati descrittivi specifici per una data tiplgia di Dcument Dcument Prfil specifici <DatiSpecificiMigrazine> </DatiSpecificiMigrazine> Metadati specifici per una data tiplgia di Dcument che frniscn infrmazini relative al Dcument sull eventuale prcess di cnservazine cui è stata sttpst in precedenza Dcument Cnservazine <DatiFiscali> Deprecat. Per la trattazine della dcumentazine rilevante ai fini fiscali si rimanda al paragraf Dcument <StrutturaOriginale> </StrutturaOriginale> Infrmazini sulla struttura del Dcument versat Dcument Struttura <Cmpnenti> </Cmpnenti> Infrmazini sui Cmpnenti in cui si articla il Dcument, inclus il frmat. Può cntenere infrmazini sugli eventuali Sttcmpnenti Cmpnente Struttura e Identificazine L XSD dell Indice SIP di Unità dcumentaria è pubblicat sul sit di ParER (vedi paragraf Elenc degli XSD descritti nel presente dcument ). Nei paragrafi seguenti sn descritti le single macrclassi di metadati, suddivise per i livelli in cui si articla l Indice SIP (Unità dcumentaria, Dcument, Cmpnente). Per gni metadat dell Indice SIP sn riprtate le seguenti infrmazini: Nme metadat: la denminazine del metadat csì cme definita nell XSD dell Indice SIP; Descrizine: descrizine del metadat, inclusi esempi di valrizzazine, valri assunti, ecc.; Obbligatrietà: indica se il metadat è bbligatri men; Dimensine Massima: indica il numer massim di caratteri che pssn essere inseriti nel relativ tag. Nn è stata indicata nel cas di valri bleani e di tag che accettan sl valri predefiniti. I campi pzinali, se vuti, nn devn essere inseriti nel file XML cme tag vuti. Quindi nn sarà accettat, per esempi: <PrfilArchivistic> <FasciclPrincipale> <Classifica>1.0.0</Classifica> </FasciclPrincipale> Specifiche tecniche dei servizi di versament [ 23 ]

24 <FascicliSecndari> <FasciclSecndari/> Errre: i tag nn valrizzati nn devn essere inseriti nell XML </PrfilArchivistic> Metadati di <UnitàDcumentaria> Intestazine Si tratta di un tag bbligatri che cntiene le infrmazini che identifican univcamente il Sggett versante e l Unità dcumentaria cntenuta nel SIP. Nme metadat Descrizine OBBL Versine Indica la versine dell XSD cn cui è validat l Indice SIP. Deve cincidere cn il tag VERSIONE utilizzat nella request del servizi di versament utilizzat (vedi paragraf 2.1.2). La versine più recente è 1.4. Dim. max X 100 Ambiente Identificativ dell'ambiente, assegnat da ParER. X 100 Ente Identificativ del Sggett versante, assegnat da ParER. X 100 Versatre Struttura Identificativ della struttura che nell ambit dell Ente è cmpetente per il versament del SIP, assegnat da ParER. Dve presente è valrizzat cn il cdice dell Area Organizzativa Omgenea presente nell Indice PA. X 100 UserID Identificativ dell Applicativ versante assegnat da ParER. Deve cincidere cn il tag LOGINNAME utilizzat nella request del servizi di versament utilizzat (vedi paragraf 2.1.2). X 100 Numer Numer cdice identificativ dell Unità dcumentaria. Deve essere univc nell ambit del TipRegistr e dell Ann. X 100 Chiave Ann Ann di prduzine del dcument. X 4 TipRegistr TiplgiaUnitaDcumentaria Cdice del Registr, Repertri altr in cui è registrata l Unità dcumentaria. È cncrdat cn ParER. Identifica la tiplgia di Unità dcumentaria. È cncrdata cn ParER X 100 X Cnfigurazine È un tag pzinale che definisce i Parametri di versament. Specifiche tecniche dei servizi di versament [ 24 ]

25 Nme metadat Descrizine OBBL Definisce il particlare prcess di cnservazine gestit nel Sistema. Assume i valri: Dim. max VERSAMENTO_ANTICIPATO; FISCALE; MIGRAZIONE; VERSAMENTO_IN_ARCHIVIO; SOSTITUTIVA (DEPRECATO). Valre default: VERSAMENTO ANTICIPATO. VERSAMENTO_ANTICIPATO: definisce il prcess di cnservazine relativ a single Unità dcumentarie che pssn trvarsi ancra nella fase attiva del lr cicl di vita. TipCnservazine FISCALE: definisce il prcess di cnservazine finalizzat all asslviment degli bblighi fiscali relativi ai dcumenti infrmatici, secnd quant dispst dal DMEF 17 giugn MIGRAZIONE: definisce il prcess di cnservazine relativ a Unità dcumentarie già sttpste a prcess di cnservazine in un altr sistema. VERSAMENTO_IN_ARCHIVIO: definisce il prcess di cnservazine per le Unità archivistiche (ad esempi, fascicli) altre aggregazini dcumentali. Nn si applica in nessun cas ai SIP di Unità dcumentarie. SOSTITUTIVA: definisce il tip di cnservazine previst dalla Delibera CNIPA 11/2004, nn più in vigre cn l entrata in vigre delle nuve regle tecniche (DPCM 3 dicembre 2013). Il su utilizz è deprecat e deve essere sstituit cn il valre VERSAMENTO_ANTICIPATO. Specifiche tecniche dei servizi di versament [ 25 ]

26 SistemaDiMigrazine FrzaCnservazine FrzaAccettazine Stringa indicante il nme del sistema di cnservazine in cui l Unità dcumentaria è stata cnservata. Deve essere indicat nel cas in cui <Tip Cnservazine> sia settat a Migrazine. Definisce il cmprtament del Sistema in relazine al versament di SIP cntenenti file nn firmati. Assume valri False True. Valre di default: False. False: il Sistema accetta il versament dell Unità Dcumentaria sl se è presente almen un file firmat. True: il Sistema accetta il versament dell Unità dcumentaria anche nel cas in cui nessun dei file sia firmat. Definisce il cmprtament del Sistema in relazine agli esiti delle verifiche di firma e/ frmat dei file cntenuti nel SIP. Assume valri False True. Valre di default: False. False: il Sistema accetta il versament dell Unità dcumentaria sl se tutti i cntrlli relativi alla firma e al frmat hann esit psitiv. True: il Sistema accetta il versament dell Unità dcumentaria anche nel cas in cui almen un dei cntrlli relativi alla firma e al frmat hann esit negativ. X Se TipCnser vazine = Migrazine 100 NB: il Sistema cnsente, tramite la cnfigurazine di pprtuni parametri, di limitare i casi in cui pera la frzatura dell accettazine (vedi paragraf 2.2.2). Definisce il cmprtament del Sistema in funzine della presenza men nel Sistema stess delle Unità dcumentarie ggett di cllegament. Assume valri False True. Valre di default: False. FrzaCllegament False: il Sistema accetta il versament di Unità dcumentarie i cui eventuali Cllegamenti sian rivlti a Unità dcumentarie già presenti nel Sistema. True: il Sistema accetta il versament di Unità dcumentarie anche nel cas in cui gli eventuali Cllegamenti sian rivlti a Unità dcumentaria nn presenti nel Sistema. Specifiche tecniche dei servizi di versament [ 26 ]

27 SimulaSalvataggiDatiInDB Definisce il cmprtament del Sistema in rdine al salvataggi dei SIP versati, cnsentend, a sli fini di test, di simulare un versament senza che il relativ SIP venga memrizzat nel Sistema. Assume valri False True. Valre di default: False. False: il Sistema memrizza il SIP versat True: il Sistema, pur inviand al sistema versante la rispsta al versament effettuat (Esit versament), nn esegue il salvataggi dell Unità dcumentaria versata, né dei relativi file. Prfil Archivistic È un tag pzinale che definisce le infrmazini di classificazine e fasciclazine dell Unità dcumentaria cntenuta nel SIP. Nme metadat Descrizine OBBL FasciclPrincipale In quest macr tag sn incluse le infrmazini relative alla Classifica principale, al Fascicl principale e all eventuale Sttfascicl cui appartiene l Unità dcumentaria. È pssibile valrizzare sl la Classifica e nn i campi descrittivi del Fascicl nel cas l Unità dcumentaria sia stata sl classificata e nn fasciclata. Classifica: cdice cn cui l Unità dcumentaria è classificata in base al pian di classificazine titlari in us press il Prduttre. Es: 1.2; 1; Fascicl: fascicl di appartenenza dell Unità dcumentaria. Si cmpne di: Identificativ: identificativ del Fascicl cstruit nrmalmente da una stringa cmpsta da Classifica/Ann del fascicl/numer del fascicl Dim. max Oggett: ggett del fascicl 1024 SttFascicl: Sttfascicl di appartenenza dell Unità dcumentaria. Si cmpne di: Specifiche tecniche dei servizi di versament [ 27 ]

28 FascicliSecndari (cntiene n tag FasciclSecndari) Identificativ: identificativ del Sttfascicl cstruit nrmalmente da una stringa cmpsta da Identificat del fascicl/ann del Sttfascicl/Numer del Sttfascicl 100 Oggett: ggett del Sttfascicl 1024 In quest macr tag sn incluse le infrmazini relative alle eventuali Classifiche secndarie, Fascicli e Sttfascicli secndari in cui sia stata classificata fasciclata l Unità dcumentaria. Cme nel cas del Fascicl principale, è pssibile valrizzare sl la Classifica (secndaria) e nn i campi descrittivi del Fascicl (secndari) nel cas l Unità dcumentaria sia stata sl Classificata e nn fasciclata. Inltre è pssibile gestire il cas in cui un Unità dcumentaria sia stata inserita in più fascicli, ripentend nel tag <FascicliSecndari> tanti tag <FasciclSecndari> quanti sn i fascicli secndari. Classifica: vedi tag <Classifica> in <FasciclPrincipale> Fascicl: vedi tag <Fascicl> in <FasciclPrincipale> Si cmpne di: Identificativ: vedi tag <Identificativ> in <Fascicl> di <FasciclPrincipale> Oggett: vedi tag <Oggett> in <Fascicl> di <FasciclPrincipale> SttFascicl: vedi tag <SttFascicl> in <FasciclPrincipale>. Si cmpne di: Identificativ: vedi tag <Identificativ> in <Sttfascicl> di <FasciclPrincipale> Identificativ: vedi tag <Oggett> in <SttFascicl> di <FasciclPrincipale> Alcuni esempi: 1) Valrizzazine della classifica e dell identificativ del fascicl principale: <PrfilArchivistic> <FasciclPrincipale> <Classifica>3.2.2</Classifica> <Fascicl> <Identificativ>3.2.2/2011/1</Identificativ> <Oggett>Cstruzine strada XXX</Oggett> </Fascicl> <SttFascicl> <Identificativ>3.2.2/2011/1/1</Identificativ> Specifiche tecniche dei servizi di versament [ 28 ]

29 <Oggett>Esprpri XXX</Oggett> </SttFascicl> </FasciclPrincipale> </PrfilArchivistic> 2) Valrizzazine della sla classifica <PrfilArchivistic> <FasciclPrincipale> <Classifica>1.2.4</Classifica> </FasciclPrincipale> <FascicliSecndari> <FasciclSecndari> <Classifica>2.5.7</Classifica> </FasciclSecndari> </FascicliSecndari> </PrfilArchivistic> 3) Valrizzazine del fascicl principale e dei fascicli secndari: <PrfilArchivistic> <FasciclPrincipale> <FasciclPrincipale> <Classifica>3.2.2</Classifica> <Fascicl> <Identificativ>3.2.2/2011/1</Identificativ> <Oggett>Cstruzine strada XXX</Oggett> </Fascicl> <SttFascicl> <Identificativ>3.2.2/2011/1/1</Identificativ> <Oggett>Esprpri XXX</Oggett> </SttFascicl> </FasciclPrincipale> <FascicliSecndari> <FasciclSecndari> <Classifica>9.2.4</Classifica> <Fascicl> <Identificativ>9.2.4/2011/2</Identificativ> <Oggett>Cntenzis XXX</Oggett> </Fascicl> </FasciclSecndari> <FasciclSecndari> <Classifica>2.1</Classifica> <Fascicl> <Identificativ>2.1/2011/3</Identificativ> <Oggett>Incarichi a legali</oggett> </Fascicl> Specifiche tecniche dei servizi di versament [ 29 ]

30 <SttFascicl> <Identificativ>2.1/2011/3/1</Identificativ> <Oggett>Incaric a legale XXX</Oggett> </SttFascicl> </FasciclSecndari> </FascicliSecndari> </PrfilArchivistic> Prfil Unità dcumentaria È un tag che cntiene i metadati di prfil generali, cmuni a tutte le tiplgie di Unità dcumentaria. Nme metadat Descrizine OBBL Dim. max Oggett Oggett dell Unità dcumentaria 1024 Data Cartace Data dell Unità dcumentaria Deprecat Dati specifici È il tag che cntiene i metadati di prfil specifici per la tiplgia dcumentaria identificata dal metadat TiplgiaUnitaDcumentaria (in Intestazine). In base alla tiplgia di Unità dcumentaria definita, è pssibile inserire nell Indice SIP dei metadati specifici, indicand la versine di riferiment. La dimensine massima cnsentita per la valrizzazine di gni singl metadat specific è di 4000 byte: vviamente nell XSD riferit alla specifica Tiplgia di Unità dcumentaria pssn essere impstati limiti più restrittivi (per esempi inserire un numer massim di 11 caratteri per il metadat specific che descrive la Partita Iva, etc). Se la Tiplgia di Unità dcumentaria prevede metadati specifici, è bbligatri indicare nell Indice del SIP il tag <DatiSpecifici> e la versine (<VersineDatiSpecifici>). Se la Tiplgia di Unità dcumentaria nn prevede dati specifici, il tag <DatiSpecifici> nn deve cmparire nella request XML. Nel Sistema i metadati specifici sn definiti cme una lista flat di attribut/valre, ed il valre nn può cntenere altri element. Per gestire Metadati specifici strutturati multipli, cme per esempi più cntraenti nella gestine dei cntratti (e più in generale più firmatari di un qualsiasi att), cn indicazine, per gni cntraente, di nminativ/ragine sciale, CF/PIVA, e dmicili, più destinatari di un dcument prtcllat cn indicazine, per gni destinatari, di nminativ/ragine sciale, CF/PIVA e indirizz di spedizine, è pssibile utilizzare una delle seguenti mdalità: Specifiche tecniche dei servizi di versament [ 30 ]

31 Questa sluzine, preferibile, prevede di inserire tale metadat cme element indentat utilizzand il c.d XML escaping 2, che cnsiste nel cdificare i caratteri "<", ">" e "&" in md che vengan interpretati cme semplice stringa. Ad esempi il metadat specific strutturat e multipl <cntraenti> verrà valrizzat nel md seguente: <cntraenti> <cntraente> <nme>pal Rssi</nme> <cf>cppmrzxxxxx</cf> </cntraente><cntraente> <nme>michele Bianchi</nme> <cf>csgcrsxxxxx</cf> </cntraente> </cntraenti> In quest cas la visualizzazine del valre dell'attribut nel Sistema risulta perfettamente leggibile (nell'interfaccia web il valre < viene autmaticamente visualizzat cn "<"). Nn si perde la semantica del dat, che ptrà essere trattat in maniera autmatica in base alle necessità che dvesser emergere in futur; Questa sluzine cnsiste nell usare dei campi stringa in cui cncatenare i diversi valri, cn marcatri di separazine. I separatri usati cmunemente sn: la virgla "," (mutuand l standard csv) cme separatre di camp e il punt e virgla ; cme separatre di recrd il circnfless "^" (utilizzat in particlare nell standard DICOM) cme separatre di camp ed il dppi circnfless "^^" cme separatre di recrd. Cn questa sluzine si riesce a rappresentare sl dati in frma tabellare, di cui si perde la semantica. Dati specifici migrazine Si tratta di un tag pzinale che cnsente, nel cas in cui il TipCnservazine sia valrizzat cn Migrazine, di definire i metadati specifici relativi alla migrazine (ciè al trasferiment da altr sistema di cnservazine) dell Unità dcumentaria nel Sistema. Quest macr tag andrà valrizzat sl nel cas in la migrazine preveda dei dati specifici dell Unità Dcumentaria relativi al prcess di cnservazine cui è stata sttpsta. In quest cas è bbligatri indicare il tag <DatiSpecificiMigrazine> e la versine (<VersineDatiSpecifici>). Dcumenti cllegati Si tratta di un tag pzinale che cnsente di definire il cllegament dell Unità dcumentaria cntenuta nel SIP ad altre Unità dcumentarie precedentemente versate nel Sistema che l sarann in futur (in quest ultim cas è necessari valrizzare il parametr FrzaCllegament cn True, cme descritt nel paragraf Cnfigurazine). Nme metadat Descrizine OBBL Dim. max 2 Per maggiri infrmazini vedi Specifiche tecniche dei servizi di versament [ 31 ]

32 ChiaveCllegament DescrizineCllegament Numer Ann TipRegistr Numer cdice dentificativ dell Unità dcumentaria da cllegare. Ann di prduzine dell Unità dcumentaria da cllegare Cdice del Registr, Repertri altr in cui è registrata l Unità dcumentaria da cllegare Descrizine del cllegament (ad esempi, in cas il Cllegament si riferisca a una catena dcumentale, ptrebbe essere valrizzat cn Precedente Successiv Catena dcumentale) Numer allegati, Numer annessi e Numer anntazini Nme metadat Descrizine OBBL Dim. max NumerAllegati NumerAnnessi NumerAnntazini Rappresenta il numer di allegati. Assume valre 0 se nn sn presenti allegati; nel cas sian presenti allegati il valre è pari al numer di allegati presenti. Valre di default: 0 Rappresenta il numer di annessi. Assume valre 0 se nn sn presenti annessi; nel cas sian presenti annessi il valre è pari al numer di annessi presenti. Valre di default: 0 Rappresenta il numer di anntazini. Assume valre 0 se nn sn presenti anntazini; nel cas sian presenti anntazini il valre è pari al numer di anntazini presenti. Valre di default: Metadati di Dcument (<Dcument principale>, <Allegati>, <Annessi> e <Anntazini>) ID dcument e Tip dcument Sn tag bbligatri che identifican il Dcument nel cntest dell Unità dcumentaria. Nme metadat Descrizine OBBL Dim. max IDDcument TipDcument Rappresenta l identificativ del dcument assegnat dal Prduttre. Deve essere univc all intern della stessa Unità Dcumentaria. Rappresenta la tiplgia del dcument. È cncrdata cn ParER X 100 Specifiche tecniche dei servizi di versament [ 32 ] X

33 Prfil dcument È un tag che cntiene i metadati di prfil generali, cmuni a tutte le tiplgie Dcument. Nme metadat Descrizine OBBL Dim. max Descrizine Descrizine del Dcument 1024 Autre Autre del Dcument (clui che ha la respnsabilità del cntenut del Dcument) 4000 Dati specifici È il tag che cntiene i metadati di prfil specifici per una determinata tiplgia di Dcument identificata dal metadat TipDcument. In base alla tiplgia definita, è pssibile inserire nell Indice SIP dei metadati specifici, indicand la versine di riferiment. Se la Tiplgia di Dcument prevede metadati specifici, è bbligatri indicare nell Indice del SIP il tag <DatiSpecifici> e la versine (<VersineDatiSpecifici>). Se la Tiplgia di Dcument nn prevede dati specifici, il tag <DatiSpecifici> nn deve cmparire nella request XML. Per gni ulteriri dettagli sulla gestine dei Dati specifici di Dcument, inclusa la gestine di metadati specifici strutturati e multipli, si rimanda a quant descritt nel paragraf Dati specifici dell Unità dcumentaria. Dati specifici migrazine Si tratta di un tag pzinale che cnsente di definire i dati specifici di migrazine del Dcument, in analgia cn l mlg tag definit a livell di Unità dcumentaria a cui si rimanda per gni altra infrmazine. Tip Struttura È un tag pzinale che definisce la struttura del Dcument, in termini di articlazine e natura dei Cmpnenti. Nme metadat Descrizine OBBL Dim. max TipStruttura Descrive il tip di struttura. Se nn è valrizzat assume il valre di default (DcumentGeneric) Metadati di <Cmpnenti> Cmpnente È un tag bbligatri che cntiene i metadati che descrivn il Cmpnente. Specifiche tecniche dei servizi di versament [ 33 ]

34 Nme metadat Descrizine OBBL ID OrdinePresentazine TipCmpnente Cnsente di ricngiungere il Cmpnente al relativ file del SIP. Nn è memrizzat nel Sistema e deve essere univc all intern dell Indice SIP. Numer che indica l rdine di successine del singl Cmpnente all intern del Dcument. Deve essere univc e pssibilmente sequenziale 3 all intern del Dcument. Tiplgia del Cmpnente. Se nn è valrizzat assume il valre di default Cntenut. È cncrdat cn ParER Tip di supprt del Cmpnente. Le tiplgie gestite dal sistema sn: Dim. max X 254 X 5 cifre TipSupprtCmpnente FILE: nel cas in cui il Cmpnente sia riferit a un Oggett-dati di tip file; METADATI 4 : nel cas in cui il Cmpnente nn faccia riferiment a un file (in quest cas il SIP è cmpst dal sl Indice); Riferiment RIFERIMENTO: indica che l Oggettdati descritt nel Cmpnente è estern all Unità dcumentaria e che deve essere indicat il riferiment (Chiave) per accedervi (vedi punt successiv). Se nn è valrizzat assume il valre di default (FILE). Necessaria nel cas in cui il TipSupprtCmpnente sia di tip Riferiment. Rappresenta la Chiave (cmpsta da Numer Ann - Registr) di un Unità dcumentaria già presente nel Sistema. X (se Tip SupprtC mpnente = Riferiment) 3 Ad esempi, in un Unità dcumentaria cmpsta da Dcument principale e un Allegat, entrambi cmpsti da due Cmpnenti, il prim Cmpnente del Dcument principale assumerà valre 1 e il secnd Cmpnente valre 2. Analgamente anche il prim Cmpnente dell Allegat assumerà valre 1 mentre il secnd Cmpnente dell Allegat assumerà valre 2. Nn sarebbe crrett, invece, valrizzare i due Cmpnenti del Dcument principale cn i valri 1 e 2, e i due Cmpnenti dell Allegat cn valri 3 e 4 perché l Ordine presentazine determina la sequenza nel cntest dell specific Dcument cui il Cmpnente appartiene e nn dell intera Unità dcumentaria. 4 Il Sistema, per accettare un SIP che cntiene un Cmpnente di tip METADATI deve avere cnfigurat per quella determinata Struttura versante il parametr Versament cmpnenti di tip metadati a True. Specifiche tecniche dei servizi di versament [ 34 ]

35 TipRappresentazineCm pnente Tip di rappresentazine del Cmpnente. È valrizzat nel cas in cui il SIP cntenga un file che deve essere rappresentat utilizzand un specific cnvertitre (il cas classic è un file XML da trasfrmare cn XSLT). Il valre deve essere cncrdat cn ParER. NmeCmpnente Stringa che rappresenta il nme del file nei sistemi del Prduttre. X (se Tip SupprtC mpnente = File) 254 FrmatFileVersat Rappresenta il frmat del file. X (se Tip SupprtC mpnente = File) HashVersat Rappresenta l hash del file. 254 UrnVersat IDCmpnenteVersat DatiSpecifici DatiSpecificiMigrazine Stringa univca che rappresenta l'indirizz lgic in cui è memrizzat il file nei sistemi del Prduttre. Identificativ univc del Cmpnente nei Sistemi del prduttre. In base alla tiplgia del Cmpnente (identificata dal metadat TipCmpnente ), è pssibile inserire dei metadati specifici per tale tiplgia, indicand la versine di riferiment. Se la tiplgia assciata al Cmpnente prevede metadati specifici, è bbligatri il tag <DatiSpecifici> e indicarne la versine (<VersineDatiSpecifici>). Se la tiplgia di Cmpnente nn prevede dati specifici, il tag <DatiSpecifici> nn deve cmparire nell Indice SIP Quest macr tag andrà valrizzat sl nel cas in cui il versament si riferisca a una migrazine da un precedente sistema di cnservazine e se la prcedura di migrazine gestisce dei dati specifici del Cmpnente che verrann migrati in tale macr tag. In quest cas è bbligatri indicare il tag <DatiSpecificiMigrazine> e la versine (<VersineDatiSpecifici>) Specifiche tecniche dei servizi di versament [ 35 ]

36 UtilizzDataFirmaPerRifTe mp 5 RiferimentTemprale DescrizineRiferimentTem prale Indica se il Sistema debba utilizzare la data di firma del file per le verifiche di firma. Nel cas sia presente una marca temprale, viene utilizzata la data della marca. Assume valre True False. Se assente assume il valre di default False. Indica la data a cui deve essere verificata la firma digitale appsta sul file. Il frmat della data è cnfrme all standard ISO 8601 (ann-mese-girnra:minut:secnd.millisecnd+delta rispett a UTC). Ad esempi: T16:49: :00. Descrive il riferiment temprale specificat nel tag precendente. Quand è valrizzat il tag RiferimentTemprale, va sempre valrizzat. 254 Sttcmpnente Cme già dett in precedenza, gni Cmpnente può cntenere un più Sttcmpnenti riferiti al Cmpnente stess (ad esempi, una marca temprale detached). I Sttcmpnenti sn descritti cn un set di metadati mlt simile a quelli del Cmpnente, a cui si rinvia per la relativa descrizine. Nme metadat Descrizine OBBL Dim. max ID Vedi Cmpnente X 254 OrdinePresentazine Vedi Cmpnente X 5 cifre TipCmpnente Vedi Cmpnente X TipSupprtCmpnente Riferiment Vedi Cmpnente Vedi Cmpnente X (se Tip Supprt Cmpne nte = Riferimen t) 5 Nel cas in cui sian assenti i tag UtilizzDataFirmaPerRifTemp, RiferimentTemprale, DescrizineRiferimentTemprale, il Sistema utilizza la data ed ra di versament per le verifiche sulla firma. Specifiche tecniche dei servizi di versament [ 36 ]

37 NmeCmpnente Vedi Cmpnente X (se Tip Supprt Cmpne nte = File) 254 FrmatFileVersat Vedi Cmpnente X (se Tip Supprt Cmpne nte = File) UrnVersat Vedi Cmpnente 1024 IDCmpnenteVersat Vedi Cmpnente 254 DatiSpecifici DatiSpecificiMigrazine Vedi Cmpnente Vedi Cmpnente Esempi di Indice SIP di Unità dcumentaria Esempi di un generic Indice SIP di Unità dcumentaria L esempi fa riferiment a un Indice SIP di Unità dcumentaria cmpsta, ltre che dal Dcument principale, da un Allegat, un Anness e un Anntazine. Per i tag pzinali in cui è previst un valre di default nel cas nn vengan valrizzati, sn stati indicati tali valri di default. Per i tag il cui valre deve essere cnfigurat sul Sistema, è indicat se il valre che devn assumere è assegnat cncrdat cn ParER. Per quant riguarda i Cmpnenti e i Sttcmpnenti, sn riprtati vari esempi in funzinale del valre che può assumere il tag TipSupprtCmpnente (FILE, RIFERIMENTO e METADATI), il tag TipCmpnente (Cntenut, Firma Marca, Rappresentazine e Fgli di trasfrmazine). <?xml versin="1.0" encding="is "?> <UnitaDcumentaria xmlns:xsi=" xsi:nnamespaceschemalcatin=" "> <Intestazine> <Versine>string</Versine> <Versatre> <Ambiente>assegnat da ParER</Ambiente> <Ente>assegnat da ParER</Ente> <Struttura>assegnat da ParER</Struttura> <UserID>assegnat da ParER</UserID> </Versatre> <Chiave> <Numer>string</Numer> <Ann>AAAA</Ann> <TipRegistr>cncrdat cn ParER</TipRegistr> </Chiave> Specifiche tecniche dei servizi di versament [ 37 ]

38 <TiplgiaUnitaDcumentaria>cncrdat cn ParER</TiplgiaUnitaDcumentaria> </Intestazine> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccetazine>false</FrzaAccetazine> <FrzaCnservazine>false</FrzaCnservazine> <FrzaCllegament>false</FrzaCllegament> <SimulaSalvataggiDatiInDB>false</SimulaSalvataggiDatiInDB> </Cnfigurazine> <PrfilArchivistic> <FasciclPrincipale> <Classifica>tken</Classifica> <Fascicl> <Identificativ>tken</Identificativ> <Oggett>string</Oggett> </Fascicl> <SttFascicl> <Identificativ>tken</Identificativ> <Oggett>string</Oggett> </SttFascicl> </FasciclPrincipale> <FascicliSecndari> <FasciclSecndari> <Classifica>tken</Classifica> <Fascicl> <Identificativ>tken</Identificativ> <Oggett>string</Oggett> </Fascicl> </FasciclSecndari> </FascicliSecndari> </PrfilArchivistic> <PrfilUnitaDcumentaria> <Oggett>string</Oggett> <Data>date</Data> </PrfilUnitaDcumentaria> <DatiSpecifici> <VersineDatiSpecifici>string</VersineDatiSpecifici> </DatiSpecifici> <DcumentiCllegati> <DcumentCllegat> <ChiaveCllegament> <Numer>string</Numer> <Ann>year</Ann> <TipRegistr>string</TipRegistr> </ChiaveCllegament> <DescrizineCllegament>string</DescrizineCllegament> </DcumentCllegat> </DcumentiCllegati> <NumerAllegati>1</NumerAllegati> Specifiche tecniche dei servizi di versament [ 38 ]

39 <NumerAnnessi>1</NumerAnnessi> <NumerAnntazini>1</NumerAnntazini> <DcumentPrincipale> <IDDcument>tken</IDDcument> <TipDcument>cncrdat cn ParER</TipDcument> <PrfilDcument> <Descrizine>string</Descrizine> <Autre>string</Autre> </PrfilDcument> <DatiSpecifici> <VersineDatiSpecifici>string</VersineDatiSpecifici> </DatiSpecifici> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>tken</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <TipRappresentazineCmpnente>assegnat da ParER</TipRappresentazineCmpnente> <NmeCmpnente>tken</NmeCmpnente> <FrmatFileVersat>tken</FrmatFileVersat> <HashVersat>tken</HashVersat> <UrnVersat>tken</UrnVersat> <IDCmpnenteVersat>tken</IDCmpnenteVersat> <UtilizzDataFirmaPerRifTemp>false</UtilizzDataFirmaPerRifTemp> <RiferimentTemprale> AAAA-MM- GGTHH:MM:SS.mss+HH:00</RiferimentTemprale> <DescrizineRiferimentTemprale>string</DescrizineRiferimentTemprale> <SttCmpnenti> <SttCmpnente> <ID>tken</ID> <OrdinePresentazine>2</OrdinePresentazine> <TipCmpnente>tken</TipCmpnente> <TipSupprtCmpnente>RIFERIMENTO</TipSupprtCmpnente> <Riferiment> <Numer>string</Numer> <Ann>AAAA</Ann> <TipRegistr>cncrdat cn ParER</TipRegistr> </Riferiment> <NmeCmpnente>tken</NmeCmpnente> <FrmatFileVersat>tken</FrmatFileVersat> <UrnVersat>tken</UrnVersat> <IDCmpnenteVersat>tken</IDCmpnenteVersat> </SttCmpnente> </SttCmpnenti> </Cmpnente> Specifiche tecniche dei servizi di versament [ 39 ]

40 </Cmpnenti> </StrutturaOriginale> </DcumentPrincipale> <Allegati> <Allegat> <IDDcument>tken</IDDcument> <TipDcument>cncrdat cn ParER</TipDcument> <PrfilDcument> <Descrizine>string</Descrizine> <Autre>string</Autre> </PrfilDcument> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>tken</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>METADATI</TipSupprtCmpnente> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Allegat> </Allegati> <Annessi> <Anness> <IDDcument>tken</IDDcument> <TipDcument>cncrdat cn ParER</TipDcument> <PrfilDcument> <Descrizine>string</Descrizine> <Autre>string</Autre> </PrfilDcument> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>tken</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <TipRappresentazineCmpnente>assegnat da ParER</TipRappresentazineCmpnente> <NmeCmpnente>tken</NmeCmpnente> <FrmatFileVersat>tken</FrmatFileVersat> <HashVersat>tken</HashVersat> <UrnVersat>tken</UrnVersat> <IDCmpnenteVersat>tken</IDCmpnenteVersat> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> Specifiche tecniche dei servizi di versament [ 40 ]

41 <RiferimentTemprale> AAAA-MM- GGTHH:MM:SS.mss+HH:00</RiferimentTemprale> <DescrizineRiferimentTemprale>string</DescrizineRiferimentTemprale> <SttCmpnenti> <SttCmpnente> <ID>tken</ID> <OrdinePresentazine>2</OrdinePresentazine> <TipCmpnente>Firma</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>tken</NmeCmpnente> <FrmatFileVersat>tken</FrmatFileVersat> <UrnVersat>tken</UrnVersat> <IDCmpnenteVersat>tken</IDCmpnenteVersat> </SttCmpnente> </SttCmpnenti> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Anness> </Annessi> <Anntazini> <Anntazine> <IDDcument>tken</IDDcument> <TipDcument>tken</TipDcument> <PrfilDcument> <Descrizine>string</Descrizine> <Autre>string</Autre> </PrfilDcument> <StrutturaOriginale> <TipStruttura>tken</TipStruttura> <Cmpnenti> <Cmpnente> <ID>tken</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Rappresentazine</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <TipRappresentazineCmpnente>tken</TipRappresentazineCmpnente> <NmeCmpnente>tken</NmeCmpnente> <FrmatFileVersat>tken</FrmatFileVersat> <HashVersat>tken</HashVersat> <UrnVersat>tken</UrnVersat> <IDCmpnenteVersat>tken</IDCmpnenteVersat> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> <RiferimentTemprale> AAAA-MM- GGTHH:MM:SS.mss+HH:00</RiferimentTemprale> <DescrizineRiferimentTemprale>string</DescrizineRiferimentTemprale> <SttCmpnenti> <SttCmpnente> <ID>tken</ID> Specifiche tecniche dei servizi di versament [ 41 ]

42 <OrdinePresentazine>2</OrdinePresentazine> <TipCmpnente>Fgli di trasfrmazine</tipcmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>tken</NmeCmpnente> <FrmatFileVersat>tken</FrmatFileVersat> <UrnVersat>tken</UrnVersat> <IDCmpnenteVersat>tken</IDCmpnenteVersat> </SttCmpnente> </SttCmpnenti> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Anntazine> </Anntazini> </UnitaDcumentaria> Esempi di Indice SIP di una Determina dirigenziale Di seguit si presenta un esempi di Indice SIP di un Unità dcumentaria di tip Determina dirigenziale che presenta un Allegat generic, un Anness cn il Vist cntabile e un Anntazine relativa alla Relata di pubblicazine. Nell esempi, sn riprtati varie casistiche di indicazine della data da utilizzare cme riferiment temprale per la verifica della firma, ltre a vari casi di utilizz dei valri di default dei tag pzinali. <?xml versin="1.0" encding="is "?> <UnitaDcumentaria xmlns:xsi=" xsi:nnamespaceschemalcatin=" "> <Intestazine> <Versine>1.4</Versine> <Versatre> <Ambiente>PARER</Ambiente> <Ente>XXX</Ente> <Struttura>YYY</Struttura> <UserID>username</UserID> </Versatre> <Chiave> <Numer>2685</Numer> <Ann>2014</Ann> <TipRegistr>DETE</TipRegistr> </Chiave> <TiplgiaUnitaDcumentaria>Determina dirigenziale</tiplgiaunitadcumentaria> </Intestazine> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>false</FrzaAccettazine> <FrzaCnservazine>false</FrzaCnservazine> <FrzaCllegament>true</FrzaCllegament> <SimulaSalvataggiDatiInDB>false</SimulaSalvataggiDatiInDB> Specifiche tecniche dei servizi di versament [ 42 ]

43 </Cnfigurazine> <PrfilArchivistic> <FasciclPrincipale> <Classifica>3.2.2</Classifica> <Fascicl> <Identificativ>3.2.2/2014/1</Identificativ> <Oggett>Cstruzine strada XXX</Oggett> </Fascicl> <SttFascicl> <Identificativ>3.2.2/2011/1/1</Identificativ> <Oggett>Esprpri XXX</Oggett> </SttFascicl> </FasciclPrincipale> <FascicliSecndari> <FasciclSecndari> <Classifica>2.0</Classifica> <Fascicl> <Identificativ>2.0/2014/2</Identificativ> <Oggett>Acquisti Vari</Oggett> </Fascicl> </FasciclSecndari> <FasciclSecndari> <Classifica>2.1</Classifica> <Fascicl> <Identificativ>2.1/2014/3</Identificativ> <Oggett>Oggett del fascicl 2.1</Oggett> </Fascicl> <SttFascicl> <Identificativ>2.1/2014/3/1</Identificativ> <Oggett>Prva</Oggett> </SttFascicl> </FasciclSecndari> </FascicliSecndari> </PrfilArchivistic> <PrfilUnitaDcumentaria> <Oggett>Assegnazine gara</oggett> <Data> </Data> </PrfilUnitaDcumentaria> <DatiSpecifici> <VersineDatiSpecifici>1.0</VersineDatiSpecifici> <Firmatari>Mari Rssi</Firmatari> <DataVistCntabile> </DataVistCntabile> <DataEsecutivita> </DataEsecutivita> </DatiSpecifici> <NumerAllegati>1</NumerAllegati> <NumerAnnessi>1</NumerAnnessi> <NumerAnntazini>1</NumerAnntazini> <DcumentPrincipale> <IDDcument>DETE _01</IDDcument> Specifiche tecniche dei servizi di versament [ 43 ]

44 <TipDcument>Determina dirigenziale</tipdcument> <PrfilDcument> <Autre>Mari Rssi</Autre> </PrfilDcument> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>ID1</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>Determinazine2685.pdf.p7m</NmeCmpnente> <FrmatFileVersat>PDF.P7M</FrmatFileVersat> <HashVersat>HASHAAAAAAAAAAAAAAAA</HashVersat> <IDCmpnenteVersat> </IDCmpnenteVersat> <UtilizzDataFirmaPerRifTemp>false</UtilizzDataFirmaPerRifTemp> <RiferimentTemprale> T16:49: :00</RiferimentTemprale> <DescrizineRiferimentTemprale>Data esecutività</descrizineriferimenttemprale> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </DcumentPrincipale> <Allegati> <Allegat> <IDDcument>DETE _ALL_01</IDDcument> <TipDcument>GENERICO</TipDcument> <PrfilDcument> <Descrizine>Verbale di gara</descrizine> </PrfilDcument> <StrutturaOriginale> <Cmpnenti> <Cmpnente> <ID>ID2</ID> <OrdinePresentazine>1</OrdinePresentazine> <NmeCmpnente>VerbaleGara.pdf</NmeCmpnente> <FrmatFileVersat>PDF</FrmatFileVersat> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Allegat> </Allegati> <Annessi> <Anness> <IDDcument>DETE _ALL_01</IDDcument> <TipDcument>VISTO REGOLARITA CONTABILE</TipDcument> <DatiSpecifici> Dati Specifici relativi al Dcument <VersineDatiSpecifici>1.0</VersineDatiSpecifici> Specifiche tecniche dei servizi di versament [ 44 ]

45 <DataVist> </DataVist> </DatiSpecifici> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>ID3</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>Vist.pdf.p7m</NmeCmpnente> <FrmatFileVersat>PDF.P7M</FrmatFileVersat> <HashVersat> HASHAAAAAAAAAAAAAAAA </HashVersat> <IDCmpnenteVersat>0236</IDCmpnenteVersat> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Anness> </Annessi> <Anntazini> <Anntazine> <IDDcument>DETE _ALL_01</IDDcument> <TipDcument>RELATA DI PUBBLICAZIONE</TipDcument> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>ID4</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>relata_pubblicazine.pdf.p7m</NmeCmpnente> <FrmatFileVersat>PDF.P7M</FrmatFileVersat> <HashVersat>HASHBBBBBBBBBBB</HashVersat> /Cmpnente> </Cmpnenti> </StrutturaOriginale> </Anntazine> </Anntazini> </UnitaDcumentaria> Esempi di Indice SIP di un refert cn fgli di trasfrmazine L esempi è riferit a un Unità dcumentaria di tip Refert cmpsta dal sl Dcument principale che a sua vlta è articlat in un Cmpnente e un Sttcmpnente. Il prim è riferit al file del refert (in frmat XML), mentre il secnd è riferit al Fgli di trasfrmazine da utilizzare per rappresentare il refert in frmat PDF mediante pprtuna trasfrmazine. Specifiche tecniche dei servizi di versament [ 45 ]

46 <?xml versin="1.0" encding="is "?> <UnitaDcumentaria> <Intestazine> <Versine>1.4</Versine> <Versatre> <Ambiente>PARER</Ambiente> <Ente>XXX</Ente> <Struttura>YYY</Struttura> <UserID>username</UserID> </Versatre> <Chiave> <Numer>1</Numer> <Ann>2014</Ann> <TipRegistr>MICROBIOLOGIA</TipRegistr> </Chiave> <TiplgiaUnitaDcumentaria>REFERTO</TiplgiaUnitaDcumentaria> </Intestazine> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>true</FrzaAccettazine> <FrzaCnservazine>false</FrzaCnservazine> <FrzaCllegament>true</FrzaCllegament> </Cnfigurazine> <PrfilUnitaDcumentaria> <Oggett>Esame di micrbilgia</oggett> <Data> </Data> </PrfilUnitaDcumentaria> <NumerAllegati>0</NumerAllegati> <NumerAnnessi>1</NumerAnnessi> <NumerAnntazini>0</NumerAnntazini> <DcumentPrincipale> <IDDcument>DOC1</IDDcument> <TipDcument>REFERTO DI MICROBIOLOGIA</TipDcument> <StrutturaOriginale> <Cmpnenti> <Cmpnente> <ID>ID1</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <TipRappresentazineCmpnente>Rappresentazine cn XSLT</TipRappresentazineCmpnente> <NmeCmpnente>Refert_1.xml.p7m</NmeCmpnente> <FrmatFileVersat>XML.P7M</FrmatFileVersat> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> <SttCmpnenti> <SttCmpnente> <ID>ID2</ID> <OrdinePresentazine>2</OrdinePresentazine> Specifiche tecniche dei servizi di versament [ 46 ]

47 <TipCmpnente>Fgli di trasfrmazine</tipcmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>FgliTrasfrmazine.xslt</NmeCmpnente> <FrmatFileVersat>XSLT</FrmatFileVersat> </SttCmpnente> </SttCmpnenti> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </DcumentPrincipale> </UnitaDcumentaria> Packaging Infrmatin SIP (PI SIP) Il Packaging Infrmatin SIP (PI SIP) è un dcument in frmat XML che cntiene le infrmazini sull impacchettament nel cas in cui il SIP di Unità dcumentaria sia versat nel Sistema in mdalità asincrna, utilizzand i servizi descritti nella Sez. 3. Le infrmazini cntenute nel PI SIP cnsentn di: frnire una mappatura tra i file del SIP, descritti nell Indice SIP dai Cmpnenti, e i rispettivi percrsi nel filesystem; indicare, per gni file, se deve essere effettuata la verifica di firma e frmat ed il calcl dell'hash (vedi paragrafi e seguenti); specificare le infrmazini relative al frmat e all'hash nel cas queste sian già state calclate dall'applicativ che effettua il versament. L XSD del PI SIP è pubblicat sul sit di ParER (vedi paragraf Elenc degli XSD descritti nel presente dcument ) Struttura dati del PI SIP La struttura dati del PI SIP è descritta nella seguente tabella. Nme metadat Descrizine OBBL Versine Versine del PI SIP X Applicativ chiamante ID URN Cmpnente VerificaFirmeFrmati Identificativ dell'applicativ versante. Viene impiegat per stabilire la rt del filesystem da cui leggere i file Identificativ univc del Cmpnente, deve cincidere cn l'id indicat nell Indice SIP Percrs del file assciat al Cmpnente indicat nel camp ID Flag che indica se deve essere eseguita la verifica di firme e frmati (al mment le due verifiche nn sn separabili). X X X X Specifiche tecniche dei servizi di versament [ 47 ]

48 FrzaFrmat Tag che permette di frzare le infrmazini relative al frmat (vedi paragraf ). È cmpst da: FrmatStandard Nme del frmat standard X X FrmatRappresentazineEstes FrmatRappresentazineCmpatt CalclaHash FrzaHash Frmat di rappresentazine estes Frmat di rappresentazine cmpatt Flag che indica se deve essere calclat l'hash del file Tag che permette di frzare le infrmazini relative all'hash. È cmpst da: X X X X Hash Valre dell'hash calclat X Algritm Algritm di hash X Encding Encding della stringa che rappresenta l'hash X Esempi di PI SIP <IndiceMM> <Versine>1.0</Versine> <ApplicativChiamante>VERSATOREYYY</ApplicativChiamante> <Cmpnenti> <Cmpnente> <ID>1</ID> <URNFile>/VERSATOREYYY/INPUT_FOLDER/LOG-SERVER_ / zip</URNFile> <VerificaFirmeFrmati>false</VerificaFirmeFrmati> <FrzaFrmat> <FrmatStandard>ZIP</FrmatStandard> <FrmatRappresentazineEstes>ZIP</FrmatRappresentazineEstes> <FrmatRappresentazineCmpatt>ZIP</FrmatRappresentazineCmpatt> </FrzaFrmat> <CalclaHash>true</CalclaHash> </Cmpnente> </Cmpnenti> </IndiceMM> 1.2. SIP di Dcument Specifiche tecniche dei servizi di versament [ 48 ]

49 Il SIP di Dcument è il Pacchett di versament che cntiene un Dcument da aggiungere a un Unità dcumentaria già presente nel Sistema. La necessità di aggiungere un Dcument a un Unità dcumentaria deriva sstanzialmente da due mtivi: il Dcument è stat prdtt successivamente al versament in cnservazine dell Unità dcumentaria di cui fa parte, per cui si rende necessari integrarl in quest ultima cn un versament successiv; l Unità dcumentaria è cmpsta da un numer elevat di Dcumenti, per cui per ragini tecniche si reputa preferibile inviarla in cnservazine suddivisa in più SIP, di cui il prim cnterrà l Unità dcumentaria cn al minim il Dcument principale, mentre i successivi cnterrann gnun un dei Dcumenti appartenenti all Unità dcumentaria. Analgamente al SIP di Unità dcumentaria, il SIP di Dcument è cmpst dall Indice SIP e da un più Oggetti-dati, anche se ci sn casi particlari in cui il SIP può nn cntenere Oggetti-dati (ad esempi, Dcumenti di cui esiste sl l riginale cartace), per cui il SIP è cmpst unicamente dall Indice. Più in dettagli, gli elementi che cmpngn il SIP di Dcument sn i seguenti: Element del SIP Indice SIP Oggett-dati Descrizine È un dcument in frmat XML prdtt stt la respnsabilità del Prduttre che cntiene i metadati del Dcument, nnché i parametri di versament. La descrizine dettagliata dell Indice e la sua struttura dati sn riprtate nel paragraf È la sequenza di bit, nrmalmente in frma di file, che cstituisce l ggett della cnservazine. È descritt nell Indice SIP a livell di Cmpnente del Dcument. Nte È sempre presente Nel SIP pssn essere presenti un più Oggetti-dati, ma in alcuni casi l Oggett-dati può nn essere presente (ad esempi, se il SIP cntiene sl metadati, cme nel cas di un Dcument esistente sl in riginale cartace) La seguente figura illustra in un diagramma UML la struttura del SIP di Dcument. Specifiche tecniche dei servizi di versament [ 49 ]

50 Il SIP di Dcument è versat nel Sistema utilizzand esclusivamente i Servizi di versament sincrni, descritti alla Sez Indice del SIP di Dcument L Indice del SIP di Dcument è un dcument in frmat XML creat stt la respnsabilità dal Prduttre e cntiene i metadati che descrivn cntenut e struttura del Dcument. Per l Indice SIP di Dcument vale, in via generale, quant dett per l Indice di Unità dcumentaria, in cnsiderazine del fatt che l Indice SIP di Dcument può essere cnsiderat cme un sttinsieme dell Indice SIP di Unità dcumentaria, essend sstanzialmente una parte di quest ultim (quella relativa a Dcument e Cmpnente). In quest sens, le categrie di metadati e i Parametri di versament sn gli stessi previsti per l Indice SIP di Unità dcumentaria (descritte nel paragraf 2.1.1), ad eccezine del Prfil archivistic, qui nn presente in quant il Dcument assume il Prfil archivistic dell Unità dcumentaria cui appartiene. Specifiche tecniche dei servizi di versament [ 50 ]

51 Anche per quant cncerne la struttura, si può far riferiment a quant in generale scritt per l Unità dcumentaria nel paragraf L XSD dell Indice SIP di Dcument è pubblicat sul sit di ParER (vedi paragraf Elenc degli XSD descritti nel presente dcument ). Nella tabella seguente è descritta la macrstruttura dell Indice SIP di Dcument. La prima clnna riprta la denminazine dei macr tag nell schema XML dell Indice, la secnda la descrizine, la terza il livell della struttura dell Indice SIP cui il macr tag afferisce (Dcument, Cmpnente) e l ultima il riferiment alla categria di metadati tra quelle descritte nel paragraf Schema XML <Intestazine> </Intestazine> <Cnfigurazine> </Cnfigurazine> <IDDcument> </IDDcument> <TipDcument> </TipDcument> <PrfilDcument> </PrfilDcument> <DatiSpecifici> </DatiSpecifici> <DatiSpecificiMigrazine> </DatiSpecificiMigrazine> <StrutturaOriginale> </StrutturaOriginale> Descrizine Metadati che permettn di identificare univcamente il Sggett versante, la Chiave e la tiplgia dell Unità dcumentaria a cui il Dcument appartiene. Parametri che permettn di determinare le mdalità (frzature) cn cui il Sistema accetta i Dcumenti. Identificativ del Dcument (Principale, Allegat, Anness e Anntazine). Livell struttura Indice SIP Dcument 6 Dcument Dcument Categria di metadati Identificazine Parametri di versament Identificazine Tiplgia del dcument. Dcument Identificazine Metadati descrittivi cmuni a tutte le tiplgie di Dcument. Metadati descrittivi specifici per una data tiplgia di Dcument. Metadati specifici per una data tiplgia di Dcument che frniscn infrmazini relative al Dcument sull eventuale prcess di cnservazine cui è stata sttpst in precedenza. Infrmazini sulla struttura del Dcument. Dcument Dcument Dcument Dcument Prfil generale Prfil specifici Cnservazine Struttura 6 Anche se i metadati di identificazine sn quelli di Chiave dell Unità dcumentaria, in quest cntest sn riferibili al Dcument perché utilizzati per identificare il Dcument. Specifiche tecniche dei servizi di versament [ 51 ]

52 <Cmpnenti> </Cmpnenti> Infrmazini sui Cmpnenti in cui si articla il Dcument, inclus il frmat. Può cntenere infrmazini sugli eventuali Sttcmpnenti Cmpnente Struttura e Identificazine Nei paragrafi seguenti sn descritti le single macrclassi di metadati, suddivise per i livelli in cui si articla l Indice SIP di Dcument (Dcument, Cmpnente). Per gni metadat dell Indice SIP sn riprtate le seguenti infrmazini: Nme metadat: la denminazine del metadat csì cme definita nell XSD dell Indice SIP Descrizine: descrizine del metadat, inclusi esempi di valrizzazine, valri assunti, ecc. Obbligatrietà: indica l bbligatrietà del metadat Dimensine Massima: indica il numer massim di caratteri che pssn essere inseriti nel relativ tag. Nn è stata indicata nel cas di valri bleani e di tag che accettan sl valri predefiniti I campi pzinali, se vuti, nn devn essere inseriti nel file XML cme tag vuti. Quindi nn sarà accettat, per esempi: <PrfilDcument> <Autre>Mari Rssi</Autre> < Descrizine/> Errre: i tag nn valrizzati nn devn essere inseriti nell XML </PrfilDcument> Metadati di <Dcument> Intestazine Si tratta di un tag bbligatri che cntiene le infrmazini che identifican univcamente il Sggett versante e l Unità dcumentaria cntenuta nel SIP. Nme metadat Descrizine OBBL Versine Vedi paragraf (Intestazine) X 100 Dim. max Ambiente Sn i metadati che identifican il Sggett X 100 Ente versante (Versatre) e che cstituiscn una parte dell identificav univc (l altra è la X 100 Struttura Chiave) dell Unità dcumentaria cui appartiene il Dcument X 100 UserID Vedi paragraf (Intestazine) X 100 Chiave Numer X 100 Ann Sn i metadati identificativi dell Unità dcumentaria cui appartiene il Dcument X 4 TipRegistr X 100 Specifiche tecniche dei servizi di versament [ 52 ]

53 Cnfigurazine È un tag pzinale che definisce i Parametri di versament. Nme metadat Descrizine OBBL Dim. max TipCnservazine SistemaDiMigrazine FrzaCnservazine Vedi paragraf (Cnfigurazine) X (se TipCnservazine = Migrazine) 100 FrzaAccettazine SimulaSalvataggiDatiInDB ID dcument e Tip dcument Sn tag bbligatri che identifican il Dcument nel cntest dell Unità dcumentaria. Nme metadat Descrizine OBBL Dim. max IDDcument TipDcument Rappresenta l identificativ del Dcument assegnat dal Prduttre. Deve essere univc all intern della stessa Unità Dcumentaria, cnsiderand anche gli IDDcument degli altri Dcumenti appartenenti all Unità dcumentaria già presenti nel Sistema. Rappresenta la tiplgia del dcument. È cncrdata cn ParER. X 100 X Prfil dcument È un tag che cntiene i metadati di prfil generali, cmuni a tutte le tiplgie di Dcument. Nme metadat Descrizine OBBL Dim. max Descrizine 1024 Vedi paragraf (Prfil dcument) Autre 254 Dati specifici Vedi paragraf (Dati specifici) Dati specifici migrazine Vedi paragraf (Dati specifici migrazine) Specifiche tecniche dei servizi di versament [ 53 ]

54 Tip Struttura È un tag pzinale che definisce la struttura del Dcument, in termini di articlazine e natura dei Cmpnenti. Nme metadat Descrizine OBBL Dim. max TipStruttura Descrive il tip di struttura. Se nn è valrizzat assume il valre di default (DcumentGeneric) Metadati di <Cmpnenti> Cmpnente È un tag bbligatri che cntiene i metadati che descrivn il Cmpnente Nme metadat Descrizine OBBL ID OrdinePresentazine TipCmpnente TipSupprtCmpnente Riferiment TipRappresentazineCmpnente NmeCmpnente FrmatFileVersat Vedi paragraf (Cmpnente) Dim. max X X cifre X (se TipSupprtCmpnente = Riferiment) X (se TipSupprtCmpnente = File) X (se TipSupprtCmpnente = File) HashVersat 254 UrnVersat 1024 IDCmpnenteVersat 254 DatiSpecifici DatiSpecificiMigrazine UtilizzDataFirmaPerRifTemp RiferimentTemprale DescrizineRiferimentTemprale Specifiche tecniche dei servizi di versament [ 54 ]

55 Sttcmpnente Cme già dett in precedenza, gni Cmpnente può cntenere un più Sttcmpnenti riferiti al Cmpnente stess (ad esempi, una marca temprale detached). I Sttcmpnenti sn descritti cn un set di metadati mlt simile a quelli del Cmpnente, a cui si rinvia per la relativa descrizine. Nme metadat Descrizine OBBL Dim. max ID Vedi Cmpnente X 254 OrdinePresentazine Vedi Cmpnente X 5 cifre TipCmpnente Vedi Cmpnente X TipSupprtCmpnente Vedi Cmpnente Riferiment Vedi Cmpnente X (se TipSupprtCmpnente = Riferiment) NmeCmpnente Vedi Cmpnente X (se TipSupprtCmpnente = File) 254 FrmatFileVersat Vedi Cmpnente X (se Tip SupprtCmpnente = File) UrnVersat Vedi Cmpnente 1024 IDCmpnenteVersat Vedi Cmpnente 254 DatiSpecifici DatiSpecificiMigrazine Vedi Cmpnente Vedi Cmpnente Esempi di Indice SIP di Dcument Esempi di un generic Indice SIP di Dcument L esempi fa riferiment a un Indice SIP di Dcument cmpsta da un Allegat. Per i tag pzinali in cui è previst un valre di default nel cas nn vengan valrizzati, sn stati indicati tali valri di default. Per i tag il cui valre deve essere cnfigurat sul Sistema, è indicat se il valre che devn assumere è assegnat cncrdat cn ParER. <?xml versin="1.0" encding="is "?> <UnitaDcAggAllegati > <Intestazine> <Versine>1.4</Versine> <Versatre> Specifiche tecniche dei servizi di versament [ 55 ]

56 <Ambiente>assegnat da ParER</Ambiente> <Ente>assegnat da ParER</Ente> <Struttura>assegnat da ParER</Struttura> <UserID>assegnat da ParER</UserID </Versatre> <Chiave> <Numer>string</Numer> <Ann>AAAA</Ann> <TipRegistr>cncrdat cn ParER</TipRegistr> </Chiave> </Intestazine> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccetazine>false</FrzaAccetazine> <FrzaCnservazine>false</FrzaCnservazine> <FrzaCllegament>false</FrzaCllegament> <SimulaSalvataggiDatiInDB>false</SimulaSalvataggiDatiInDB> </Cnfigurazine> <Allegat> <IDDcument>tken</IDDcument> <TipDcument>cncrdat cn ParER</TipDcument> <PrfilDcument> <Descrizine>string</Descrizine> <Autre>string</Autre> </PrfilDcument> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>tken</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <TipRappresentazineCmpnente>assegnat da ParER</TipRappresentazineCmpnente> <NmeCmpnente>tken</NmeCmpnente> <FrmatFileVersat>tken</FrmatFileVersat> <HashVersat>tken</HashVersat> <UrnVersat>tken</UrnVersat> <IDCmpnenteVersat>tken</IDCmpnenteVersat> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> <RiferimentTemprale>AAAA-MM- GGTHH:MM:SS.mss+HH:00</RiferimentTemprale> <DescrizineRiferimentTemprale>string</DescrizineRiferimentTemprale> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Allegat> </UnitaDcAggAllegati> Specifiche tecniche dei servizi di versament [ 56 ]

57 Esempi di Indice SIP di un Attestat di pubblicazine da aggiungere a un Dcument prtcllat L esempi fa riferiment all aggiunta di un Dcument di tip ATTESTATO DI PUBBLICAZIONE a un Unità dcumentaria di tip DOCUMENTO PROTOCOLLATO già presente nel Sistema. <?xml versin="1.0" encding="is "?> <UnitaDcAggAllegati > <Intestazine> <Versine>1.4</Versine> <Versatre> </Versatre> <Chiave> </Chiave> </Intestazine> <Ambiente>PARER</Ambiente> <Ente>XXX</Ente> <Struttura>YYY</Struttura> <UserID>username</UserID> <Numer>3</Numer> <Ann>2011</Ann> <TipRegistr>PROTOCOLLO</TipRegistr> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>false</FrzaAccettazine> <FrzaCnservazine>false</FrzaCnservazine> </Cnfigurazine> <Anntazine> <IDDcument>501</IDDcument> <TipDcument>ATTESTATO DI PUBBLICAZIONE</TipDcument> <PrfilDcument> <Descrizine>Attestazine di pubblicazine del band di cncrs dell ente XYZ all Alb n line</descrizine> <Autre>Virginia Rssi</Autre> </PrfilDcument> <StrutturaOriginale> <TipStruttura>DcumentGeneric</TipStruttura> <Cmpnenti> <Cmpnente> <ID>ID1</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>pubblicazine_alb.pdf.p7m</NmeCmpnente> <FrmatFileVersat>PDF.P7M</FrmatFileVersat> <HashVersat>AAAAAAAAAAAAAAAAAA</HashVersat> <UrnVersat>PROTOCOLLO:2011:1-ALL03</UrnVersat> <IDCmpnenteVersat>23514</IDCmpnenteVersat> <UtilizzDataFirmaPerRifTemp>false</UtilizzDataFirmaPerRifTemp> Specifiche tecniche dei servizi di versament [ 57 ]

58 </StrutturaOriginale> </Anntazine> </UnitaDcAggAllegati> <RiferimentTemprale> T14:00:00Z</RiferimentTemprale> <DescrizineRiferimentTemprale>Data di pubblicazine Alb n line</descrizineriferimenttemprale> </Cmpnente> </Cmpnenti> 1.3. SIP di Metadati Il SIP di Metadati è un pacchett di versament che cntiene esclusivamente metadati ed è utilizzat per aggirnare i metadati di un Unità dcumentaria già presente nel Sistema. La mdalità attualmente utilizzata per prcedere a tale aggirnament è quella di inserire i metadati da aggirnare cme metadati specifici nell Indice SIP di Dcument, cncrdand cn ParER sia il set di metadati specifici da utilizzare, sia le tiplgie di Dcument a cui assciarli, in base alle specifiche esigenze (es: annullament di una registrazine di prtcll, annullament di un att, ecc.). Cn il versament di tale SIP, i metadati sn aggiunti all Unità dcumentaria stt frma di Dcument. In un mment successiv il Sistema, cn pprtune rielabrazini, prvvederà ad aggirnare il set di metadati dell Unità dcumentaria cn quelli presenti nel Dcument. In casi particlari, i metadati da aggirnare sn cntenuti nn all intern dell Indice SIP del Dcument, ma in un file (nrmalmente in frmat XML) che viene versat cme Cmpnente del Dcument stess. In questi casi, il Sistema aggirnerà i metadati dell Unità dcumentaria riprcessand i metadati cntenuti nel file invece che quelli cntenuti nell Indice SIP. Per quant riguarda la cmpsizine del SIP di Metadati, nnché la sua struttura e la descrizine dei relativi metadati, essend tale SIP una particlare mdalità di utilizz del SIP di Dcument, si rinvia in tt a quant dett per l Indice SIP di Dcument nel paragraf Nella Sez. 4 sn descritti in dettagli i più frequenti casi d us che prevedn l aggirnament metadati mediante invi di un SIP di Metadati Esempi di Indice SIP di Metadati relativ all annullament di una registrazine di prtcll L esempi è relativ a un Indice SIP di Metadati trasmess al Sistema per aggirnare i metadati di un Unità dcumentaria di tip Dcument prtcllat a seguit dell avvenut annullament da parte del Prduttre della relativa registrazine di prtcll. Il nuv set di metadati è cntenut integralmente nell Indice SIP, per cui nel SIP nn sn presenti Oggetti-dati. Specifiche tecniche dei servizi di versament [ 58 ]

59 <?xml versin="1.0" encding="is "?> <UnitaDcAggAllegati xmlns:xsi=" xsi:nnamespaceschemalcatin="file:///c:/wsrequestunic.xsd"> <Intestazine> <Versine>1.4</Versine> <Versatre> <Ambiente>PARER</Ambiente> <Ente>XXX</Ente> <Struttura>YYY</Struttura> <UserID>username</UserID> </Versatre> <Chiave> <Numer>6</Numer> <Ann>2014</Ann> <TipRegistr>PROTOCOLLO</TipRegistr> </Chiave> </Intestazine> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>false</FrzaAccettazine> <FrzaCnservazine>true</FrzaCnservazine> </Cnfigurazine> <Anness> <IDDcument>02</IDDcument> <TipDcument>ANNULLAMENTO</TipDcument> <PrfilDcument> <Descrizine>Aggirnament metadati per annullament registrazine di prtcll</descrizine> <Autre>Euridice Rssi</Autre> </PrfilDcument> <DatiSpecifici> <Mviment>Entrata</Mviment> <Mittente>Franc Argent</Mittente> <Validita>Annullat<Validita> <DataAnnullament> </DataAnnullament> <MtivAnnullament>Dppia registrazine</mtivannullament> <EsecutreAnnullament>Antni Bald<EsecutreAnnullament> </DatiSpecifici> <StrutturaOriginale> <Cmpnenti> <Cmpnente> <ID>ID1</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>METADATI</TipSupprtCmpnente> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Anness> </UnitaDcAggAllegati> 1.4. SIP di Unità archivistica (Fascicl) Specifiche tecniche dei servizi di versament [ 59 ]

60 Il SIP di Unità archivistica è cstituit da un più Unità archivistiche di tip Fascicl, che a lr vlta cntengn l elenc delle Unità dcumentarie cntenute. Attravers tale elenc, il Sistema esegue il ricngiungiment delle Unità dcumentarie cn l Unità Archivistica a cui appartengn. Il SIP di Unità archivistica può inltre cntenere i c.d. Metadati di chiusura, vver il set di metadati che aggirna sstituisce quell dell Unità Dcumentaria precedentemente versata e che si cnsidera definitiv e nn più mdificabile. Tant la struttura del SIP di Unità archivistica, quant i servizi necessari alla gestine del Pacchett sn in fase di implementazine. Qui di seguit si riprta il diagramma UML che descrive la macrstruttura dell Indice SIP di Unità archivistica. Specifiche tecniche dei servizi di versament [ 60 ]

61 1.5. SIP nn nrmalizzati Il SIP nn nrmalizzat è cstituit da una cmpnente bbligatria, definita Oggett e una cmpnente pzinale, definita Indice. L Oggett è cstituit da un file, tipicamente in frmat ZIP, che a sua vlta può cntenere un più file relativi ai dcumenti da versare in cnservazine (eventualmente rganizzati in cartelle) e i relativi metadati, i quali pssn essere cntenuti in file distinti da quelli dei dcumenti essere cntenuti nei dcumenti stessi, se questi sn in un frmat idne a cntenere dati strutturati (ad esempi, XML). L Oggett è versat nel Sistema utilizzand il prtcll FTP cme descritt nella Sez. 3. L Indice è un dcument in frmat XML (la cui struttura dati è descritta nella Sez. 3) che cntiene la descrizine dell Oggett, ciè i sui metadati e altre infrmazini relative alle mdalità cn cui svlgere il prcess di nrmalizzazine del SIP stess. L Indice è pzinale in quant i metadati del SIP e le altre infrmazini necessarie a eseguire il prcess di nrmalizzazine, pssn essere cntenute ricavabili dall Oggett stess. L Indice è versat utilizzand i servizi di versament in mdalità asincrna descritti nella Sez. 3. In ragine del fatt che i SIP nn nrmalizzati pssn differire mlt tra lr sia per struttura dati che per cntenut, i vari Mdelli di SIP nn standard sn cncrdati di vlta in vlta cn il Prduttre e sn descritti nei singli Disciplinari tecnici. Specifiche tecniche dei servizi di versament [ 61 ]

62 Sez. 2 Servizi di versament in mdalità sincrna Nella presente sezine sn descritti i servizi di versament sincrni, da utilizzare per versare nel Sistema i SIP (nrmalizzati) di Unità dcumentaria, Dcument e Metadati descritti nella Sezine 1. I Servizi di versament sincrn prevedn l invi dell inter SIP (Indice ed eventuali file) in un unica chiamata, cn cntestuale rispsta al versament eseguit. I servizi attualmente dispnibili sn i seguenti: Servizi di versament sincrn di Unità dcumentaria (VersamentSync): è il servizi da utilizzare per versare nel Sistema il SIP di Unità dcumentaria descritt nel paragraf 1.1; Servizi di versament sincrn di aggiunta Dcument (AggiuntaAllegatiSync): è il servizi utilizzat per versare il SIP di Dcument (descritt al paragraf 1.1.2) da aggiungere a un Unità dcumentaria già esistente nel Sistema e il SIP di Metadati (descritt al paragraf 1.3) per aggirnare i metadati di un Unità dcumentaria già presente nel Sistema. In ragine del fatt che tutti i Servizi di versament sincrni cndividn architettura di sessine, prtcll, struttura della chiamata, cntrlli sui pacchetti versati e rispsta alla chiamata, nel paragraf 2.1 sn descritte le specifiche generali dei servizi. Nei paragrafi successivi, invece, sn descritti nell specific i due web service VersamentSync e AggiuntaAllegatiSync, evidenziandne le peculiari mdalità di funzinament rispett alle specifiche generali L architettura per l scambi dei messaggi I Servizi di versament sincrni permett di inviare al Sistema una serie di ggetti definiti, vver i SIP nrmalizzati di Unità Dcumentaria, Dcument e Metadati, a lr vlta cmpsti da un Indice SIP che cntiene i metadati e i parametri di versament e dagli eventuali Oggettidati (file), csì cme illustrat nella Sez. 1. I Servizi che gestiscn l invi di Unità archivistiche sn al mment in crs di implementazine. Le infrmazini riferite ad Ambiente, Ente, Struttura e UserID (presenti nell Intestazine dell Indice SIP) permettn di identificare il Sggett versante e l Applicativ versante, ciè il client del Sggett versante che richiama il servizi. Tale indicazine risulta fndamentale per garantire la prvenienza e l'autenticità dei SIP, cnsentend il versament sl alle applicazini autrizzate. Le infrmazini riferite alla Chiave permettn di identificare univcamente nel Sistema gli ggetti di cui si richiede il versament, cnsentend di verificare che nn sian già presenti nel Sistema. Specifiche tecniche dei servizi di versament [ 62 ]

63 Ogni file (Oggett-dati) presente nel SIP è identificat nell Indice SIP attravers un identificativ univc cntenut nel Cmpnente, utilizzat dal Sistema per assciare il file al crrispettiv Cmpnente che l descrive. Al riceviment del SIP, il Sistema avvia in autmatic i seguenti cntrlli: cntrll frmale, eseguit attravers il cnfrnt dell Indice SIP cn il relativ XSD, e degli eventuali metadati specifici presenti cn l XSD relativ alla specifica tiplgia di Unità dcumentaria di Dcument; cntrll semantic sui metadati, eseguit estrapland dall Indice SIP le infrmazini sggette a specifici cntrlli; cntrll sui file inviati che sn stati referenziati nell Indice SIP. Sia che i cntrlli abbian esit psitiv che esit negativ, all Applicativ versante è inviata una rispsta (Esit versament). In cas di esit psitiv, nell Esit versament sarà trasmess anche il Rapprt di versament relativ al SIP versat. In cas di esit negativ, nell Esit versament sarann elencati gli errri riscntrati in sede di cntrlli del SIP ma nn sarà presente il Rapprt di versament in quant quest è generat esclusivamente a frnte dei SIP presi in caric dal Sistema. In ragine del fatt che tutti i cntrlli sn svlti a livell sincrn, una pssibile criticità è rappresentata dall eventuale scadenza di sessine da parte dell Applicativ versante in fase di attesa della rispsta (timeut). In cas di timeut, il Sistema cntinua ad elabrare il versament, ma l Applicativ versante nn ha pssibilità di ricevere l Esit versament, avend interrtt la sessine di cmunicazine. Nel cas in cui l Applicativ versante, nn avend ricevut l esit dell perazine a causa del timeut, ripetesse il versament del medesim SIP, il Sistema genererà un errre in quant l ggett del versament è già presente nel Sistema. In questi casi, l Esit versament, anche se negativ, cnterrà cmunque il Rapprt di versament relativ all ggett già presente sul Sistema in maniera tale che il Versatre abbia cmunque tutte le infrmazini relative all acquisizine e presa in caric da parte del Sistema del SIP versat Struttura della chiamata dei servizi di versament sincrn L Applicativ versante richiama il servizi inviand l Indice SIP e i file che cmpngn il SIP. Il Sistema inizia a prcessare l Indice SIP ricavand le infrmazini riferite al Versatre (Ambiente, Ente, Struttura e UserID), identificand la prvenienza del pacchett e verificand che il Versatre sia autrizzat al versament. Specifiche tecniche dei servizi di versament [ 63 ]

64 Il Sistema avvia in autmatic i cntrlli, al termine dei quali invia la rispsta (Esit versament) all Applicativ versante. Il grafic seguente mdella la sequenza del prcess: Figura 1 - Diagramma di sequenza Versament sincrn di un SIP Pass 1 L Applicativ versante chiama il Servizi di versament ed esegue l invi del SIP cstituit da: Indice SIP cntenente la descrizine dell ggett di cui si richiede il versament; file (Oggetti-dati) che cmpngn il SIP. Pass 2 Il Sistema esegue: la validazine dell Indice SIP cn il relativ XSD, e degli eventuali metadati specifici presenti cn l XSD relativ ai Dati specifici previsti per la tiplgia dell ggett versat; il cntrll semantic sui metadati estraplati dall Indice SIP inviat; il calcl degli appsiti attributi sui Cmpnenti inviati: identificativi, dimensine file, URN, hash, verifica presenza firma (vedi paragraf per ulteriri dettagli); i cntrlli sui file (Oggetti-dati) inviati: cntrll frmat e cntrll della firma digitale. Pass 3 Al termine dei cntrlli definiti al pass 2, il Sistema esegue il salvataggi del SIP (Indice SIP e relativi file). Pass 4 Il Sistema invia all Applicativ versante un messaggi cn l Esit versament. Specifiche tecniche dei servizi di versament [ 64 ]

65 Descrizine del servizi di versament sincrn Il web service di versament è stat implementat sul mdell ReST 7, all scp di superare le intrinseche limitazini del prtcll SOAP, nat per trasprtare messaggi tra differenti applicazini ma pc adatt per la trasmissine di file di dimensini cnsistenti. Quest mdell di trasmissine è cnsiderat mlt efficiente, perché priv delle svrastrutture impste da SOAP, tra le quali il vincl di dver tradurre tutt il cntenut infrmativ in test XML cn la cnseguente necessità di trasmettere gli allegati binari cdificati tramite Base64. Inltre, l utilizz di un web service ReST cmprta diversi vantaggi: l utilizz del prtcll standard http risulta perfettamente gestibile anche in ambienti in cui sian presenti firewall prxy; il web service risulta cmpletamente sincrn e la mdalità di invcazine richiede l us di un unic prtcll, rendend l svilupp l adeguament di un client, relativamente semplice; la pssibilità fferta dal prtcll HTTP di pter trasmettere gli allegati binari senza cnversine in Base64 cnsente un tangibile increment delle prestazini ed un impieg più efficiente della rete Struttura della chiamata Cme già accennat, il pacchett di infrmazini trasmess dalla chiamata di versament del web service è cstituit da una request http che usa il metd POST ed è cdificata cme multipart/frm-data. L utilizz della mdalità multipart cnsente di inviare tutte le cmpnenti della request in un unica transazine. L utilizz dell encding frm-data è stat scelt perché permette di gestire le parti che cmpngn la request cme se fsser i campi (field) di una frm di una pagina web. In particlare: le infrmazini di tip testuale (cme l Indice SIP) vengn incapsulati in frm fields ; gli allegati binari (file) vengn semplicemente accdati nel pacchett infrmativ, senza dverli cnvertire in frmati testuali quali Base64. I campi che cmpngn la request sn: Nme camp Tip Descrizine VERSIONE Frm field Cntiene la stringa relativa alla versine del web service (al mment quest valre è fissat a 1.4 ) Il sistema gestisce dalla versine 1.2 la retrcmpatibilità. Nel cas in cui il Servizi di versament sia invcat cn una versine precedente all attuale (1.4), il sistema rispnderà cn l XML di Esit redatt in md cnfrme alla versine di XSD indicata nella Request. I casi attualmente pssibili sn i 7 Representatinal State Transfer, Specifiche tecniche dei servizi di versament [ 65 ]

66 seguenti: Request versine 1.1 : Respnse versine 1.2 (unic cas di mancata cincidenza tra la versine della Request e della Respnse); Request versine 1.2 : Respnse versine 1.2; Request versine 1.3 : Respnse versine 1.3; Request versine 1.4 : Respnse versine 1.4. LOGINNAME Frm field Cntiene il nme dell Applicativ versante, cme cnfigurat nel Sistema. Ogni applicativ dvrà essere preventivamente registrat press il PARER all scp di ricevere un identificativ univc. PASSWORD Frm field Cntiene la passwrd di autenticazine dell Applicativ versante. XMLSIP (Id univc) Frm field File field Cntiene l Indice SIP, vver il dcument in frmat XML cntenente i metadati. Per gnun dei Cmpnenti descritti, deve essere specificat un appsit camp ID univc all intern del versament, all scp di pter assciare crrettamente i metadati al file. Il valre di quest camp nn viene cnservat e serve slamente per garantire la cerenza del versament. Cntiene i dati binari del file (Oggett-dati). Quest tip di pacchett dati viene replicat tante vlte quanti sn i file da spedire. L schema che segue mstra la sequenza delle parti che cmpngn la richiesta di versament di un SIP. Specifiche tecniche dei servizi di versament [ 66 ]

67 Figura 2 Richiesta di versament di un SIP Esempi di invcazine della chiamata del web service In quest paragraf sn riprtati esempi di invcazine della chiamata del web service in linguaggi Java e in linguaggi C#. Esempi di invcazine della chiamata del web service in linguaggi Java Specifiche tecniche dei servizi di versament [ 67 ]

68 Di seguit viene mstrat un esempi di cdice Java che effettua l invi di un file. Da ntare cme per la gestine a bass livell del prtcll HTTP venga usata la libreria HttpClient di Apache, il cui us è liber tant in prgetti cmmerciali che Open Surce. imprt java.i.file; imprt rg.apache.http.httpentity; imprt rg.apache.http.httprespnse; imprt rg.apache.http.client.httpclient; imprt rg.apache.http.client.methds.httppst; imprt rg.apache.http.entity.cntenttype; imprt rg.apache.http.entity.mime.httpmultipartmde; imprt rg.apache.http.entity.mime.multipartentitybuilder; imprt rg.apache.http.entity.mime.cntent.filebdy; imprt rg.apache.http.entity.mime.cntent.stringbdy; imprt rg.apache.http.impl.client.httpclientbuilder; imprt rg.apache.http.util.entityutils; public class Uplad { public static vid testuplad(string myupladurl, String filename) thrws Exceptin { POST // crea una nuva istanza di HttpClient, predispnend la chiamata del metd HttpClient httpclient = HttpClientBuilder.create().build(); HttpPst httppst = new HttpPst(myUpladUrl); //Inizializza la request cme multipart, nella mdalità brwser cmpatible che //cnsente di inviare i dati cme campi di una frm web MultipartEntityBuilder reqentity = MultipartEntityBuilder.create(); reqentity.setmde(httpmultipartmde.browser_compatible); //aggiunge alla request il camp testuale VERSIONE reqentity.addpart("versione", new StringBdy("1.4", CntentType.MULTIPART_FORM_DATA)); //aggiunge alla request il camp testuale LOGINNAME reqentity.addpart("loginname", new StringBdy("username_dummy", CntentType.MULTIPART_FORM_DATA)); //aggiunge alla request il camp testuale PASSWORD reqentity.addpart("password", new StringBdy("passwrd_dummy", CntentType.MULTIPART_FORM_DATA)); //aggiunge alla request il camp testuale XMLSIP, cn il dcument XML dei metadati reqentity.addpart("xmlsip", new StringBdy("dati xml dummy", CntentType.MULTIPART_FORM_DATA)); //crea un nuv FileBdy, leggend i dati dal file system FileBdy bin = new FileBdy(new File(filename)); caricat. //aggiunge alla request il il camp binari(file), cn il file appena //il nme del camp _deve_ cincidere cn un degli ID indicati nell XML reqentity.addpart("id1", bin); //impsta la chiamata del metd POST cn i dati appena caricati httppst.setentity(reqentity.build()); System.ut.println("esegu la richiesta... " + httppst.getrequestline()); //invca il web service HttpRespnse respnse = httpclient.execute(httppst); Specifiche tecniche dei servizi di versament [ 68 ]

69 } } //recupera la rispsta HttpEntity resentity = respnse.getentity(); if (resentity!= null) { String page = EntityUtils.tString(resEntity); System.ut.println("Rispsta :" + page); } Tutta la dcumentazine necessaria ad impiegare al megli la libreria Apache HttpClient è reperibile all URL Esempi di invcazine della chiamata del web service in linguaggi C# Di seguit viene mstrat un esempi di cdice C# per il framewrk.net che effettua l invi di un file. In quest cas nn esiste una libreria di us cmune quale la Apache Cmmns che svlga direttamente quest cmpit. Il cdice che segue perciò implementa la chiamata REST tramite le funzini di base del framewrk, per garantire la massima cmpatibilità. Esistn cmunque sul mercat alcune sluzini anche gratuite che cnsentn di effettuare invcazini a WS di tip REST in md più semplice 8. /* * User: Firavanti_F * Date: 13/07/2011 * Time: 18:43 */ using System; using System.Cllectins.Generic; using System.Cllectins.Specialized; using System.IO; using System.Net; using System.Text; namespace PrvaUplad { class Prgram { public static vid Main(string[] args) { string filedaspedire = "c:\\webinstall.lg"; string urldelwebservice = " string useragent = "Brwser fint."; Cnsle.WriteLine("Prva di invi dei dati."); // Leggi il file e memrizzal in un array di byte FileStream fs = new FileStream(fileDaSpedire, FileMde.Open, FileAccess.Read); byte[] data = new byte[fs.length]; fs.read(data, 0, data.length); fs.clse(); // Genera i dati della chiamata POST Dictinary<string, bject> parametriperpst = new Dictinary<string, bject>(); parametriperpst.add("versione", "versine 1.0"); parametriperpst.add("loginname ", "LginDummy"); parametriperpst.add("password ", "passwrddummy"); 8 Si veda ad esempi la libreria RestSharp, gratuita e pen surce Specifiche tecniche dei servizi di versament [ 69 ]

70 parametriperpst.add("xmlsip", "dati xml dummy"); parametriperpst.add("id1", new FrmUplad.FileParameter(data, "ID1", "binary/ctet-stream")); // Prepara la request e ttieni la respnse HttpWebRespnse webrespnse = FrmUplad.MultipartFrmDataPst(urlDelwebService, useragent, parametriperpst); // Elabra la respnse StreamReader respnsereader = new StreamReader(webRespnse.GetRespnseStream()); string fullrespnse = respnsereader.readtend(); webrespnse.clse(); Cnsle.Write(fullRespnse); } } // termina Cnsle.Write("Premere un tast per prseguire... "); Cnsle.ReadKey(true); /// <summary> /// classe di supprt all'uplad di file /// </summary> public static class FrmUplad { private static readnly Encding encding = Encding.UTF8; public static HttpWebRespnse MultipartFrmDataPst(string psturl, string useragent, Dictinary<string, bject> pstparameters) { string frmdatabundary = " "; string cntenttype = "multipart/frm-data; bundary=" + frmdatabundary; byte[] frmdata = GetMultipartFrmData(pstParameters, frmdatabundary); } return PstFrm(pstUrl, useragent, cntenttype, frmdata); private static HttpWebRespnse PstFrm(string psturl, string useragent, string cntenttype, byte[] frmdata) { HttpWebRequest request = WebRequest.Create(pstUrl) as HttpWebRequest; if (request == null) { thrw new NullReferenceExceptin("la request deve essere di tip HTTP."); } inviand // Impsta le prprietà della request request.methd = "POST"; request.cntenttype = cntenttype; request.useragent = useragent; request.ckiecntainer = new CkieCntainer(); request.cntentlength = frmdata.length; // Dbbiam cntare quanti bite stiam using (Stream requeststream = request.getrequeststream()) { // Scrittura sull stream della request requeststream.write(frmdata, 0, frmdata.length); requeststream.clse(); } } return request.getrespnse() as HttpWebRespnse; Specifiche tecniche dei servizi di versament [ 70 ]

71 private static byte[] GetMultipartFrmData(Dictinary<string, bject> pstparameters, string bundary) { // stream temprane in cui scrivere la request multipart Stream frmdatastream = new System.IO.MemryStream(); freach (var param in pstparameters) { if (param.value is FileParameter) { FileParameter filetuplad = (FileParameter)param.Value; // prepara l'header di un frm-field di tip file string header = string.frmat("--{0}\r\ncntent-dispsitin: frm-data; name=\"{1}\"; filename=\"{2}\";\r\ncntent-type: {3}\r\n\r\n", bundary, param.key, filetuplad.filename?? param.key, filetuplad.cntenttype?? "applicatin/ctet-stream"); frmdatastream.write(encding.getbytes(header), 0, header.length); // Scrivi i dati sull stream, senza passare per una stringa frmdatastream.write(filetuplad.file, 0, filetuplad.file.length); // aggiunge un "a cap" per permettere di caricare più file frmdatastream.write(encding.getbytes("\r\n"), 0, 2); } else { // prepara l'header di un frm-field nrmale, cntenente una stringa string pstdata = string.frmat("--{0}\r\ncntent-dispsitin: frm-data; name=\"{1}\"\r\n\r\n{2}\r\n", bundary, param.key, param.value); frmdatastream.write(encding.getbytes(pstdata), 0, pstdata.length); } } // Aggiunge l'ultima parte della request string fter = "\r\n--" + bundary + "--\r\n"; frmdatastream.write(encding.getbytes(fter), 0, fter.length); // Scarica l stream preparat in un array di byte frmdatastream.psitin = 0; byte[] frmdata = new byte[frmdatastream.length]; frmdatastream.read(frmdata, 0, frmdata.length); frmdatastream.clse(); } return frmdata; } /// <summary> /// Struttura che spita le infrmazini relative ad un file da spedire /// </summary> public class FileParameter { public byte[] File { get; set; } public string FileName { get; set; } public string CntentType { get; set; } public FileParameter(byte[] file) : this(file, null) { } public FileParameter(byte[] file, string filename) : this(file, filename, null) { public FileParameter(byte[] file, string filename, string cntenttype) Specifiche tecniche dei servizi di versament [ 71 ]

72 } } { } File = file; FileName = filename; CntentType = cntenttype; } Nta relativa alle cdifiche XML e HTTP La specifica http 1.1 indica che, in mancanza di altri parametri, l standard per la cdifica dei caratteri per la request e per la respnse è l ISO , cmpatibile cn i set di caratteri usati nell Eurpa Centrale. La cdifica ISO è anche quella utilizzata dal Sistema. L Indice del SIP è inserit all'intern di una request POST HTTP, ed è pprtun che rispetti la medesima cdifica ISO sia per evitare ambiguità di interpretazine da parte del Sistema, sia per evitare errate trasfrmazini durante le varie elabrazini fin all arriv nel Sistema. In particlare, nel cas tipic si stia usand una cdifica Unicde (ad esempi UTF-8), gli eventuali caratteri multi-byte (ad esempi le maiuscle accentate) vengn nrmalmente perduti. Per evitare gni prblema di interpretazine imprpria trasfrmazine, sn pssibili diverse sluzini: La sluzine più sicura è effettuare l escape XML di tutt il test cntenut negli attributi stringa dell'xml. In particlare i caratteri nn inclusi nel charset ASCII 7 bit vann cnvertirli nel cdice numeric crrispndente del set di caratteri Unicde. Ad esempi, al pst del carattere À si dvrebbe scrivere "À". Essend la cdifica ASCII 7 bit cmune a tutte le altre, la cdifica usata (e dichiarata) per l'xml diventa ininfluente. Questa sluzine è praticabile anche nel cas il dcument XML venga cstruit senza un tlkit dedicat, cnvertend gni stringa di test tramite funzini di traslazine XML generiche già presenti nelle librerie dei vari linguaggi. Una sluzine alternativa è unifrmare l'xml alla cdifica ISO Questa sluzine ffre il vantaggi di essere di implementazine piuttst semplice ma rischia di prre prblemi qualra i metadati da trasferire presentin caratteri nn cntenuti nella cdifica ISO (ad esempi caratteri specifici di lingue baltiche). Per cdificare l'xml in ISO è necessari: frzare la serializzazine del dcument XML cn la cdifica ISO ; indicare nell header e nell eventuale camp META del dcument XML che la cdifica usata è ISO ; ad esempi <?xml versin="1.0" encding="iso "?> indicare chiaramente nella request http che quest è l encding usat tramite l header Cntent-Type: applicatin/xml; charset=iso Nel linguaggi Java è pssibile usare il metd escapexml della classe StringEscapeUtils frnit da rg.apache.cmmns.lang nella versine 2.x. Specifiche tecniche dei servizi di versament [ 72 ]

73 Ad esempi: lg.inf(stringescapeutils.escapexml("università di BOLOGNA, divisine R&S ")); che prdurrà :16:46,773 INFO [main] it.eng.ff.test.testescape - UNIVERSITÀ di BOLOGNA, divisine R&S In alternativa (e più crrettamente) è pssibile usare l ggett ESCAPE_XML della classe StringEscapeUtils frnit da rg.apache.cmmns.lang3 nella versine 3.x che svlge esattamente quest cmpit, usand una sintassi cme quella indicata di seguit: package it.eng.ff.test; imprt rg.apache.cmmns.lang3.stringescapeutils; imprt rg.apache.cmmns.lang3.text.translate.numericentityescaper; imprt rg.apache.lg4j.lgger; public class TestEscape { private static final Lgger lg = Lgger.getLgger(TestEscape.class); } public static vid main(string[] args) { lg.inf(stringescapeutils.escape_xml.with(numericentityescaper.between(0x7f,integer.max_value)).translate("università di BOLOGNA, divisine R&S")); } Che prdurrà: :03:28,724 INFO [main] it.eng.ff.test.testescape - UNIVERSITÀ di BOLOGNA, divisine R&S Si elencan alcuni riferimenti utili per apprfndire le tematiche dell encding: Per l escape XML: Apache Cmmns Lang: Metd escapexml, nella versine legacy 2.6: Classe StringEscapeUtils, nella versine crrente: Cntrlli sul SIP I cntrlli eseguiti sn sincrni rispett alla chiamata al web service in analisi Cntrlli sull Indice SIP Includn il cntrll frmale e il cntrll semantic sull Indice SIP. Cntrll frmale Specifiche tecniche dei servizi di versament [ 73 ]

74 La cmunicazine cn il servizi di versament utilizza l scambi di messaggi XML strutturati il cui cntenut viene sttpst alla validazine attravers appsiti XSD. L utilizz degli XSD permette: la validazine del cntenut di un element di un attribut rispett a un determinat tip di dat (per esempi, un attribut ptrebbe essere vinclat alla memrizzazine esclusiva di una data di un numer decimale); la verifica della presenza di metadati definiti cme bbligatri. Nel cas di assenza di metadati bbligatri per la tiplgia dcumentaria, l XML nn sarà validat dall applicativ; la verifica della presenza di eventuali attributi nn previsti per quella data tiplgia dcumentaria. Nel cas l XML preveda degli attributi nn previsti per quella data tiplgia, nn sarà validat dall applicativ; la validazine di espressini reglari. Per esempi la verifica che un determinat attribut preveda l immissine di una stringa cmpsta da un numer predefinit di valri (per esempi il cntrll che la partita iva sia cmpsta bbligatriamente da 11 campi). Ogni Indice SIP sarà cmpst di alcune parti fisse generali e di altre specializzate per la tiplgia dcumentaria di riferiment. Per le parti fisse dell Indice SIP, cmuni a tutte le tiplgie di Unità dcumentarie versate, è definit un schema XSD generale. A tale parte fissa sarà assciata la parte variabile in funzine del Versatre e della tiplgia di Unità dcumentaria di Dcument ggett di versament, cnsentend al Sistema di eseguire una validazine frmale dei metadati prpri di gni tiplgia. Cntrll semantic Al termine della prima verifica frmale sull Indice SIP, il Sistema prcede ad una estraplazine dei dati cntenuti nell Indice per un cntrll sui cntenuti. I cntrlli semantici vengn attivati sui metadati che cstituiscn la parte fissa dell Indice SIP (vver la parte nn definita cme Dati specifici). Sui Dati specifici nn pssn essere attivati in quant nn sn nti a priri, per cui su tale categria di metadati viene svlt sl il cntrll frmale tramite XSD descritt al paragraf precedente. I cntrlli eseguiti in questa fase sn i seguenti: 1) Cntrll dell univcità: il Sistema cntrlla che l ggett versat nn sia già presente nel Sistema. 2) Cntrll sulla versine dell XSD: il Sistema cntrlla che la versine dichiarata nell Indice SIP cincida cn quella dichiarata nella chiamata al servizi di versament 3) Cntrll sul sistema versante: il Sistema verifica che l USER_ID dichiarat nell Indice SIP cincida cn quella dichiarata nel LOGINNAME nella chiamata al servizi di versament Specifiche tecniche dei servizi di versament [ 74 ]

75 4) Cntrll di validità: il Sistema esegue un cntrll sulla validità alla data di versament dei seguenti elementi: Tiplgia di Unità Dcumentaria Tiplgia di Dcument Tip Struttura Dcument Tip Cmpnente Tip Rappresentazine Frmat File Versat Registr Ammess Il cntrll su questi elementi viene svlt verificand che l element in questine sia valid al mment del versament. Ad esempi, se una certa tiplgia di Unità dcumentaria nn è più gestita dal Sggett versante, questa viene dichiarata nel Sistema nn più valida e, nel cas in cui in un mment successiv alla data di sppressine sia effettuat il versament di un Unità dcumentaria appartenente a quella tiplgia, il versament fallisce Cntrlli sui file (Oggetti-dati) I cntrlli eseguiti sui file (Oggetti-dati) cntenuti nel SIP e descritti nei Cmpnenti riguardan la firma digitale e i frmati Cntrlli sulla firma digitale I file (Oggetti-dati) cntenuti nel SIP pssn essere firmati digitalmente. La firma può essere embedded detached: nel prim cas è cntenuta nel file cn il cntenut firmat, descritt nel Cmpnente; nel secnd è cntenuta in un file distint rispett a quell che cntiene il cntenut firmat ed è descritta da un Sttcmpnente il cui TipCmpnente è Firma (vedi paragraf ). I cntrlli sulla firma sn svlti in due ccasini: al versament, in sede di verifica del SIP, e alla chiusura del Vlume di cnservazine dell Elenc di versament. Quest ultim cntrll viene effettuat alla data cntenuta nella marca temprale appsta sul Vlume di cnservazine sull Elenc di versament. Su gni file firmat viene eseguit, sl al mment del versament, il cntrll di cnfrmità della firma (sia embedded che detached) per verificare se la sua struttura è cnfrme rispett ai frmati di firma ricnsciuti dal Sistema. I frmati di firma ricnsciuti, sn: P7M (PKCS#7/CMS) (cme definit in RFC 5652 e RFC 2315); CAdES / CAdES_T (cme definit in ETSI TS e RFC 3161); XML Signature (RFC 3075) / XAdES / XAdES_T (cme definit in ETSI TS ); Specifiche tecniche dei servizi di versament [ 75 ]

76 PDF Signature / PAdES (cme definit in ETSI TS ). Il cntrll si articla nei seguenti passi: 1) Il Sistema effettua il cntrll del frmat della firma: a) se è determinabile, l esit cntrll cnfrmità è POSITIVO; b) se il frmat della firma nn è determinabile l esit del versament varia a secnda dei parametri di versament nell Indice SIP e delle cnfigurazini della Struttura versante sul Sistema, vver: Esit versament pari a WARNING: se nell Indice SIP il parametr Frza accettazine è settat a True e la struttura versante prevede di accettare firme cn frmat nn cnsciut (parametr Firma scnsciuta pari a True). In questi casi il Sistema registra la firma specificand: cdice, cgnme e nme del firmatari pari a SCONOSCIUTO ; l esit del cntrll di cnfrmità pari a FORMATO_NON_CONOSCIUTO, cn il messaggi pari a Frmat firma nn ricnsciut ; il frmat della firma; nulle le altre infrmazini della firma. Esit versament pari a NEGATIVO: se il frmat della firma nn è determinabile e Frza accettazine è settat a False, ppure se Frza accettazine è True ma nella Struttura versante è abilitat il parametr che prevede di nn accettare firme cn frmat nn cnsciut (parametr Firma scnsciuta pari a false). 2) Il Sistema effettua il cntrll della cnfrmità del frmat di firma, per determinare se la struttura della firma è cnfrme al su frmat. L esit del versament dipende dai parametri presenti nell Indice SIP e dalle cnfigurazini della Struttura versante nel Sistema, vver: Esit versament pari a WARNING: nel cas in cui la struttura della firma nn sia cnfrme e nell Indice SIP il parametr Frza accettazine sia settat a True e la struttura versante prevede di accettare firme cn frmat nn cnfrme (parametr Firma nn cnfrme pari a True). In questi casi, il Sistema registra la firma specificand: cdice, cgnme e nme del firmatari pari ai valri definiti dalla firma (se determinabili), ppure pari a SCONOSCIUTO ; l esit del cntrll di cnfrmità pari a FORMATO_NON_CONFORME cn il messaggi pari a Struttura firma nn cnfrme rispett al su frmat ; il frmat della firma; nulle le altre infrmazini della firma. Esit versament pari a NEGATIVO: nel cas in cui la struttura della firma nn sia cnfrme e Frza accettazine sia settat a False, ppure Frza accettazine sia True ma nella Struttura versante è abilitat il parametr che prevede di nn accettare firme cn tip nn cnfrme alla struttura (parametr Firma nn cnfrme pari a False). Specifiche tecniche dei servizi di versament [ 76 ]

77 3) Il Sistema determina l eventuale data della firma, vver la data cntenuta nella firma stessa e la data da usare cme riferiment temprale per il cntrll della firma. La data è individuata da una delle seguenti date, scelta in base all rdine indicat: a) data cntenuta in un eventuale marca temprale detached a nrma semplice (qualra fsser presenti più marche detached si utilizzerà la prima marca versata cme sttcmpnente); b) data cntenuta in un eventuale marca temprale embedded; c) data della firma appsta sul file (nel cas nell Indice SIP sia valrizzat True il tag <UtilizzDataFirmaPerRifTemp> e la data della firma è presente nella firma stessa); d) data del riferiment temprale definita dal Versatre (nel cas abbia indicat tale pzine nell Indice SIP valrizzand i tag presenti in <RiferimentTemprale>); e) data di versament definita dal web service di versament. 4) Il Sistema verifica se, alla data da usare cme riferiment temprale, il frmat di firma ricnsciut è fra quelli ammessi successivamente al 30/6/2011 dalla Deliberazine CNIPA n. 45 del 21 maggi 2009: a) se il frmat della firma è fra quelli previsti dalla Delibera 45 del CNIPA, il Sistema registra la firma cn le infrmazini previste, specificand il riferiment temprale (e relativa tiplgia) usat per il cntrll, l esit del cntrll di cnfrmità pari a POSITIVO cn il messaggi pari a Frmat ricnsciut e cnfrme ; b) se il frmat della firma nn è fra quelli previsti dalla Delibera 45 del CNIPA, l esit del versament sarà determinat in base ai parametri di versament e cnfigurazine presenti rispettivamente nell Indice SIP e nel Sistema, vver: esit versament WARNING: se nell Indice SIP il parametr Frza Accettazine è valrizzat True e la Struttura versante accetta firme nn ammesse dalla Delibera 45 (parametr Firma n Delibera 45 settat a True). In quest cas il Sistema registra la firma cn le infrmazini previste, specificand il riferiment temprale (e relativa tiplgia) utilizzat per la verifica, e definisce il cntrll di cnfrmità pari a NON_AMMESSO_DELIB_45_CNIPA cn il messaggi pari a Frmat ricnsciut e cnfrme anche se nn ammess dalla delibera 45 del CNIPA ; esit versament NEGATIVO: se nell Indice SIP Frza accettazine è valrizzat False ppure cn True ma la Struttura versante nn accetta firme nn ammesse dalla Delibera 45 (parametr Firma n Delibera 45 settat a False). Il file è definit nn firmat se il Sistema nn rileva alcuna firma se almen una delle sue firme è pari a FORMATO_NON_CONOSCIUTO 9. Se la firma risulta cnfrme, ciè se l esit del cntrll è POSITIVO NON_AMMESSO_DELIB_45_CNIPA, la verifica prsegue cn i seguenti cntrlli: CRITTOGRAFICO, CATENA TRUSTED, CERTIFICATO E CRL Nel cas in cui i file appartenenti a un SIP sian tutti nn firmati, il versament va a bun fine se il parametr di versament Frza Cnservazine nell Indice SIP è settat a True. 10 Per le firme il cui esit del cntrll di cnfrmità è pari a FORMATO_NON_CONFORME i cntrlli CRITTOGRAFICO, CATENA TRUSTED, CERTIFICATO e CRL assumn valre pari a NON_ESEGUITO. Specifiche tecniche dei servizi di versament [ 77 ]

78 A. Cntrll CRITTOGRAFICO Al versament, il cntrll viene svlt sempre, tranne nel cas in cui è disabilitat per la Struttura versante. Alla chiusura del Vlume di cnservazine dell Elenc di versament, il cntrll viene svlt sl se l esit al versament è pari a DISABILITATO. Negli altri casi nn è svlt e viene assunt l esit del cntrll al versament. Il cntrll Crittgrafic può prdurre i seguenti esiti: Cdice esit Messaggi esit Osservazini Esit versament POSITIVO Cntrll OK POSITIVO NEGATIVO Cntrll fallit Se Frza accettazine è True e sul Sistema il parametr Cntrll crittgrafic negativ è True, l esit versament è WARNING NEGATIVO WARNING DISABILITATO Il cntrll è disabilitat Il cntrll nn è svlt perché nn abilitat per la Struttura (parametr Cntrll crittgrafic pari a False) POSITIVO ERRORE Cntrll nn svlt per errre del Sistema Il sftware di cntrll ha rilevat un errre NEGATIVO B. Cntrll di tip CATENA TRUSTED Al versament il cntrll viene svlt sempre, tranne nel cas in cui è disabilitat per la Struttura versante. Alla chiusura del Vlume di cnservazine dell Elenc di versament, il cntrll viene svlt sl se l esit al versament è pari a DISABILITATO. Il cntrll nn è svlt se l esit al versament è NEGATIVO, se invece l esit al versament è POSITIVO è svlt il cntrll sulla validità/scadebza dei certificati della catena trusted. Il cntrll Catena trusted può prdurre i seguenti esiti: Cdice esit Messaggi esit Osservazini POSITIVO Cntrll OK Esit versament POSITIVO Specifiche tecniche dei servizi di versament [ 78 ]

79 Cdice esit Messaggi esit Osservazini NEGATIVO DISABILITATO ERRORE Cntrll fallit Il cntrll è disabilitat Cntrll nn svlt per errre del Sistema Se Frza accettazine è True e sul Sistema il parametr Cntrll catena trusted negativ è True, l esit versament è WARNING Il cntrll nn è svlt perché nn abilitat per la Struttura (parametr Cntrll catena trusted pari a False) Il sftware di cntrll ha rilevat un errre Esit versament NEGATIVO WARNING POSITIVO NEGATIVO C. Cntrll di tip CERTIFICATO Il cntrll viene svlt sempre, sia al versament che alla chiusura del Vlume di cnservazine Elenc di versament, tranne nel cas in cui è disabilitat per la Struttura versante. Il cntrll sul Certificat può prdurre i seguenti esiti: Cdice esit Messaggi esit Osservazini Esit versament POSITIVO Cntrll OK POSITIVO CERTIFICATO_SCADUTO Il certificat è scadut Se Frza accettazine è True e sul Sistema il parametr Cntrll certificat scadut è True, l esit versament è WARNING NEGATIVO WARNING CERTIFICATO_NON_VALIDO Il certificat nn è ancra valid Se Frza accettazine è True e sul Sistema il parametr Cntrll certificat nn valid è True, l esit versament è WARNING NEGATIVO WARNING CERTIFICATO_ERRATO Il certificat nn è un certificat di firma Se Frza accettazine è True e sul Sistema il parametr Cntrll certificat n cert. è True, l esit versament è WARNING NEGATIVO WARNING Specifiche tecniche dei servizi di versament [ 79 ]

80 Cdice esit Messaggi esit Osservazini Esit versament DISABILITATO Il cntrll è disabilitat Il cntrll nn è svlt perché nn abilitat per la Struttura (parametr Cntrll certificat pari a False) POSITIVO ERRORE Cntrll nn svlt per errre del Sistema Il sftware di cntrll ha rilevat un errre NEGATIVO D. Cntrll di tip CRL Il cntrll viene svlt sempre, sia al versament che alla chiusura del Vlume di cnservazine Elenc di versament, tranne nel cas in cui è disabilitat per la Struttura versante. Il cntrll sulle CRL può prdurre i seguenti esiti: Cdice esit Messaggi esit Osservazini Esit versament POSITIVO Cntrll OK POSITIVO CERTIFICATO_REVOCATO CRL_SCADUTA CRL_NON_VALIDA CRL_NON_SCARICABILE Il certificat è stat revcat Il cntrll nn è svlt perché la CRL scaricata è scaduta Il cntrll nn è svlt perché la CRL nn è valida (ad es. per mancanza della data di scadenza) Il cntrll nn è svlt perché la CRL nn è scaricabile dal server Se Frza accettazine è True e sul Sistema il parametr Cntrll crl negativ è True, l esit versament è WARNING Se Frza accettazine è True e sul Sistema il parametr Cntrll crl scaduta è True, l esit versament è WARNING Se Frza accettazine è True e sul Sistema il parametr Cntrll crl nn valida è True, l esit versament è WARNING Se Frza accettazine è True e sul Sistema il parametr Cntrll crl nn scaricabile è True, l esit versament è WARNING NEGATIVO WARNING NEGATIVO WARNING NEGATIVO WARNING NEGATIVO WARNING Specifiche tecniche dei servizi di versament [ 80 ]

81 CERTIFICATO_SCADUTO_ 3/12/2009 DISABILITATO NON_NECESSARIO ERRORE Il cntrll nn è svlt perché il certificat è scadut prima del 3/12/2009 Il cntrll è disabilitat Il cntrll nn è necessari Cntrll nn svlt per errre del Sistema A partire dal 3/12/2009 le CA sn bbligate a mantenere nelle CRL anche i certificati scaduti Il cntrll nn è svlt perché nn abilitat per la Struttura (parametr Cntrll crl pari a False) Il cntrll nn viene svlt quand il cdice esit del cntrll di tip CERTIFICATO è divers da POSITIVO DISABILITATO. Il sftware di cntrll ha rilevat un errre WARNING POSITIVO POSITIVO NEGATIVO La figura che segue illustra le dipendenze fra i cntrlli definite spra. Versament se esit cntrll CERTIFICATO pari a POSITIVO DISABILITATO CRITTOGRAFICO CATENA_TRUSTED CERTIFICATO CRL se esit cntrll uguale a DISABILITATO se esit cntrll uguale a DISABILITATO Chiusura Vlume/Elenc CRITTOGRAFICO CATENA_TRUSTED CERTIFICATO CRL La verifica al versament delle firme esamina le firme dei file di gni Cmpnente cmpres nel SIP. Gli esiti cmplessivi della verifica della firma al versament sn i seguenti: 1) Per la singla firma Cdice Messaggi Osservazini POSITIVO NEGATIVO Esit psitiv Esit negativ Se tutti i cntrlli hann restituit esit di tip psitiv Se almen un cntrll ha restituit esit di tip negativ Specifiche tecniche dei servizi di versament [ 81 ]

82 WARNING Esit cn warning Se almen il cntrll di tip CRL ha restituit esit di tip warning e gli altri cntrlli hann restituit esit di tip psitiv 2) Per il Cmpnente (file) Cdice Messaggi Osservazini POSITIVO NEGATIVO WARNING Esit psitiv Esit negativ Esit cn warning Se tutte le firme hann esit della verifica POSITIVO Se almen una firma ha esit della verifica NEGATIVO Se almen una firma ha esit della verifica pari a WARNING e le altre firme hann esit POSITIVO 3) Per il Dcument Cdice Messaggi Osservazini POSITIVO NEGATIVO WARNING Esit psitiv Esit negativ Esit cn warning Se tutti i file hann esit della verifica delle firme POSITIVO Se almen un file ha esit della verifica delle firme NEGATIVO Se almen un file ha esit della verifica delle firme pari a WARNING e le altre firme hann esit POSITIVO 4) Per l Unità dcumentaria Cdice Messaggi Osservazini POSITIVO NEGATIVO WARNING Esit psitiv Esit negativ Esit cn warning Se tutti i dcumenti hann esit della verifica delle firme POSITIVO Se almen un dcument ha esit della verifica delle firme NEGATIVO Se almen un dcument ha esit della verifica delle firme pari a WARNING e le altre firme hann esit POSITIVO Alla chiusura del Vlume di cnservazine dell Elenc di versament, l esit cmplessiv della verifica firma è definit in funzine degli esiti dei cntrlli svlti su tale firma, cme segue. 1) Per la singla firma Cdice Messaggi Osservazini POSITIVO NEGATIVO Esit psitiv Esit negativ Se tutti i cntrlli hann restituit esit di tip psitiv Se almen un cntrll ha restituit esit di tip negativ Specifiche tecniche dei servizi di versament [ 82 ]

83 2) Per il Cmpnente (file) Cdice Messaggi Osservazini POSITIVO NEGATIVO Esit psitiv Esit negativ Tutte le firme del cmpnente hann esit della verifica di chiusura pari a POSITIVO Almen una firma del cmpnente ha esit pari a NEGATIVO Cntrlli sulla marca temprale I file (Oggetti-dati) cntenuti nel SIP pssn essere marcati tempralmente. La marca temprale può essere embedded detached: nel prim cas è cntenuta nel file cn il cntenut marcat, descritt nel Cmpnente; nel secnd è cntenuta in un file distint rispett a quell che cntiene il cntenut firmat ed è descritta da un Sttcmpnente il cui TipCmpnente è Marca (vedi paragraf ). I cntrlli sulla marca sn svlti sl al versament, in sede di verifica del SIP e sn i seguenti: cntrll di CONFORMITÀ; cntrll CRITTOGRAFICO; cntrll di CATENA_TRUSTED del certificat della TSA (Time Stamp Autrithy); cntrll di validità del CERTIFICATO della TSA; cntrll di CRL del certificat della TSA. Il cntrll di cnfrmità della marca (sia embedded che detached) cnsiste nel verificare che la marca temprale sia aderente ad un dei frmati definiti dalla Deliberazine CNIPA 45/2009. I frmati embedded sn: CAdES_T (cme definit in ETSI TS e RFC 3161); XAdES_T (cme definit in ETSI TS ); PAdES (cme definit in ETSI TS ). I frmati detached sn: TST - TimeStampTken (ETSI TS e RFC 3161); TSR TimeStampRespnse (ETSI TS e RFC 3161). Il cntrll di CONFORMITÀ può frnire un dei seguenti esiti. Cdice esit Messaggi esit Osservazini Esit versament Specifiche tecniche dei servizi di versament [ 83 ]

84 POSITIVO Cntrll OK POSITIVO FORMATO_NON_CONOSCIUTO Frmat nn cnsciut NEGATIVO Il cntrll di tip CRITTOGRAFICO cnsiste nel verificare la crrispndenza tra marca temprale e cntenut marcat e può frnire un dei seguenti esiti. Cdice esit Messaggi esit Osservazini Esit versament POSITIVO Cntrll OK POSITIVO NEGATIVO ERRORE L hash del dcument marcat nn crrispnde all hash su cui è stata appsta la marca temprale Il cntrll nn è svlt per errre del sistema Il sftware di cntrll ha rilevat un errre NEGATIVO NEGATIVO Il cntrll di CATENA_TRUSTED cnsiste nel verificare l appartenenza del certificat della TSA nella lista dei certificatri accreditati da AgID. Il cntrll può frnire un dei seguenti esiti. Cdice esit Messaggi esit Osservazini Esit versament POSITIVO Cntrll OK POSITIVO NEGATIVO ERRORE La TSA nn è tra quelle accreditate da AgID Il cntrll nn è svlt per errre del sistema Il sftware di cntrll ha rilevat un errre NEGATIVO NEGATIVO Il cntrll di validità del CERTIFICATO cnsiste nel verificare che la data della marca sia cmpresa nel perid di validità del certificat della TSA. Cdice esit Messaggi esit Osservazini Esit versament POSITIVO Cntrll OK POSITIVO NEGATIVO ERRORE La data di generazine della marca temprale è [successiva / precedente] alla data di [scadenza / inizi validità] del certificat Il cntrll nn è svlt per errre del sistema Il sftware di cntrll ha rilevat un errre NEGATIVO NEGATIVO Specifiche tecniche dei servizi di versament [ 84 ]

85 Il cntrll di validità di CRL del certificat della TSA cnsiste nel verificare, alla data della marca temprale, la revca la sspensine del certificat della TSA. Può prdurre un dei seguenti esiti. Cdice esit Messaggi esit Osservazini POSITIVO CERTIFICATO_REVOCATO CRL_SCADUTA CRL_NON_VALIDA CRL_NON_SCARICABILE CERTIFICATO_SCADUTO_ 3/12/2009 NON_NECESSARIO ERRORE Cntrll nn ha rilevat errri, il certificat della TSA nn è revcat Il certificat della TSA è stat [revcat / sspes] Il cntrll nn è svlt perché la CRL utilizzata è scaduta Il cntrll nn è svlt perché la CRL nn è valida (ad es. per mancanza della data di scadenza) Il cntrll nn è svlt perché la CRL nn è scaricabile dal server Il cntrll nn è svlt perché la CRL nn è dispnibile ed il certificat della TSA è scadut prima del 3/12/2009 Il cntrll nn è necessari Il cntrll nn è svlt per errre del sistema A partire dal 3/12/2009 le CA sn bbligate a mantenere nelle CRL anche i certificati scaduti Il cntrll nn è svlt perché nn necessari (il cntrll CERTIFICATO ha dat un esit negativ) Il sftware di cntrll ha rilevat un errre Esit versament POSITIVO NEGATIVO NEGATIVO NEGATIVO NEGATIVO NEGATIVO POSITIVO NEGATIVO Qualra al mment del versament il cntrll di cnfrmità restituisca un esit POSITIVO è necessari prcedere cn gli altri cntrlli, viceversa, se l esit dvesse risultare FORMATO_NON_CONOSCIUTO, ulteriri cntrlli NON vengn effettuati e l esit da restituire al versament per la marca temprale sarà pari a WARNING. Effettuati gli altri cntrlli (CRITTOGRAFICO, CATENA_TRUSTED, CERTIFICATO e CRL), l esit da restituire al versament sarà pari a: Esit versament Messaggi Osservazini Specifiche tecniche dei servizi di versament [ 85 ]

86 POSITIVO WARNING Esit psitiv Esit warning Se tutti i cntrlli hann restituit esit di tip psitiv Se almen un cntrll ha restituit esit negativ Il risultat dei cntrlli sulla marca temprale servn a determinarne l us, cme riferiment temprale estern, per i cntrlli di verifica firma al versament: se tutti i cntrlli hann restituit esit di tip psitiv ppure sl quell di CATENA_TRUSTED ha avut un esit negativ, la marca temprale dvrà essere utilizzata dai cntrlli di firma al versament; se un tra i seguenti cntrlli: CONFORMITÀ, CRITTOGRAFICO, CERTIFICATO CRL ha restituit un esit negativ la marca temprale nn può essere utilizzata cme riferiment temprale estern Cntrlli sui frmati Il Sistema effettua le seguenti verifiche sui frmati dei file cntenuti nel SIP: Verifica dell ammissibilità del frmat versat: ha l biettiv di verificare che il frmat del file versat rientri tra i Frmati ammessi per la specifica Struttura versante (vedi paragraf 3.2 del Manuale di cnservazine), ciè i frmati cncrdati tra Prduttre e ParER. Il metd di verifica dell ammissibilità del frmat riceve in input il frmat del file dichiarat nell Indice SIP in fase di versament (nel tag <FrmatFileVersat>) e verifica che sia presente tra i frmati ammessi per la quella Struttura versante. L esit della verifica di ammissibilità ptrà essere: Psitiv (frmat ammess): il frmat ricnsciut rientra nella lista dei frmati ammessi entr la Struttura versante; Negativ (frmat NON ammess): il frmat ricnsciut NON rientra nella lista dei frmati ammessi per la Struttura versante. Il prcess di versament viene interrtt. Verifica del frmat: verifica che il frmat del file ricevut crrispnda al frmat dichiarat nell Indice SIP (nel tag <FrmatFileVersat>). Se il file versat è un Cmpnente un Sttcmpnente cn <TipCmpnente> divers da FIRMA da MARCA, viene sttpst al cntrll frmat. Nel cas in cui il file versat sia firmat marcat, viene prima sbustat e si sttpne al cntrll frmat il file sbustat. Per eseguire il ricnsciment del frmat il sistema determina il mimetype del file versat e la cnfrnta cn il frmat assciat a quel mimetype nel Registr dei frmati del Sistema (Frmat di rappresentazine). Verifica dell idneità alla cnservazine del frmat: se il frmat è ricnsciut, il Sistema verifica sul Registr dei frmati cme è definita per quel frmat l idneità alla cnservazine a lung termine, per determinare se il frmat in questine sia: IDONEO, vver nn ha la necessità di essere cnvertit in altr frmat in quant già idne alla cnservazine a lung termine; Specifiche tecniche dei servizi di versament [ 86 ]

87 GESTITO, vver nn idne alla cnservazine a lung termine, ma che può essere migrat in un Frmat idne; DEPRECATO, vver nn idne alla cnservazine a lung termine e che nn può essere cnvertit in un Frmat idne. I Frmati deprecati sn accettati dal Sistema su esplicita richiesta del Prduttre, ma per essi nn può essere garantita la cnservazine a lung termine. Il Sistema cnsente di cnfigurare per gni struttura versante dei parametri che cnsentn di gestire le mdalità cn cui avvengn le verifiche di frmat al mment del versament: Abilita cntrll frmat: indica se effettuare il cntrll frmati sui SIP per una determinata Struttura versante; Accetta cntrll frmat negativ: indica se accettare il SIP anche se il cntrll frmati sui Cmpnenti cn Tip supprt = FILE restituisce esit negativ. Se il parametr risulta attiv, eseguend il versament cn Frza accettazine impstat a True è pssibile frzare il versament di un SIP che cntiene almen un file che presenta un errre nella verifica dei frmati. In cas di errre sul frmat pssn verificarsi le seguenti casistiche: PARAMETRI SISTEMA DI CONSERVAZIONE Abilita cntrll frmat = FALSE Abilita cntrll frmat = TRUE ESITO CONTROLLI Il cntrll del frmat nn viene eseguit. Nell Esit versament il tag <VerificaRicnscimentFrmat> è valrizzat cn DISABILITATO. Se il Frmat versat nn cincide cn il Frmat di rappresentazine il Sistema frnisce un messaggi di errre: Il frmat di rappresentazine calclat è divers da quell versat. Se il Frmat versat cincide cn il Frmat di rappresentazine, l esit è POSITIVO Se il Frmat versat nn cincide cn il Frmat di rappresentazine: Accetta cntrll frmat negativ = TRUE se il tag <Frza Accettazine> = True il tag <VerificaRicnscimentFrmat> è valrizzat cn WARNING; se il tag <Frza Accettazine> = False il tag <VerificaRicnscimentFrmat> è valrizzat cn NEGATIVO. Se il Frmat versat cincide cn il Frmat di rappresentazine, l esit è POSITIVO Specifiche tecniche dei servizi di versament [ 87 ]

88 Accetta cntrll frmat negativ = FALSE Se il Frmat versat nn cincide cn il Frmat di rappresentazine il tag <VerificaRicnscimentFrmat> è valrizzat cn NEGATIVO. Se il Frmat versat cincide cn il Frmat di rappresentazine, l esit è POSITIVO Il Rapprt di versament Nel cas in cui il versament restituisca un esit POSITIVO WARNING, il Sistema genera, per gni SIP, un Rapprt di versament per attestarne l avvenuta acquisizine e presa in caric. Il Rapprt di versament è un dcument in frmat XML la cui struttura dati è la seguente: Metadat Versine URNRapprtVersament Descrizine Indica la versine di XSD utilizzata per la prduzine del Rapprt di versament. L attuale versine è 1.0. È l identificativ univc del Rapprt di versament, cstruit cn la seguente sintassi: Urn:RapprtVersament:URN Unità dcumentaria/urn Dcument. Esempi di URN di Rapprt di versament di SIP di Unità dcumentaria: Urn:RapprtVersament:Parer:EnteX:AOOX:Prtcll Esempi di URN di Rapprt di versament di SIP di Dcument: Urn:RapprtVersament:Parer:EnteX:AOOX:Prtcll ANNOTAZIONE-1. DataRapprtVersament Data di prduzine del Rapprt di versament. Tag cntenente i seguenti tag: CdiceEsit (assume valri POSITIVO WARNING NEGATIVO); EsitGenerale CdiceErrre (valrizzat sl nel cas di esit WARNING NEGATIVO cn il cdice dell errre riscntrat); MessaggiErrre (valrizzat sl nel cas di esit WARNING NEGATIVO cn la descrizine dell errre riscntrat). Tag riprtante gli eventuali ulteriri warning. Il tag cntiene n Tag <Warning> ciascun dei quali è descritt attravers i tag <CdiceWarning> e <DescrizineWarning> secnd la seguente struttura: WarningUlteriri <WarningUlteriri>; <Warning>; <CdiceWarning>; <DescrizineWarning>. Specifiche tecniche dei servizi di versament [ 88 ]

89 Tag riprtante gli estremi del Versatre. Cntiene i seguenti tag: Versatre Ambiente; Ente; Struttura; UserID. Tag cntenente la descrizine sintetica del pacchett versat. Cmprende i seguenti tag: SIP URNIndiceSIP: urn dell Indice del pacchett versat; HashIndiceSIP: hash dell Indice del pacchett versat; AlgritmHashIndiceSIP: algritm utilizzat per il calcl dell hash dell Indice del pacchett versat. Attualmente è utilizzat SHA-1; EncdingHashIndiceSIP: encding utilizzat per il calcl dell hash dell Indice del pacchett versat. Attualmente è utilizzat hexbinary; URNPISIP: tag presente sl per i SIP nn standard versati in mdalità asincrna. È valrizzat cn l urn del PI - Packaging Infrmatin, vver il file XML che, nel cas di versament asincrn, cntiene le infrmazini sull impacchettament del SIP; HashPISIP: tag presente sl per i SIP nn standard versati in mdalità asincrna. È valrizzat cn l hash del file PI - Packaging Infrmatin; AlgritmHashPISIP: tag presente sl per i SIP nn standard versati in mdalità asincrna. È valrizzat cn l algritm utilizzat per la prduzine dell hash del file PI - Packaging Infrmatin; EncdingHashPISIP: tag presente sl per i SIP nn standard versati in mdalità asincrna. È valrizzat cn l encding utilizzat per la prduzine dell hash del file PI - Packaging Infrmatin; DataVersament: indica la data di apertura della sessine di versament; Unita Dcumentaria: cntiene una descrizine sintetica dell UD versata. Cmprende i seguenti tag: Chiave (Registr-Ann-Numer dell ud); TiplgiaUnitaDcumentaria; DcumentPrincipale; Allegat (presente se il SIP cntiene allegati); Anness (presente se il SIP cntiene annessi); Specifiche tecniche dei servizi di versament [ 89 ]

90 Anntazine (presente se il SIP cntiene anntazini). Ogni tag riferit a un Dcument (DcumentPrincipale, Allegat, Anness, Anntazine) viene descritt attravers i seguenti tag: ChiaveDc (Registr-Ann-Numer dell Unità dcumentaria- Element-numer element); IDDcument (identificativ del Dcument frnit dal versatre); Tip Dcument (tiplgia di dcument); Firmat Digitalmente (assume valri true false); Cmpnenti (tag cmpst da n tag <Cmpnente>. Rappresenta i Cmpnenti del Dcument). Ogni tag riferit a un Cmpnente viene descritt attravers i seguenti tag: Urn (urn del Cmpnente); Hash (hash del Cmpnente calclat in sede di versament); AlgritmHash (algritm utilizzat per il calcl dell hash); Encding (encding utilizzat per il calcl dell hash). Il Rapprt di versament viene memrizzat nel Sistema e inviat al sggett versante all intern dell Esit versament (vedi paragraf 0) nel cas di esit POSITIVO e WARNING. In cas di esit NEGATIVO, il Sistema trasmette il Rapprt di Versament nell Esit versament sl nel cas di errre UD generat quand il SIP cntiene un Unità dcumentaria un Dcument già presenti nel Sistema di cnservazine (vedi paragraf ). L XSD del Rapprt di versament è pubblicat sul sit di ParER (vedi paragraf Elenc degli XSD descritti nel presente dcument ) Esempi di Rapprt di versament di Unità dcumentaria <?xml versin="1.0" encding="iso "?> <RapprtVersament> <Versine>1.0</Versine> <URNRapprtVersament>urn:RapprtVersament:PARER:ENTEXXX:STRUTTURAYYY:DELIB ERA </URNRapprtVersament> <DataRapprtVersament> T16:04: :00</DataRapprtVersament> <EsitGenerale> <CdiceEsit>POSITIVO</CdiceEsit> </EsitGenerale> <Versatre> Specifiche tecniche dei servizi di versament [ 90 ]

91 <Ambiente>PARER</Ambiente> <Ente>ENTEXXX</Ente> <Struttura>STRUTTURAYYY</Struttura> <UserID>VersatreYYY</UserID> </Versatre> <SIP> <URNIndiceSIP>urn:IndiceSIP:PARER:ENTEXXX:STRUTTURAYYY:DELIBERA </URNIndiceSIP> <HashIndiceSIP>d29e e f10c bd3a163f9</HashIndiceSIP> <AlgritmHashIndiceSIP>SHA-1</AlgritmHashIndiceSIP> <EncdingHashIndiceSIP>hexBinary</EncdingHashIndiceSIP> <DataVersament> T16:04: :00</DataVersament> <UnitaDcumentaria> <Chiave> <Numer>1020</Numer> <Ann>2014</Ann> <TipRegistr>DELIBERA</TipRegistr> </Chiave> <TiplgiaUnitaDcumentaria>DELIBERA</TiplgiaUnitaDcumentaria> <DcumentPrincipale> <ChiaveDc>DELIBERA PRINCIPALE-1</ChiaveDc> <IDDcument>238</IDDcument> <TipDcument>DOCUMENTO PROTOCOLLATO</TipDcument> <FirmatDigitalmente>TRUE</FirmatDigitalmente> <Cmpnenti> <Cmpnente> <URN>urn:PARER:ENTEXXX:STRUTTURAYYY:DELIBERA PRINCIPALE- 1:1:0</URN> <Hash>d057f271f67f0ab1838e3e1723d9fdc91270e96c</Hash> <AlgritmHash>SHA-1</AlgritmHash> <Encding>hexBinary</Encding> </Cmpnente> </Cmpnenti> </DcumentPrincipale> </UnitaDcumentaria> </SIP> </RapprtVersament> Esempi di Rapprt di versament di Dcument <?xml versin="1.0" encding="utf-8"?> <RapprtVersament> <Versine>1.0</Versine> <URNRapprtVersament>urn:RapprtVersament:PARER:ENTEXXX:STRUTTURAYYY:FATTU RE ANNESSO-2</URNRapprtVersament> <DataRapprtVersament> T15:14: :00</DataRapprtVersament> <EsitGenerale> <CdiceEsit>POSITIVO</CdiceEsit> </EsitGenerale> Specifiche tecniche dei servizi di versament [ 91 ]

92 <Versatre> <Ambiente>PARER</Ambiente> <Ente>ENTEXXX</Ente> <Struttura>STRUTTURAYYY</Struttura> <UserID>VersatreYYY</UserID> </Versatre> <SIP> <URNIndiceSIP>urn:IndiceSIP:PARER:ENTEXXX:STRUTTURAYYY:FATTURE ANNESSO-2</URNIndiceSIP> <HashIndiceSIP>5ed51dc60cf319f05f4427f48ae14ef3a8c31a73</HashIndiceSIP> <AlgritmHashIndiceSIP>SHA-1</AlgritmHashIndiceSIP> <EncdingHashIndiceSIP>hexBinary</EncdingHashIndiceSIP> <DataVersament> T15:14: :00</DataVersament> <UnitaDcumentaria> <Chiave> <Numer>1</Numer> <Ann>2014</Ann> <TipRegistr>FATTURE</TipRegistr> </Chiave> <TiplgiaUnitaDcumentaria>FATTURA ATTIVA</TiplgiaUnitaDcumentaria> <Anness> <ChiaveDc>FATTURE ANNESSO-2</ChiaveDc> <IDDcument>urn:efatturapa:2014:1:CA:RICEVUTA_DI_CONSEGNA:S DI</IDDcument> <TipDcument>RICEVUTA DI CONSEGNA</TipDcument> <FirmatDigitalmente>true</FirmatDigitalmente> <Cmpnenti> <Cmpnente> <URN>urn:PARER:ENTEXXX:STRUTTURAYYY:FATTURE ANNESSO-2:1:1</URN> <Hash>23a02ce1de9fd79abfd0b7063bf338505fadc8d9</Hash> <AlgritmHash>SHA-1</AlgritmHash> <Encding>hexBinary</Encding> </Cmpnente> <Cmpnente> <URN>urn:PARER:ENTEXXX:STRUTTURAYYY:FATTURE /1-ANNESSO-2:1:2</URN> </Cmpnente> </Cmpnenti> </Anness> </UnitaDcumentaria> </SIP> </RapprtVersament> L Esit versament (rispsta alla chiamata) Specifiche tecniche dei servizi di versament [ 92 ]

93 In rispsta alla chiamata al Servizi di versament da parte dell'applicativ versante, il Sistema trasmette a quest ultim l Esit versament, un dcument XML che cntiene le infrmazini relative all esit del versament, ai cntrlli effettuati e alle cnfigurazine del Sistema al mment del versament. Include, inltre, il Rapprt di versament. Questa la sua struttura dati: Infrmazini Generali Nme metadat Descrizine Versine Indica la versine dell Esit versament (attualmente 1.4). VersineXMLChiamata Indica la versine dell Indice SIP (attualmente 1.4). Data versament EsitGenerale WarningUlteriri ErrriUlteriri EsitChiamataWS EsitXSD Indica la data di versament del SIP. Indica l esit generale della chiamata al Servizi di versament. In cas tutti i cntrlli abbian esit psitiv, il <CdiceEsit> sarà valrizzat a POSITIVO. Nel cas in cui almen un cntrll ha avut esit negativ viene indicat <CdiceEsit> NEGATIVO, e nei tag <CdiceErrre> e <Messaggi Errre> vengn indicati rispettivamente il cdice e la descrizine del prim errre riscntrat durante i cntrlli sul SIP. In tutti i casi in cui gli esiti negativi del cntrlli nn prtan al falliment del versament per le frzature impstate nei Parametri di versament (Cnfigurazine), il CdiceEsit sarà valrizzat cn WARNING. In cas di esit generale WARNING, cntiene tanti tag Warning quanti sn gli eventuali ulteriri warning (ltre a quell rilevat in Esit generale) rilevati sul SIP in sede di cntrll. Ogni tag Warning cntiene i tag CdiceWarning e MessaggiWarning. In cas di EsitGenerale NEGATIVO, cntiene tanti tag Errre quanti sn gli eventuali ulteriri errri (ltre a quell rilevat in EsitGenerale) rilevati sul SIP in sede di cntrll. Ogni tag Errre cntiene i tag CdiceErrre e MessaggiErrre. Può evidenziare errre nel cas in cui le credenziali dell Applicativ versante nn sian crrette, nel cas in cui la versine nn sia cerente, nel cas in cui i file attesi dichiarati nell Indice SIP nn cincidan cn quelli effettivamente versati. Indica l esit del cntrll dell Indice SIP inviat in chiamata rispett al relativ XSD definit all intern del Servizi. In cas di errre (per esempi per assenza di un metadat definit cme bbligatri) il tag <CdiceEsit> viene valrizzat cn NEGATIVO. Il tag ErrreCntrllStrutturaXML è valrizzat mediante il messaggi prdtt dal parser che esamina l Indice SIP rispett al su XSD. Il tag UnivcitaIDCmpnenti è valrizzat mediante il messaggi prdtt dal cntrll della univcità dell element ID di gni Cmpnente e Sttcmpnente presente nell Indice SIP rispett ai file (Oggetti-dati) cntenuti nel SIP versat. Specifiche tecniche dei servizi di versament [ 93 ]

94 Infrmazini riferite ai dati di cnfigurazine Nme metadat Cnfigurazine Descrizine Nella rispsta vengn riprtati i Parametri di versament presenti nell Indice SIP versat. Inltre, per gli Esiti versament cn Esit generale POSITIVO WARNING, sn riprtati anche i valri presenti al mment del versament di tutti i parametri di cnfigurazine del Sistema per la Struttura versante. Infrmazini riferite all Unità dcumentaria Nme metadat Versatre Descrizine Indicazine di Ambiente, Ente, Struttura e UserID. Numer. Chiave Ann. Tip Registr. DataVersament Data di Versament del SIP. Specifiche tecniche dei servizi di versament [ 94 ]

95 Assume valre POSITIVO se tutti i tag di cui si cmpne assumn valre psitiv. I tag sn i seguenti: EsitUnitaDcumentaria IdentificazineVersatre: è valrizzat cn POSITIVO se il Versatre indicat nell Indice SIP è ricnsciut dal Sistema; UnivcitaChiave: è POSITIVO se la Chiave dell Unità dcumentaria valrizzata nell IndiceSIP di Unità dcumentaria risulta univca nel Sistema per quella determinata Struttura versante; VerificaTiplgiaUD: è POSITIVO se TiplgiaUnitaDcumentaria nell Indice SIP di Unità dcumentaria è presente e valida nel Sistema per quella determinata Struttura versante; CrrispndenzaDatiSpecifici: è POSITIVO se i Dati specifici dell Unità dcumentaria indicati nell Indice SIP crrispndn cn quelli cnfigurati nel Sistema per quella determinata Struttura versante; PresenzaUDCllegate: è POSITIVO se le Unità dcumentarie ggett di Cllegamenti sn presenti nel Sistema; è WARNING se tali Unità dcumentarie nn sn presenti nel Sistema e il parametr FrzaCllegament è settat a True; VerificaFirmeUnitaDcumentaria: è POSITIVO se i cntrlli sulla firma di tutte le firme dei file di tutti i Cmpnenti di tutti i Dcumenti hann esit psitiv; è WARNING se almen un cntrll di firma ha esit negativ e il parametr FrzaAccettazine è True; IdentificazineChiave: è POSITIVO se la Chiave indicata nell Indice SIP di Dcument crrispnde a un Unità dcumentaria presente nel Sistema; DcumentUnivcInUD: è POSITIVO se l IDDcument nell Indice SIP di Dcument risulta essere univc nell Unità dcumentaria. Infrmazini riferite al Dcument Nme metadat Descrizine Specifiche tecniche dei servizi di versament [ 95 ]

96 Assume valre psitiv se tutti i tag di cui si cmpne assumn valre psitiv. I stt tag in ess cntenuti sn i seguenti: EsitDcument VerificaTipDcument: è valrizzat cn NEGATIVO se il tip di Dcument cmunicat cn il tag TipDcument nn è cnigurat nel Sistema per quella determinata Struttura versante; CrrispndenzaDatiSpecifici: è valrizzat cn NEGATIVO se vi sn discrepanze tra i metadati specifici indicati nell Indice SIP e quelli cnfigurati per quella data tiplgia di Dcument per quella determinata Struttura versante; CrrispndenzaDatiFiscali: nn più utilizzat in quant deprecat; VerificaTipStruttura: è valrizzat cn NEGATIVO se il tip struttura cmunicat cn il tag TipStruttura nell Indice SIP nn è cnfigurat nel Sistema per quella determinata Struttura versante; VerificaFirmeDcument: il tag nn è definit se il tag FirmatDigitalmente nel Cmpnente vale false. È valrizzat cn POSITIVO se tutti i tag VerificaFirmeCmpnente dell Esit versament hann valre POSITIVO ; UnivcitaOrdinePresentazine: il Sistema verifica la sequenzialità dell rdine di presentazine dei Cmpnenti che fann parte del Dcument. È valrizzat cn POSITIVO se la sequenzialità del tag OrdinePresentazine è rispettata. Infrmazini riferite al Cmpnente Nme metadat OrdinePresentazine TipCmpnente Urn Hash AlgritmHash Encding FrmatRappresentazine Descrizine Numer che indica l rdine di successine del Cmpnente all intern del Dcument Tiplgia del Cmpnente URN calclat dal Sistema Hash del file calclat dal Sistema Algritm utilizzat generare l hash Tip di encding utilizzat per l hash Frmat del file calclat dal Sistema Specifiche tecniche dei servizi di versament [ 96 ]

97 FrmatRappresentazineEstes DimensineFile FirmatDigitalmente È la cncatenazine del Frmat standard calclat sul file sbustat, seguit dai frmati standard calclati delle buste, nell rdine descending rispett al prgressiv delle buste. Ciascun frmat standard è separat dal precedente mediante.. Se il frmat standard calclat dell sbustat nn è definit, si utilizza la ntazine???. Se per una busta nn è definit il frmat calclat, si utilizza la ntazine???. Indica la dimensine in byte del file calclata dal Sistema Indica se il file è firmat digitalmente men Specifiche tecniche dei servizi di versament [ 97 ]

98 Assume valre psitiv se tutti i tag di cui si cmpne assumn valre psitiv. I tag in ess cntenuti sn i seguenti: EsitCmpnente VerificaTipCmpnente: è valrizzat cn NEGATIVO se il tip di Cmpnente cmunicat cn il tag TipCmpnente nell Indice SIP, nn è cnfigurat nel Sistema; CrrispndenzaDatiSpecifici: è valrizzat cn NEGATIVO se vi sn discrepanze tra i metadati specifici indicati nell Indice SIP e quelli previsti per quella data tiplgia di Cmpnente per quella Struttura versante; VerificaTipSupprtCmpnente: il tag TipSupprtCmpnente nell Indice SIP può essere FILE, RIFERIMENTO METADATI. Se è valrizzat cn RIFERIMENTO, viene cntrllat che sia presente il tag Riferiment ; se è valrizzat cn FILE METADATI, viene cntrllat che il tag Riferiment nn sia presente. In cas di errre VerificaTipSupprtCmpnente viene valrizzat cn NEGATIVO; VerificaNmeCmpnente: è valrizzat cn NEGATIVO se il tag NmeCmpnente nell Indice SIP nn è valrizzat e il tip di supprt è pari a FILE VerificaAmmissibilitaFrmat: è valrizzat cn NEGATIVO se il frmat del file cmunicat cn il tag FrmatFileVersat nell Indice SIP nn è cnfigurat nel Sistema per la struttura versante. VerificaRicnscimentFrmat: Il tag è valrizzat cn: DISABILITATO se sulla struttura versante il parametr Abilita cntrll frmat nn è attiv; POSITIVO se l esit del cntrll frmat è pari a IDONEO GESTITO; WARNING se l esit del cntrll frmat è pari a DEPRECATO; Firmatari NEGATIVO se l esit del cntrll frmat è pari a NEGATIVO. Indica le infrmazini sulla firma appsta sul file: Nme del firmatari, frmat della firma, riferiment temprale utilizzat per il cntrll, nnché l esit di tutti i cntrlli eseguiti sulla firma (Cntrll Crittgrafic, Cntrll Catena Trusted, Cntrll Certificat, Cntrll CRL) Specifiche tecniche dei servizi di versament [ 98 ]

99 Rapprt di versament Nme metadat RapprtVersament Descrizine In cas di esit generale POSITIVO WARNING nel cas di esit NEGATIVO a frnte di errre di Unità dcumentaria Dcument già presente nel Sistema (vedi paragaraf ), quest tag cntiene il Rapprt di versament in frmat stringa (vedi paragraf 2.1.5). L XSD dell Esit versament è pubblicat sul sit di ParER (vedi paragraf Elenc degli XSD descritti nel presente dcument ) Esempi di Esit versament di Unità dcumentaria cn esit generale POSITIVO <?xml versin="1.0" encding="iso "?> <EsitVersament> <Versine>1.4</Versine> <VersineXMLChiamata>1.4</VersineXMLChiamata> <DataVersament> T17:02: :00</DataVersament> <EsitGenerale> <CdiceEsit>POSITIVO</CdiceEsit> </EsitGenerale> <EsitChiamataWS> <VersineWSCrretta>POSITIVO</VersineWSCrretta> <CredenzialiOperatre>POSITIVO</CredenzialiOperatre> <FileAttesiRicevuti>POSITIVO</FileAttesiRicevuti> </EsitChiamataWS> <EsitXSD> <CdiceEsit>POSITIVO</CdiceEsit> <CntrllStrutturaXML>POSITIVO</CntrllStrutturaXML> <UnivcitaIDCmpnenti>POSITIVO</UnivcitaIDCmpnenti> <UnivcitaIDDcumenti>POSITIVO</UnivcitaIDDcumenti> <CrrispndenzaAllegatiDichiarati>POSITIVO</CrrispndenzaAllegatiDichiarati> <CrrispndenzaAnnessiDichiarati>POSITIVO</CrrispndenzaAnnessiDichiarati> <CrrispndenzaAnntaziniDichiarate>POSITIVO</CrrispndenzaAnntaziniDichiarate> </EsitXSD> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>true</FrzaAccettazine> <FrzaCnservazine>true</FrzaCnservazine> <FrzaCllegament>true</FrzaCllegament> <AbilitaCntrllCrittgrafic>true</AbilitaCntrllCrittgrafic> <AbilitaCntrllTrust>true</AbilitaCntrllTrust> <AbilitaCntrllCertificat>true</AbilitaCntrllCertificat> <AbilitaCntrllCRL>true</AbilitaCntrllCRL> <AbilitaCntrllFrmat>true</AbilitaCntrllFrmat> <AccettaFirmaScnsciuta>true</AccettaFirmaScnsciuta> Specifiche tecniche dei servizi di versament [ 99 ]

100 <AccettaFirmaNnCnfrme>true</AccettaFirmaNnCnfrme> <AccettaFirmaNDelibera45>true</AccettaFirmaNDelibera45> <AccettaMarcaScnsciuta>false</AccettaMarcaScnsciuta> <AccettaCntrllCrittgraficNegativ>true</AccettaCntrllCrittgraficNegativ> <AccettaCntrllTrustNegativ>true</AccettaCntrllTrustNegativ> <AccettaCntrllCertificatScadut>true</AccettaCntrllCertificatScadut> <AccettaCntrllCertificatNValid>true</AccettaCntrllCertificatNValid> <AccettaCntrllCertificatNFirma>true</AccettaCntrllCertificatNFirma> <AccettaCntrllCRLNegativ>true</AccettaCntrllCRLNegativ> <AccettaCntrllCRLScaduta>true</AccettaCntrllCRLScaduta> <AccettaCntrllCRLNValida>true</AccettaCntrllCRLNValida> <AccettaCntrllCRLNScaric>true</AccettaCntrllCRLNScaric> <AccettaCntrllFrmatNegativ>true</AccettaCntrllFrmatNegativ> </Cnfigurazine> <UnitaDcumentaria> <Versatre> <Ambiente>PARER</Ambiente> <Ente>XXX</Ente> <Struttura>YYY</Struttura> <UserID>YYY_Versatre</UserID> </Versatre> <Chiave> <Numer>5</Numer> <Ann>2011</Ann> <TipRegistr>PROTOCOLLO</TipRegistr> </Chiave> <DataVersament> T17:02: :00</DataVersament> <StatCnservazine>IN_ATTESA_SCHED</StatCnservazine> <EsitUnitaDcumentaria> <CdiceEsit>POSITIVO</CdiceEsit> <IdentificazineVersatre>POSITIVO</IdentificazineVersatre> <UnivcitaChiave>POSITIVO</UnivcitaChiave> <VerificaTiplgiaUD>POSITIVO</VerificaTiplgiaUD> <CrrispndenzaDatiSpecifici>POSITIVO</CrrispndenzaDatiSpecifici> </EsitUnitaDcumentaria> <DcumentPrincipale> <ChiaveDc>PROTOCOLLO PRINCIPALE-1</ChiaveDc> <IDDcument>015</IDDcument> <TipDcument>Dcument prtcllat</tipdcument> <FirmatDigitalmente>false</FirmatDigitalmente> <EsitDcument> <CdiceEsit>POSITIVO</CdiceEsit> <VerificaTipDcument>POSITIVO</VerificaTipDcument> <CrrispndenzaDatiSpecifici>POSITIVO</CrrispndenzaDatiSpecifici> <CrrispndenzaDatiFiscali>POSITIVO</CrrispndenzaDatiFiscali> <VerificaTipStruttura>POSITIVO</VerificaTipStruttura> <UnivcitaOrdinePresentazine>POSITIVO</UnivcitaOrdinePresentazine </EsitDcument> <Cmpnenti> Specifiche tecniche dei servizi di versament [ 100 ]

101 <Cmpnente> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <Hash>AAAAAAAAA</Hash> <AlgritmHash>tken</AlgritmHash> <Encding>tken</Encding> <FrmatRappresentazine>PDF</FrmatRappresentazine> <FrmatRappresentazineEstes>string</FrmatRappresentazineEste s> <IdneitaFrmat>IDONEO</IdneitaFrmat> <DimensineFile>14563</DimensineFile> <FirmatDigitalmente>false</FirmatDigitalmente> <EsitCmpnente> <CdiceEsit>POSITIVO</CdiceEsit> <VerificaTipCmpnente>POSITIVO</VerificaTipCmpnente> <CrrispndenzaDatiSpecifici>POSITIVO</CrrispndenzaDatiSpecifici> <VerificaTipSupprtCmpnente>POSITIVO</VerificaTipSupprtCm pnente> <VerificaNmeCmpnente>POSITIVO</VerificaNmeCmpnente> <VerificaAmmissibilitaFrmat>POSITIVO</VerificaAmmissibilitaFrmat > <VerificaRicnscimentFrmat>POSITIVO</VerificaRicnscimentFr mat> <MessaggiRicnscimentFrmat>string</MessaggiRicnscimentF rmat> </EsitCmpnente> </Cmpnente> </Cmpnenti> </DcumentPrincipale> </UnitaDcumentaria> <RapprtVersament><?xml versin="1.0" encding="iso "?> <RapprtVersament><Versine>1.0</Versine...;</RapprtVersa ment> </EsitVersament> Esempi di Esit versament di Unità dcumentaria cn esit generale NEGATIVO <Versine>1.4</Versine> <VersineXMLChiamata>1.4</VersineXMLChiamata> <DataVersament> T11:01: :00</DataVersament> <EsitGenerale> <CdiceEsit>NEGATIVO</CdiceEsit> <CdiceErrre>UD </CdiceErrre> <MessaggiErrre>Unità Dcumentaria FLUSSI_ORDINATIVI : l'ann 2007 nn è valid per il tip registr FLUSSI_ORDINATIVI</MessaggiErrre> </EsitGenerale> <EsitChiamataWS> <VersineWSCrretta>POSITIVO</VersineWSCrretta> Specifiche tecniche dei servizi di versament [ 101 ]

102 <CredenzialiOperatre>POSITIVO</CredenzialiOperatre> <FileAttesiRicevuti>POSITIVO</FileAttesiRicevuti> </EsitChiamataWS> <EsitXSD> <CdiceEsit>POSITIVO</CdiceEsit> <CntrllStrutturaXML>POSITIVO</CntrllStrutturaXML> <UnivcitaIDCmpnenti>POSITIVO</UnivcitaIDCmpnenti> <UnivcitaIDDcumenti>POSITIVO</UnivcitaIDDcumenti> <CrrispndenzaAllegatiDichiarati>POSITIVO</CrrispndenzaAllegatiDichiarati> <CrrispndenzaAnnessiDichiarati>POSITIVO</CrrispndenzaAnnessiDichiarati> <CrrispndenzaAnntaziniDichiarate>POSITIVO</CrrispndenzaAnntaziniDichiarate> </EsitXSD> <Cnfigurazine> <TipCnservazine>SOSTITUTIVA</TipCnservazine> <FrzaAccettazine>false</FrzaAccettazine> <FrzaCnservazine>true</FrzaCnservazine> <FrzaCllegament>true</FrzaCllegament> </Cnfigurazine> <UnitaDcumentaria> <Versatre> <Ambiente>PARER</Ambiente> <Ente>regine_emilia-rmagna</Ente> <Struttura>AGREA</Struttura> <UserID>bridge_ agrea</userid> </Versatre> <Chiave> <Numer>819</Numer> <Ann>2007</Ann> <TipRegistr>FLUSSI_ORDINATIVI</TipRegistr> </Chiave> <DataVersament> T11:01: :00</DataVersament> <EsitUnitaDcumentaria> <CdiceEsit>NEGATIVO</CdiceEsit> <IdentificazineVersatre>POSITIVO</IdentificazineVersatre> <UnivcitaChiave>POSITIVO</UnivcitaChiave> <VerificaTiplgiaUD>NEGATIVO</VerificaTiplgiaUD> </EsitUnitaDcumentaria> </UnitaDcumentaria> <XMLVersament><?xml versin="1.0" encding="is "?><unitadcumentaria > <Intestazine> <Versine>1.3</Versine> <Versatre> <Ambiente>PARER</Ambiente> <.. </XMLVersament> </EsitVersament> Esempi di Esit versament di Unità dcumentaria cn esit generale negativ e cdice errre UD Specifiche tecniche dei servizi di versament [ 102 ]

103 <EsitVersament> <Versine>1.4</Versine> <VersineXMLChiamata>1.4</VersineXMLChiamata> <DataVersament> T10:22: :00</DataVersament> <EsitGenerale> <CdiceEsit>NEGATIVO</CdiceEsit> <CdiceErrre>UD </CdiceErrre> <MessaggiErrre> Unità Dcumentaria PROTOCOLLO : la chiave indicata crrispnde ad una Unità Dcumentaria già presente nel sistema </MessaggiErrre> </EsitGenerale> <EsitChiamataWS> <VersineWSCrretta>POSITIVO</VersineWSCrretta> <CredenzialiOperatre>POSITIVO</CredenzialiOperatre> <FileAttesiRicevuti>POSITIVO</FileAttesiRicevuti> </EsitChiamataWS> <EsitXSD> <CdiceEsit>POSITIVO</CdiceEsit> <CntrllStrutturaXML>POSITIVO</CntrllStrutturaXML> <UnivcitaIDCmpnenti>POSITIVO</UnivcitaIDCmpnenti> <UnivcitaIDDcumenti>POSITIVO</UnivcitaIDDcumenti> <CrrispndenzaAllegatiDichiarati>POSITIVO</CrrispndenzaAllegatiDichiarati> <CrrispndenzaAnnessiDichiarati>POSITIVO</CrrispndenzaAnnessiDichiarati> te> <CrrispndenzaAnntaziniDichiarate>POSITIVO</CrrispndenzaAnntaziniDichiara </EsitXSD> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>false</FrzaAccettazine> <FrzaCnservazine>false</FrzaCnservazine> <FrzaCllegament>false</FrzaCllegament> </Cnfigurazine> <UnitaDcumentaria> <Versatre> <Ambiente>PARER </Ambiente> <Ente>ENTEXXX</Ente> <Struttura>STRUTTURAYYY</Struttura> <UserID>versatreYYY</UserID> </Versatre> <Chiave> <Numer>99</Numer> <Ann>2014</Ann> <TipRegistr>PROTOCOLLO</TipRegistr> </Chiave> <DataVersament> T10:22: :00</DataVersament> Specifiche tecniche dei servizi di versament [ 103 ]

104 <EsitUnitaDcumentaria> <CdiceEsit>NEGATIVO</CdiceEsit> <IdentificazineVersatre>POSITIVO</IdentificazineVersatre> <UnivcitaChiave>NEGATIVO</UnivcitaChiave> </EsitUnitaDcumentaria> </UnitaDcumentaria> <RapprtVersament><?xml versin=&qut;1.0&qut; encding=&qut;utf- 8&qut;?> <RapprtVersament> <Versine>1.0</Versine> <URNRapprtVersament>urn:RapprtVersament:PARER:ENTEXXX:STRUTTUR AYYY:PROTOCOLLO </URNRapprtVersament> <DataRapprtVersament> T12:54: :00</DataRapprtVersament> <EsitGenerale> <CdiceEsit>WARNING</CdiceEsit> <CdiceErrre>UD </CdiceErrre> <MessaggiErrre>Unità Dcumentaria PROTOCOLLO : nn sn stati trvati cmpnenti firmati digitalmente</messaggierrre> </EsitGenerale> <Versatre> <Ambiente>PARER</Ambiente> <Ente>ENTEXXX</Ente> <Struttura>STRUTTURAYYY</Struttura> <UserID>versatreYYY</UserID> </Versatre> <SIP> <URNIndiceSIP>urn:IndiceSIP:PARER:ENTEXXX:STRUTTURAYYY:PROTOCOLLO </URNIndiceSIP> <HashIndiceSIP>e05c8e1906ba8b65cb bbcb799c </HashIndice SIP> <AlgritmHashIndiceSIP>SHA-1</AlgritmHashIndiceSIP> <EncdingHashIndiceSIP>hexBinary</EncdingHashIndiceSIP> <DataVersament> T12:54: :00</DataVersament> <UnitaDcumentaria> <Chiave> <Numer>99</Numer> <Ann>2014</Ann> <TipRegistr>PROTOCOLLO</TipRegistr> </Chiave> <TiplgiaUnitaDcumentaria>DOCUMENTO PROTOCOLLATO</TiplgiaUnitaDcumentaria> <DcumentPrincipale> <ChiaveDc>PROTOCOLLO PRINCIPALE-1</ChiaveDc> <IDDcument>21051</IDDcument> <TipDcument>DOCUMENTO PROTOCOLLATO</TipDcument> <FirmatDigitalmente>false</FirmatDigitalmente> <Cmpnenti> <Cmpnente> <URN>urn:PARERPARER:ENTEXXX:STRUTTURAYYY:PROTOCOLLO PRINCIPALE-1:1:1</URN> <Hash>e6a9fc04320a924f46c7c737432bb0389d9dd095</Hash> <AlgritmHash>SHA-1</AlgritmHash> <Encding>hexBinary</Encding> </Cmpnente> </Cmpnenti></DcumentPrincipale> </UnitaDcumentaria> </SIP> </RapprtVersament></RapprtVersament> </EsitVersament> Esempi di Esit versament di Dcument cn esit generale POSITIVO <?xml versin="1.0" encding="iso "?> <EsitVersAggAllegati> Specifiche tecniche dei servizi di versament [ 104 ]

105 <Versine>1.4</Versine> <VersineXMLChiamata>1.4</VersineXMLChiamata> <DataVersament> T12:19: :00</DataVersament> <EsitGenerale> <CdiceEsit>POSITIVO</CdiceEsit> <CdiceErrre/> <MessaggiErrre/> </EsitGenerale> <EsitChiamataWS> <VersineWSCrretta>POSITIVO</VersineWSCrretta> <CredenzialiOperatre>POSITIVO</CredenzialiOperatre> <FileAttesiRicevuti>POSITIVO</FileAttesiRicevuti> </EsitChiamataWS> <EsitXSD> </EsitXSD> <CdiceEsit>POSITIVO</CdiceEsit> <CntrllStrutturaXML>POSITIVO</CntrllStrutturaXML> <UnivcitaIDCmpnenti>POSITIVO</UnivcitaIDCmpnenti> <Cnfigurazine> <TipCnservazine>SOSTITUTIVA</TipCnservazine> <FrzaAccettazine>true</FrzaAccettazine> <FrzaCnservazine>true</FrzaCnservazine> <AbilitaCntrllCrittgrafic>true</AbilitaCntrllCrittgrafic> <AbilitaCntrllTrust>true</AbilitaCntrllTrust> <AbilitaCntrllCertificat>true</AbilitaCntrllCertificat> <AbilitaCntrllCRL>true</AbilitaCntrllCRL> <AbilitaCntrllFrmat>true</AbilitaCntrllFrmat> <AccettaFirmaScnsciuta>true</AccettaFirmaScnsciuta> <AccettaFirmaNnCnfrme>true</AccettaFirmaNnCnfrme> <AccettaFirmaNDelibera45>true</AccettaFirmaNDelibera45> <AccettaMarcaScnsciuta>false</AccettaMarcaScnsciuta> <AccettaCntrllCrittgraficNegativ>true</AccettaCntrllCrittgraficNegativ> <AccettaCntrllTrustNegativ>true</AccettaCntrllTrustNegativ> <AccettaCntrllCertificatScadut>true</AccettaCntrllCertificatScadut> <AccettaCntrllCertificatNValid>true</AccettaCntrllCertificatNValid> <AccettaCntrllCertificatNFirma>true</AccettaCntrllCertificatNFirma> <AccettaCntrllCRLNegativ>true</AccettaCntrllCRLNegativ> <AccettaCntrllCRLScaduta>true</AccettaCntrllCRLScaduta> <AccettaCntrllCRLNValida>true</AccettaCntrllCRLNValida> <AccettaCntrllCRLNScaric>true</AccettaCntrllCRLNScaric> <AccettaCntrllFrmatNegativ>true</AccettaCntrllFrmatNegativ> </Cnfigurazine> <UnitaDcumentaria> <Versatre> <Ambiente>PARER</Ambiente> Specifiche tecniche dei servizi di versament [ 105 ]

106 <Ente>XXX</Ente> <Struttura>YYY</Struttura> <UserID>YYY_Versatre</UserID> </Versatre> <Chiave> </Chiave> <Numer>3</Numer> <Ann>2011</Ann> <TipRegistr>PROTOCOLLO</TipRegistr> <DataVersament> T12:19: :00</DataVersament> <EsitUnitaDcumentaria> <CdiceEsit>POSITIVO</CdiceEsit> <IdentificazineVersatre>POSITIVO</IdentificazineVersatre> <IdentificazineChiave>POSITIVO</IdentificazineChiave> <DcumentUnivcInUD>POSITIVO</DcumentUnivcInUD> <VerificaFirmeUnitaDcumentaria>POSITIVO</VerificaFirmeUnitaDcumentaria> </EsitUnitaDcumentaria> <Allegat> <ChiaveDc>PROTOCOLLO ALLEGATO-19</ChiaveDc> <IDDcument>ID1</IDDcument> <TipDcument>ATTESTATO PUBBLICAZIONE</TipDcument> <FirmatDigitalmente>true</FirmatDigitalmente> <EsitDcument> <CdiceEsit>POSITIVO</CdiceEsit> <VerificaTipDcument>POSITIVO</VerificaTipDcument> <CrrispndenzaDatiSpecifici>POSITIVO</CrrispndenzaDatiSpecifici> <CrrispndenzaDatiFiscali>POSITIVO</CrrispndenzaDatiFiscali> <VerificaTipStruttura>POSITIVO</VerificaTipStruttura> <VerificaFirmeDcument>POSITIVO</VerificaFirmeDcument> <UnivcitaOrdinePresentazine>POSITIVO</UnivcitaOrdinePresentazine> </EsitDcument> <Cmpnenti> <Cmpnente> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <URN>c:\cartella permessi\righi.pdf.p7m</urn> <Hash>AAAAAAAAA</Hash> <AlgritmHash>tken</AlgritmHash> <Encding>tken</Encding> <FrmatRappresentazine>PDF</FrmatRappresentazine> <FrmatRappresentazineEstes>string</FrmatRappresentazineEste s> <DimensineFile>14563</DimensineFile> <FirmatDigitalmente>false</FirmatDigitalmente> <EsitCmpnente> <CdiceEsit>POSITIVO</CdiceEsit> <VerificaTipCmpnente>POSITIVO</VerificaTipCmpnente> <CrrispndenzaDatiSpecifici>POSITIVO</CrrispndenzaDatiSpecifici> Specifiche tecniche dei servizi di versament [ 106 ]

107 <VerificaTipSupprtCmpnente>POSITIVO</VerificaTipSupprtCm pnente> <VerificaNmeCmpnente>POSITIVO</VerificaNmeCmpnente> <VerificaAmmissibilitaFrmat>POSITIVO</VerificaAmmissibilitaFrmat > <VerificaRicnscimentFrmat>POSITIVO</VerificaRicnscimentFr mat> <MessaggiRicnscimentFrmat>string</MessaggiRicnscimentFr mat> </EsitCmpnente> </Cmpnente> </Cmpnenti> </Allegat> </UnitaDcumentaria> <RapprtVersament><?xml versin="1.0" encding="iso "?> <RapprtVersament><Versine>1.0</Versine...</RapprtVersament> </EsitVersAggAllegati> Esempi di Esit versament di Dcument cn esit generale NEGATIVO <EsitVersAggAllegati> <Versine>1.4</Versine> <VersineXMLChiamata>1.4</VersineXMLChiamata> <DataVersament> T10:48: :00</DataVersament> <EsitGenerale> <CdiceEsit>NEGATIVO</CdiceEsit> <CdiceErrre>UD </CdiceErrre> <MessaggiErrre> Unità Dcumentaria FATTUREATTIVE : la chiave indicata nn crrispnde a nessuna Unità Dcumentaria presente nel sistema </MessaggiErrre> </EsitGenerale> <EsitChiamataWS> <VersineWSCrretta>POSITIVO</VersineWSCrretta> <CredenzialiOperatre>POSITIVO</CredenzialiOperatre> <FileAttesiRicevuti>POSITIVO</FileAttesiRicevuti> </EsitChiamataWS> <EsitXSD> <CdiceEsit>POSITIVO</CdiceEsit> <CntrllStrutturaXML>POSITIVO</CntrllStrutturaXML> <UnivcitaIDCmpnenti>POSITIVO</UnivcitaIDCmpnenti> </EsitXSD> <Cnfigurazine> <TipCnservazine>SOSTITUTIVA</TipCnservazine> <FrzaAccettazine>true</FrzaAccettazine> <FrzaCnservazine>true</FrzaCnservazine> </Cnfigurazine> <UnitaDcumentaria> <Versatre> <Ambiente>PARER</Ambiente> <Ente>XXX</Ente> <Struttura>YYY</Struttura> Specifiche tecniche dei servizi di versament [ 107 ]

108 <UserID>versatreYYY</UserID> </Versatre> <Chiave> <Numer>85</Numer> <Ann>2014</Ann> <TipRegistr>FATTUREATTIVE</TipRegistr> </Chiave> <DataVersament> T10:48: :00</DataVersament> <EsitUnitaDcumentaria> <CdiceEsit>NEGATIVO</CdiceEsit> <IdentificazineVersatre>POSITIVO</IdentificazineVersatre> <IdentificazineChiave>NEGATIVO</IdentificazineChiave> </EsitUnitaDcumentaria> </UnitaDcumentaria> <XMLVersament> <UnitaDcAggAllegati> <Intestazine> <Versine>1.4</Versine> <Versatre> <Ambiente>PARER</Ambiente> <Ente>XXX</Ente> <Struttura>YYY</Struttura> <UserID>VERSATOREYYY</UserID> </Versatre> <Chiave> <Numer>85</Numer> <Ann>2014</Ann> <TipRegistr>FATTUREATTIVE</TipRegistr> </Chiave> </Intestazine> <Cnfigurazine> <FrzaAccettazine>true</FrzaAccettazine> <FrzaCnservazine>true</FrzaCnservazine> <SimulaSalvataggiDatiInDB>false</SimulaSalvataggiDatiInDB> </Cnfigurazine> <Anness> <IDDcument>urn: efatturapa:2014: _85:ca:ricevuta_di_consegna:sdi</iddcument> <TipDcument>RICEVUTA DI CONSEGNA</TipDcument> <StrutturaOriginale> <Cmpnenti> <Cmpnente> <ID>ID5</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipRappresentazineCmpnente>Trasfrmazine XML cn XSLT</TipRappresentazineCmpnente> <NmeCmpnente>anness</NmeCmpnente> <FrmatFileVersat>xml</FrmatFileVersat> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> <SttCmpnenti> <SttCmpnente> <ID>ID6</ID> Specifiche tecniche dei servizi di versament [ 108 ]

109 <OrdinePresentazine>2</OrdinePresentazine> trasfrmazine</tipcmpnente> <TipCmpnente>Fgli di <TipSupprtCmpnente>RIFERIMENTO</TipSupprtCmpnente> <Riferiment> <Numer>FS_SDI_RDC_01</Numer> <TipRegistr>FOGLI_TRASFORMAZIONE</TipRegistr> <Ann>2014</Ann> </Riferiment> <NmeCmpnente>FS_SDI_RDC_01.xsl</NmeCmpnente> </SttCmpnente> </SttCmpnenti> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Anness> </UnitaDcAggAllegati> </XMLVersament> </EsitVersAggAllegati> Metadati generati dal Sistema sugli ggetti versati Il Sistema, a seguit dei cntrlli effettuati sul SIP al mment del versament e delle successive elabrazini cui è sttpst nel crs del prcess di cnservazine, genera dei metadati che memrizza a integrazine di quelli trasmessi nell Indice SIP dal Prduttre e che cnfluiscn nel Pacchett di archiviazine (AIP) Metadati di identificazine degli ggetti versati nel Sistema Il Sistema per identificare univcamente degli ggetti versati (Unità dcumentarie, Dcumenti, Cmpnenti e i relativi Indici SIP) calcla degli URN che si basan sulla Chiave dell Unità dcumentaria definita dal Prduttre e sulla struttura della stessa: Urn dell Unità dcumentaria: stringa che identifica univcamente l Unità dcumentaria nel Sistema. L URN dell Unità dcumentaria è cmpst dai seguenti elementi: Ambiente; Ente; Struttura; Chiave Unità dcumentaria. Esempi di URN dell Unità dcumentaria: urn:parer:entex:aooentex:pg [ambiente] [ente] [struttura] [Chiave] Specifiche tecniche dei servizi di versament [ 109 ]

110 Urn del Dcument: stringa che identifica univcamente il Dcument nel Sistema. L URN del Dcument è cmpst da: Urn della UD; Element (assume valre Principale, Allegat, Anness Anntazine); Numer element. Esempi di URN del Dcument: urn:parer:entex:aooentex:pg principale-1; urn:parer:entex:aooentex:pg allegato-1; urn:parer:entex:aooentex:pg allegato-2; urn:parer:entex:aooentex:pg annesso-1; urn:parer:entex:aooentex:pg annotazione-1. Urn del Cmpnente: stringa che identifica univcamente il Cmpnente nel Sistema. L URN del Cmpnente è cmpst da: Urn del dcument; Numer d rdine struttura; Numer d rdine del Cmpnente. Esempi di URN del Cmpnente: urn:parer:entex:aooentex:pg principale Urn dell Indice SIP: stringa che identifica univcamente l Indice SIP del pacchett versat. L URN dell Indice SIP è cmpst da: Suffiss IndiceSIP; URN dell Unità dcumentaria del Dcument. Esempi di URN dell Indice SIP di Unità dcumentaria: Urn:IndiceSIP:Parer:EnteX:AOOX:Prtcll Esempi di URN dell Indice SIP di Dcument: Urn:IndiceSIP:Parer:EnteX:AOOX:Prtcll ANNESSO-1. Urn del PI SIP: stringa che identifica univcamente le Infrmazini sull impacchettament (Packaging Infrmatin) del pacchett versat (vedi paragraf 1.1 e 1.2). L URN del PI SIP è cmpst da: Suffiss PISIP; URN dell Unità dcumentaria del Dcument. Specifiche tecniche dei servizi di versament [ 110 ]

111 Esempi di URN del PI SIP di Unità dcumentaria: Urn:PISIP:Parer:EnteX:AOOX:Prtcll Esempi di URN del PI SIP di Dcument: Urn:PISIP:Parer:EnteX:AOOX:Prtcll ANNESSO-1. Urn dell Esit versament: stringa che identifica univcamente l Esit versament del pacchett versat. L URN dell Esit versament è cmpst da: Suffiss EsitVersament; URN dell Unità dcumentaria del Dcument. Esempi di URN dell Esit versament di un SIP di Unità dcumentaria: Urn:EsitVersament:Parer:EnteX:AOOX:Prtcll Esempi di URN dell Esit versament di un SIP di Dcument: Urn:EsitVersament:Parer:EnteX:AOOX:Prtcll ANNESSO-1. Urn del Rapprt di versament: stringa che identifica univcamente il Rapprt di versament del pacchett versat. L URN del Rapprt di versament è cmpst da: Suffiss RapprtVersament; URN dell Unità dcumentaria del Dcument. Esempi di URN del Rapprt di versament di un SIP di Unità dcumentaria: Urn:RapprtVersament:Parer:EnteX:AOOX:Prtcll Esempi di URN del Rapprt di versament di un SIP di Dcument: Urn:RapprtVersament:Parer:EnteX:AOOX:Prtcll ANNESSO Metadati descrittivi del file Il Sistema memrizza un set di metadati descrittivi del file, calclati nel crs delle verifiche effettuate in fase di versament: Infrmazini sul file Dimensine file: è la dimensine del file espressa in bytes; Hash: imprnta del file; Algritm: algritm di hashing utilizzat (attualmente SHA-1); Encding: cdifica dell hash (attualmente binari esadecimale, hexbinary). Infrmazini sul frmat Specifiche tecniche dei servizi di versament [ 111 ]

112 Frmat di rappresentazine: è il cdice identificativ del frmat del file (generalmente definit cn l estensine) utilizzat nel Registr dei frmati del Sistema; Descrizine frmat: descrizine del frmat di rappresentazine; Frmat di rappresentazine estes: è una particlare cdifica del frmat di rappresentazine che tiene cnt anche del numer di buste crittgrafiche presenti nel file. Nel cas nn sian presenti buste crittgrafiche ce ne sia una sla, cincide cn il frmat di rappresentazine; Frmat del file sbustat: nel cas in cui il file cntenga una busta crittgrafica, individua il frmat del file che vi è cntenut. Nel cas nn sian presenti buste crittgrafiche, cincide cn il frmat di rappresentazine; Mimetype: è il mimetype del file calclat al mment del versament. Infrmazini sulla firma Presenza firma: indica se il file è firmat digitalmente men; Prgressiv busta: individua la busta crittgrafica; Prgressiv firma: individua la firma all intern della busta; Firmatari: nminativ e cdice identificativ del firmatari estratt dal certificat di firma; Data firma: data e ra di firma cntenuta nella firma digitale (se presente); Cntrfirma di: individua la firma cntrfirmata, nel cas in cui la firma sia una cntrfirma; Frmat: frmat della firma; Tip: tip di firma (es.: DIGITALE); Firma Base64: valre della firma espress in Base64; Algritm calcl hash: algritm utilizzat per calclare l hash del file da firmare; Esit cntrll cnfrmità: esit del cntrll di cnfrmità della firma; Descrizine esit cntrll cnfrmità: descrizine dell esit; Riferiment temprale usat: data e ra utilizzati per la verifica della firma; Tip riferiment temprale usat: indica la tiplgia del riferiment temprale usat (es.: Marca temprale); Esit verifica versament: esit delle verifiche sulla firma al versament; Descrizine esit verifica versament: descrizine dell esit della verifica di firma effettuata al versament; Esit verifica chiusura vlume: esit delle verifiche di firma effettuate alla chiusura del vlume di cnservazine (fin al ); Specifiche tecniche dei servizi di versament [ 112 ]

113 Descrizine esit verifica chiusura vlume: descrizine dell esit della verifica di firma effettuata alla chiusura del vlume di cnservazine (fin al ); Inltre il Sistema memrizza infrmazini dettagliate dei singli cntrlli di firma effettuati (Crittgrafic, Catena trusted, Certificat, CRL), dei Certificati del firmatari, dei Certificati CA, delle CRL utilizzate per le verifiche, nnché le CRL stesse Gestine degli errri L Applicativ versante ptrà avere un errre di timeut in fase di versament del SIP e/ in fase di attesa della rispsta. Tali errri dipendn dall Applicativ versante e nn sn gestiti (né gestibili) dal Sistema. Gli errri gestiti dal Sistema in fase di versament sn: Errre di autenticazine dell Applicativ versante; Errre nella struttura dei metadati: sn gestiti gli errri generati dal parsing dell Indice SIP sia per quant cncerne la parte fissa, sia per i dati specifici della tiplgia di Unità dcumentaria versata. Si tratta di errri strutturali gestiti da tl autmatizzati di cntrll e pertant frniscn una descrizine tecnica dell errre in lingua inglese, tipicamente destinata a sviluppatri; Errri specifici del cntenut dei metadati. Sn gestite le seguenti casistiche: errre nel parametr dati incngruenti errre nella numerazine (se sul Tip registr il Sistema ha impstat il cntrll di cnsecutività). Gli errri gestiti dal Sistema in lingua italiana direttamente dalla lgica applicativa sn: Errre di lettura sul DB Errre di persistenza dvut al mancat salvataggi del lg di sistema Errre di ricmpsizine dei dati cnclusivi (numer di Cmpnenti dichiarati nell Indice SIP divers dal numer di quelli effettivamente inviati) Errre di persistenza dvut all impssibilità di salvare i metadati sul DataBase di salvare l ggett di versament Errre che segnala che l Unità dcumentaria di cui si richiede il versament è già stata versata Errre dvut ad almen un esit negativ nelle verifiche sui file del SIP (errri sulla firma e sui frmati) Si segnala che l errre di Unità dcumentaria Dcument già presente nel Sistema sn trattati in md particlare in quant è l unic cas in cui, a frnte di un errre di versament, l ggett versat è cmunque presente nel Sistema. Specifiche tecniche dei servizi di versament [ 113 ]

114 I messaggi di errre, in questi casi, sn i seguenti: Unità dcumentaria già presente nel Sistema: Cdice errre: UD Descrizine errre: Unità Dcumentaria <IdentificativUD>: la chiave indicata crrispnde ad una Unità Dcumentaria già presente nel sistema Dcument già presente nel Sistema: Cdice errre: DOC Descrizine errre: Dcument <IdentificativDcument>: un dcument cn il tag <IDDcument> uguale a (id dcument da versare) è già presente nell Unità Dcumentaria In questi casi è cnsigliabile che l Applicativ versante gestisca le rispste cn quest cdice tenend cnt che, pur cnfigurandsi cme un errre, una rispsta di quest tip implica che l Unità dcumentaria il Dcument che si è tentat di versare sn cmunque presenti nel Sistema. Quindi sarebbe pprtun che venisse trattata nel sistema del Versatre cme tale, ad esempi evitand ulteriri tentativi di versament e/ aggirnand il su stat nel sistema in md analg agli altri dcumenti già versati in cnservazine. Per facilitare la gestine di quest errre, il Sistema prduce una particlare variante dell Esit versament che, diversamente da quant nrmalmente accade per gli Esiti versament a seguit di esit NEGATIVO, riprta in un tag appsit il Rapprt di versament generat dal Sistema al mment del versament dell Unità dcumentaria del Dcument in questine. Si rimanda al dcument Cdifiche Errri per la descrizine dettagliata delle tiplgie di errri gestite dal Sistema Annullament del versament di una Unità dcumentaria È pssibile che il Versatre abbia la necessità di annullare il versament di un Unità dcumentaria presente sul Sistema. I mtivi pssn essere diversi: un errre nell assciazine del file al SIP, un errre che ha causat l invi in cnservazine di dcumenti che nn dvevan essere inviati in cnservazine, e via dicend. In questi casi è pssibile prcedere all annullament del versament dell Unità dcumentaria sul Sistema. Tale perazine nn cmprta la cancellazine dal Sistema dell Unità dcumentaria versata. Questa viene marcata cme annullata, nn cmpare nei risultati delle ricerche (a men che nn sia esplicitamente richiest) ma rimane dispnibile per mantenere traccia del versament riginari, rendend al cntemp pssibile l eventuale versament da parte del Prduttre dell Unità dcumentaria crretta utilizzand gli stessi dati di Chiave. L annullament cnsente, quindi, di inviare nuvamente in cnservazine un Unità dcumentaria avente la stessa chiave di quella il cui versament è stat annullat senza che il Sistema restituisca l errre di Unità dcumentaria già presente (UD : la chiave indicata crrispnde ad una Unità Dcumentaria già presente nel sistema). Specifiche tecniche dei servizi di versament [ 114 ]

115 L annullament del versament di un Unità dcumentaria è un perazine che, al mment, può essere svlta sl da ParER. Per pter prcedere il Versatre dvrà, quindi, cmunicare a ParER gli estremi dell Unità dcumentaria della quale si vule annullare il versament e la relativa mtivazine. Una vlta prcedut all annullament, ParER infrmerà il Versatre che ptrà csì, eventualmente, versare in cnservazine l Unità dcumentaria crretta Servizi di versament sincrn di Unità dcumentaria (VersamentSync) Versine 1.4 Il web service VersamentSync è il servizi di versament sincrn che permette all Applicativ versante di versare nel Sistema un SIP di Unità dcumentaria (vedi paragraf 1.1). Attravers il web service VersamentSync è pssibile inviare una sla Unità dcumentaria per vlta, che a sua vlta può essere cmpsta in più Dcumenti, a lr vlta articlati in un più Cmpnenti, gnun dei quali descrive, quand presente, un unic file. Nn è quindi pssibile richiamare il Servizi VersamentSync per versare cntestualmente due più Unità dcumentarie: per eseguire tale perazine il Servizi dvrà essere chiamat tante vlte quante sn le Unità dcumentarie da versare nel Sistema. Il servizi si cmpne di una sla chiamata, in cui l Applicativ versante invca il Servizi inviand l Indice SIP di Unità dcumentaria e i file che cmpngn l Unità dcumentaria stessa, cn le mdalità e il prcess descritt nei paragrafi 2.1 e seguenti. Si rimanda agli stessi paragrafi anche per tutte le infrmazini relative al prtcll impiegat, l architettura per l scambi di messaggi, encding e tematiche cnnesse Struttura della chiamata al servizi VersamentSync Cme già descritt in generale nel paragraf 2.1.1, l Applicativ versante richiama il Servizi inviand l Indice SIP di Unità dcumentaria e i file che cmpngn l Unità dcumentaria stessa. Il Sistema inizia a prcessare l Indice SIP ricavand le infrmazini riferite al Versatre (Ambiente, Ente, Struttura e UserID), identificand la prvenienza del pacchett e verificand che il Versatre sia autrizzat al versament. Il Sistema avvia in autmatic i cntrlli, al termine dei quali invia la rispsta (Esit versament) all Applicativ versante. Il prcess di versament si articla nei seguenti passi: Pass 1 L Applicativ versante chiama il Servizi di versament ed esegue l invi del SIP cstituit da: Specifiche tecniche dei servizi di versament [ 115 ]

116 Indice SIP cntenente la descrizine dell ggett di cui si richiede il versament; file (Oggetti-dati) che cmpngn il SIP. Pass 2 Il Sistema esegue: la validazine dell Indice SIP cn il relativ XSD, e degli eventuali metadati specifici presenti cn l XSD relativ ai Dati specifici previsti per la tiplgia dell ggett versat; il cntrll semantic sui metadati estraplati dall Indice SIP inviat; il calcl degli appsiti attributi sui Cmpnenti inviati: identificativi, dimensine file, URN, hash, verifica presenza firma (vedi paragraf per ulteriri dettagli) i cntrlli sui file (Oggetti-dati) inviati: cntrll frmat e cntrll della firma digitale. Pass 3 Al termine dei cntrlli definiti al pass 2, il Sistema esegue il salvataggi del SIP (Indice SIP e relativi file). Pass 4 Il Sistema invia all Applicativ versante un messaggi cn l esit del versament eseguit Cntrlli sul SIP di Unità dcumentaria Per quant riguarda i cntrlli che il Sistema pera sul SIP, si rimanda al paragraf per la descrizine dei cntrlli effettuati indipendentemente dall specific Servizi invcat. Nei paragrafi seguenti sn descritti i cntrlli che vengn svlti esclusivamente a frnte del versament di un SIP di Unità dcumentaria mediante l invcazine del servizi VersamentSync Cntrlli semantici sull Indice SIP Oltre ai cntrlli semantici sull Indice SIP descritti nel paragraf , nel cas di versament di un SIP di Unità dcumentaria il Sistema svlge i seguenti cntrlli Cntrll del criteri di calcl di rdinament della Chiave dell Unità dcumentaria: il Sistema determina la tiplgia di calcl di rdinament assciata al Tip registr ggett di versament e verifica che il valre inserit nel metadat Numer della Chiave rispnda alle regle definite per tale criteri. Attualmente le tiplgie di calcl gestite dal sistema sn le seguenti: FMT_STANDARD: il valre indicat nel numer della chiave deve cntenere sl cifre arabe; GENERICO: il valre indicat nel numer della chiave verrà accettat indipendentemente da criteri di calcl particlari (viene quindi accettat cme se fsse una stringa). Cntrll sul Tip registr: il Sistema esegue i seguenti cntrlli: Specifiche tecniche dei servizi di versament [ 116 ]

117 cntrlla che il Tip registr indicat nella Chiave dell Unità dcumentaria versata sia ammess per la Struttura versante e per quella determinata tiplgia di Unità dcumentaria; cntrlla che il Tip Registr sia valid nell ann indicat nel metadat Ann della Chiave dell Unità dcumentaria; Cntrll della presenza dei dati fiscali: se il Tip registr indicat nella Chiave dell Unità dcumentaria versata è definit fiscalmente rilevante sn eseguiti i Cntrlli fiscali, descritti al paragraf seguente Cntrlli fiscali Nel cas in cui l Unità dcumentaria appartenga a una tiplgia fiscalmente rilevante 11, e che pertant debba essere ggett di un particlare prcess di cnservazine 12, il Sistema prevede una serie di cntrlli specifici per attivare i quali è necessari che il parametr Tip cnservazine dell Indice SIP sia valrizzat cn Fiscale, vver: cntrll di cnsecutività: è finalizzat a supprtare la verifica del rispett di quant indicat al punt a) del cmma 1 dell art. 3 del DMEF 17/6/2014 (crretta tenuta della cntabilità). Mediante tale cntrll il Sistema verifica che l invi della dcumentazine fiscale in cnservazine avvenga senza interruzini nella numerazine prgressiva. Se il cntrll è attivat, il Sistema varifica che, al mment del versament, per quel determinat Tip registr e per il medesim perid fiscale, il metadat Numer della Chiave dell Unità dcumentaria versata sia cnsecutiv cn l ultim già presente nel Sistema. Cnsiderand che il prcess di cnservazine di dcumentazine fiscalmente rilevante ptrebbe iniziare a esercizi fiscale in crs, il Sistema cnsente di impstare il numer prgressiv di partenza, in md che il Sistema pssa cntrllare la cntinuità di versamenti e l assenza di interruzini nella cnsecutività a partire da tale prgressiv. Il 11 Ai sensi della Circlare dell Agenzia delle Entrate n. 36/E del 2006, le tiplgie dcumentarie fiscalmente rilevanti sn le seguenti: Libri (Libr Girnale Libr degli Inventari Libr sci Libr delle Obbligazini Libr delle adunanze e delle deliberazini del cnsigli di amministrazine Libr delle adunanze e delle deliberazini delle assemblee di sci Libr delle adunanze e delle deliberazini del cllegi sindacale Libr delle adunanze e delle deliberazini del cmitat esecutiv Libr delle adunanze e delle deliberazini delle assemblee degli bbligazinisti) Relazini (Relazine sulla gestine Relazine dei sindaci e dei revisri cntabili) Scritture cntabili (Scritture ausiliarie cn la registrazine degli elementi patrimniali e reddituali Scritture ausiliarie di magazzin) Registri (Registr dei Beni ammrtizzabili Registr degli Acquisti Registr dei Crrispettivi Registr delle Fatture Emesse ) Bilanci (Stat Patrimniale, Cnt Ecnmic, Nta Integrativa) Dichiarazini Fiscali Mdulistica relativa a pagamenti Fatture 12 Al mment la nrmativa di riferiment per la cnservazine di dcumenti fiscalmente rilevanti è il DMEF 17 giugn 2014 Mdalità di asslviment degli bblighi fiscali relativi ai dcumenti infrmatici e alla lr riprduzine su diversi tipi di supprt Specifiche tecniche dei servizi di versament [ 117 ]

118 cntrll di cnsecutività nn è bbligatri: per essere eseguit deve essere attivat nel Sistema, impstand il relativ parametr sul Tip registr (Cntrll cnsecutività). cntrll sulle chiavi di ricerca: è finalizzat a garantire la presenza nell Indice SIP delle infrmazini minime previste al punt b) del cmma 1 dell art. 3 del DMEF 17/6/2014 (funzini di ricerca ed estrazine delle infrmazini dagli archivi infrmatici). Tale cntrll viene effettuat mediante la verifica che nei Dati specifici cntenuti nell Indice SIP sian presenti i metadati relativi a cgnme, nme, denminazine, cdice fiscale, partita IVA e data. Su tali metadati specifici è pssibile eseguire i cntrlli descritti al paragraf Rispsta alla chiamata (Esit versament) In rispsta alla chiamata al Servizi di versament sincrn di Unità dcumentaria da parte dell'applicativ versante, il Sistema trasmette a quest ultim l Esit versament, un dcument XML la cui struttura dati è descritta nel paragraf 2.1.6, al quale si rimanda per ulteriri infrmazini. In questa sede si evidenzia che il tag EsitUnitaDcumentaria dell Esit versament generat e trasmess a seguit del versament di un SIP di Unità dcumentaria, avrà la seguente struttura: IdentificazineVersatre: è valrizzat cn POSITIVO se il Versatre indicat nell Indice SIP è ricnsciut dal Sistema; UnivcitaChiave: è POSITIVO se la Chiave dell Unità dcumentaria valrizzata nell IndiceSIP di Unità dcumentaria risulta univca nel Sistema; VerificaTiplgiaUD: è POSITIVO se TiplgiaUnitaDcumentaria nell Indice SIP di Unità dcumentaria è presente e valida nel Sistema; CrrispndenzaDatiSpecifici: è POSITIVO se i Dati specifici dell Unità dcumentaria indicati nell Indice SIP crrispndn cn quelli cnfigurati nel Sistema; PresenzaUDCllegate: è POSITIVO se le Unità dcumentarie ggett di Cllegamenti sn presenti nel Sistema; è WARNING se tali Unità dcumentarie nn sn presenti nel Sistema e il parametr FrzaCllegament è settat a True; VerificaFirmeUnitaDcumentaria: è POSITIVO se i cntrlli sulla firma di tutte le firme dei file di tutti i Cmpnenti di tutti i Dcumenti hann esit psitiv; è WARNING se almen un cntrll di firma ha esit negativ e il parametr FrzaAccettazine è True Servizi di versament sincrn di aggiunta Dcument (AggiuntaAllegatiSync) Versine 1.4 Il web service AggiuntaAllegatiSync cnsente di versare un SIP di Dcument (vedi paragraf 1.1.2) da aggiungere a un Unità dcumentaria già presente nel Sistema. Il Specifiche tecniche dei servizi di versament [ 118 ]

119 Dcument può essere un Allegat, un Anness un Anntazine e mai un Dcument principale, in quant il Dcument principale può essere presente una sla vlta in un Unità dcumentaria e vede essere bbligatriamente versat cn l Unità dcumentaria cui appartiene. Attravers il web service AggiuntaAllegatiSync è pssibile inviare un sl Dcument per vlta. Eventualmente il Dcument può essere cmpst da più Cmpnenti. Nn è quindi pssibile richiamare il Servizi AggiuntaAllegatiSync per versare cntestualmente due più Dcumenti riferiti alla stessa Unità dcumentaria: per eseguire tale perazine il servizi dvrà essere chiamat tante vlte quanti sn i Dcumenti da ricngiungere all Unità dcumentaria precedentemente versata. Il Servizi si cmpne di una sla chiamata, in cui l applicativ invca il Servizi inviand l Indice SIP di Dcument e i file che cmpngn il Dcument da versare, cn le mdalità descritte nei paragrafi 2.1 e seguenti. Si rimanda agli stessi paragrafi anche per tutte le infrmazini relative al prtcll impiegat, l architettura per l scambi di messaggi, encding e tematiche cnnesse Struttura della chiamata al servizi AggiuntaAllegatiSync Cme già descritt in generale nel paragraf 2.1.1, l Applicativ versante richiama il Servizi inviand l Indice SIP di Dcument e i file che cmpngn il Dcument da versare. Il Sistema inizia a prcessare l Indice SIP ricavand le infrmazini riferite al Versatre (Ambiente, Ente, Struttura e UserID), identificand la prvenienza del pacchett e verificand che il Versatre sia autrizzat al versament. Le infrmazini riferite alla Chiave permettn di identificare l Unità dcumentaria in md che il Sistema pssa verificare se l Unità dcumentaria cui cllegare il Dcument è effettivamente presente nel Sistema. Il Sistema avvia in autmatic i cntrlli, al termine dei quali invia la rispsta (Esit versament) all Applicativ versante. Il prcess di versament si articla nei seguenti passi: Prerequisit al versament di un Dcument L Unità dcumentaria X è presente nel Sistema, cn il Dcument principale e gli eventuali Allegati, Annessi e Anntazini di cui era cmpsta al mment del versament. In seguit il Versatre ha l esigenza di aggiungere un Dcument (Allegat, Anness Anntazine) all Unità dcumentaria X versata in precedenza. L Applicativ versante invca il servizi AggiuntaAllegatiSync per ricngiungere tale Dcument all Unità dcumentaria X di appartenenza, già presente nel Sistema. Pass 1 L Applicativ versante chiama il Servizi di versament sincrn di aggiunta nuv Dcument (AggiuntaAllegatiSync) inviand sia l Indice SIP del Dcument sia gli eventuali file (Oggetti- Specifiche tecniche dei servizi di versament [ 119 ]

120 dati) di cui si cmpne. L Indice SIP del Dcument, descritt al paragraf 1.1.2, nn cnterrà i metadati dell Unità dcumentaria, in quant tali metadati rimangn immutati. Pass 2 Il sistema di Cnservazine esegue: la validazine dell Indice SIP di Dcument cn l schema XSD indicat nell Indice SIP stess per cnsentire la validazine dei tag cntenuti nella struttura <Anness>, <Allegat>, <Anntazine>; i cntrlli sui Cmpnenti ricevuti (cntrll frmati; cntrll firma digitale). Pass 3 Nel cas in cui i cntrlli frniscan esit psitiv, il Sistema prcede alla memrizzazine dei metadati cntenuti nell Indice SIP e dei file relativi al Dcument versat. In cas di warning si prcede cme nel cas di esit psitiv, memrizzand inltre nel Sistema l anmalia nn blccante riscntrata. Nel cas di errre blccante, il Sistema nn esegue il salvataggi dei file e dei metadati cntenuti nell Indice SIP, memrizzand l errre nel Sistema tra i versamenti falliti. Pass 4 Il Sistema invia all Applicativ versante un messaggi che riprta l esit del versament (Esit versament) Cntrlli sul SIP di Dcument Per quant riguarda i cntrlli, si rimanda al paragraf per la descrizine delle verifiche che vengn effettuate sui SIP indipendentemente dall specific servizi invcat. Rispett a tali cntrlli, si evidenzian di seguit i cntrlli specifici previsti esclusivamente sui SIP di Dcument versati mediante il servizi AggiuntaAllegatiSync: Presenza dell Unità dcumentaria nel Sistema: in fase di versament di un SIP di Dcument il Sistema cntrlla che l Unità dcumentaria cui si riferisce il Dcument versat sia presente nel Sistema; Univcità del Dcument: se l Unità dcumentaria risulta essere presente, il Sistema cntrlla l identificativ del Dcument (tag <IDDcument>), verificand che il Dcument ggett di versament nn sia già presente nel Sistema. Al termine dei cntrlli il sistema di cnservazine invia all Applicativ versante un messaggi cntenente l esit del versament eseguit (Esit versament) L Esit versament in rispsta alla chiamata del servizi AggiuntaAllegatiSync Specifiche tecniche dei servizi di versament [ 120 ]

121 In rispsta alla chiamata al Servizi di versament sincrn di aggiunta Dcument da parte dell'applicativ versante, il Sistema trasmette a quest ultim l Esit versament, un dcument XML la cui struttura dati è descritta nel paragraf 2.1.5, al quale si rimanda per ulteriri infrmazini. In questa sede si evidenzia che il tag EsitUnitaDcumentaria dell Esit versament generat e trasmess a seguit del versament di un SIP di Dcument, avrà la seguente struttura: IdentificazineVersatre: è valrizzat cn POSITIVO se il Versatre indicat nell Indice SIP è ricnsciut dal Sistema; IdentificazineChiave: è POSITIVO se la Chiave indicata nell Indice SIP di Dcument crrispnde a un Unità dcumentaria presente nel Sistema; DcumentUnivcInUD: è POSITIVO se l IDDcument nell Indice SIP di Dcument risulta essere univc nell Unità dcumentaria Servizi di versament per l aggirnament dei metadati In cnsiderazine del fatt che il SIP di Metadati (vedi paragraf 1.3), si cnfigura cme utilizz particlare del SIP di un Dcument, il web service AggiuntaAllegatiSync cnsente di aggiungere a un Unità dcumentaria precedentemente versata anche un SIP di Metadati per aggirnare i metadati dell Unità dcumentaria stessa. Le cnsiderazini svlte in tema di versament di un SIP di Dcument mediante l utilizz del web service AggiuntaAllegatiSync nei paragrafi 2.3 e seguenti sn applicabili, in tutt e per tutt, anche al versament di un SIP di Metadati. Nella Sez. 4 sn riprtati alcuni casi d us che illustran alcuni esempi di utilizz del servizi AggiuntaAllegatiSync per l aggirnament dei metadati di un Unità dcumentaria mediante la trasmissine di un SIP di Metadati. Specifiche tecniche dei servizi di versament [ 121 ]

122 Sez. 3 Servizi di versament in mdalità asincrna Nella presente sezine sn descritti i servizi di versament in mdalità asincrna, da utilizzare per versare nel Sistema i SIP da nrmalizzare, ciè quei pacchetti di versament che per la natura degli ggetti da versare per ragini di natura tecnica rganizzativa, nn è pssibile prdurre nei frmati descritti nella Sez. 1 e/ trasmettere al Sistema cn i Servizi di versament in mdalità sincrna descritti alla Sez. 2. Per una descrizine generale dei SIP da nrmalizzare, si rimanda al paragraf 1.5. I Servizi di versament in mdalità asincrna prevedn che il versament del SIP avvenga in più fasi, utilizzand sia servizi sincrni, sia del prtcll FTPS (per la trasmissine dell Oggett). Questi servizi cnsentn di superare i prblemi prestazinali cnnessi al versament di ggetti di dimensini mlt grandi e/ di SIP per i quali nn è pssibile cmpletare le verifiche cntestualmente al versament. Nella figura seguente è illustrata l architettura per cnsentire all Applicativ versante il versament in mdalità asincrna dei SIP. Figura 3 Architettura per il versament asincrn Specifiche tecniche dei servizi di versament [ 122 ]

123 PING (PRE INGEST): è il mdul del Sistema prepst alla ricezine dei SIP nn nrmalizzati, alla lr trasfrmazine in SIP nrmalizzati (vedi Sez. 1) e al cnseguente versament nel Sistema. Tra le sue funzinalità, rientran quelle di gestine dei servizi di versament in mdalità asincrna. FTP SERVER: è utilizzat per il trasferiment via FTP dell Oggett. Ogni Struttura versante dispne di una cartella dedicata (HOME). SACER (Sistema per l Archivi di Cnservazine dell Emilia Rmagna): è il Sistema di cnservazine di ParER (Sistema) Il prcess di versament asincrn Il grafic mdella la sequenza del prcess di versament asincrn di un SIP nn nrmalizzat, cmpst dall Indice e dall Oggett, che può generare un più SIP nrmalizzati da versare nel Sistema. Figura 4 - Diagramma di Sequenza Versament Asincrn 1) L Applicativ versante chiama il web service InviOggettPreIngest inviand l Indice del SIP nn nrmalizzat. Specifiche tecniche dei servizi di versament [ 123 ]

124 2) Il Sistema esegue la validazine dell Indice inviat eseguend i seguenti cntrlli: verifica che il file sia strutturat crrettamente; verifica che tutti i metadati definiti cme bbligatri sian stati valrizzati; verifica che le Unità dcumentarie ggett di versament nn sian già presenti nel Sistema in crs di versament. Il Sistema cmunica l esit all Applicativ versante. L Indice SIP inviat ptrà essere: valid: in quest cas l esit ha valre POSITIVO. Il Sistema autrizza il trasferiment via FTP del SIP; l stat del SIP viene pst IN_ATTESA_FILE; nn valid: nel cas di errre nella validazine dell Indice, il SIP viene pst in errre. L esit ha valre NEGATIVO. Il prcess di versament termina. 3) L Applicativ versante trasferisce via FTP l Oggett. Il file deve avere nme <cdiceoggett>. 4) Al termine del trasferiment l Applicativ versante ntifica al Sistema l avvenut trasferiment dell Oggett sulla cartella FTP chiamand il web service NtificaAvvenutTrasferimentFile. 5) Il Sistema verifica che nella cartella FTP sia presente l Oggett: nel cas in cui sia stat riscntrat un errre, il Sistema pne l Oggett in errre (CHIUSO_ERR_NOTIF); nel cas in cui i cntrlli frniscan esit psitiv, l stat dell Oggett viene pst a IN_ATTESA_SCHED; 6) Ad intervalli prestabiliti il Sistema (PING) avvia un jb (PreparaXMLSACER) per la nrmalizzazine, vver la preparazine degli Indici SIP nrmalizzati di tutti gli Oggetti in stat IN_ATTESA_SCHED per il successiv versament (in SACER) dei relativi SIP. Il Sistema, qualra la tiplgia di Oggett l preveda, esegue il cntrll dell hash per verificare l integrità del pacchett trasmess: se sn riscntrati degli errri nella predispsizine delll indice SIP nrmalizzat il Sistema pne l Oggett in errre (CHIUSO_ERR_SCHED); se la predispsizine dell indice SIP di Unità dcumentaria secnd le specifiche indicate nel paragraf nn segnala errri il sistema pne l Oggett in stat IN_ATTESA_VERS; 7) Il sistema (PING) avvia un jb (PrducerCdaVersament) per prre i SIP nrmalizzati predispsti al punt precedente nella cda di versament a SACER: se sn riscntrati degli errri nel psizinament in cda dei SIP nrmalizzati il Sistema pne l Oggett in errre (CHIUSO_ERR_CODA); se nn sn riscntrati errri il Sistema pne l Oggett in stat IN_CODA_VERS; 8) Il Sistema (PING) richiama il servizi Versament Multimedia per eseguire il versament del SIP di Unità dcumentaria (in SACER). Tale versament nn prevede il trasferiment del file, che rimane sulla cartella FTP cndivisa tra PING e SACER; 9) SACER invia a PING l esit del versament eseguit. Gli esiti pssibili sn: - POSITIVO WARNING: nel cas in cui l Unità dcumentaria sia versata crrettamente su SACER; Specifiche tecniche dei servizi di versament [ 124 ]

125 - NEGATIVO: nel cas in cui l Unità dcumentaria nn sia versata su SACER a causa di un errre blccante. 10) In entrambi i casi PING aggirna l stat dell Oggett ed elimina il file dalla cartella FTP Stati assunti da un Oggett nel prcess di versament in mdalità asincrna Riassumend gli stati che un Oggett può assumere nel prcess di versament a SACER sn i seguenti: Specifiche tecniche dei servizi di versament [ 125 ]

126 Stat IN_ATTESA_FILE IN_ATTESA_SCHED CHIUSO_ERR_NOTIF IN_ATTESA_VERS CHIUSO_ERR_SCHED IN_CODA_VERS CHIUSO_ERR_CODA CHIUSO_OK CHUSO_ERR_TIMEOUT CHIUSO_ERR_CRASH_FTP CHIUSO_ERR_CRASH_FS_PRIM CHIUSO_ERR_CRASH_FS_SECOND ANNULLATO CHIUSO_ERR_VERS Descrizine Stat che l Oggett assume nel mment in cui viene eseguita la chiamata al servizi InviOggettPreIngest (i file devn ancra essere trasmessi al server FTP). Stat che l Oggett assume nel mment in cui il Sistema ha ricevut la ntifica dell avvenut trasferiment dei file ed ha cntrllat l effettiva presenza di tale cartella. Stat che l Oggett assume in cas di errre nella ntifica dell avvenut trasferiment via FTP dei file. Stat che l Oggett assume nel mment in cui il jb PreparaXMLSACER predispne l Indice SIP nrmalizzat per versare in Sacer il relativ SIP. Stat che l Oggett assume in cas di errre nella fase di predispsizine dell Indice SIP nrmalizzat da versare a SACER. Stat che l Oggett assume nel mment in cui il jb PrducerCdaVersament pne il SIP nella cda di versament a SACER. Stat che l Oggett assume in cas di errre intercrs nella predispsizine della cda per il versament a SACER. Stat che l Oggett assume quand il versament nel Sistema del SIP nrmalizzat è andata a bun fine. Stat che l Oggett assume se il servizi attravers il quale viene versat il SIP nrmalizzat ha rilevat un timeut da SACER. Stat che l Oggett in crs di versament e cn l indicazine che è da recuperare, assume se la prcedura di recuper dell area FTP ha success. Stat che l Oggett assume dp il su versament a Sacer se la prcedura di recuper del file system primari ha success. Stat che l Oggett assume dp il su versament a Sacer se la prcedura di recuper del file system secndari ha success. Stat che l Oggett assume dp il su versament a Sacer se l Oggett viene annullat. Stat che l Oggett assume in cas di errre intercrs nel versament a SACER del SIP nrmalizzat. Il diagramma stati-transizini che segue illustra il cicl di vita di un Oggett in PING. Specifiche tecniche dei servizi di versament [ 126 ]

127 Un Oggett nasce cn stat IN_ATTESA_FILE se il servizi InviOggettPreIngest cn cui l Oggett è versat, ha success. Un Oggett cn stat IN_ATTESA_FILE, assume stat IN_ATTESA_SCHED se il servizi NtificaTrasferimentFile cn cui è ntificat l avvenut trasferiment via FTP dei file dell Oggett, ha success. Un Oggett cn stat IN_ATTESA_FILE, assume stat CHIUSO_ERR_NOTIF se il servizi NtificaTrasferimentFile cn cui è ntificat l avvenut trasferiment via FTP dei file dell Oggett, fallisce. Un Oggett cn stat IN_ATTESA_SCHED, assume stat IN_ATTESA_VERS se il jb PreparaXMLSACER cn cui sn preparati gli Indici SIP nrmalizzati per il versament a SACER ha success. Un Oggett cn stat IN_ATTESA_SCHED, assume stat CHIUSO_ERR_SCHED se il jb PreparaXMLSACER cn cui sn preparati gli Indici SIP nrmalizzati per il versament a SACER fallisce. Un Oggett cn stat IN_ATTESA_VERS, assume stat IN_CODA_VERS se il jb PrducerCdaVersament cn cui le Unità dcumentarie da versare sn pste in cda per essere versate, ha success e se il jb ha pst in cda tutte le Unità dcumentarie relative all Oggett. Un Oggett cn stat IN_ATTESA_VERS, assume stat CHIUSO_ERR_CODA se il jb PrducerCdaVersament cn cui le Unità dcumentarie relative all Oggett sn pste in cda per essere versate fallisce. Un Oggett cn stat IN_CODA_VERS, assume stat CHIUSO_OK se il servizi CnsumerCdaVersament cn cui le Unità dcumentarie relative all Oggett sn versate in SACER ha success. Specifiche tecniche dei servizi di versament [ 127 ]

128 Un Oggett cn stat IN_CODA_VERS, assume stat CHIUSO_ERR_VERS se il servizi CnsumerCdaVersament nn ha success. Un Oggett cn stat IN_CODA_VERS, assume stat CHUSO_ERR_TIMEOUT se il servizi CnsumerCdaVersament ha rilevat un timeut da SACER. Un Oggett cn stat CHIUSO_ERR_CODA, assume stat IN_ATTESA_VERS se il jb RecuperaErrriInCda cn cui sn recuperati gli errri di messa in cda di versament delle Unità dcumentarie da versare relative all Oggett, ha success. Un Oggett cn stat CHIUSO_ERR_TIMEOUT, assume stat IN_ATTESA_VERS se il jb RecuperaVersErr cn cui sn recuperati i versamenti a SACER per i quali è stat rilevat un timeut, ha success. Un Oggett cn stat CHIUSO_ERR_VERS, assume stat IN_ATTESA_VERS se l utente ha verificat l Oggett nn versat definendl da recuperare e se il jb RecuperaVersErr cn cui sn recuperati i versamenti a SACER per i quali è stat rilevat un errre recuperabile, ha success. Un Oggett cn stat IN_ATTESA_SCHED IN_ATTESA_VERS IN_CODA_VERS CHIUSO_ERR_TIMEOUT CHIUSO_ERR_VERS e cn l indicazine che è da recuperare, assume stat CHIUSO_ERR_CRASH_FTP se la prcedura di recuper dell area FTP ha success. Un Oggett cn stat CHIUSO_OK, assume stat CHIUSO_ERR_CRASH_FS_PRIM se la prcedura di recuper del file system primari ha success. Un Oggett cn stat CHIUSO_OK, assume stat CHIUSO_ERR_CRASH_FS_SECOND se la prcedura di recuper del file system secndari ha success. Un Oggett cn stat CHIUSO_OK, assume stat ANNULLATO se l Oggett viene annullat Infrmazini per attivare i servizi di versament asincrn Il Servizi di versament in mdalità asincrna può essere utilizzat sl dai Versatri abilitati. L abilitazine è definita in sede di Disciplinare tecnic frnend le infrmazini descritte nel presente paragraf, utilizzate per cnfigurare pprtunamente il Sistema Infrmazini sul Versatre asincrn Le principali infrmazini relative al Versatre riguardan: Descrizine Versatre asincrn: gni Versatre per il versament di SIP nn nrmalizzati (Versatre asincrn) viene definit attravers le seguenti infrmazini: Ambiente, Nme, Descrizine e Passwrd; Specifiche tecniche dei servizi di versament [ 128 ]

129 Assciazine tra Versatre asincrn e Struttura versante: serve a definire in quale Struttura versante verrann versati i SIP ricevuti dal Versatre asincrn al termine del prcess di nrmalizzazine (fase di Preacquisizine del prcess di cnservazine, vedi paragraf del Manuale di cnservazine). L identificazine della Struttura versante è definita dalle seguente infrmazini: Ambiente, Ente, Struttura, UserID e Passwrd (vedi paragraf ); Cartelle FTP: definisce il riferiment alle cartelle FTP utilizzate dal Versatre asincrn per scrivere (path_in) e recuperare (path_ut); Tiplgie di Oggett: definisce le tiplgie di Oggett da versare in mdalità asincrna (vedi paragraf 3.2.2). Più in dettagli: Nme Descrizine OBBL Nme Versatre Nme che identifica il Versatre asincrn. X Descrizine Versatre Nme Ambiente Versatre Path Ftp Input Path Ftp Output Ambiente Sacer Ente Sacer Descrizine del Versatre asincrn. Denminazine dell Ambiente in cui pera il Versatre asincrn, definit da ParER. Riferiment FTP alla cartella in cui il Versatre asincrn esegue la scrittura dei file (Oggetti-dati). Riferiment FTP alla cartella in cui il Versatre asincrn esegue il recuper dei file richiesti. Nme dell Ambiente della Struttura versante (vedi paragraf ). Nme dell Ente di appartenenza delle Struttura versante (vedi paragraf ). X X X X X X Struttura Sacer Nme della Struttura versante (vedi paragraf ). X User ID Sacer Nme del Versatre della Struttura versante (UserID, vedi paragraf ). X Passwrd Versatre Passwrd del Versatre asincrn. X Passwrd Sacer Passwrd del Versatre di Sacer (deve crrispndere cn la passwrd definita per quel determinat UserID). X Tiplgie di Oggett Mentre le tiplgie di SIP nrmalizzati sn definite a priri (vedi Sez. 1), nel cas di versament di SIP nn nrmalizzati le tiplgie di SIP nn sn stabilite a priri ma vann definite di vlta in vlta per pter cnfigurare crrettamente il prcess di nrmalizzazine e cncrdate cn gni singl Prduttre. Per gni tiplgia di Oggett è necessari definire le seguenti infrmazini: Specifiche tecniche dei servizi di versament [ 129 ]

130 Nme Descrizine OBBL Nme Oggett Descrizine Oggett Tip di calcl dell Unità dcumentaria Nme che identifica la tiplgia di Oggett da versare (per esempi: PUC) Descrizine della tiplgia di Oggett da versare (per esempi: Piani Urbanistici Cmunali) Indica il frmat del metadat Numer della Chiave Le mdalità di trasmissine dei file gestite dal Sistema sn le seguenti: X X X file n ZIP: la cstruzine del SIP nrmalizzat sarà eseguita dal Sistema estraend e rielabrand i dati presenti nel file; Tip di versament file file ZIP cn Indice SIP: il SIP da nrmalizzare è cstituit da tante cartelle quante sn i SIP di Unità dcumentaria da versare nel Sistema. Ogni cartella è riferita a un singl SIP di Unità dcumentaria, è nminata cn la Chiave dell Unità dcumentaria e cntiene al su intern l Indice SIP di Unità dcumentaria e i file (Oggetti dati) di cui si cmpne; X file ZIP senza Indice SIP: il SIP da nrmalizzare è cstituit da tante cartelle quante sn i SIP di Unità dcumentaria da versare nel Sistema. Ogni cartella è riferita a un singl SIP di Unità dcumentaria, è nminata cn la Chiave dell Unità dcumentaria e cntiene al su intern i file (Oggetti-dati) di cui si cmpne. In quest cas la cstruzine dell Indice SIP di Unità dcumentaria sarà eseguita dal Sistema estraend e rielabrand i dati presenti nel file. Cntrll Hash Registr Sacer Nme Tip UD Sacer Indica se per il Tip di Oggett deve essere eseguit men il cntrll Hash (Si N). Indica il nme del Tip registr da utilizzare per la creazine dell Indice SIP di Unità dcumentaria Indica il nme della Tiplgia di Unità dcumentaria da utilizzare per la creazine dell Indice SIP di Unità dcumentaria. Frza Accettazine Frza Cnservazine Frza Cllegament Definisce cme devn essere valrizzati i Parametri di versament nell Indice SIP di Unità dcumentaria. Tip Cnservazine Dati specifici della tiplgia di Oggett Specifiche tecniche dei servizi di versament [ 130 ]

131 Nel cas in cui la tiplgia di Oggett preveda dei Dati specifici, è pssibile assciare a quella determinata tiplgia un XSD cn i metadati specifici (per infrmazini più dettagliate sul cncett di Dati specifici vedi paragraf ) Tiplgie di file gestite per l specific Oggett Per gni tiplgia di Oggett ccrre definire i tipi di file attesi per quella determinata tiplgia. Il Tip di file accettat in versament è caratterizzat dalle seguenti infrmazini: Nme Descrizine OBBL Nme Tip File Oggett Descrizine Tip File Oggett Versament Sacer Nme Tip Dcument Sacer Tip Dcument Nme che identifica il tip di file all intern dell Oggett Descrizine della tiplgia di tip di file dell Oggett da versare Assume valre True se il Tip versament file è n ZIP, mentre assume valre False il Tip versament file è di altr tip. X X X Nme Struttura Dcument Sacer Nme Tip Cmpnente Sacer Frmat File Versat in Sacer Verifica Firma Frmat Frmat File Calclat Sacer Frmat Rappresentazine Estes Sacer Frmat Rappresentazine Calclat Sacer Calcl hash Sacer Tip calcl hash Infrmazini relative alle valrizzazine dei metadati dell Indice SIP nrmalizzat da versare in SACER (vedi paragraf ). Indicazine se per il tip di file deve essere eseguit men il cntrll Hash (Si N) Assume valri: - NOTIFICATO nel cas in cui l hash venga cmunicat nel servizi Ntifica trasferiment file - FILE HASH DICOM nel cas in cui l hash venga cmunicat nell Indice SIP inviat in fase di chiamata al servizi InviOggettPreIngest X X Specifiche tecniche dei servizi di versament [ 131 ]

132 3.3. Descrizine del prcess di versament in mdalità asincrna Chiamata del web service InviOggettPreIngest L Applicativ versante invca il web service SOAP InviOggettPreIngest res dispnibile dal Sistema. Il web service prevede la seguente interfaccia di chiamata: Parametr Tip Descrizine OBBL NmAmbiente String Nme che identifica l Ambiente cui appartiene il Versatre asincrn. X NmVersatre String Nme che identifica il Versatre asincrn nell'ambit dell'ambiente di appartenenza X CdPasswrd String Cntiene la passwrd di autenticazine del versatre asincrn X CdKeyObject String Chiave che identifica l'oggett versat nell'ambit del Versatre asincrn. Per esempi: PUC X NmTipObject String Nme identificante il tip dell'oggett versat nell'ambit del Versatre asincrn X FlFileCifrat Blean Indica se i file dell'oggett sarann trasmessi cifrati, ppure n (default = false) X flfrzawarning Blean Indica se frza a WARNING l esit del versament; default = false X FlFrzaAccettazine Blean Assume valri True False. Valre di default: False True: indica la vlntà del versante di vler eseguire l invi in cnservazine anche se la precedente sessine di ingest dell Oggett versat è in stat WARNING X DlMtivazine String Mtiv della frzatura (da indicare nel cas in cui FlFrzaAccettazine sia settat a True) CdVersineXML String Versine del file XML cntenente i Dati specifici versat cn l'oggett. È definit se nel versament è inviat anche il file XML cn i dati specifici XML String È l Indice del SIP da nrmalizzare, un dcument in frmat XML. Può cntenere i metadati specifici dell Oggett se per la Tiplgia di Unità dcumentaria relative all Oggett per le tiplgie di file versati sn previsti Dati specifici Indice del SIP da nrmalizzare Specifiche tecniche dei servizi di versament [ 132 ]

133 Per gni Unità dcumentaria cntenuta nell Oggett, l Indice del SIP da nrmalizzare cnsente al Versatre asincrn di cmunicare tutte le infrmazini necessarie al Sistema per creare gli Indici SIP (nrmalizzati) di Unità dcumentaria da versare in cnservazine. L Indice del SIP è trasmess tramite il servizi InviOggettPreIngest e deve essere cstruit in md cerente cn la versine supprtata dal servizi (attualmente la 1.0), il cui XSD è allegat al presente dcument. Nella descrizine delle Unità dcumentarie, il tag Dati Specifici va valrizzat sl se per quella tiplgia di Unità dcumentaria sn previsti Dati specifici (vedi paragraf 1.1.1) la cui versine deve cincidere cn quella riprtata nell Indice nel tag <VersineDatiSpecifici>. Nella descrizine dei File, il tag Dati Specifici va valrizzat sl se il tip File specificat nel tag <TipFile> prevede Dati specifici la cui versine deve cincidere cn quella riprtata nell Indice nel tag <VersineDatiSpecifici>. L XSD dell Indice del SIP da nrmalizzare è pubblicat sul sit di ParER (vedi paragraf Elenc degli XSD descritti nel presente dcument ). Esempi di Indice del SIP da nrmalizzare Nel seguente esempi viene eseguit il versament di un SIP da nrmalizzare cntenente un Unità dcumentaria cstituita un Dcument principale e un Allegat, un Anness e da tre File. I Dati specifici sn previsti per la tiplgia di Unità dcumentaria e su due tiplgie di File: TipFilePrincipale e TipFileAllegat, mentre nn sn previsti per la tiplgia di file TipFileAnness. <?xml versin="1.0" encding="iso " standalne="yes"?> <ListaUnitaDcumentarie> <Versine>1.0</Versine> <UnitaDcumentaria> <Chiave> <Numer>1</Numer> <Ann>2013</Ann> <TipRegistr>PUC</TipRegistr> </Chiave> <PrfilUnitaDcumentaria> <Oggett>Pian strutturale cmunale 2013</Oggett> <Data> </Data> </PrfilUnitaDcumentaria> <DatiSpecifici> <VersineDatiSpecifici>1.0</VersineDatiSpecifici> < TipStrument>Pian Strutturale Cmunale</TipStrument> < DataApprvazine> </DataApprvazine> </DatiSpecifici> <Files> <File> <TipFile>TipFilePrincipale</TipFile> Specifiche tecniche dei servizi di versament [ 133 ]

134 <PrfilDcument> <Descrizine>Tavla riepilgativa</descrizine> <Autre>Cmune XXX</Autre> </PrfilDcument> <DatiSpecifici> <VersineDatiSpecifici>1.0</VersineDatiSpecifici> <TipTavla>Riepilgativa</TipTavla> </DatiSpecifici> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> </File> <File> <TipFile>TipFileAllegat</TipFile> <PrfilDcument> <Descrizine>Tavla 1</Descrizine> <Autre>Cmune XXX</Autre> </PrfilDcument> <DatiSpecifici> <VersineDatiSpecifici>1.0</VersineDatiSpecifici> <NumerTavla>1</ NumerTavla> </DatiSpecifici> <UtilizzDataFirmaPerRifTemp>false</UtilizzDataFirmaPerRifTemp> </File> <File> <TipFile>TipFileAnness</TipFile> <UtilizzDataFirmaPerRifTemp>false</UtilizzDataFirmaPerRifTemp> </File> </Files> </UnitaDcumentaria> </ListaUnitaDcumentarie> Esit chiamata al servizi InviOggettPreIngest Il Sistema esegue un cntrll sincrn sulla chiamata al servizi InviOggettPreIngest tes a verificare la crrettezza della chiamata e a validare l Indice. In cas di errre nella chiamata al servizi InviOggettPreIngest nella validazine dell Indice, l Oggett viene pst in errre (errri appartenenti alle classi di errre PING- SENDOBJ e PING-SENDOBJ-XML) ed il prcess di versament termina. In assenza di errre il Sistema autrizza il trasferiment via FTP dell Oggett. Nel Sistema l Oggett rimane nell stat IN_ATTESA_FILE. I parametri in utput del servizi di InviOggettPreIngest sn i seguenti: Parametr Tip Descrizine OBBL Specifiche tecniche dei servizi di versament [ 134 ]

135 Cdice che identifica l esit del servizi: CdEsit String OK se nn si determinan errri; KO se si determina un errre; X WARN se si determina un warning. cderr dlerr String String Cdice identificante l errre il warning rilevat. Nn è definit se CdEsit = OK. Descrizine dell errre del warning rilevat. Nn è definit se CdEsit = OK. NmAmbiente String X NmVersatre String X CdKeyObject String X NmTipObject String X Valre inserit nella chiamata al servizi. FlFileCifrat Blean X flfrzawarning Blean X FlFrzaAccettazine Blean X CdVersineXML String XML String Trasferiment FTP In assenza di errre nella chiamata al servizi InviOggettPreIngest e nella validazine dell eventuale Indice trasmess, il Sistema autrizza il trasferiment via FTP dell Oggett. L Applicativ versante può quindi prcedere al trasferiment via FTP dell Oggett File system area FTP Il file system dell area FTP usat dall Applicativ versante e dal Sistema per il versament degli Oggetti, è rganizzat cme segue: rt <sacer_ping.ftp.input_flder> <cdiceoggett> <cdiceoggett>_xxxxxx.xxx <cdiceoggett>_yyy.jjj Dve: rt è la cartella assciata all utente (specificat dal parametr sacer_ping.ftp.user) in fase di cnfigurazine del FTP server; Specifiche tecniche dei servizi di versament [ 135 ]

136 <sacer_ping.ftp.input_flder> è la cartella in cui il client trasferisce i file dell Oggett da versare; <cdiceoggett> è la cartella che cntiene il file dell Oggett; <cdiceoggett>_xxxxxx.xxx e <cdiceoggett>_yyy.jjj sn i file dell Oggett da versare Chiamata del servizi NtificaTrasferimentFile Dp aver trasferit gli ggetti da versare nell area FTP dedicata, l Applicativ versante invca il servizi NtificaTrasferimentFile per cmunicare al Sistema l avvenut trasferiment. I parametri in input per la chiamata al servizi sn i seguenti: Parametr Tip Descrizine OBBL NmAmbiente String Nme che identifica l'ambiente a cui appartiene il Versatre asincrn. X NmVersatre String Nme che identifica il Versatre asincrn. X CdPasswrd String Cntiene la passwrd di autenticazine del Versatre asincrn. CdKeyObject String Chiave che identifica l'oggett versat nell'ambit del Versatre asincrn. X ListaFileDepsitati Array X NmTipFile String Nme identificante il tip di file versat nell'ambit del tip Oggett. NmNmeFile String Nme del file depsitat. X CdEncding String Encding hash. TiAlgritmHash String Algritm di hash utilizzat. Al mment sn gestiti SHA256, SHA1, MD5. DsHashFile String Hash dei file trasmessi. Viene utilizzat in fase di cntrll asincrn per verificare l integrità dei file inviati. X X Fasi successive del prcess di Preacquisizine Dp aver ricevut la ntifica dell avvenut trasferiment del file da parte del Versatre asincrn, il mdul Sacer Pre Ingest prcede alle successive perazini per eseguire l invi a Sacer. Nell specific tali perazini sn: predispsizine delle cde di versament. Tale funzinalità viene eseguita tramite un appsit jb, eseguit ad intervalli prestabiliti. In questa fase, nel cas in cui la tiplgia di Oggett la preveda, il Sistema esegue il cntrll dell hash per verificare l integrità del SIP trasmess. Specifiche tecniche dei servizi di versament [ 136 ]

137 predispsizine dell Indice SIP nrmalizzat secnd le specifiche descritte nella Sez. 1. Nel cas in cui l Indice SIP nrmalizzat sia versat dall applicativ chiamante in fase di invcazine del servizi InviOggettPreIngest, questa fase nn viene svlta. versament in cnservazine del SIP nrmalizzat attravers il servizi Versament Multimedia, utilizzand il PI SIP (vedi paragraf 1.1.2) per cmunicare a Sacer dve recuperare i file del SIP. Specifiche tecniche dei servizi di versament [ 137 ]

138 Sez. 4 Scenari di utilizz In questa sezine sn descritti alcuni degli scenari di utilizz più cmuni riguardanti il versament di SIP nel Sistema Versament di un Unità dcumentaria In quest scenari, la Struttura versante trasmette al Sistema un Unità dcumentaria da cnservare invcand tramite l Applicativ versante il web service VersamentSync. Servizi: VersamentSync - Versament sincrn di Unità dcumentaria (paragraf 2.1.8). Attri: Applicativ versante; Sistema di cnservazine (Sistema). Event scatenante: Chiamata dell Applicativ versante. Precndizini 1) L Applicativ versante deve essere autrizzat al versament sul Sistema; Pstcndizini 1) Materiale crrettamente inviat al Sistema di Cnservazine. 2) L Indice SIP di Unità dcumentaria deve essere cnfrme alla struttura richiesta dal XSD descritta nel paragraf e dall XSD di Dati specifici (se presenti) previst per la specifica tiplgia di Unità dcumentaria (vedi paragraf ); 3) I dcumenti da versare devn essere firmati cn un dei frmati di firma ammessi dalle Regle tecniche, a men che nn sia impstat il parametr Frza cnservazine a True (in quest cas viene accettat in cnservazine anche un dcument nn firmat); 4) Le eventuali firme digitali appste sul dcument da firmare devn essere valide a men che nn sia impstat il parametr Frza accettazine a False (in quest cas viene accettat in cnservazine anche un dcument cn firma nn valida). Attività 1) L Applicativ versante chiama il Servizi di versament sincrn di Unità dcumentaria (VersamentSync) inviand l Indice del SIP e i file che cstituiscn l Unità dcumentaria; Specifiche tecniche dei servizi di versament [ 138 ]

139 2) Il Sistema recupera l XSD definit per la specifica tiplgia di Unità dcumentaria; 3) Il Sistema esegue la validazine dell Indice SIP inviat in input cn l schema XSD relativ alla tiplgia di Unità dcumentaria versata; 4) Il Sistema verifica che l Applicativ versante sia autrizzat al versament (cntrlland le infrmazini presenti nel tag Versatre: Ambiente, Ente, Struttura e UserID); 5) Il Sistema verifica la presenza, nella chiamata al servizi, dei file dichiarati nell Indice SIP; 6) Il Sistema verifica che la tiplgia di Unità dcumentaria e il tip Dcument di ciascun dcument appartenga a una delle tiplgie definite per la Struttura versante; 7) Il Sistema esegue un cntrll semantic sull Indice SIP; 8) Il Sistema esegue il cntrll sui file cntenuti nel SIP (frmat e firma); 9) Il Sistema calcla gli identificativi degli ggetti versati, nnché l hash e la dimensine di gni file versat; 10) Al termine dei cntrlli il Sistema chiude il versament e, se a bun fine, genera il Rapprt di versament; 11) Il Sistema invia all Applicativ chiamante l Esit del versament. Flussi alternativi 1) Nel cas in cui nn sian previsti Dati specifici per la tiplgia di Unità dcumentaria da versare, il Sistema esegue la validazine basandsi esclusivamente sull schema XSD generale dell Indice SIP di Unità dcumentaria; 2) Nel cas in cui la firma appsta su un file sia prssima alla scadenza (rispett ad un intervall di temp precnfigurat) il sistema evidenzia un warning. Flussi di errre 1) Se l Applicativ versante cmpie un errre nella chiamata al servizi viene generat errre (errre nell invcazine del servizi); 2) Se l Applicativ versante nn è autrizzat al versament il Sistema genera errre (errre di autenticazine della Struttura versante); 3) Se l Applicativ versante nn invia l Indice SIP, il Sistema genera errre (Parametr nn valid nella chiamata al servizi); 4) Se la tiplgia di Unità dcumentaria indicata nell Indice SIP nn crrispnde ad una delle tiplgie cnfigurate per la Struttura versante, il Sistema genera errre (Parametr nn valid nella chiamata al servizi); 5) Se la validazine dell Indice SIP cn il relativ XSD nn va a bun fine il Sistema genera errre (errre nella struttura dei metadati); 6) Se dal cntrll sulla Chiave risulta che l Unità dcumentaria è già presente nel Sistema, il Sistema genera errre (l Unità dcumentaria ggett di versament è già stata acquisita nel Sistema); 7) Se il TipRegistr ha attivat il cntrll di cnsecutività, il Sistema cntrlla che il numer di Unità dcumentaria versata sia cnsecutiv rispett all ultim numer versat; Specifiche tecniche dei servizi di versament [ 139 ]

140 8) Nel cas di timeut nell attesa della rispsta il Sistema di cnservazine cnclude il versament ma nn riesce a restituire l Esit versament all Applicativ versante. Nel cas in cui l Applicativ versante richiami il web service di versament per inviare la stessa Unità dcumentaria, il Sistema genererà errre inviand all Applicativ versante l Esit versament che cnterrà cmunque l stat di cnservazine e il Rapprt di versament dell Unità dcumentaria. In alternativa, L Applicativ versante ptrà chiamare il web service di Recuper dell stat di cnservazine (vedi dcument Specifiche tecniche dei servizi di recuper) per cnscere l esit del versament; 9) Nel cas in cui i cntrlli sui file inviati nn vadan a bun fine, il Sistema genera errre (almen un esit negativ nelle verifiche dei file che cmpngn l Unità dcumentaria versata) Aggiunta di un Dcument ad un Unità dcumentaria già presente nel Sistema In quest scenari la Struttura versante esegue il versament di Dcument da aggiungere a un Unità dcumentaria già presente nel Sistema invcand l appsit web service AggiuntaAllegatiSync. Servizi: Versament sincrn di aggiunta Dcument (AggiuntaAllegatiSync). Attri: Applicativ versante; Sistema di cnservazine (Sistema). Event scatenante: Chiamata dell Applicativ versante. Precndizini 1) L Applicativ versante deve essere autrizzat al versament sul Sistema; Pstcndizini 1) Dcument crrettamente inviat al Sistema. 2) L Unità dcumentaria cui il Dcument da versare si riferisce deve essere già presente nel Sistema. Attività 1) L Applicativ versante chiama il servizi di AggiuntaAllegatiSync inviand l Indice del SIP e i file che cstituiscn il Dcument; 2) Il Sistema verifica che l Applicativ versante sia autrizzat al versament cntrlland i valri Ambiente, Ente, Struttura e UserID); 3) Il Sistema verifica attravers la Chiave presente nell Indice SIP di Dcument che l Unità dcumentaria cui il Dcument versat appartiene sia effettivamente presente nel Sistema; 4) Il Sistema esegue la validazine dell Indice del SIP di Dcument inviat cn il relativ schema XSD; 5) Il Sistema di cnservazine esegue un cntrll semantic sull Indice SIP di Dcument inviat; Specifiche tecniche dei servizi di versament [ 140 ]

141 6) Il Sistema esegue il cntrll sui file (frmat e firma); 7) Al termine dei cntrlli il Sistema chiude il versament e, se a bun fine, genera il Rapprt di versament; 8) Il Sistema invia all Applicativ versante l Esit versament. Flussi di errre 1) Se l Applicativ versante nn è autrizzat al versament, il Sistema genera errre (errre di autenticazine della Struttura versante); 2) Se la validazine dell Indice SIP cn il relativ XSD nn va a bun fine, il Sistema genera errre (errre nella struttura dei metadati); 3) Se dal cntrll sulla Chiave risulta che l Unità dcumentaria NON è presente nel Sistema, il Sistema genera errre (l Unità dcumentaria cui il Dcument si riferisce nn è presente nel Sistema); 4) Nel cas di errre nell invi del file il Sistema segnala errre in fase di salvataggi del Dcument; 5) Nel cas in cui i cntrlli sui file inviati nn vadan a bun fine, il Sistema genera errre (almen un esit negativ nelle verifiche dei file che cmpngn il Dcument); 6) Nel cas di timeut nell attesa della rispsta, il Sistema cnclude il versament ma nn riesce a restituire l Esit versament all Applicativ versante. L Applicativ versante ptrà chiamare il web service di Recuper dell stat di cnservazine (vedi dcument Specifiche tecniche dei servizi di recuper) per cnscere l esit del versament, in alternativa, ripetere il versament del Dcument. In quest cas, il Sistema genererà errre inviand all Applicativ versante l Esit versament che cnterrà cmunque l stat di cnservazine e il Rapprt di versament dell Unità dcumentaria Aggirnament dei metadati di un Unità dcumentaria già presente nel Sistema Quest scenari riguarda l aggirnament dei metadati di un Unità dcumentaria già presente nel Sistema. L aggirnament avviene attravers il versament di un SIP di Metadati che può l inter nuv set di metadati per sstituire quell esistente ppure un set di metadati differente da integrare a quell esistente. Cme già descritt nel paragraf 1.3, il SIP di Metadati assume la frma di un SIP di Dcument da aggiungere all Unità dcumentaria i cui metadati devn essere aggirnati mediante l invcazine del web service AggiuntaAllegatiSync. Il cas nrmale è che nel SIP di Metadati tali metadati sian cntenuti nel tag Dati specifici del Dcument, il cui SIP, di cnseguenza, nn cnterrebbe alcun file ma sl l Indice. Per versare nel Sistema un SIP di Dcument senza file ccrre che nell Indice SIP il relativ Cmpnente abbia il tag TipSupprt valrizzat cn METADATI e che i parametri Frza accettazine e Frza cnservazine sian valrizzati True. Specifiche tecniche dei servizi di versament [ 141 ]

142 È tuttavia prevista l iptesi che, per ragini tecniche rganizzative, sia pssibile prdurre e inviare i metadati sl inserendli in un file (nrmalmente in frmat XML). In quest cas, il SIP di Metadati sarà cmpst dall Indice SIP e dal file che cntiene i metadati. Nell Indice SIP il TipSupprt va valrizzat cn FILE, mentre il parametr Frza cnservazine deve essere valrizzat True. Per attivare le prcedure di aggirnament dei metadati, ccrre cncrdare cn ParER la tiplgia di Dcument da utilizzare (in entrambi i casi) e il relativ set di metadati specifici (nel prim cas). Una vlta ricevut il SIP di Metadati e aggiunt cme Dcument all Unità dcumentaria, i Sistema prvvederà in un mment successiv a rielabrare i nuvi metadati trasmessi, sstituend e/ integrandli ai metadati dell Unità dcumentaria preesistenti. Sin a quel mment, qualra i metadati aggiunti sian cntenuti nell Indice del SIP inviat, i nuvi metadati sarann ricercabili nel Sistema utilizzand le funzinalità di ricerca sui metadati specifici del Dcument aggiunt. Nel cas in cui i metadati aggiunti sn cntenuti nn nell Indice ma nel file del SIP versat, nn sarann ricercabili sul Sistema prima del cmpletament delle perazini di rielabrazine cui si accennava prima. Servizi: Servizi di versament sincrn di aggiunta Dcument (AggiuntaAllegatiSync). Attri: Applicativ versante; Sistema di cnservazine (Sistema). Event scatenante: Necessità di aggirnare i metadati di un Unità dcumentaria già presente nel Sistema. Precndizini 1) L Unità dcumentaria i cui metadati devn essere aggirnati è già presente nel Sistema. Pstcndizini 1) Il Dcument che cntiene i metadati necessari ad aggirnare quelli preesistenti è crrettamente aggiunt all Unità dcumentaria. Attività 1) L Applicativ versante chiama il web service AggiuntaAllegatiSync per inviare il SIP cn il Dcument cntenente i metadati. Il SIP nn cnterrà file (Oggetti-dati) ma sl l Indice SIP, in quant i metadati sn trasmessi nel tag DatiSpecifici; Nell Indice SIP il TipSupprt del Cmpnente è METADATI, FrzaAccettazine e FrzaCnservazine sn valrizzati True, mentre TipDcument e DatiSpecifici devn essere cnfrmi a quant precedentemente cncrdat tra Struttura versante e ParER. L Applicativ versante eseguirà l invi del sl Indice SIP. Di seguit un esempi di Indice di un SIP di Metadati che cntiene i metadati nei DatiSpecifici dell Indice: <?xml versin="1.0" encding="is "?> <UnitaDcAggAllegati > Specifiche tecniche dei servizi di versament [ 142 ]

143 <Intestazine> <Versine>1.4</Versine> <Versatre> <Ambiente> </Ambiente> <Ente> </Ente> <Struttura> </Struttura> <UserID> </UserID> </Versatre> <Chiave> </Chiave> </Intestazine> <Numer></Numer> <Ann></Ann> <TipRegistr> </TipRegistr> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>true</FrzaAccettazine> <FrzaCnservazine>true</FrzaCnservazine> </Cnfigurazine> <Anness> <IDDcument></IDDcument> <TipDcument>CONCORDATO CON PARER</TipDcument> <PrfilDcument> <Descrizine>Descrizine</Descrizine> <Autre>Autre</Autre> </PrfilDcument> <DatiSpecifici> </DatiSpecifici> </Anness> </UnitaDcAggAllegati> <VersineDatiSpecifici> </VersineDatiSpecifici> <MetadatUn>Uguale al preesistente</ MetadatUn > < MetadatDue >METADATO AGGIORNATO</ MetadatDue > < MetadatTre >Uguale al preesistente</ MetadatTre > <StrutturaOriginale> <Cmpnenti> <Cmpnente> <ID> </ID> <OrdinePresentazine></OrdinePresentazine> <TipCmpnente> </TipCmpnente> <TipSupprtCmpnente>METADATI</TipSupprtCmpnente> </Cmpnente> </Cmpnenti> </StrutturaOriginale> Flussi Alternativi Specifiche tecniche dei servizi di versament [ 143 ]

144 1) L Applicativ versante esegue l invi del SIP cstituit dall Indice SIP e dal file cntenente i metadati in frmat XML. I metadati nn sn cntenuti nell Indice SIP ma in un file. In quest cas, il TipSupprt del Cmpnente è FILE, FrzaCnservazine è valrizzat True, mentre per il TipDcument (che dvrà cmunque essere precedentemente cncrdat tra ParER e Struttura versante) nn sn definiti metadati specifici. Di seguit un esempi di Indice di un SIP di Metadati che cntiene i metadati nel file: <?xml versin="1.0" encding="is "?> <UnitaDcAggAllegati > <Intestazine> <Versine>1.4</Versine> <Versatre> <Ambiente> </Ambiente> <Ente> </Ente> <Struttura> </Struttura> <UserID> </UserID> </Versatre> <Chiave> </Chiave> </Intestazine> <Numer></Numer> <Ann></Ann> <TipRegistr> </TipRegistr> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaCnservazine>true</FrzaCnservazine> </Cnfigurazine> <Anness> <IDDcument></IDDcument> <TipDcument> CONCORDATO CON PARER</TipDcument> <PrfilDcument> <Descrizine> </Descrizine> <Autre> </Autre> </PrfilDcument> </Anness> <StrutturaOriginale> <Cmpnenti> </UnitaDcAggAllegati> <Cmpnente> <ID> </ID> <OrdinePresentazine></OrdinePresentazine> <TipCmpnente> </TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <FrmatFileVersat>XML</FrmatFileVersat> </Cmpnente> </Cmpnenti> </StrutturaOriginale> Specifiche tecniche dei servizi di versament [ 144 ]

145 Flussi di errre 1) Se dal cntrll sulla Chiave risulta che l Unità dcumentaria cui il SIP di Metadati deve perare NON è già stata versata nel Sistema, il Sistema genera errre (l Unità dcumentaria nn è presente nel sistema) 4.4. Annullament di un Unità dcumentaria già versata nel Sistema Nel seguente scenari sn presentate le diverse mdalità che permettn al Versatre di gestire l avvenut annullament nei prpri sistemi di un dcument che già versat nel Sistema. Va da sé che le varie casistiche pssn essere gestite anche in cmbinazine tra lr, in funzine delle mdalità cn cui le stesse sn gestite nei sistemi del Prduttre del Versatre. EVENTO AZIONE SUI SISTEMI DEL VERSATORE EMISSIONE DI NUOVO DOCUMENTO AZIONI SUL SISTEMA DI CONSERVAZIONE Annullament mediante mdifica metadati L annullament del dcument viene gestit mediante la valrizzazine di un specific metadat ( più metadati) del dcument stess nei sistemi del Versatre. NO CASO 1: viene effettuat il versament di un SIP di Metadati cntenente il valre aggirnat del metadat utilizzand il web service AggiuntaAllegatiSync. Annullament mediante appsizine di watermark sul dcument annullat L annullament del dcument viene gestit mediante la prduzine di un nuv dcument identic a quell annullat cn medesim identificativ, data e cntenut che però reca un watermark cmunque una dicitura che dichiara il dcument annullat. SI, cn la stessa Chiave del precedente CASO 2:2.1.8 il nuv dcument dvrà essere versat in cnservazine cme Anness dell Unità dcumentaria già inviata in cnservazine utilizzand il web service AggiuntaAllegatiSync. L Anness sarà tipizzat cncrdand cn ParER un pprtuna valrizzazine del metadat <TipDcument>. Specifiche tecniche dei servizi di versament [ 145 ]

146 Annullament mediante prduzine di un nuv dcument che annulla il precedente Annullament mediante prduzine di un nuv dcument che sstituisce il precedente L annullament del dcument viene gestit mediante la prduzine di un nuv dcument, cn identificativ, data e cntenut diversi dal dcument annullat, il cui cntenut è limitat alla dispsizine dell annullament. L annullament del dcument viene gestit mediante la prduzine di un nuv dcument cn identificativ, data e cntenut diversi dal dcument annullat che sstituisce quell riginari. SI, cn Chiave diversa dalla precedente CASO 3: il nuv dcument dvrà essere versat in cnservazine cme un Unità dcumentaria distinta, che cnterrà nell Indice SIP le infrmazini per cllegarl all Unità dcumentaria annullata, già presente nel Sistema. Il metadat DescrizineCllegament sarà valrizzat in md da chiarire la natura del cllegament (es.: Annullament, Sstituzine). Il web service da utilizzare per il versament è VersamentSync CASO 1: Annullament mediante mdifica metadati In quest scenari l annullament del dcument già versat in cnservazine avviene senza la prduzine da parte del Versatre di un nuv dcument. Un dei casi più frequenti è, ad esempi, l annullament di una registrazine di prtcll. Qualra il Versatre vglia allineare anche sul Sistema le infrmazini sull stat di validità del dcument, può aggirnare le infrmazini precedentemente versate mediante il versament di un SIP di Metadati, secnd le mdalità descritte nel paragraf 4.3 Più in dettagli, per gestire questa casistica in md efficace, ricrdand che il SIP di Metadati si cnfigura cme un particlare us del SIP di Dcument, è necessari: 1) cncrdare un TipDcument specific per l scp (ad esempi: ANNULLAMENTO REGISTRAZIONE DI PROTOCOLLO); 2) cncrdare cn quali mdalità descrivere l annullament, e in particlare: a) se è pssibile inviare i metadati inserendli nell Indice SIP (vedi punt 3), che rappresenta la sluzine preferibile; b) se per ragini tecniche rganizzative i metadati pssn essere prdtti e trasmessi in un file (vedi punt 4). 3) nel cas in cui le infrmazini sull annullament sian cntenute nell Indice SIP, il SIP di Metadati cnterrà sl l Indice SIP. A quest punt ccrre definire in che md i metadati relativi all annullament sarann presenti nell Indice SIP. Tre le sluzini pssibili: a) Specifiche tecniche dei servizi di versament [ 146 ]

147 utilizzand i metadati del PrfilDcument (Autre e Descrizine); b) utilizzand il set di metadati specifici dell Unità dcumentaria ( del Dcument principale) dell Unità dcumentaria annullata; c) utilizzand un set di metadati specifici divers. Più in dettagli: a) nel cas in cui si decida di utilizzare i metadati di PrfilDcument Autre e Descrizine per descrivere il mtiv dell annullament e il su autre, l Indice SIP nn cnterrà metadati specifici. Si tratta di un pzine nn cnsigliata in quant le infrmazini sull annullament sn limitate e frnite in md pc strutturat che pngn al Sistema seri prblemi per la lr successiva rielabrazine per integrarli sstituirli a quelli riginari; b) in quest cas se, ad esempi, ad essere annullata è una registrazine di prcll, il Versatre ptrà versare un SIP di Metadati cstituit da un Anness cn tip dcument ANNULLAMENTO REGISTRAZIONE DI PROTOCOLLO e un set di metadati specifici identic a quell della tiplgia di Unità dcumentaria del tip di Dcument principale dell Unità dcumentaria la cui registrazine di prtcll è stata annullata. Il SIP di Metadati versat, quindi, cnterrà sl l Indice SIP cn nei DatiSpecifici l inter set di metadati, che a sua vlta cnterrà le infrmazini sull annullament (es.: data, autre, mtiv) mediante l pprtuna valrizzazine dei relativi metadati. Tale set di metadati andrà a sstituire integralmente nel Sistema quell precedentemente inviat; c) nel terz cas, si definirà un set di metadati specific divers da quell previst per l Unità dcumentaria il Dcument principale. Tale set può essere un subset dei metadati specifici riginari (ad esempi, sl quelli relativi all annullament della registrazine) un set aggiuntiv (se, ad esempi, si vglin trasmettere infrmazini più dettagliate sull annullament della registrazine utilizzand metadati nn ricmpresi nel set riginari). Anche in quest cas il SIP di Metadati cnterrà sl l Indice SIP cn un set di metadati specifici che andrà ad aggirnare nel Sistema quell riginari, sstituend integrand, a secnda dei casi, i relativi metadati; 4) nel cas in cui le infrmazini sull annullament sn cntenute nn nell Indice SIP ma in un file, il SIP di Metadati sarà frmat dall Indice SIP e dal file cntenente i metadati. Le limitazini in fase di ricerca che implica quest scenari d us, descritte nel paragraf 4.3, scnsiglian l utilizz di questa mdalità per aggirnare i metadati. Servizi: Servizi di versament sincrn di aggiunta Dcument (AggiuntaAllegatiSync); Attri: Applicativ versante; Sistema di cnservazine (Sistema) Event scatenante: Necessità di cmunicare al Sistema l annullament da parte del Versatre di un Unità dcumentaria già versata mediante aggirnament dei metadati Precndizini 1) L Unità dcumentaria annullata dal Versatre è già presente nel Sistema. Pstcndizini 1) Il Dcument trasmess cn il SIP di Metadati cn i metadati di annullament è crrettamente versat nel Sistema. Attività Specifiche tecniche dei servizi di versament [ 147 ]

148 1) L applicativ chiama il Servizi di versament sincrn di aggiunta Dcument (AggiuntaAllegatiSync) per inviare il SIP di Metadati cntenente le infrmazini sull annullament dell Unità dcumentaria. Nell esempi i metadati sn riprtati nei metadati specifici, per cui nell Indice SIP è indicat che il tip supprt del Cmpnente è METADATI. L Applicativ versante eseguirà l invi di un SIP di Metadati cntenente sl l Indice SIP (per un esempi si veda quell riprtat nel paragraf 1.3.1). Flussi di Errre Se dal cntrll sulla Chiave risulta che l Unità dcumentaria cui il SIP di Metadati deve perare NON è già stata versata nel Sistema, il Sistema genera errre (l Unità dcumentaria nn è presente nel sistema) CASO 2: Annullament mediante prduzine di un dcument cn stessa Chiave In quest scenari, l annullament da parte del Versatre avviene mediante la prduzine di un nuv dcument cn gli stessi elementi identificativi (Chiave) di quell annullat. Questa casistica può essere gestita inviand il nuv dcument al Sistema per integrarl nell Unità dcumentaria annullata. Ad esempi, quest avviene quand in cas di annullament viene prdtta una nuva versine del dcument annullat cntenente watermark altre diciture che rendn evidente che il dcument stess sia stat annullat. In questi casi, la nuva versine del dcument sarà versat cme Anness all Unità dcumentaria versata riginariamente nel Sistema, definend un specific tip dcument che identifica la natura dell Anness stess (ad esempi VERSIONE ANNULLATA ). In fase di generazine aggirnament dell AIP, al fine di agevlare la cnsultazine di quella specifica Unità dcumentaria, il Sistema ptrà cnsiderare l Anness aggiunt cme il nuv Dcument principale, definend al cntemp quell vecchi cme Anness. Questa mdalità di gestine dell annullament viene gestita nel md descritt qui di seguit. Servizi: Servizi di versament aggiunta Dcument (AggiuntaAllegatiSync); Attri: Applicativ versante; Sistema di cnservazine (Sistema) Event scatenante: Necessità di trasmettere al Sistema il dcument che sstituisce quell annullat, da integrare nell Unità dcumentaria cntenente il dcument annullat dal Versatre, versata in precedenza nel Sistema. Precndizini: 1) L applicativ chiamante ha già inviat a Sacer l UD che dvrà essere sstituita/integrata. Pstcndizini: 1) Il nuv Anness che integra l Unità dcumentaria è crrettamente versat in Sacer. Specifiche tecniche dei servizi di versament [ 148 ]

149 Attività 1) L applicativ chiama il Servizi di aggiunta Dcument AggiuntaAllegatiSync per inviare il nuv anness che cntiene le infrmazini per integrare la UD. 2) Di seguit un esempi di Indice SIP di Dcument: <?xml versin="1.0" encding="is "?> <UnitaDcAggAllegati xmlns:xsi=" xsi:nnamespaceschemalcatin="file:///c:/wsrequestunic.xsd"> <Intestazine> <Versine>1.4</Versine> <Versatre> <Ambiente>PARER</Ambiente> <Ente>ENTEXXX</Ente> <Struttura>STRUTTURAYYY</Struttura> <UserID>versatreYYY</UserID> </Versatre> <Chiave> <Numer>6</Numer> <Ann>2011</Ann> <TipRegistr>REFERTI</TipRegistr> </Chiave> </Intestazine> <Cnfigurazine> <TipCnservazine>VERSAMENTO_ANTICIPATO</TipCnservazine> <FrzaAccettazine>false</FrzaAccettazine> <FrzaCnservazine>false</FrzaCnservazine> </Cnfigurazine> <Anness> <IDDcument>02</IDDcument> <TipDcument>VERSIONE ANNULLATA</TipDcument> <PrfilDcument> <Descrizine>Descrizine xxx</descrizine> <Autre>Pal Rssi</Autre> </PrfilDcument> <StrutturaOriginale> <Cmpnenti> <Cmpnente> <ID>ID1</ID> <OrdinePresentazine>1</OrdinePresentazine> <TipCmpnente>Cntenut</TipCmpnente> <TipSupprtCmpnente>FILE</TipSupprtCmpnente> <NmeCmpnente>Dcument_1.xml.p7m</NmeCmpnente> <FrmatFileVersat>XML.P7M</FrmatFileVersat> <UtilizzDataFirmaPerRifTemp>true</UtilizzDataFirmaPerRifTemp> </Cmpnente> </Cmpnenti> </StrutturaOriginale> </Anness> Specifiche tecniche dei servizi di versament [ 149 ]

150 </UnitaDcAggAllegati> Flussi alternativi Prcedere cn l annullament del versament dell Unità dcumentaria relativa al dcument annullat (vedi paragraf 2.1.8) e versare il nuv dcument che sstituisce quell precedentemente versat cme una nuva Unità dcumentaria cn i medesimi dati identificativi (Chiave) di quella il cui versament è stat annullat. Flussi di errre Se dal cntrll sulla Chiave risulta che l Unità dcumentaria NON è già stata versata nel Sistema, il Sistema genera errre (l Unità dcumentaria nn è presente nel sistema) CASO 3: Annullament mediante prduzine di un dcument cn Chiave diversa In quest scenari il Versatre ha annullat sui prpri sistemi un dcument già versat nel Sistema e vule riprtare questa infrmazine anche nel sistema di cnservazine. L annullament in questine avviene mediante la prduzine di un nuv dcument che annulla il precedente. Quest nuv dcument dvrà essere versat nel Sistema cme una nuva Unità dcumentaria, la quale sarà cllegata a quella annullata (già presente nel Sistema). La relazine (Cllegament) che viene in quest md creata tra le due entità cnsente di descrivere efficacemente l annullament della Unità dcumentaria precedentemente versata ad pera della nuva. La nuva Unità Dcumentaria verrà quindi versata in Sacer utilizzand il web service VersamentSync, indicand nel relativ Indice SIP, nel tag Cllegamenti, il riferiment all Unità dcumentaria ( alle Unità dcumentarie) annullata (annullate). In quest md il Sistema creerà un cllegament tra le due ( più) Unità dcumentarie. Questa mdalità si presta ad essere utilizzata quand, ad esempi, l annullament di un più dcumenti è dispst da un prvvediment. L annullament è cmunicat al Sistema mediante il versament dell Unità dcumentaria di tale prvvediment, cn le infrmazini per cllegare al prvvediment le Unità dcumentarie annullate dall stess. Alcuni esempi di questa casistica in ambit di dcumentazine sanitaria sn: refert sstitutiv che viene emess cn un numer divers rispett al refert riginale; prduzine di più versini dell stess refert, la cui numerazine è però distinta tramite utilizz di lettere numeri (ad esempi: refert n. 1234, 1234a, 1234b ppure , , ). In questi casi, nell Indice SIP dell Unità dcumentaria del refert sstitutiv integrativ sarà indicat il cllegament alle Unità dcumentarie dei referti riginari e la descrizine della natura del cllegament (ad esempi: Sstituzine, Integrazine, Annullament, ecc.). Servizi: Servizi di versament sincrn di Unità dcumentaria (VersamentSync). Attri: Applicativ versante; Sistema di cnservazine (Sistema). Specifiche tecniche dei servizi di versament [ 150 ]

151 Event scatenante: Necessità di cmunicare al Sistema l annullament da parte del Versatre di un Unità dcumentaria già versata dispsta da un altr dcument. Precndizini 1) L Unità dcumentaria annullata è già presente nel Sistema. Pstcndizini 1) La nuva Unità dcumentaria che annulla la precedente è crrettamente versata nel Sistema. Il Sistema crea un cllegament tra la nuva Unità dcumentaria e l Unità dcumentaria annullata. Attività 1) L Applicativ versante chiama il web service VersamentSync per versare l Unita dcumentaria che annulla l Unità dcumentaria già presente nel Sistema, inviand il SIP di Unità dcumentaria cntenente l Indice SIP e i relativi file. 2) L Indice SIP cnterrà nel tag DcumentiCllegati le chiavi delle Unità dcumentarie annullate e la descrizine della natura del cllegament: <DcumentiCllegati> <DcumentCllegat> <ChiaveCllegament> <Numer>string</Numer> <Ann>ann</Ann> <TipRegistr>string</TipRegistr> </ChiaveCllegament> <DescrizineCllegament>Annullament</DescrizineCllegament> </DcumentCllegat> <DcumentCllegat> <ChiaveCllegament> <Numer>string</Numer> <Ann>2012</Ann> <TipRegistr>string</TipRegistr> </ChiaveCllegament> <DescrizineCllegament>Annullament</DescrizineCllegament> </DcumentCllegat> </DcumentiCllegati> Nel cas in cui il parametr FrzaCllegament sia valrizzat False, il Sistema cntrlla che tutte le Unità dcumentarie elencate nel tag DcumentiCllegati sian presenti nel Sistema. Flussi di Errre 1) Nel cas in cui il parametr FrzaCllegament sia valrizzat False e nn tutte le Unità dcumentarie cllegate a quella in versament sn presenti nel Sistema, il Sistema segnala errre e impedisce il versament dell Unità dcumentaria. Specifiche tecniche dei servizi di versament [ 151 ]