PUBBLICAZIONE INCARICHI DI COLLABORAZIONE SUL SITO CNR

Transcript

1 PUBBLICAZIONE INCARICHI DI COLLABORAZIONE SUL SITO CNR RAPPORTO TECNICO Gianluca Troiani

2 Revisioni Data Vers. Descrizione Autore 19/11/ Bozza iniziale Gianluca Troiani 23/11/ Versione finale Gianluca Troiani 2 di 14

3 Indice 1 Introduzione Scopo del documento Contesto Posizionamento Definizione del problema Analisi delle tipologie di utenti a cui è rivolto il Sistema Stakeholders e Utenti Stakeholders Utenti Utente Web Visione d insieme del Sistema Estrazione dei dati e visualizzazione nella pagina Web Ricerche testuali sui dati visualizzati nella pagina Ordinamento dei dati visualizzati Indice delle figure Figura 1 Diagramma dei casi d uso... 7 Figura 2 Diagramma delle attività del Sistema di estrazione e visualizzazione dei dati... 8 Figura 3 Pagina degli avvisi, durante il caricamento dei dati XML... 9 Figura 4 Avviso di elaborazione dati Figura 5 Pagina degli avvisi, dopo la trasformazione dei dati XML Figura 6 Diagramma delle attività relativo all esecuzione delle ricerche testuali sui dati visualizzati Figura 7 Pulsante per l annullamento della ricerca testuale nei dati visualizzati di 14

4 INTRODUZIONE SCOPO DEL DOCUMENTO Lo scopo di questo documento è raccogliere, analizzare e definire i principali requisiti, le funzionalità chiave e i vincoli del sistema di Pubblicazione degli incarichi di collaborazione sul sito CNR. CONTESTO Questo documento si applica alla fase di progettazione e realizzazione della pubblicazione degli incarichi di collaborazione sul sito del CNR, come previsto dal nuovo regolamento per il conferimento degli incarichi di collaborazione (art. 7 commi 6 e 6 bis del Dlgs 165/2001 e L. 4 Agosto 2006, n. 248). POSIZIONAMENTO DEFINIZIONE DEL PROBLEMA Il problema di Pubblicare i dati relativi agli incarichi di collaborazione pubblicati nel Sistema SIGLA all interno delle pagine del sito del CNR senza che tali pagine possano dinamicamente accedere direttamente alla base dati del Sistema SIGLA Che coinvolge Dipendenti del CNR o personale esterno interessati agli incarichi; strutture amministrative e scientifiche del CNR interessate alla pubblicazione delle richieste Le cui conseguenze sono La mancata pubblicazione in tempo reale delle richieste e delle offerte di incarichi di collaborazione Una possibile soluzione è La realizzazione di pagine in grado di interrogare documenti XML contenenti i record d interesse estratti dalla base dati del Sistema SIGLA attraverso un oggetto Javascript in grado di eseguire richieste HTTP e di produrre HTML tramite trasformazioni XSLT ANALISI DELLE TIPOLOGIE DI UTENTI A CUI È RIVOLTO IL SISTEMA Il sistema è rivolto al personale tecnico o amministrativo del CNR ovvero a personale esterno di provata esperienza nelle tematiche trattate nelle richieste di professionalità pubblicate. È dunque plausibile ipotizzare che gli utenti dispongono di tecnologie di navigazione sufficientemente moderne per poter sfruttare l oggetto Javascript citato nella possibile soluzione indicata nel paragrafo 2.1 di questo documento. 4 di 14

5 STAKEHOLDERS E UTENTI STAKEHOLDERS Definizione Ruolo Coinvolgimento Strutture scientifiche e amministrative Pubblicano gli avvisi di ricerca di professionalità; definiscono le informazioni da pubblicare, e le modalità per la loro pubblicazione Soggetti rappresentativi delle strutture scientifiche e amministrative sono stati coinvolti durante la fase di analisi e di realizzazione e test del sistema Analisti e programmatori del Sistema Informativo del CNR Verificano che il sistema funzioni correttamente, che le informazioni fornite siano quelle indicate e che le modalità di consultazione siano sufficientemente semplici per l utenza a cui il sistema è rivolto; verificano che il sistema di lettura dei dati non influisca negativamente al corretto funzionamento del Sistema SIGLA da cui i dati sono estratti Personale del Sistema Informativo del CNR ha partecipato alla realizzazione del Sistema ed alla verifica del corretto funzionamento. UTENTI Il Sistema di pubblicazione degli incarichi di collaborazione prevede come utenti sia dipendenti del CNR, interessati agli avvisi di ricerca di professionalità che saranno pubblicati dalle strutture scientifiche e amministrative del CNR, sia soggetti esterni interessati alle richieste di incarichi di collaborazione. Infine ogni cittadino, a vario titolo, può essere interessato alla consultazione dell elenco incarichi affidati a consulenti. Questi tre tipi di utenti possono essere riassunti in un unico profilo: l Utente Web. UTENTE WEB Descrizione Un qualsiasi utente che tramite browser e semplice connessione Internet si connette alle pagine predisposte nel sito del CNR per la consultazione degli avvisi, delle richieste e dell elenco degli incarichi Tipo È presumibile che la maggior parte degli utenti sarà costituita da personale CNR o da professionisti interessati al conferimento d incarichi di collaborazione Criteri di successo L utente è in grado di: consultare gli avvisi, le richieste e gli elenchi; 5 di 14

