MANUALE UTENTE SRTY SISTEMA INFORMATIVO SANITARIO SRTY MANUALE UTENTE. Contratto:

Transcript

1 Contratto: Contratto del 23/04/2002 (Rep. 6253/Raccolta 1966), per l affidamento dell espletamento dei Servizi Informatici per la progettazione, realizzazione e manutenzione di prodotti software per il sistema informativo sanitario. Modulo: Sistema: Sistema Informativo Sanitario Nota: A solo uso interno della Regione Toscana - Ufficio Ingegneria dei sistemi informativi e della comunicazione. Versione documento: 3.0 Livelli di approvazione Engineering Redazione Funzione Nome Data Firma Francesco Castellani Revisione Approvazione/Emissione CP Engineering Alessandro Bemporad 20/08/2003 Livelli di approvazione Funzione Nome Data Firma Cliente Verifica Responsabile Laura Castellani Tecnico RT Approvazione Dirigente settore Angelo Marcotulli competente DSPS Approvazione Responsabile Contratto RT Laura Bennici LISTA DI DISTRIBUZIONE Angelo Marcotulli, Giancarlo Galardi, Laura Castellani, Laura Bennici SIS_CC MU_3.0.doc Pagina 1 di 19

2 REVISIONI Numero del paragrafo Modifica effettuata Data Approvaz./Autorizzaz Emissione 23/08/2003 Michela Rachini SIS_CC MU_3.0.doc Pagina 2 di 19

3 SOMMARIO GENERALITÀ STORIA DELLE MODIFICHE APPORTATE SCOPO VALIDITÀ RIFERIMENTI DEFINIZIONI E ABBREVIAZIONI ALLEGATI PASSI PER LA CREAZIONE DELL APPLICAZIONE SCHEMA DI NAVIGAZIONE INSERIMENTO NEL DATABASE DI PROFILAZIONE IL FILE DI CONFIGURAZIONE LA RADICE DE DOCUMENTO: IL TAG CONFIGURE IL TAG SERVER IL TAG PATHFILEUPLOAD IL TAG CERTIFICATO IL TAG AUTENTICAZIONE IL TAG DEBUG IL TAG WEBSERVICES IL TAG LOAD-ON-STARTUP IL TAG SECURITY IL TAG DATABASE IL TAG MIMEMAPPING IL TAG APPLICAZIONE CREAZIONE DEGLI OGGETTI DI BUSINESS, DEGLI OGGETTI DI DECIDE E DELLE PAGINE DI PRESENTAZIONE GLI OGGETTI DI BUSINESS GLI OGGETTI DI DECIDE PAGINE DI PRESENTAZIONE Presentazione tramite jsp Presentazione tramite xsl IL FILE WEB.XML SIS_CC MU_3.0.doc Pagina 3 di 19

4 GENERALITÀ Lo sviluppo di applicativi web sicuri che utilizzano il framework di profilazione devono seguire delle regole in modo da poter funzionare correttamente. Nel documento in esame verranno dettagliatamente descritti i passi da eseguire per la corretta creazione e manutenzione di applicativi gestiti dal modulo di profilazione srty. 1.1 Storia delle modifiche apportate Versione Definitiva Release n. 1.0 del Capitolo / Paragrafo (della Precedente) rel. Descrizione variazione 1.2 Scopo Lo scopo di questo documento è di costituire un manuale utente di riferimento per la creazione di applicativi web sicuri che utilizzano il modulo srty. 1.3 Validità Il presente documento è valido a partire dalla data di emissione riportata in copertina. 1.4 Riferimenti SIS SAR_3.0.doc e successivi 1.5 Definizioni e abbreviazioni MVC: Pattern Model-View-Controller : Modulo di profilazione 1.6 Allegati N.A. SIS_CC MU_3.0.doc Pagina 4 di 19

