Sommario 1 Introduzione progetto Soluzione Integrazione Conclusioni... 10

Transcript

1 SISS SUITE

2 Sommario 1 Introduzione progetto Soluzione Integrazione Conclusioni

3 1 INTRODUZIONE L OMNICOM SISS Suite è una libreria DLL espressamente concepita per facilitare l adeguamento delle applicazioni alle specifiche regionali del CRS-SISS. La OMNICOM SISS Suite è realizzata utilizzando le più avanzate metodologie software, e rappresenta lo stato dell arte nell impiego degli strumenti di sviluppo e degli standard internazionali.net, C#, XML, COM. 2 PROGETTO OMNICOM srl produce e assiste soluzioni applicative per la Sanità validate e certificate SISS dal Nel percorso seguito da OMNICOM per l adeguamento delle proprie applicazioni al SISS, è stato privilegiato l aspetto globale dell integrazione orientato a sviluppare una soluzione il più possibile indipendente dai meccanismi di comunicazione, dai metodi, e dal formato dei messaggi. Questa linea progettuale ci ha permesso di realizzare un componente in grado di risolvere tutte le problematiche del SISS presenti e future. 3 SOLUZIONE In particolare il componente è stato ingegnerizzato in modo tale che è in grado di realizzare tutti i metodi richiesti dal SISS, sia lato Client che Server, sia verso l adattatore SEBC che verso l adattatore SYSS Way della piattaforma standard regionale ed è indipendente dal formalismo del messaggio di comunicazione. Le informazioni che vengono passate o ricevute dal componente nel dialogo da e verso il SISS attraverso i metodi del componente sono indipendenti dall adattatore presente sulla PDL e dalla versione in uso. Inoltre il componente OMNICOM nasconde allo sviluppatore la complessità del formato XML/SOAP, che è lo standard adottato per lo scambio di informazioni con il CRS-SISS sia per quanto riguarda la stringa di comunicazione con l adattatore ( SEBC o SYSS Way ), sia per quanto riguarda la risposta. Seguendo lo stesso criterio di semplificazione il componente espone un unico metodo per l invio e la ricezione di messaggi SOAP, in modo da renderlo indipendente dagli scenari, e dalla modalità ( porta Delegata, porta Applicativa). Inoltre il metodo di comunicazione utilizzato dal componente OMNICOM garantisce la certezza dell utilizzo per qualunque tipo di integrazione in quanto impiega un interfaccia di rete al posto di componenti SW pre-installati, pertanto è indipendente dal linguaggio e dall ambiente di esecuzione dell applicazione integrata. 3

4 In fig viene mostrato un esempio in C# di istanziazione della libreria OMNICOM SISS Suite in una applicazione tipo, per attivare uno dei metodi previsti dallo scenario di identificazione del cittadino. fig 1 4

5 fig 2 fig 3 5

6 In fig 4 viene mostrato il flusso della comunicazione tra una applicazione e il CRS-SISS. Nell esempio si vede come l applicazione Client ( installato sulla PDL dove risiedono i servizi SISS ) grazie all interoperabilità COM comunica i dati da inviare al SISS attraverso la OMNICOM SISS interface semplicemente come una struttura dati. La OMNICOM SISS Adapter si occupa di comunicare con il servizio remoto OMNICOM SISS engine che provvede alla costruzione del messaggio SOAP e alla validazione e verifica dei vincoli. Il messaggio SOAP viene inviato alla OMNICOM SISS comunicator che provvede all inoltro all adattatore SEBC. Il messaggio SOAP di risposta allo stesso modo viene convertito in un oggetto risposta e consegnato alla applicazione come parametro di ritorno del metodo start scenario. fig 4 6

7 Grazie ad un tools grafico, è possibile partendo dai template XML della documentazione originale dei messaggi da implementare, modellare automaticamente le classi C# che concorreranno a formare le DLL da integrare. Queste DLL sono le interfacce che instanziate nelle applicazioni esporranno attraverso le loro proprietà i tag dell XML. I metodi SISS a seconda dello scenario richiesto richiedono che i valori passati dalla stringa XML siano sottoposti a vincoli di validità. Mediante lo stesso Tools è possibile associare ad ogni proprietà della classe che ha una corrispondenza con un tag XML il vincolo richiesto. In questo modo i valori inviati dalla applicazione vengono validati prima di procedere alla costruzione della stringa XML da inviare all adattatore SISS. Questa soluzione ha permesso di realizzare un sistema con un avanzato indice di aderenza alla evoluzione dei modelli informativi prolungando il ciclo di vita dello stesso. fig 5 In fig 5 viene mostrato come esempio la costruzione della libreria OMNICOM SISS interface per la implementazione dello scenario GP ( prenotazione ) partendo dai file XML della documentazione originale. 7