6 effettuare ricerche testuali in campi specifici dei dati; modificare l ordine con cui sono visualizzati i dati; consultare eventuali allegati. Materiale da fornire È auspicabile la pubblicazione di una piccola guida al sistema di pubblicazione dei dati che contenga sia note relative alla normativa sia note tecniche relative al funzionamento del sistema (comunque intuitivo) ed ai requisiti per il corretto funzionamento del sistema stesso Note Il sistema sfrutta JavaScript per cui il suo corretto funzionamento è subordinato all utilizzo, da parte dell utente, di un browser con JavaScript abilitato. Inoltre l oggetto JavaScript utilizzato per la lettura dei dati XML è assente nelle versioni meno aggiornate dei browser, come ad esempio Internet Explorer 4 (si può comunque ipotizzare una diffusione di browser incompatibili inferiore all 1% della possibile utenza e ancor minore nell utenza di riferimento). Quando si presentassero delle incompatibilità, l utente viene informato del problema. VISIONE D INSIEME DEL SISTEMA Il Sistema di Pubblicazione incarichi di collaborazione sul sito CNR prevede essenzialmente tre funzionalità i. estrazione dei dati e visualizzazione nella pagina Web ii. iii. ricerche testuali sui dati visualizzati nella pagina scelta dell ordine in cui i dati sono visualizzati nella pagina 6 di 14

7 Figura 1 Diagramma dei casi d uso ESTRAZIONE DEI DATI E VISUALIZZAZIONE NELLA PAGINA WEB 7 di 14

8 Figura 2 Diagramma delle attività del Sistema di estrazione e visualizzazione dei dati Il funzionamento indicato dallo schema a blocchi di figura 1 è piuttosto semplice: 8 di 14

9 1. l utente accede alla pagina di interesse, ad esempio gli avvisi di ricerca di professionalità interne al CNR: Figura 3 Pagina degli avvisi, durante il caricamento dei dati XML 2. Nel momento in cui la pagina è caricata essa carica all interno del browser una serie di script per leggere ed elaborare i dati, nonché una serie di template XSL per la trasformazione del dato XML in HTML. Qualora il browser non fosse abilitato all esecuzione degli script, ovvero quando gli script utilizzati non fossero compatibili col browser utilizzato, l utente è avvisato dell incompatibilità e l esecuzione viene interrotta. 3. Quando la pagina è completa, essa crea un oggetto JavaScript che effettua una richiesta HTTP verso le pagine di sigla, ad esempio durante il caricamento dei dati la pagina mostra un animazione di attesa (vedi Figura 3). 4. La richiesta non è direttamente rivolta al server del Sistema SIGLA, ma viene effettuata attraverso una pagina del server del sito Web del CNR. Questo passaggio attraverso il server del sito Web del CNR è necessario per questioni di sicurezza che impediscono all oggetto JavaScript di accedere direttamente a documenti XML provenienti da server differenti da quello in cui la pagina che crea l oggetto JavaScript è ospitata. Qualora il server del sito Web del CNR restituisse un messaggio di errore, allora il codice JavaScript genererà un documento XML di errore; qualora l errore fosse restituito dal server di SIGLA, allora il documento XML di errore sarà generato direttamente dal server del sito Web del CNR. 5. Il server di SIGLA risponde inviando un documento in formato XML contenente le informazioni estratte dalla base dati del Sistema SIGLA, ad esempio: Listato 1: Esempio XML per gli avvisi di ricerca di professionalità interne 100 <?xml version="1.0" encoding="iso " standalone="no"?> 101 <incarichi:root xmlns:incarichi=" 102 <incarichi:numris>1</incarichi:numris> 9 di 14