5 2. PASSI PER LA CREAZIONE DELL APPLICAZIONE Per la corretta creazione di un applicativo attraverso il modulo srty devono essere seguiti i seguenti passi. 1. Creazione dello schema di navigazione in cui vengono evidenziate le funzionalità, le operazioni, i metodi di business e i passi. 2. Mappatura dello schema di cui al punto 1 nel database di profilazione 3. Creazione del file di configurazione del modulo 4. Creazione degli oggetti di business, degli oggetti di decide e delle pagine di presentazione Nei paragrafi seguenti verranno analizzati singolarmente i punti sopra elencati. 3. SCHEMA DI NAVIGAZIONE Una delle prime operazioni da effettuare è quella relativa alla creazione dello schema di navigazione. Nella Figura 1 viene riportato un esempio dello schema di navigazione relativo all applicativo demo. Funz: Lettura Anagrafica Simbolo delle Funzionalità Simbolo dei Passi Funz: Start LetturaAnagrafica( LetturaAnagrafica ) LetturaAna grafic a Avvio Menu Avvio( Avvio ) Avvio( Avvio ) PaginaFra me CercaAnagrafica( CercaAnagrafica ) CercaAnagrafica( CercaAnagrafica ) RicercaAnagr afica ModificaInsertAnagrafica( ModificaInsertAnagrafica ) Anagrafica CancellaAnagrafica( CancellaAnagrafica ) Esegui( Esegui ) Funz: Gestione Anagrafica Figura 1: Schema di navigazione SIS_CC MU_3.0.doc Pagina 5 di 19

6 Nello schema di navigazione di Figura 1 sono presenti tutti i passi, le operazioni che permettono di passare da una pagina ad un altra e le funzionalità, mentre fra parentesi vengono indicati i metodi di business associati alle singole operazioni. 4. INSERIMENTO NEL DATABASE DI PROFILAZIONE Una volta definito lo schema di navigazione è necessario riportare tutte le informazioni in esso contenute nel database di profilazione. Per eseguire questa operazione è stato costruito un tool grafico scaricabile tramite Java Web Start e per la descrizione della relative funzionalità si rimanda al manuale utente ad esso dedicato. 5. IL FILE DI CONFIGURAZIONE Per ogni applicativo deve essere creato il file xml di configurazione. Nella Figura 2 viene riportato, in forma grafico, l albero relativo al documento xml di configurazione generato dall xml schema mentre in Figura 3 viene riportato un file xml di esempio. SIS_CC MU_3.0.doc Pagina 6 di 19

7 Figura 2: Albero Xml del file di configurazione. SIS_CC MU_3.0.doc Pagina 7 di 19

8 Figura 3: Documento XML file di configurazione 5.1 La radice de documento: il tag CONFIGURE Il tag <configure> rappresenta la radice del documento xml del file di configurazione. La parte dello schema ad esso associato è data da: <xs:element name="configuration"> SIS_CC MU_3.0.doc Pagina 8 di 19

9 <xs:sequence> <xs:element ref="server"/> <xs:element name="pathfileupload" type="xs:string"/> <xs:element ref="certificato"/> <xs:element ref="autenticazione"/> <xs:element ref="webservices"/> <xs:element name="load-on-startup" type= xs:string minoccurs= 0 /> <xs:element ref="security"/> <xs:element ref="database" maxoccurs="unbounded"/> <xs:element ref="mimemapping" maxoccurs="unbounded"/> <xs:element ref="applicazione" minoccurs="0" maxoccurs="unbounded"/> <xs:any processcontents="skip" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> 5.2 Il tag SERVER Il tag <server> individua il server in cui è deployata l applicazione. E sorta la necessita di introdurre questo marcatore in quanto differenti application server gestiscono il certificato X509 dell utente in diersi modi. La parte dello schema ad esso associato è data da: <xs:element name="server"> <xs:complextype mixed="true"> <xs:attribute name="version" type="xs:string" use="required"/> 5.3 Il tag PATHFILEUPLOAD Il tag <pathfileupload> indica al modulo di security dove salvare il file che l utente invia nelle operazioni di upload. La directory di salvataggio è indipendente dall applicativo in esame. La parte dello schema ad esso associato è data da: <xs:element name="pathfileupload" type="xs:string"/> 5.4 Il tag CERTIFICATO Il tag <certificato> indica al modulo di security il livello di sicurezza richiesto dall applicativo. La parte dello schema ad esso associato è data da: <xs:element name="certificato"> <xs:attribute name="valore" default="dynamic"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="none"/> <xs:enumeration value="static"/> <xs:enumeration value="dynamic"/> </xs:restriction> </xs:simpletype> </xs:attribute> SIS_CC MU_3.0.doc Pagina 9 di 19

