Il Ministero della Salute (MdS) metterà a disposizione degli Enti, da cui riceve dati, applicazioni SDK specifiche per flusso logico e tecnologie applicative (Java, PHP e C#) per verifica preventiva (in casa Ente) della qualità del dato prodotto.
Nel presente documento sono fornite la struttura e la sintassi dei tracciati previsti dalla soluzione SDK per avviare il proprio processo elaborativo, nonché i relativi schemi xsd di convalida e i controlli di merito sulla qualità, completezza e coerenza dei dati.
Gli obiettivi del documento sono:
- fornire una descrizione funzionale chiara e consistente dei tracciati di input a SDK;
- fornire le regole funzionali per la verifica di qualità, completezza e coerenza dei dati;
In generale, la soluzione SDK è costituita da 2 diversi moduli applicativi (Access Layer e Validation Engine) per abilitare
- l’interoperabilità con il contesto tecnologico dell’Ente in cui la soluzione sarà installata;
- la validazione del dato ed il suo successivo invio verso il MdS.
La figura che segue descrive la soluzione funzionale ed i relativi benefici attesi.
Nella tabella riportata di seguito sono elencati tutti gli acronimi e le definizioni adottati nel presente documento.
| # | Acronimo / Riferimento | Definizione |
|---|---|---|
| 1 | NSIS | Nuovo Sistema Informativo Sanitario |
| 2 | SDK | Software Development Kit |
| 3 | SISM | Sistema Informativo Salute Mentale |
Di seguito una rappresentazione architetturale del processo di gestione e trasferimento dei flussi dall’ente verso l’area MdS attraverso l’utilizzo dell’applicativo SDK e il corrispondente diagramma di sequenza.
- L’utente dell’ente caricherà in una apposita directory (es. /sdk/input/) il flusso sorgente. L’utente avvierà l’SDK passando in input una serie di parametri descritti in dettaglio al paragrafo 3.1
- La compenente Access Layer estrae dalla chiamata dell’ente i parametri utilizzati per lanciare l’SDK, genera un identificativo ID_RUN, e un file chiamato “{ID_RUN}.json” in cui memorizza le informazioni dell’esecuzione.
- I record del flusso verranno sottoposti alle logiche di validazione e controllo definite nel Validation Engine. Nel processare il dato, il Validation Engine acquisirà da MdS eventuali anagrafiche di validazione del dato stesso.
- Generazione del file degli scarti contenente tutti i record in scarto con evidenza degli errori riscontrati. I file di scarto saranno memorizzati in cartelle ad hoc (es. /sdk/esiti).
- Tutti i record che passeranno i controlli verranno inseriti in un file xml copiato in apposita cartella (es /sdk/xml_output), il quale verrà eventualmente trasferito a MdS utilizzando la procedura “invioFlussi” esposta da GAF WS (tramite PDI). A fronte di un’acquisizione, il MdS fornirà a SDK un identificativo (ID_UPLOAD) che sarà usato da SDK sia per fini di logging che di recupero del File Unico degli Scarti.
- A conclusione del processo di verifica dei flussi, il Validation Engine eseguirà le seguenti azioni:
a. Aggiornamento file contenente il riepilogo dell’esito dell’elaborazione del Validation Engine e del ritorno dell’esito da parte di MdS. I file contenenti l’esito dell’elaborazione saranno memorizzati in cartelle ad hoc (es. /sdk/run).
b. Consolidamento del file di log applicativo dell’elaborazione dell’SDK in cui sono disponibili una serie di informazioni tecniche (Es. StackTrace di eventuali errori).
c. Copia del file generato al punto 5, se correttamente inviato al MdS, in apposita cartella (es. /sdk/sent).
Ad ogni step del precedente elenco e a partire dal punto 2, l’SDK aggiornerà di volta in volta il file contenente l’esito dell’elaborazione.
Nota: l’SDK elaborerà un solo file di input per esecuzione.
In generale, le classi di controllo previste su Validation Engine sono:
- Controlli FORMALI (es. correttezza dei formati e struttura record)
- Controlli SINTATTICI (es. check correttezza del Codice Fiscale)
- Controlli di OBBLIGATORIETÀ DEL DATO (es. Codice Prestazione su flusso…)
- Controlli STRUTTURE FILE (es. header/footer ove applicabile)
- Controlli di COERENZA CROSS RECORD
- Controlli di corrispondenza dei dati trasmessi con le anagrafiche di riferimento
- Controlli di esistenza di chiavi duplicate nel file trasmesso rispetto alle chiavi logiche individuate per ogni tracciato.
Si sottolinea che la soluzione SDK non implementa controlli che prevedono la congruità del dato input con la base date storica (es: non viene verificato se, per un nuovo inserimento, la chiave del record non sia già presente sulla struttura dati MdS).
La figura sottostante mostra l’architettura di integrazione della soluzione SDK con il MdS. Si evidenzia in particolare che:
- Tutti i dati scambiati fra SDK e MdS saranno veicolati tramite Porta di Interoperabilità (PDI);
- Il MdS esporrà servizi (API) per il download di dati anagrafici;
- SDK provvederà ad inviare vs MdS l’output (record validati) delle proprie elaborazioni. A fronte di tale invio, il MdS provvederà a generare un identificativo di avvenuta acquisizione del dato (ID_UPLOAD) che SDK memorizzerà a fini di logging.
In questa sezione è descritta le specifica di funzionamento del flusso ANR per l’alimentazione dello stesso.
In fase di caricamento del file verrano impostati i seguenti parametri che andranno in input al SDK in fase di processamento del file:
| NOME PARAMETRO | DESCRIZIONE | LUNGHEZZA | DOMINIO VALORI |
|---|---|---|---|
| ID CLIENT | Identificativo univoco della transazione che fa richiesta all'SDK | 100 | Non definito |
| NOME FILE INPUT | Nome del file per il quale si richiede il processamento lato SDK | 256 | Non definito |
| ANNO RIFERIMENTO | Stringa numerica rappresentante l’anno di riferimento per cui si intende inviare la fornitura | 4 | Anno (Es. 2022) |
| PERIODO RIFERIMENTO | Stringa alfanumerica rappresentante il periodo per il quale si intende inviare la fornitura. In fase di invio della fornitura verso Mds si dovrà concatenare al valore di questo campo il carattere I (i MAIUSCOLA) (Es. S1I) | 2 | S1, S2 |
| TIPO TRASMISSIONE | Indica se la trasmissione dei dati verso MDS avverrà in modalità full (F) o record per record (R). Per questo flusso la valorizzazione del parametro sarà impostata di default a F | 1 | F/R |
| FINALITA’ ELABORAZIONE | Indica se i flussi in output prodotti dal SDK verranno inviati verso MDS (Produzione) oppure se rimarranno all’interno del SDK e il processamento vale solo come test del flusso (Test) | 1 | Produzione/Test |
| CODICE REGIONE | Individua la Regione a cui afferisce la struttura. Il codice da utilizzare è quello a tre caratteri definito con DM 17 settembre 1986, pubblicato nella Gazzetta Ufficiale n.240 del 15 ottobre 1986, e successive modifiche, utilizzato anche nei modelli per le rilevazioni delle attività gestionali ed economiche delle Aziende unità sanitarie locali. |
3 | Es. 010 |
Il flusso di input avrà formato csv posizionale e una naming convention libera a discrezione dell’utente che carica il flusso senza alcun vincolo di nomenclatura specifica (es: nome_file.csv). Il separatore per il file csv sarà la combinazione di caratteri tra doppi apici: “~“.
All’interno della specifica del tracciato sono indicati i dettagli dei campi di business del tracciato di input atteso da SDK, il quale differisce per i diversi flussi dell’area SISM. All’interno di tale file è presente la colonna Posizione nel file la quale rappresenta l’ordinamento delle colonne del tracciato di input da caricare all’SDK.
Di seguito la tabella in cui è riportata la specifica del tracciato di input per il flusso in oggetto:
| Nome campo | Posizione nel File | Key | Descrizione | Tipo | Obbligatorietà | Informazioni di Dominio | Lunghezza campo | XPATH Tracciato Output |
|---|---|---|---|---|---|---|---|---|
| Anno di riferimento | 1 | KEY | Indica l’anno a cui si riferisce la rilevazione. | N | OBB | Formato AAAA | 4 | /ResidenzialeAnagrafica/AnnoRiferimento |
| Codice Regione | 2 | KEY | Individua la Regione a cui afferisce la struttura. Il codice da utilizzare è quello a tre caratteri definito con DM 17 settembre 1986, pubblicato nella Gazzetta Ufficiale n.240 del 15 ottobre 1986, e successive modifiche, utilizzato anche nei modelli per le rilevazioni delle attività gestionali ed economiche delle Aziende unità sanitarie locali. | AN | OBB | 3 | /ResidenzialeAnagrafica/CodiceRegione | |
| Periodo di Riferimento | 3 | KEY | Indica il semestre a cui si riferisce la rilevazione. | AN | OBB | Valori Accettati • S1 • S2 |
2 | /ResidenzialeAnagrafica/PeriodoRiferimento |
| Codice Azienda Sanitaria di Riferimento | 4 | KEY | Id Identifica l’azienda sanitaria locale in cui e’ sito il Servizio. Il codice da utilizzare è quello a tre caratteri usato anche nei modelli per le rilevazioni delle attività gestionali ed economiche delle Aziende unità sanitarie locali (codici di cui al D.M. 05/12/2006 e successive modifiche). | AN | OBB | Riferimento: · codice ASL - MRA (Monitoraggio Rete Assistenza); | 3 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/CodiceAziendaSanitariaRiferimento |
| Codice Dipartimento Salute Mentale | 5 | KEY | Identifica il dipartimento di Salute Mentale interessato alla rilevazione. | AN | OBB | ** | 3 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/CodiceDSM |
| Id Record | 6 | KEY | Codice identificativo unico del record | AN | OBB | Il valore deve essere generato come descritto nel par. 2.2.3.3.2 - Codice identificativo unico del record (ID_REC) – modalità di alimentazione | 88 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/Id_Rec |
| CUNI | 7 | Identificativo unico non invertibile dell’assistito | AN | OBB | Il campo deve essere valorizzato con il codice identificativo dell’assistito generato come descritto nel par. 2.2.3.3.1- CUNI – modalità di alimentazione | 88 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/CUNI | |
| Validità del codice Identificativo dell'assistito | 8 | Informazione relativa alla validità del codice identificativo dell'assistito recuperata a seguito della chiamata al servizio di validazione esposto dal sistema TS del MEF | N | OBB | I valori ammessi sono: 0 - Codice identificativo valido (presente in banca dati MEF) 1 - Codice identificativo errato (non presente in banca dati MEF) |
1 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/validitaCI | |
| Tipologia del codice Identificativo dell'assistito | 9 | Informazione relativa alla tipologia del codice identificativo dell'assistito recuperata a seguito della chiamata al servizio di validazione esposto dal sistema TS del MEF | N | OBB | I valori ammessi sono: 0 - Codice Fiscale, 1 - Codice STP, 2 - Codice ENI, 3 - Codice TEAM, 4 - codice fiscale numerico provvisorio a 11 cifre, 99 - Codice non presente in banca dati |
2 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/tipologiaCI | |
| Anno di nascita | 10 | Identifica l’anno di nascita dell’assistito, il formato da utilizzare è il seguente: AAAA. L’età dell’assistito nell’anno della rilevazione del dato deve essere compresa tra i 18 ed i 100 anni. | N | OBB | Formato: AAAA | 4 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/AnnoNascita | |
| Sesso | 11 | Identifica il sesso anagrafico dell’assistito. E’ necessario riportare l’informazione più aggiornata al termine del periodo di riferimento della rilevazione. | N | OBB | Valori Ammessi: 1=MASCHIO 2=FEMMINA 9=NON NOTO/NON RISULTA |
1 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/Sesso | |
| Cittadinanza | 12 | Identifica la cittadinanza dell’assistito a cui è stata erogata la prestazione. La codifica da utilizzare è quella Alpha2 (a due lettere) prevista dalla normativa ISO 3166. E’ necessario riportare l’informazione più aggiornata al termine del periodo di riferimento della rilevazione | A | OBB | Valore Ammesso: Codice Alpha 2 codifica ISO 3166-1. o ZZ = APOLIDI o XX = CITTADINANZA SCONOSCIUTA o XK = KOSOVO |
2 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/Cittadinanza | |
| Regione di residenza | 13 | Individua la Regione di residenza dell’assistito a cui è stata erogata la prestazione. Il codice da utilizzare è quello a tre caratteri definito dal DM 17 settembre 1986, pubblicato nella Gazzetta Ufficiale n.240 del 15 ottobre 1986, e successive modifiche, utilizzato anche nei modelli per le rilevazioni delle attività gestionali ed economiche delle Aziende unità sanitarie locali. Nel caso di soggetto senza fissa dimora si adotterà il codice 098. Nel caso di soggetto residente all’estero si adotterà il codice 998. In ogni caso, è necessario riportare l’informazione più aggiornata al termine del periodo di riferimento della rilevazione. |
AN | OBB | Valori Ammessi: Allegato 1 o 098=SENZA FISSA DIMORA o 998=RESIDENTE ALL’ESTERO o 999=NON NOTO/NON RISULTA |
3 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/CodiceRegioneResidenza | |
| ASL di Residenza | 14 | Indica il codice dell’azienda unità sanitaria locale che comprende il comune, o la frazione di comune, in cui risiede l’assistito. Il codice da utilizzare è quello a tre caratteri usato anche nei modelli per le rilevazioni delle attività gestionali ed economiche delle Aziende unità sanitarie locali (codici di cui al D.M. 05/12/2006 e successive modifiche). Nel caso di soggetto senza fissa dimora si adotterà il codice 098. Nel caso di soggetto residente all’estero si adotterà il codice 998. |
AN | OBB | Riferimento: MRA (Monitoraggio Rete Assistenza) Valori Ammessi: Anagrafica MRA o 098=SENZA FISSA DIMORA o 998=RESIDENTE ALL’ESTERO o 999=NON NOTO/NON RISULTA |
3 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/ASLResidenza | |
| Stato estero di residenza | 15 | Codice dello Stato estero in cui risiede l’assistito a cui è stata erogata la prestazione. La codifica da utilizzare è quella Alpha2 (a due lettere) prevista dalla normativa ISO 3166. E’ necessario riportare l’informazione più aggiornata al termine del periodo di riferimento della rilevazione. | A | FAC | Valore Ammesso: Codice Alpha 2 codifica ISO 3166-1. o XX = STATO ESTERO DI RESIDENZA SCONOSCIUTO o XK = KOSOVO |
2 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/StatoEsteroResidenza | |
| Stato Civile | 16 | Identifica lo stato civile dell’assistito alla fine del periodo di riferimento della rilevazione. | N | OBB | Valori Ammessi: 1=celibe 2=nubile 3=coniugato 4=separato 5=divorziato 6=vedovo 9= non noto/non risulta |
1 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/StatoCivile | |
| Collocazione Socio Ambientale | 17 | Indica la collocazione socio-ambientale dell'assistito al momento della rilevazione. | N | OBB | Valori Ammessi: 1=da solo 2=famiglia di origine 3=famiglia acquisita 4=con altri familiari o con altre persone 5=struttura residenziale psichiatrica per ricovero o lungodegenza 6=casa di riposo per anziani, RSA,altro istituto o comunità non a carattere psichiatrico 7=senza fissa dimora 8=altro 9=sconosciuto |
1 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/CollocazioneSocioAmbientale | |
| Titolo di Studio | 18 | Titolo di studio conseguito dall’assistito al termine del periodo di riferimento della rilevazione. | N | OBB | Valori Ammessi: 1=nessuno 2=licenza elementare 3=licenza media inferiore 4=diploma di qualifica professionale 5=diploma media superiore 6=laurea 7=laurea magistrale 9= non noto/non risulta |
1 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/TitoloStudio | |
| Codice Professionale | 19 | Indica il codice dell’ attività Professionale dell’ utente oggetto della rilevazione. | N | OBB | Valori Ammessi: 01=in cerca prima occupazione 02=disoccupato 03=casalinga 04=studente 05=pensionato 06=invalido 07=altra condizione non professionale 08=dirigente 09=quadro direttivo 10=impiegato, tecnico 11=capo operaio,operaio, bracciante 12=altro lavoratore dipendente 13=apprendista 14=lavoratore a domicilio per conto di imprese 15=militare di carriera 16=imprenditore 17=lavoratore in proprio 18=libero professionista 19=familiare coadiuvante 99=non noto/non risulta |
2 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/CodiceProfessionale | |
| Tipo operazione | 20 | Campo tecnico utilizzato per distinguere la trasmissione di informazioni nuove, modificate o eventualmente annullate. | A | OBB | Valori Ammessi: I=Inserimento C=Cancellazione V=Variazione NM: Non Movimentato (la componente Anagrafica del record non viene inserita nel relativo xml a valle della validazione) |
1 | /ResidenzialeAnagrafica/AziendaSanitariaRiferimento/DSM/Assistito/TipoOperazione |
Di seguito sono indicati i controlli da configurare sulla componente di Validation Engine e rispettivi error code associati riscontrabili sui dati di input per il flusso ANR.
Gli errori sono solo di tipo scarti (mancato invio del record).
Al verificarsi anche di un solo errore di scarto, tra quelli descritti, il record oggetto di controllo sarà inserito tra i record scartati.
Business Rule non implementabili lato SDK:
- Storiche (Business Rule che effettuano controlli su dati già acquisiti/consolidati che non facciano parte del dato anagrafico)
- Transazionali (Business Rule che effettuano controlli su record, i quali rappresentano transazioni, su cui andrebbe garantito l’ACID (Atomicità-Consistenza-Isolamento-Durabilità))
- Controllo d’integrità (cross flusso) (Business Rule che effettuano controlli sui record utilizzando informazioni estratte da record di altri flussi)
Di seguito le BR per il flusso in oggetto:
| CAMPO | FLUSSO | CODICE ERRORE | ATTIVA/DISATTIVA | DESCRIZIONE ERRORE | DESCRIZIONE MDS | DESCRIZIONE ALGORITMO | TABELLA ANAGRAFICA | CAMPI DI COERENZA | SCARTI/ANOMALIE | TIPOLOGIA BR |
|---|---|---|---|---|---|---|---|---|---|---|
| Anno Riferimento | ANR | 3001 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | il campo deve essere valorizzato e diverso da blanks | Non Definito | Non definito | Scarti | Basic |
| Anno Riferimento | ANR | 3000 | Attiva | Datatype errato in un campo obbligatorio | Valore compreso tra 1000 e 2999 | Non definito | Non definito | Non definito | Scarti | Basic |
| Anno Riferimento | ANR | 3009 | Attiva | Il valore del campo Anno Riferimento e' diverso dal valore Anno Riferimento GAF | Il valore del campo Anno Riferimento e' diverso dall’Anno di Riferimento specificato al momento dell’upload sul GAF | Il valore del campo Anno Riferimento del tracciato di input e' diverso dall’Anno di Riferimento passato come parametro all'SDK | Non Definito | Non definito | Scarti | Basic |
| Codice Regione | ANR | 3011 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Codice Regione | ANR | 3012 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | Valori diversi da 010,020,030,041,042,050,060,070,080,090,100,110,120,130,140,150,160,170,180,190,200 | Non definito | Non definito | Non definito | Scarti | Basic |
| Codice Regione | ANR | 3305 | Attiva | Il codice regione non coincide con il MITTENTE | Il parametro Codice Regione passato in input all'SDK non coincide con il campo Codice Regione | Non definito | Non definito | Non definito | Scarti | Basic |
| Periodo Riferimento | ANR | 3021 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Periodo Riferimento | ANR | 3022 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | Il campo è valorizzato con valori diversi da S1, S2 | Non definito | Non definito | Non definito | Scarti | Basic |
| Periodo Riferimento | ANR | 3010 | Attiva | Il valore del campo Periodo Riferimento e' diverso dal valore Periodo Riferimento GAF | Il valore del campo Periodo Riferimento e' diverso dal Periodo di Riferimento specificato al momento dell’upload sul GAF | Il valore del campo Periodo Riferimento del tracciato di input e' diverso dall’Anno di Riferimento passato come parametro all'SDK | Non Definito | Non definito | Scarti | Basic |
| Codice Azienda Sanitaria di Riferimento | ANR | 3031 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Codice Azienda Sanitaria di Riferimento | ANR | 3030 | Attiva | Datatype errato in un campo obbligatorio | Il campo prevede 3 caratteri numerici. | Non definito | Non definito | Non definito | Scarti | Basic |
| Codice Azienda Sanitaria di Riferimento | ANR | 3310 | Attiva | Il codice della ASL di riferimento non esiste nella relativa anagrafica | Non Definito | Se ASL di residenza è uguale a 098, 999, 998 l'esito è ok, altrimenti il valore del campo Codice Azienda Sanitaria di Riferimento del tracciato di input deve esistere all'interno della colonna COD_ASL della query filtrata con le seguenti condizioni: - num_ann (QUERY) = Anno Riferimento (TRACCIATO INPUT)cod_reg_erg (QUERY) = Codice Regione (TRACCIATO INPUT) cod_asl (QUERY)= Codice Azienda Sanitaria di Riferimento (TRACCIATO INPUT). |
ASL | Anno Riferimento; Codice Regione; Codice Azienda Sanitaria di Riferimento | Scarti | Anagrafica |
| Codice Dipartimento Salute Mentale | ANR | 3041 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Codice Dipartimento Salute Mentale | ANR | 3040 | Attiva | Datatype errato in un campo obbligatorio | Il campo prevede 3 caratteri alfanumerici | Non definito | Non definito | Non definito | Scarti | Basic |
| Codice Dipartimento Salute Mentale | ANR | 3315 | Attiva | Il codice DSM non esiste nella relativa anagrafica | Non Definito | Il Codice Dipartimento Salute Mentale non esiste all'interno della colonna COD_DSM della query della query filtrata con le seguenti condizioni: - num_ann (QUERY) = Anno Riferimento (TRACCIATO INPUT)cod_reg (QUERY) = Codice Regione (TRACCIATO INPUT) cod_asr_rfr (QUERY)= Codice Azienda Sanitaria di Riferimento (TRACCIATO INPUT) |
DSM | Anno Riferimento; Codice Regione; Codice Azienda Sanitaria di Riferimento | Scarti | Anagrafica |
| Id Record | ANR | 3051 | Attiva | mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Id Record | ANR | 3050 | Attiva | Lunghezza non conforme a quella attesa | La lunghezza del valore specificato non è conforme a quanto previsto (88 caratteri) | Non definito | Non definito | Non definito | Scarti | Basic |
| CUNI | ANR | 3061 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| CUNI | ANR | 3060 | Attiva | Lunghezza non conforme a quella attesa | La lunghezza del valore specificato non è conforme a quanto previsto (88 caratteri) | Non definito | Non definito | Non definito | Scarti | Basic |
| Validità del codice Identificativo dell'assistito | ANR | 3072 | Attiva | Validità del Codice Identificativo non appartenente al dominio atteso (0,1) | Non Definito | Non definito | Non Definito | Non definito | Scarti | Basic |
| Validità del codice Identificativo dell'assistito | ANR | 3071 | Attiva | Mancata valorizzazione del campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Tipologia del codice Identificativo dell'assistito | ANR | 3082 | Attiva | Tipologia del Codice Identificativo non appartenente al dominio atteso (0,1,2,3,99) | Non Definito | Non definito | Non Definito | Non definito | Scarti | Basic |
| Tipologia del codice Identificativo dell'assistito | ANR | 3081 | Attiva | Mancata valorizzazione del campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Anno di nascita | ANR | 3091 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Anno di nascita | ANR | 3090 | Attiva | Datatype errato in un campo obbligatorio | Il campo deve essere un numerico compreso tra 1000 e 2999 | Non definito | Non definito | Non definito | Scarti | Basic |
| Anno di nascita | ANR | 3370 | Attiva | Anno di nascita successivo all'anno di riferimento | Non Definito | Non definito | Non Definito | Anno Riferimento | Scarti | Basic |
| Anno di nascita | ANR | 3941 | Attiva | L’età dell’assisitito non è compresa nel range atteso | L’età dell’assistito nell’anno della rilevazione del dato deve essere compresa tra i 18 ed i 100 anni. | anno della rilevazione coincide con il campo anno riferimento del record | Non definito | Non definito | Scarti | Basic |
| Sesso | ANR | 3101 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Sesso | ANR | 3102 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | valori diversi da 1,2,9 | Non definito | Non definito | Non definito | Scarti | Basic |
| Cittadinanza | ANR | 3111 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Cittadinanza | ANR | 3110 | Attiva | Datatype errato in un campo obbligatorio | Il campo deve essere di 2 caratteri alfabetici. | Non definito | Non definito | Non definito | Scarti | Basic |
| Cittadinanza | ANR | 3345 | Attiva | Cittadinanza non esiste nella relativa anagrafica | Non Definito | La cittadinanza non esiste all'interno della colonna SGL_NAZ della query | Codifica Alpha2 | Non definito | Scarti | Basic |
| Codice Regione di Residenza | ANR | 3121 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Codice Regione di Residenza | ANR | 3122 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | Non Definito | Non c'è una query su cui fare controlli perché è un controllo a livello xsd; controllo da eseguire sui valori presenti nel xsd; Valori diversi da: 010,020,030,041,042,050,060,070,080,090,100,110,120,130,140,150,160,170,180,190,200,999,998,098 | Regioni | Non definito | Scarti | Basic |
| ASL Residenza | ANR | 3131 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| ASL Residenza | ANR | 3130 | Attiva | Datatype errato | Il campo prevede 3 caratteri numerici. | Non definito | Non definito | Non definito | Scarti | Basic |
| ASL Residenza | ANT | 3601 | Attiva | ASL di residenza non valida | Il campo Asl di residenza è valorizzato con un codice non valido, (non presente in anagrafica e diverso da 098, 998 e 999) | Esito è ok se ASL di residenza è uguale a 098, 999, 998 oppure il campo Codice Azienda Sanitaria di Residenza del tracciato di input deve esistere all'interno della colonna COD_ASL della query filtrata con le seguenti condizioni: - num_ann (QUERY) = Anno Riferimento (TRACCIATO INPUT)cod_reg_erg (QUERY) = Codice Regione (TRACCIATO INPUT) cod_asl (QUERY)= Codice Azienda Sanitaria di Residenza (TRACCIATO INPUT). |
ASL | Anno Riferimento; Codice Regione; Codice Azienda Sanitaria di Residenza | Scarti | Anagrafica |
| ASL Residenza | ANR | 3602 | Attiva | Codice ASL di residenza dell'assistito incongruente rispetto al codice regione di residenza | Il campo Asl di residenza, valorizzato con 098 non è congruente con il codice Regione. | Controllo non da effettuare su anagrafica.Se il campo ASL Residenza è valorizzato con 098 (persona senza fissa dimora) allora anche il campo codice regione residenza deve essere valorizzato con 098 | tabella di raccordo regioni-province-comuni-asl | codice Regione | Scarti | Basic |
| Stato estero di residenza | ANR | 3132 | Attiva | Datatype errato | Il campo deve essere di 2 caratteri alfabetici. | Non definito | Non definito | Non definito | Scarti | Basic |
| Stato estero di residenza | ANR | 3375 | Attiva | Stato estero di residenza non presente in anagrafica | Non Definito | La cittadinanza non esiste all'interno della colonna SGL_NAZ della query | Codifica Alpha2 | Non definito | Scarti | Basic |
| Stato estero di residenza | ANR | 7366 | Attiva | Stato estero di residenza non congruente con la regione di residenza | Il campo Stato Estero di residenza non è congruente con il Codice Regione, valorizzato con 998. Se il campo è valorizzato con XX o ZZ, il campo Regione dovrebbe essere valorizzato con 999 o 098. | Controllo non da effettuare su anagrafica | tabella di raccordo regioni-province-comuni-asl | Codice Regione di residenza | Anomalia | Basic |
| Stato civile | ANR | 3141 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Stato civile | ANR | 3142 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | Valori diversi dai quelli Ammessi:1,2,3,4,5,6,9 | Non definito | Non definito | Non definito | Scarti | Basic |
| Collocazione Socio Ambientale | ANR | 3151 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Collocazione Socio Ambientale | ANR | 3152 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | Valori diversi dai quelli Ammessi:1,2,3,4,5,6,7,8,9 | Non definito | Non definito | Non definito | Scarti | Basic |
| Titolo di Studio | ANR | 3161 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Titolo di Studio | ANR | 3162 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | Valori diversi dai quelli Ammessi:1,2,3,4,5,6,7,9 | Non definito | Non definito | Non definito | Scarti | Basic |
| Codice Professionale | ANR | 3171 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Codice Professionale | ANR | 3172 | Attiva | Non appartenenza alla tabella di riferimento per un campo obbligatorio | Valori diversi dai quelli Ammessi:01,02,03,04,05,06,07,08,09,10,11,12,13,14,15,16,17,18,19,99 | Non definito | Non definito | Non definito | Scarti | Basic |
| Tipo operazione Anagrafica | ANR | 3181 | Attiva | Mancata valorizzazione di un campo obbligatorio | Non Definito | Mancata valorizzazione di un campo obbligatorio (non presente o uguale a blanks) | Non Definito | Non definito | Scarti | Basic |
| Tipo operazione Anagrafica | ANR | 3182 | Attiva | Tipo operazione non appartenente al dominio atteso (I,V,C) | Non Definito | Non definito | Non Definito | Non definito | Scarti | Basic |
I controlli applicativi saranno implementati a partire dall’acquisizione dei seguenti dati anagrafici disponibili in ambito MdS e recuperati con servizi ad hoc (Service Layer mediante PDI):
- DSM
- ASL
- Struttura
- Codice Alpha2
- ICD-09-CM
- Capitolo di patologie psichiatriche
All’interno del file censimento_anagrafiche sono presenti per ogni anagrafica il dettaglio implementativo (Query SQL) e la tabella fisica da cui alimentare l’anagrafica.
Il dato anagrafico sarà presente sottoforma di tabella composta da tre colonne:
-
Valore (in cui è riportato il dato, nel caso di più valori, sarà usato il carattere # come separatore)
-
Data inizio validità (rappresenta la data di inizio validità del campo Valore)
-
Formato: AAAA-MM-DD
-
Notazione inizio validità permanente: 1900-01-01
-
Data Fine Validità (rappresenta la data di fine validità del campo Valore)
- Formato: AAAA-MM-DD
- Notazione fine validità permanente: 9999-12-31
Affinchè le Business Rule che usano il dato anagrafico per effettuare controlli siano correttamente funzionanti, occorre sempre controllare che la data di competenza del record su cui si effettua il controllo (la quale varia in base alla componente), sia compresa tra le data di validità.
Di seguito viene mostrato un caso limite di anagrafica in cui sono presenti delle sovrapposizioni temporali e contraddizioni di validità permanente/specifico range:
| ID | VALUE | VALID_FROM | VALID_TO |
|---|---|---|---|
| 1 | VALORE 1 | 1900-01-01 | 9999-12-31 |
| 2 | VALORE 1 | 2015-01-01 | 2015-12-31 |
| 3 | VALORE 1 | 2018-01-01 | 2023-12-31 |
| 4 | VALORE 1 | 2022-01-01 | 2024-12-31 |
Diremo che il dato presente sul tracciato di input è valido se e solo se:
∃ VALUE_R = VALUE_A “tale che” VALID_FROM <= DATA_COMPETENZA <= VALID_TO
(Esiste almeno un valore compreso tra le date di validità)
Dove:
-
VALUE_R rappresenta i campi del tracciato di input coinvolti nei controlli della specifica BR
-
VALUE_A rappresenta i campi dell’anagrafica coinvolti nei controlli della specifica BR
-
VALID_FROM/VALID_TO rappresentano le colonne dell’anagrafica
-
DATA_COMPETENZA data da utilizzare per il filtraggio del dato anagrafico
A valle delle verifiche effettuate dal Validation Engine, qualora il caricamento sia stato effettuato con il parametro Tipo Elaborazione impostato a P, verranno inviati verso MdS tutti i record corretti secondo le regole di validazione impostate.
Verrà richiamata la procedura invioFlussi di GAF WS (tramite PDI) alla quale verranno passati in input i parametri così come riportati nella seguente tabella:
| NOME PARAMETRO | VALORIZZAZIONE |
|---|---|
| ANNO RIFERIMENTO | Parametro ANNO RIFERIMENTO in input a SDK |
| PERIODO RIFERIMENTO | Parametro PERIODO RIFERIMENTO in input a SDK |
| CATEGORIA FLUSSI | RES |
| NOME FLUSSO | ANR |
| NOME FILE | Parametro popolato dall’SDK in fase di invio flusso con il nome file generato dal Validation Engine in fase di produzione file. |
I flussi generati dall’SDK saranno presenti sotto la cartella “/sdk/xml_output” e dovranno essere salvati e inviati verso MdS rispettando la seguente nomenclatura:
SDK_RES_ANR_{Periodo di riferimento}_{ID_RUN}.xml
Dove :
- Periodo di Riferimento: composto dal semestre di riferimento (Es. S1).
- ID_RUN rappresenta l’identificativo univoco
A valle della presa in carico del dato da parte di MdS, SDK riceverà una response contenente le seguenti informazioni:
- codiceFornitura: stringa numerica indicante l’identificativo univoco della fornitura inviata al GAF
- errorCode: stringa alfanumerica di 256 caratteri rappresentante il codice identificativo dell’errore eventualmente riscontrato
- errorText: stringa alfanumerica di 256 caratteri rappresentante il descrittivo dell’errore eventualmente riscontrato
- Insieme delle seguenti triple, una per ogni file inviato:
a. idUpload: stringa numerica indicante l’identificativo univoco del singolo file ricevuto ed accettato dal MdS, e corrispondente al file inviato con la denominazione riportata nell’elemento “nomeFile” che segue
b. esito: stringa alfanumerica di 4 caratteri rappresentante l’esito dell’operazione (Vedi tabella sotto)
c. nomeFile: stringa alfanumerica di 256 caratteri rappresentante il nome dei file inviati.
Di seguito la tabella di riepilogo dei codici degli esiti possibili dell’invio del file:
| ESITO | DESCRIZIONE |
|---|---|
| AE00 | Errore di autenticazione al servizio |
| IF00 | Operazione completata con successo |
| IF01 | Incongruenza tra CF utente firmatario e cf utente inviante |
| IF02 | Firma digitale non valida |
| IF03 | Firma digitale scaduta |
| IF04 | Estensione non ammessa |
| IF05 | Utente non abilitato all’invio per la Categoria Flusso indicata |
| IF06 | Utente non abilitato all’invio per il Flusso indicata |
| IF07 | Periodo non congurente con la Categoria Flusso indicata |
| IF08 | Il file inviato è vuoto |
| IF09 | Errore interno al servizio nella ricezione del file |
| IF10 | Il numero di allegati segnalati nel body non corrisponde al numero di allegati riscontrati nella request |
| IF11 | Il nome dell’allegato riportato nel body non è presente tra gli allegati della request (content-id) |
| IF12 | Presenza di nomi file duplicati |
| IF13 | Errore interno al servizio nella ricezione del file |
| IF14 | Errore interno al servizio nella ricezione del file |
| IF15 | Errore interno al servizio nella ricezione del file |
| IF99 | Errore generico dell’operation |
Copia dei file inviati verso MdS il cui esito è positivo (ovvero risposta della procedura Invio Flussi con IF00) saranno trasferiti e memorizzati in una cartella ad hoc di SDK (es. sdk/sent) rispettando la stessa naming descritta per i flussi di output.
In una cartella dedicata (es. /sdk/esiti) verrà creato un file json contenente il dettaglio degli scarti riscontrati ad ogni esecuzione del processo SDK.
Il naming del file sarà: ESITO_{ID_RUN}.json
Dove:
- ID_RUN rappresenta l’identificativo univoco dell’elaborazione
Di seguito il tracciato del record da produrre.
| CAMPO | DESCRIZIONE |
|---|---|
| NUMERO RECORD | Numero del record del flusso input |
| RECORD PROCESSATO | Campi esterni rispetto al tracciato, che sono necessari per la validazione dello stesso. Record su cui si è verificato uno scarto, riportato in maniera strutturata (nome_campo-valore). |
| LISTA ESITI | Lista di oggetti contenente l’esito di validazione per ciascun campo: - Campo: nome campo su cui si è verificato uno scarto - Valore Scarto: valore del campo su cui si è verificato uno scarto - Valore Esito: esito di validazione del particolare campo - Errori Validazione: contiene i campi Codice (della Business Rule) e Descrizione (della Business Rule) |
In una cartella dedicata (es. /sdk/run) verrà creato un file contenente il dettaglio degli esiti riscontrati ad ogni esecuzione del processo SDK. Verrà prodotto un file di log per ogni giorno di elaborazione.
Il naming del file sarà:
{ID_RUN}.json
Dove:
- ID_RUN rappresenta l’identificativo univoco dell’elaborazione
Di seguito il tracciato del record da produrre:
| CAMPO | DESCRIZIONE |
|---|---|
| ID RUN (chiave) | Identificativo univoco di ogni esecuzione del SDK |
| ID_CLIENT | Identificativo Univoco della trasazione sorgente che richiede processamento lato SDK |
| ID UPLOAD (chiave) | Identificativo di caricamento fornito da MdS |
| TIPO ELABORAZIONE | F (full)/R (per singolo record) - Impostato di default a F |
| MODALITA’ OPERATIVA | P (=produzione) /T (=test) |
| DATA INIZIO ESECUZIONE | Timestamp dell’ inizio del processamento |
| DATA FINE ESECUZIONE | Timestamp di completamento del processamento |
| STATO ESECUZIONE | Esito dell’esecuzione dell’ SDK. Possibili valori: - IN ELABORAZIONE: Sdk in esecuzione; - ELABORATA: Esecuzione completata con successo; - KO: Esecuzione fallita: - KO SPECIFICO: Esecuzione fallita per una fase/componente più rilevante della soluzione (es. ko_gestione_file, ko_gestione_validazione, ko_invio_ministero, etc.); - KO GENERICO: un errore generico non controllato. |
| FILE ASSOCIATI RUN | nome del file di input elaborato dall’SDK |
| NOME FLUSSO | valore fisso che identifica lo specifico SDK in termini di categoria e nome flusso |
| NUMERO RECORD | Numero di record del flusso input |
| NUMERO RECORD ACCETTATI | Numero validi |
| NUMERO RECORD SCARTATI | Numero scarti |
| VERSION | Versione del SDK (Access Layer e Validation Engine) |
| TIMESTAMP CREAZIONE | Timestamp creazione della info run |
| API (*DPM) | Rappresenta L’API utilizzata per il flusso DPM (non valorizzata per gli altri flussi) |
| IDENTIFICATIVO SOGGETTO ALIMENTANTE (*DPM) | Chiave flusso DPM (non valorizzata per gli altri flussi) |
| TIPO ATTO (*DPM) | Chiave flusso DPM (non valorizzata per gli altri flussi) |
| NUMERO ATTO (*DPM) | Chiave flusso DPM (non valorizzata per gli altri flussi) |
| TIPO ESITO MDS (*DPM) | Esito della response dell’API 2 (non valorizzata per gli altri flussi) |
| DATA RICEVUTA MDS (*DPM) | Data della response dell’API 3 (non valorizzata per gli altri flussi) |
| CODICE REGIONE | Codice Regione del Mittente |
| ANNO RIFERIMENTO | Anno cui si riferiscono i dati del flusso |
| PERIODO DI RIFERIMENTO | Periodo di riferimento dei dati del flusso (es. 13) |
| DESCRIZIONE STATO ESECUZIONE | Specifica il messaggio breve dell’errore, maggiori informazioni saranno presenti all’interno del log applicativo |
| NOME FILE OUTPUT MDS | Nome dei file di output inviati verso MdS |
| ESITO ACQUISIZIONE FLUSSO | Codice dell’esito del processo di acquisizione del flusso su MdS. Tale campo riflette la proprietà invioFlussiReturn/listaEsitiUpload/item/esito della response della procedura invioFlussi. (Es IF00) |
| CODICE ERRORE INVIO FLUSSI | Codice d’errore della procedura di invio. Tale campo riflette la proprietà InvioFlussiReturn/errorCode della response della procedura invioFlussi |
| TESTO ERRORE INVIO FLUSSI | Descrizione codice d’errore della procedura. Tale campo riflette la proprietà InvioFlussiReturn/ errorText della response della procedura invioFlussi |
Inoltre, a supporto dell’entità che rappresenta lo stato dell’esecuzione, sotto la cartella /sdk/log, saranno presenti anche i file di log applicativi (aggregati giornalmente) non strutturati, nei quali saranno presenti informazioni aggiuntive, ad esempio lo StackTrace (in caso di errori).
Il naming del file, se non modificata la politica di rolling (impostazioni), è il seguente:
SDK_RES-ANR.log
Accenture SpA until January 2026