10 103 <incarichi:richiesta> 104 <incarichi:numric>2007/1</incarichi:numric> 105 <incarichi:esercizio>2007</incarichi:esercizio> 106 <incarichi:progressivo>1</incarichi:progressivo> 107 <incarichi:richiedente> 108 <incarichi:cds>045</incarichi:cds> 109 <incarichi:istituto>ingegneria BIOMEDICA</incarichi:istituto> 110 <incarichi:sede>corso Stati Uniti, 4, PADOVA</incarichi:sede> </incarichi:richiedente> 113 <incarichi:attivita> 114 <incarichi:oggetto><![cdata[realizzazione di esperimenti OGTT in circa pazienti obesi diabetici di tipo 2 per la valutazione delle relazioni fra adipocitochine e parametri metabolici (con misure di adiponectina, leptina, glucosio, insulina e c- peptide)]]></incarichi:oggetto> 115 <incarichi:durata>entro 20 gg. dal conferimento</incarichi:durata> 116 <incarichi:sedelavoro>prestazione da effettuarsi in una qualunque struttura ospedaliera o centro antidiabetico situati nella Regione Veneto</incarichi:sedelavoro> 117 </incarichi:attivita> 118 <incarichi:aggiuntive> 119 <incarichi:note>l'incaricato deve avere accesso a strutture ospedaliere nella Regione Veneto; deve essere disponibile alla cessione all'isib-cnr dei diritti sui dati clinici/fisiologici/antropometrici dei sogetti in studio per eventuali successive pubblicazioni; deve concordare sugli obiettivi del progetto sul suo svolgimento e sui metodi per la diffusione dei risultati.</incarichi:note> 120 <incarichi:competenze><![cdata[medico diabetologo o specializzato in medicina interna. Provata esperienza nella conduzione di test metabolici (OGTT e/o IVGTT). Provata esperienza di ricerca possibilmente in collaborazione con istituti del C.N.R.]]></incarichi:competenze> 121 </incarichi:aggiuntive> 122 <incarichi:date> 123 <incarichi:iniziopubblicazione>16/11/2007</incarichi:iniziopubblicazio ne> 124 <incarichi:finepubblicazione>23/11/2007</incarichi:finepubblicazione> 125 </incarichi:date> 126 </incarichi:richiesta> 127 </incarichi:root> 6. Quando il documento XML è ricevuto dall oggetto JavaScript che ha effettuato la richiesta, il documento XML viene memorizzato in una variabile JavaScript e così definitivamente registrato nel browser dell utente per tutta la durata della permanenza dell utente nella pagina. 7. Dopo la memorizzazione nel browser, il documento XML viene trasformato direttamente dal browser del client in codice HTML, per mezzo di un motore XSLT in JavaScript, in base al template XSL caricato assieme alla pagina di visualizzazione dei dati prima della richiesta e memorizzazione dei dati XML. Il template XSL utilizzato per gli avvisi di ricerca di professionalità interne al CNR è di seguito indicato: Listato 2: Template XSL per gli avvisi di ricerca di professionalità interne 10 di 14

11 100 <?xml version="1.0" encoding="utf-8"?> 101 <xsl:stylesheet version="1.0" 102 xmlns:xsl=" 103 xmlns:incarichi=" 104 <xsl:output omit-xml-declaration="yes" method="xml"/> 105 <xsl:variable name="lcletters">abcdefghijklmnopqrstuvwxyzaeeiou</xsl:variable> 106 <xsl:variable name="ucletters">abcdefghijklmnopqrstuvwxyzàèéìòù</xsl:variable> 107 <xsl:template match="/incarichi:root"> 108 <xsl:apply-templates select="incarichi:richiesta"> 109 <xsl:sort select="" order="" data-type="" /> 110 </xsl:apply-templates> 111 </xsl:template> 112 <xsl:template match="incarichi:richiesta"> 113 <div class="incarichi richiesta"> 114 <div class="head"> 115 <strong>codice</strong>: <xsl:value-of select="incarichi:numric" /> 116 <strong>data di pubblicazione</strong>: <xsl:value-of select="incarichi:date/incarichi:iniziopubblicazione"/> 117 <strong>data di scadenza</strong>: <xsl:value-of select="incarichi:date/incarichi:finepubblicazione"/> 118 </div> 119 <xsl:apply-templates select="incarichi:richiedente" /> 120 <xsl:apply-templates select="incarichi:attivita" /> 121 <xsl:apply-templates select="incarichi:aggiuntive" /> 122 </div> 123 </xsl:template> 124 <xsl:template match="incarichi:richiedente"> 125 <div> 126 <strong>richiedente:</strong> 127 "<xsl:value-of select="incarichi:istituto" />" 128 [CDS: <xsl:value-of select="incarichi:cds" />] < 129 <xsl:element name="a"> 130 <xsl:attribute name="href">mailto:<xsl:value-of select="incarichi: " />?body=si ricorda che la candidatura deve contenere anche la MATRICOLA CNR e un recapito telefonico</xsl:attribute> 131 <xsl:attribute name="onclick">javascript:return confirm('attenzione:\nla procedura e\' *riservata* solo al PERSONALE DIPENDENTE CNR\n\nVuoi continuare?')</xsl:attribute> 132 <xsl:value-of select="incarichi: " /> 133 </xsl:element> >; 134 <xsl:value-of select="incarichi:sede" /> 135 </div> 136 </xsl:template> 137 <xsl:template match="incarichi:attivita"> 138 <div><strong>sede di lavoro:</strong> <xsl:value-of select="incarichi:sedelavoro"/></div> 139 <div><strong>durata:</strong> <xsl:value-of select="incarichi:durata"/></div> 140 <dl> 141 <dt>oggetto:</dt> 11 di 14