10 Dal frammento dell xml schema sopra riportato emerge che: 1. Il tag ha l attributo valore che può assumere i valori a. Static. In questo caso non viene richiesto il certificato all utente ma viene utilizzato un certificato cablato all interno dell applicativo (da usare solo in modalità di debug) b. Dinamiyc. In questo caso l applicativo legge i dati dell utente dal certificato c. None. In questo caso non viene richiesto il certificato all utente ma quest ultimo viene trattato come utente anonimo per l accesso all applicativo (da usare solo in modalità di debug) 2. Il tag è vuoto. 5.5 Il tag AUTENTICAZIONE Il tag <autenticazione> indica al modulo di security il livello minimo di autenticazione richiesto dall applicativo. La parte dello schema ad esso associato è data da: <xs:element name="autenticazione"> <xs:attribute name="valore" default="forte"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="forte"/> <xs:enumeration value="debole"/> </xs:restriction> </xs:simpletype> </xs:attribute> Dal frammento dell xml schema sopra riportato emerge che: 3. Il tag ha l attributo valore che può assumere i valori a. Forte. In questo caso è possibile accedere all applicativo solo tramite un certificato o in maniera anonima se previsto. b. Debole. In questo caso è possibile accedere all applicativo come nel caso precedente o attraverso l utilizzo della basic authentication (userid,password). 4. Il tag è vuoto. 5.6 Il tag DEBUG Il tag <debug> indica al modulo di security se l applicativo è in debug o meno. La parte dello schema ad esso associato è data da: <xs:element name="debug"> <xs:attribute name="valore" default="false"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="true"/> <xs:enumeration value="false"/> </xs:restriction> </xs:simpletype> </xs:attribute> SIS_CC MU_3.0.doc Pagina 10 di 19

11 Dal frammento dell xml schema sopra riportato emerge che: 5. Il tag ha l attributo valore che può assumere i valori a. True. In questo caso il path dei fogli xml contenenti i fogli di presentazione, se necessario, viene letto dal file xml di configurazione stesso. b. False. In questo caso il path dei fogli xml contenenti i fogli di presentazione, se necessario, viene letto dalla banca dati. 6. Il tag è vuoto. 5.7 Il tag WEBSERVICES Il tag <WebServices> indica al modulo di security se esistono o meno dei web service attivi per la determinazione del ruolo. La parte dello schema ad esso associato è data da: <xs:element name="webservices"> <xs:attribute name="stato" default="inattivo"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="attivo"/> <xs:enumeration value="inattivo"/> </xs:restriction> </xs:simpletype> </xs:attribute> Dal frammento dell xml schema sopra riportato emerge che: 1. Il tag ha l attributo stato che può assumere i valori a. Attivo. In questo caso esistono web server per la determinazione dei ruoli b. Inattivo. In questo caso non esistono web server per la determinazione dei ruoli 2. Il tag è vuoto. 5.8 Il tag load-on-startup Il tag opzionale <load-on-startup> indica al modulo di security la classe che deve essere invocata quando il metodo init della servlet gateway viene chiamato. 5.9 Il tag SECURITY Il tag <security> indica al modulo di security quali sono gli ingressi relativi alla connessione al database, e ai parametri dell applicativo relativo al modulo srty. La parte dello schema ad esso associato è data da: <xs:element name="security"> <xs:attribute name="nome" type="xs:string" use="required"/> Dal frammento dell xml schema sopra riportato emerge che: SIS_CC MU_3.0.doc Pagina 11 di 19