8 In fig 6 viene mostrato un messaggio XML prima di essere processato dal generatore della classe. fig 6 In fig 7 e in fig 8 viene mostrato come vengono attivati i vincoli o i controlli richiesti dalla documentazione SISS. fig 7 8

9 fig 8 9

10 4 INTEGRAZIONE L integrazione da parte di un applicativo con l OMNICOM SISS Suite avviene attraverso due modalità 1. Omnicom SISS Suite: collezione di librerie COM che attraverso una interfaccia applicativa a oggetti implementano la comunicazione dei messaggi SOAP da e verso il SISS ( vedi esempi di integrazione ) 2. Omnicom SISS GUI: GUI che invocate dall applicativo realizzano per mezzo di una interfaccia grafica, scenari complessi, ad esempio: la firma di documenti, l identificazione del cittadino. ecc. Grazie alle Omnicom SISS GUI è possibile conformare la propria applicazione direttamente ad uno scenario SISS con una modalità ancora più semplice. Questi oggetti sono essenzialmente delle applicazioni complete ed integrate tra di loro in grado di eseguire scenari SISS complessi ( esempio l identificazione del cittadino che richiede la partecipazione di una BAC vedi Omnicom BAC Suite, o di un motore per lo scambio di messaggi HL7 vedi OMNICOM Hydra 2009 ) laddove non sono richieste particolari personalizzazioni ed è preferibile adottare una soluzione standard.per una trattazione più completa di questi componenti si rimanda alla sezione OMNICOM SISS GUI. 5 CONCLUSIONI Vantaggi nell integrare una applicazione con il SISS attraverso l OMICOM SISS Suite rispetto all utilizzo degli adattatori SEBC o standard : elevatissimo grado di astrazione. Questa particolare architettura consente di ottenere il massimo grado di astrazione ottenibile tra la comunicazione SISS ( messaggi SOAP, meccanismi di comunicazione) e il linguaggio di programmazione. o esiste un unico metodo attraverso il quale si attiva la comunicazione verso il SISS ( identifica cittadino carta, identifica cittadino esteso, ecc ). o Al metodo viene passata una struttura dati, non una stringa XML mascherando così la complessità del messaggio SOAP. o Il meccanismo di comunicazione per l invio di richieste verso il SISS è mascherato da un metodo generico startscenario. Lo stesso meccanismo vale per i messaggi di richiesta dalla porta Applicativa, in questo caso la DLL espone un evento di richiesta disponibile. o Dal metodo si ottiene una risposta che contiene l esito. La risposta come la richiesta è una struttura dati ed allo stesso modo viene mascherata la complessità del messaggio SOAP. Aderenza alle evoluzioni del SISS o Le strutture dati di richiesta e di risposta vengono create come DLL a partire dai messaggi XML della documentazione originale, è quindi possibile integrare in una applicazione più versioni. Questo permette di testare una nuova release SISS, mantenendo comunque in produzione una versione precedente dell applicativo o di eseguire con lo stesso applicativo scenari con release diverse. Performance e centralizzazione del software o Le DLL che vengono instanziate nella procedura per eseguire la comunicazione SISS sono solo classi di interfaccia, in quanto tutta la logica di elaborazione ( verifica dei vincoli, costruzione del messaggio SOAP di risposta, parser del messaggio SOAP di richiesta ) avviene attraverso un servizio remotizzato su di un server ( centralizzazione e coerenza delle versioni ). o L invio del messaggio SOAP verso la porta Delegata e la ricezione di una richiesta dalla porta Applicativa avviene localmente mediante la DLL sisscomunicator che implementa il meccanismo di comunicazione( http POST, http Listener ). Grazie alla Omnicom SISS Suite è quindi possibile ampliare i sistemi RIS, HIS, PACS, con personalizzazioni o con programmi trasversali di supporto per l elaborazione della comunicazione al SISS. 10