12 142 <dd><xsl:value-of select="incarichi:oggetto" /></dd> 143 </dl> 144 </xsl:template> 145 <xsl:template match="incarichi:aggiuntive"> 146 <dl> 147 <dt>competenze:</dt> 148 <dd><xsl:value-of select="incarichi:competenze" /></dd> 149 <dt>note:</dt> 150 <dd><xsl:value-of select="incarichi:note" /></dd> 151 </dl> 152 </xsl:template> 153 </xsl:stylesheet> 8. Durante la trasformazione, la pagina mostra all utente un avviso che indica l elaborazione dei dati. Figura 4 Avviso di elaborazione dati 9. Il codice HTML risultante dalla trasformazione viene dunque aggiunto all interno dei contenuti della pagina mediante il metodo.innerhtml di un nodo <div> apposito (<div id="o">). Figura 5 Pagina degli avvisi, dopo la trasformazione dei dati XML RICERCHE TESTUALI SUI DATI VISUALIZZATI NELLA PAGINA 12 di 14

13 Le ricerche testuali sui dati visualizzati nella pagina possono essere effettuate solo dopo aver caricato i dati e non richiedono un ulteriore interrogazione della base dati del Sistema SIGLA: le ricerche sono effettuate direttamente nel documento XML memorizzato nella pagina (vedi il punto 6 paragrafo 4.1 Estrazione dei dati e visualizzazione nella pagina Web ). La ricerca costituisce in realtà un filtraggio dei dati contenuti nel documento XML, ottenuto modificando il template XSL in base ai criteri di ricerca e applicando una nuova trasformazione XSLT dei dati XML già memorizzati. In questo modo è possibile effettuare diverse ricerche nei dati senza alcun costo computazionale per il server, dato che tutta l interazione avviene, mediante JavaScript, fra l utente e la pagina Web scaricata. Figura 6 Diagramma delle attività relativo all esecuzione delle ricerche testuali sui dati visualizzati Ad esempio, cercando la chiave Web nel campo oggetto degli avvisi, il template XSL è modificato come di seguito indicato: Il tag: 100 <xsl:apply-templates select="incarichi:richiesta"> Diventa: 100 <applytemplates select="incarichi:richiesta[(contains(translate(incarichi:at tivita/incarichi:oggetto,$ucletters,$lcletters),'web'))]"> Nell esempio indicato l espressione XPath generata dal JavaScript seleziona tutti gli elementi <incarichi:richiesta> che hanno sotto elementi <incarichi:oggetto> il cui contenuto (normalizzato 13 di 14

14 in minuscolo) contiene la stringa web (anch essa normalizzata in minuscolo a partire dalle parole chiave inserite dall utente). La ricerca è dunque effettuata non interrogando nuovamente la base dati ed estraendo solo i dati d interesse ma applicando un semplice filtro XPath al momento della trasformazione XSLT lato client. È interessante notare che il template XSL modificato è nuovamente memorizzato nella pagina per successivi utilizzi, come ad esempio per un eventuale ordinamento dei dati filtrati. La ricerca può essere annullata attraverso il pulsante che compare dopo aver effettuato un ricerca. Figura 7 Pulsante per l annullamento della ricerca testuale nei dati visualizzati In realtà ciò che accade in questo caso è la modifica del template XSL, con l espressione XPath che perde la parte di filtro ([(contains( )]), tornando al valore incarichi:richiesta, e la successiva trasformazione del documento XML che, non più filtrato, restituisce nuovamente tutti i dati. ORDINAMENTO DEI DATI VISUALIZZATI L ordinamento dei dati visualizzati nella pagina avviene con modalità molto simili a quella con cui sono effettuate le ricerche testuali. 1. L utente seleziona il tipo di ordinamento 2. Il motore JavaScript modifica il template XSL (vedi Listato 2) assegnando gli opportuni valori agli attributi select, order e data-type del tag <xsl:sort> (vedi Listato 2, riga 109). Ad esempio, ordinando i dati per nome di Istituto, il tag <xsl:sort> del Listato 2, riga 109 diventa: 101 <sort select="incarichi:richiedente/incarichi:istituto" order="ascendi ng" data-type="text"> 3. Il motore JavaScript trasforma il codice XML in base al nuovo XSL 4. La pagina incorpora il codice HTML risultante dalla trasformazione e lo mostra all utente 14 di 14