12 1. Il tag ha l attributo nome che riporta il nome associato al modulo srty 2. Il tag è vuoto Il tag DATABASE I tags <database> servono per configurare gli accessi ai vari database necessari all applicativo. La parte dello schema ad esso associato è data da: <xs:element name="database"> <xs:sequence> <xs:element ref="dbaccessmode"/> <xs:element name="driver" type="xs:string"/> <xs:choice> <xs:element name="uri" type="xs:string"/> <xs:element name="jndiname" type="xs:string"/> </xs:choice> <xs:element name="username" type="xs:string"/> <xs:element name="password" type="xs:string"/> </xs:sequence> <xs:attribute name="nome" type="xs:string" use="required"/> <xs:attribute name="objectcreate"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="true"/> <xs:enumeration value="false"/> </xs:restriction> </xs:simpletype> </xs:attribute> <xs:attribute name="package" type="xs:string"/> <xs:element name="dbaccessmode"> <xs:attribute name="tipo" use="required"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="direct"/> <xs:enumeration value="jndi"/> <xs:enumeration value="pool"/> </xs:restriction> </xs:simpletype> </xs:attribute> L elemento radice è dato dal tag <Database> che ha due attributi : Nome. Rappresenta il nome logico associato al database (Questo ingresso viene riportato in maiuscolo) ObjectCreate. Indica al modulo srty se creare, o meno, la classe java relativo all ingresso in esame. I valori che può assumere sono true o false. Package. Indica qual e la classe che deve essere istanziata nel caso il cui l attirbuto ObjectCreation sia valorizzato a true SIS_CC MU_3.0.doc Pagina 12 di 19

13 Gli elementi figli del tag <Database> sono dati da: 1. dbaccessmode. Questo marcatore vuoto ha l attributo di nome tipo e serve per scegliere come deve essere creata la connesione al database in esame. I valori che tale attributo può assumere sono: a. direct. Tutte le volte che viene richiesta una connessione questa viene ricreata nuova e alla fine dell utilizzo viene chiusa b. pool. Tutte le volte che viene richiesta una connessione questa viene prelevata da un pool di connessioni aperte e alla fine dell utilizzo viene riposta nel pool stesso c. jndi. Tutte le volte che viene richiesta una connessione questa viene ricercata nell oggetto indicato 2. driver. Indica il driver relativo alla connessione 3. Il terzo attributo dipende dal valore assunto dall attributo tipo del tag dbaccessmode. Nel caso di connessioni di tipo direct o pool il tag è dato dall uri, che rappresenta la stringa di connessione al database server, mentre nel caso di connessioni di tipo jndi il tag è dato da jndiname, che rappresenta il nome jndi da dove prelevare la connessione 4. username. Nome utente di connesione al database 5. password. Password di connessione Prima di concludere è importante osservare che l ingresso relativo al database di profilatura è obbligatorio 5.11 Il tag MIMEMAPPING I tags <MimeMaping> servono per determinare le classi che si occupano della trasformazione attraverso i fogli di stile xsl. La parte dello schema ad esso associato è data da: <xs:element name="mimemapping"> <xs:sequence> <xs:element name="mimetype" type="xs:string"/> <xs:element name="classname" type="xs:string"/> </xs:sequence> <xs:attribute name="objectcreate"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="true"/> <xs:enumeration value="false"/> </xs:restriction> </xs:simpletype> </xs:attribute> <xs:attribute name="package" type="xs:string"/> L elemento radice è dato dal tag <MimeMaping> che ha un attributo: ObjectCreate. Indica al modulo srty se creare, o meno, la classe java relativo all ingresso in esame. I valori che può assumere sono true o false. Package. Indica qual e la classe che deve essere istanziata nel caso il cui l attirbuto ObjectCreation sia valorizzato a true Gli elementi figli del tag <MimeMaping> sono dati da: 1. mimetype. Viene indicato il mime type di riferimento 2. classname. Indica la classe che opera la trasformazione SIS_CC MU_3.0.doc Pagina 13 di 19

14 5.12 Il tag APPLICAZIONE I tags <Applicazione> servono per configurare i parametri necessari ai vari applicativi. La parte dello schema ad esso associato è data da: <xs:element name="applicazione"> <xs:sequence> <xs:choice maxoccurs="3"> <xs:element name="pathfilexmlpresentation" type="xs:string"/> <xs:element name="urljsppresentation" type="xs:string"/> <xs:element name="urlhtmlpresentation" type="xs:string"/> </xs:choice> <xs:element name="xslforprofilechoose" type="xs:string" minoccurs="0"/> <xs:element name="xslforrolechoose" type="xs:string" minoccurs="0"/> <xs:element name="xslforbasicauthentication" type="xs:string" minoccurs="0"/> <xs:element name="xslerror" type="xs:string" minoccurs="0"/> <xs:any processcontents="skip" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> <xs:attribute name="nome" type="xs:string" use="required"/> <xs:attribute name="objectcreate"> <xs:simpletype> <xs:restriction base="xs:nmtoken"> <xs:enumeration value="true"/> <xs:enumeration value="false"/> </xs:restriction> </xs:simpletype> </xs:attribute> <xs:attribute name="package" type="xs:string"/> L elemento radice è dato dal tag <Applicazione> che ha due attributi : Nome. Rappresenta il nome logico associato all applicativo ObjectCreate. Indica al modulo srty se creare, o meno, la classe java relativo all ingresso in esame. I valori che può assumere sono true o false. Package. Indica qual e la classe che deve essere istanziata nel caso il cui l attirbuto ObjectCreation sia valorizzato a true Gli elementi figli del tag <Applicazione> sono dati da: 1. pathfilexmlpresentation. Questo marcatore, presente solo nel caso della configurazione dell ingresso relativo al modulo srty, indica il path dei fogli di stile relativi alla pagina di errore, di scelta dei ruoli e di scelta dei profili. Per gli altri applicativi tale ingresso è mappato sul database. 2. URLJspPresentation. Questo marcatore indica l url necessario per richiamare le pagine jsp. 3. URLHtmlPresentation. Questo marcatore indica l url necessario per richiamare le pagine html. 4. XslForProfileChoose. Questo marcatore, presente solo nel caso della configurazione dell ingresso relativo al modulo srty, indica il nome del foglio di stile relativo alla pagina di scelta dei profili. 5. XslForRoleChoose. Questo marcatore, presente solo nel caso della configurazione dell ingresso relativo al modulo srty, indica il nome del foglio di stile relativo alla pagina di scelta dei ruoli. 6. XslForBasicAuthentication. Questo marcatore, presente solo nel caso della configurazione dell ingresso relativo al modulo srty, indica il nome del foglio di stile relativo alla pagina che permette la Basic Authentication. SIS_CC MU_3.0.doc Pagina 14 di 19

15 7. XslError. Questo marcatore, presente solo nel caso della configurazione dell ingresso relativo al modulo srty, indica il nome del foglio di stile relativo alla pagina di presentazione degli errori. 8. Any: lo schema risulta aperto per l introduzione di marcatori specifici per l applicativo che non verranno validati Prima di concludere è importante osservare che l ingresso relativo al database e all applicativo di profilatura è obbligatorio. 6. CREAZIONE DEGLI OGGETTI DI BUSINESS, DEGLI OGGETTI DI DECIDE E DELLE PAGINE DI PRESENTAZIONE Eseguite le operazioni di cui ai paragrafi precedenti si devono creare gli oggetti di business, gli oggetti di decide, dove necessario, e le pagine di presentazione. 6.1 Gli oggetti di business Per quanto riguarda la creazione degli oggetti di business la regola da seguire è molto semplice; infatti è sufficiente creare una classe java che implementi l interfaccia it.eng.srty.business.exebusiness, per la cui descrizione dettagliata si rimanda alla documentazione javadoc. Tale classe deve obbligatoriamente implementare il metodo executable, che è il metodo invocato dinamicamente dal framework di profilazione. Il valore di ritorno di tale metodo è un oggetto di tipo it.eng.srty.business.oggettotrasversale che riporta il documento xml, quando necessario, ed eventualmente altri parametri. 6.2 Gli oggetti di decide Prima di vedere quali sono le regole per la creazione dei metodi di decide è opportuno porre l accento sul compito che tali oggetti ricoprono. Gli oggetti di decide vengono invocati tutte le volte che si presenta un indeterminazione sull oggetto di business da invocare o sulla pagina di destinazione. Per quanto riguarda gli oggetti di business l indeterminazione è data dal fatto che quando il framework di profilazione srty deve determinare il metodo di business, leggendolo dalla banca dati in base alla funzionalità e all operazione da eseguire, determina un risultato con molteplicità maggiore di uno; in questo caso viene istanziata la classe di decide e viene invocato il metodo decide. Per quanto riguarda i passi di destinazione l indeterminazione è data dal fatto che quando il framework di profilazione srty deve determinare il nome del passo di destinazione, leggendolo dalla banca data in base al passo di arrivo, alla funzionalità, all operazione e al metodo di business eseguito, determina un risultato con molteplicità maggiore di uno; in questo caso viene istanziata la classe di decide e viene invocato il metodo decidepasso. Per quanto riguarda la creazione dei metodi di decide le regole da seguire sono: 1. Creare una classe java che implementi l interfaccia it.eng.srty.business.exedecide, per la cui descrizione dettagliata si rimanda alla documentazione javadoc. 2. Chiamare la classe come il nome dell operazione che genera l ambiguità Tale classe deve obbligatoriamente implementare i metodo decide e decidepasso, che rappresentano i metodi invocati dinamicamente dal framework di profilazione. Il valore di ritorno del metodo decide è un oggetto di tipo it.eng.srty.business.oggettotrasverledecide che riporta il nome del metodo di business da eseguire, mentre il metodo decidepasso deve semplicemente SIS_CC MU_3.0.doc Pagina 15 di 19

16 indicare, nell oggetto it.eng.srty.business.oggettotrasverledecide passatogli, il nome del passo di destinazione. 6.3 Pagine di presentazione Per quanto riguarda le pagine di presentazione si presentano due scenari diversi: Presentazione tramite JSP Presentazione tramite fogli di stile XSL Indipendentemente dal tipo di presentazione scelta le pagine dovranno riportare i seguenti parametri, che sono delle variabili html nascoste: 1. applicativo: valorizzato con il nome dell applicativo 2. funzionalità: che deve riportare la funzionalità che dovrà essere eseguita 3. operazione: che deve riportare l operazione che dovrà essere eseguita 4. passo: valorizzato con il nome del passo corrente (di solito è uguale al nome della pagina html) Presentazione tramite jsp Nella creazione delle pagine jsp non ci sono delle regole da seguire a parte quelle date dallo standard stesso Presentazione tramite xsl Nella creazione dei fogli di presentazione bisogna analizzare dettagliatamente i livelli di visibilità. La regola fondamentale che si deve tenere presenta durante la creazione dei documenti xsl è data dal fatto che non tutti i profili applicativi che arrivano alla visualizzazione di una pagina vedono le stesse informazioni. Si hanno due tipi di filtraggio: 1. Filtraggio sui bottoni o link che permettono di eseguire una determinata funzionalità 2. Filtraggio sui dati sensibili Per eseguire il filtraggio è necessario riportare il documento xsl in documento xml la cui strutture è data da: <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" elementformdefault="qualified"> <xs:complextype name="visibilitatype" mixed="true"> <xs:choice minoccurs="1" maxoccurs="unbounded"> <xs:element name="visibilita" type="visibilitatype"/> </xs:choice> <xs:attribute name="livello" use="required" type="xs:string"/> <xs:attribute name="nome" type="xs:string"/> <xs:attribute name="tipo" type="xs:string"/> <xs:attribute name="identificativo" type="xs:string"/> <xs:attribute name="descrizione" type="xs:string"/> </xs:schema> Nel frammento xml di Figura 4 viene invece riportato un file xml di esempio che riporta al suo interno il foglio di stile xsl per la presentazione. SIS_CC MU_3.0.doc Pagina 16 di 19

17 Marcatore di visibilità sulla funzionalità Marcatore di visibilità su i dati sensibili Figura 4: Foglio xml con marcatori di visibilità SIS_CC MU_3.0.doc Pagina 17 di 19

18 Osservando lo schema xml emerge che l unico tag presente per la creazione dei fogli xml contenenti i fogli di stile è dato dal marcatore <visibilita>, che può essere ricorsivo al suo interno. Gli attributi del marcatore <visibilita>, il cui significato varia dipendentemente dal caso in cui la visibilità sia riferita al filtraggio sulle funzionalità o sui dati sensibili, sono dati da: livello Questo rappresenta il livello associato alla visibilità. In particolare si hanno due casistiche possibile: 1. Valore con livello puntuale. Questo è il caso in cui la visibilità dell oggetto è associata solo a quei profili con i livelli specificati nell attributo. Per la scrittura dei valori dei livelli ad accesso puntuale vengono aggiunti i caratteri - prima e dopo il valore del livello stesso. (Es: livello= indica che solo i profilo con livello 1 e 10 possono vedere la parte del documento xsl associata). 2. Valore con livello gerarchico.. Questo è il caso in cui la visibilità dell oggetto è associata a quei profili con i livello inferiore al livello specificati nell attributo, che quindi rappresenta il valore massimo di visibilità. (Es: livello= 50 indica che solo i profili con livello inferiore a 50 possono vedere la parte del documento xsl associata). Questo attributo è presente sia nel caso di visibilità a livello di funzionalità che di sensibilità Il secondo attributo è diverso dipendentemente dalle due casistiche di visibilità: o Nel caso di visibilità sulle funzionalità l attributo è dato dal nome. Questo DEVE contenere il nome della funzionalità a cui si riferisce. o Nel caso di visibilità sui dati sensibili gli attributi sono dati da: tipo. Questo rappresenta il tipo dell oggetto di sensibilità (colonna tabella, elemento di una lista, etc) identificativo. Questo rappresenta l identificativo associato all oggetto di sensibilità. Questo permette di identificare oggetti di sensibilità uguali in pagine diversi e di gestirli in maniera univoca descrizione. Questo rappresenta la descrizione dell oggetto di sensibilità Le ultime osservazione su cui è importante porre l accento sono date da: 1. Il contenuto del marcatore <visibilita> è preceduto dal tag <![CDATA[ ]]>. Questo permette di poter scrivere tutti i caratteri senza incorrere nella presenza di caratteri speciali per l xml che porterebbero alla creazione di un documento xml non well-formed. 2. Il marcatore <visibilita>, radice del documento xml, ha il valore dell attributi livello impostato ad un valore alto con filtraggio gerarchico mentre all attributo nome viene associato un nome fittizio. 7. IL FILE WEB.XML Il contenuto del file di configurazione della web application (web.xml) deve contenere: 1. la dichiarazione della servlet gateway 2. Il parametro pathfileconfigurazione che indica alla servlet gateway dove trovare il file di configurazione del modulo srty Qui di seguito viene riportato un esempio del file web.xml SIS_CC MU_3.0.doc Pagina 18 di 19

19 <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" " <web-app> <servlet> <servlet-name>gateway</servlet-name> <servlet-class>it.eng.srty.gateway.servletgateway</servlet-class> <init-param> <param-name>pathfileconfigurazione</param-name> <param-value>/data_webapps/config/</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>invoker</servlet-name> <url-pattern>/servlet/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>gateway</servlet-name> <url-pattern>/gateway</url-pattern> </servlet-mapping> </web-app> SIS_CC MU_3.0.doc Pagina 19 di 19