Registro SPICCA
Manuale utente
Versione 1.0 del 25/08/2009 Sommario 1
Introduzione ......................................................................................................................................... 4
2
Avvio Applicazione................................................................................................................................ 6
3
Funzionalità di Ricerca .......................................................................................................................... 7
3.1
Ricerca Servizi, Soggetti, Ontologie ............................................................................................. 7
4
Login ..................................................................................................................................................... 9
5
Pubblicazione ..................................................................................................................................... 10
6
7
8
5.1
Nuovo Servizio ........................................................................................................................... 10
5.2
Nuovo Servizio da Ontologia ..................................................................................................... 11
5.3
Nuovo Servizio Figlio .................................................................................................................. 12
5.4
Lista Servizi ................................................................................................................................. 13
Amministrazione ................................................................................................................................ 17
6.1
Nuovo Soggetto ......................................................................................................................... 17
6.2
Nuova Ontologia ........................................................................................................................ 18
6.3
Lista Ontologie ........................................................................................................................... 19
6.4
Servizi da Pubblicare .................................................................................................................. 20
6.5
Servizi Pubblicati ........................................................................................................................ 20
6.6
Visualizza Stato Servizi ............................................................................................................... 21
Amministrazione Utenti ..................................................................................................................... 23
7.1
Lista Utenti ................................................................................................................................. 23
7.2
Registra Nuovo Utente .............................................................................................................. 24
Import/Export ..................................................................................................................................... 25
8.1
Import AS ................................................................................................................................... 25
8.2
Export AS .................................................................................................................................... 26
Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 2 IL CONTENUTO DEL PRESENTE DOCUMENTO PUÒ ESSERE RIPRODOTTO, IN TOTO O IN PARTE, PER TUTTI GLI SCOPI FUNZIONALI ALL’ADESIONE AL SISTEMA SPICCA DI REGIONE CAMPANIA ED È ESCLUSO L’UTILIZZO A FINI DI LUCRO. PER L’UTILIZZO DI QUANTO DI SEGUITO RIPORTATO SI DOVRÀ, IN TUTTI I CASI, CITARE COME FONTE IL PRESENTE DOCUMENTO. Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 3 1
Introduzione Questo documento è stato realizzato in collaborazione con Vitrociset S.p.a. in quanto ditta aggiudicataria dell’appalto concorso per la realizzazione del “Sistema Regionale per la Cooperazione Applicativa in Sicurezza” della Regione Campania. In ambito SPCOOP, il registro SPICCA è un insieme di servizi infrastrutturali di registrazione e ricerca di informazioni. In particolare, le specifiche [Sistema Pubblico di Cooperazione: Servizi di Registro. Versione 1.0 del 14/10/2005] prevedono che un registro SPICCA sia il risultato della composizione di quattro servizi che gestiscono le risorse seguenti: • il servizio di gestione dell’indice dei soggetti della comunità del SPCOOP; •
il servizio di gestione dell’elenco degli erogatori presenti sul SPCOOP; •
il servizio di gestione del catalogo degli accordi di servizio sottoscritti e implementati sul SPCOOP; •
il servizio di gestione della rubrica degli indirizzi dei punti di accesso dei sistemi erogatori e fruitori. L’applicazione consente funzionalità quali: •
Ricerca dei Servizi, dei Soggetti e delle Ontologie presenti sul Registro •
•
•
•
•
•
•
•
Pubblicazione Ontologie Registrazione Nuovo Servizio Registrazione Nuovo Servizio “Figlio” Visualizzazione Accordi di Servizio Pubblicazione Servizio Amministrazione Servizi Pubblicati Monitoraggio dello Stato dei Servizi Pubblicati Amministrazione Utenti del Registro Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 4 •
•
Import Servizio Export Servizio Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 5 2
Avvio Applicazione All’avvio dell’applicazione si presenta la pagina iniziale del Registro SPICCA (Figura 1). Figura 1: Pagina Iniziale del Registro SPICCA È possibile effettuare le sole operazioni di ricerca (Figura 2) dei Servizi, dei Soggetti o delle Ontologie presenti sul registro stesso poiché esse sono funzionalità pubbliche. Figura 2: Funzionalità di Ricerca Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 6 3
Funzionalità di Ricerca 3.1
Ricerca Servizi, Soggetti, Ontologie È possibile accedere ad una delle tre funzionalità di ricerca mediante la relativa voce del menù dell’applicazione. In Figura 3, Figura 4 e Figura 5 sono riportate le maschere di ricerca. Figura 3: Maschera di Ricerca dei Servizi Figura 4: Maschera di Ricerca dei Soggetti Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 7 Figura 5: Maschera di Ricerca delle Ontologie Riportiamo di seguito un esempio di ricerca di un soggetto. L’esempio è valido anche per le altre tipologie di ricerca. Digitatr la stringa da ricercare, selezionare il criterio di ricerca e la modalità di ordinamento e cliccare sul pulsante “Cerca” (Figura 6). Figura 6: Ricerca Soggetti ‐ Selezione Criterio Ricerca L’applicazione visualizzerà l’elenco dei soggetti che rispettano i criteri di ricerca inseriti (Figura 7). Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 8 Figura 7: Ricerca Soggetti ‐ Risultato Ricerca 4
Login Per accedere alle altre funzionalità del registro SPICCA, funzionalità non pubbliche, bisogna effettuare la procedura di login; Cliccando sul collegamento “Login”, l’applicazione visualizzerà la maschera di autenticazione (Figura 8). Figura 8: Maschera di Login Inserire i propri dati e proseguire cliccando sul pulsante “accedi”. Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 9 5
Pubblicazione Il servizio di pubblicazione permette all’operatore abilitato di inserire un “Nuovo Servizio”, un “Nuovo Servizio da Ontologia”, un “Nuovo Servizio Figlio” e visualizzare la “Lista Servizi” che vengono erogati e fruiti (Figura 9) Figura 9: Pubblicazione 5.1
Nuovo Servizio Cliccando sulla voce del menù “Nuovo Servizio”, viene visualizzata la maschera di inserimento di un nuovo Accordo di Servizio (Figura 11). In tale maschera vengono inseriti i dati e i file di un accordo di servizio. Selezionando una delle due modalità di invio dei file “wsdl” (Figura 10) vengono automaticamente abilitati o disabilitati i relativi campi per l’invio dei wsdl. In caso di invio dei wsdl completi, sarà la stessa applicazione a suddividere questi ultimi negli appositi file previsti da un accordo di servizio. Figura 10: Scelta modalità upload file wsdl Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 10 Figura 11: Maschera Inserimento Accordo di Servizio 5.2
Nuovo Servizio da Ontologia Cliccando sulla voce del menù “Nuovo Servizio da Ontologia”, viene visualizzata la maschera di inserimento di un nuovo Accordo di Servizio (Figura 12). In tale maschera vengono inseriti i dati e i file di un accordo di servizio. Selezionando una delle ontologie presenti nell’elenco, al momento della registrazione del servizio, l’applicazione verificherà la coerenza dei file con l’ontologia selezionata. Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 11 Figura 12: Inserimento Accordo di Servizio mediante Ontologia 5.3
Nuovo Servizio Figlio Cliccando sulla voce del menù “Nuovo Servizio Figlio”, viene visualizzata la maschera di inserimento di un nuovo Accordo di Servizio Figlio (Figura 12). In tale maschera vengono inseriti i dati e i file relativi alla sola parte specifica di un accordo di servizio. La restante parte dei file viene ereditata come parte comune del “servizio erogato” selezionato. Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 12 Figura 13: Inserimento Accordo di Servizio Figlio 5.4
Lista Servizi Cliccando sulla voce del menù “Lista Servizi”, vengono visualizzate informazioni sui servizi erogati, sui servizi fruiti e le informazioni relative al soggetto (Figura 15 – Figura 16 – Figura 17). Inoltre, nelle schermate relative ai servizi, cliccando sull’icona dettagli (Figura 14) verranno visualizzate informazioni dettagliate sul relativo servizio. Figura 14: Icona Dettagli Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 13 Figura 15: Lista Servizi Erogati Figura 16: Lista Servizi Fruiti Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 14 Figura 17: Informazioni relative al Soggetto Le pagine di visualizzazione dei dettagli mostrano, nell’ordine, i dettagli del servizio, i dettagli del soggetto che eroga o che fruisce il servizio in questione, a seconda del caso che sia un servizio fruito o erogato, e l’elenco dei file dell’accordo di servizio (Figura 18 – Figura 19 – Figura 20). Figura 18: Dettaglio Servizio Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 15 Figura 19: Informazioni Soggetto Erogatore o Fruitore Figura 20: Files Accordi di Servizio Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 16 Cliccando sull’icona di download (Figura 21 – a) è possibile prelevare il relativo file, mentre l’icona di file non disponibile (Figura 21 – b) indica che il file non è presente nell’accordo di servizio. (a)
(b)
Figura 21: Icona di Download (a) – Icona di file non disponibile (b) 6
Amministrazione La parte di amministrazione consente di registrare un nuovo soggetto, una nuova ontologia, visualizzare la lista delle ontologie, pubblicare servizi, gestire lo stato dei servizi e visualizzare il riepilogo dei servizi (Figura 22). Figura 22: Amministrazione Registro SPICCA 6.1
Nuovo Soggetto La funzionalità di nuovo soggetto consente di registrare un nuovo soggetto all’interno del registro SPICCA. Cliccando sulla relativa voce di menù, comparirà la maschera di inserimento dati per effettuare tale operazione (Figura 23). Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 17 Figura 23: Maschera inserimento Nuovo Soggetto Al termine dell’inserimento dei dati relativi al soggetto da registrare, cliccando sul pulsante “Registra” si effettuerà la registrazione del soggetto. 6.2
Nuova Ontologia Cliccando sulla voce di menù “Nuova Ontologia”, viene visualizzata la maschera per l’inserimento di una nuova ontologia (Figura 24). Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 18 Figura 24: Maschera Inserimento Nuova Ontologia Al termine dell’inserimento dei dati e dei files relativi all’ontologia, ciccare sul pulsante “Registra” per completare l’operazione 6.3
Lista Ontologie Cliccando sulla voce di menù “Lista Ontologie”, viene visualizzata la lista delle ontologie presenti nel registro (Figura 25). Figura 25: Lista Ontologie presenti nel Registro SPICCA Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 19 6.4
Servizi da Pubblicare Cliccando sulla voce di menù “Servizi da Pubblicare”, viene visualizzata la lista dei servizi inseriti nel registro ma non ancora pubblicati (Figura 26). La pubblicazione avviene cliccando sull’apposito link “Pubbluica”. Figura 26: Servizi da Pubblicare Al momento della pubblicazione, se disponibile il servizio di invio e‐mail, l’applicazione invia ai referenti dei soggetti tra cui vige l’accordo di servizio la relativa comunicazione di pubblicazione. 6.5
Servizi Pubblicati Cliccando sulla voce di menù “Servizi Pubblicati”, viene visualizzata la lista dei servizi pubblicati nel registro e che non sono dismessi (Figura 27).Cliccando su uno dei link disponibili, si pone il servizio in uno dei relativi stati. Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 20 Figura 27: Elenco Servizi Pubblicati 6.6
Visualizza Stato Servizi Cliccando sulla voce di menù “Visualizza Stato Servizi”, viene visualizzata la lista di tutti i servizi presenti nel registro (Figura 28), riportando lo stato attuale del servizio e la possibilità di andare a recuperare tutti i suoi dettagli mediante l’icona dettaglio (Figura 14). In questa sezione è inoltre possibile andare a recuperare un file contenente la Parte Comune dell’Accordo di Servizio, in formato apc, o un file contenente la Parte Specifica dell’Accordo di Servizio, in formato aps. Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 21 Figura 28: Elenco Servizi presenti nel Registro SPICCA Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 22 7
Amministrazione Utenti L’amministrazione degli utenti presenta un link per la registrazione di un nuovo utente e un link per ottenere la lista degli utenti registrati, dalla quale si può passare alla modifica e/o all’eliminazione di un generico utente (Figura 29). Figura 29: Amministrazione Utenti 7.1
Lista Utenti Cliccando sulla voce del menù “Lista Utenti”, l’applicazione visualizza l’elenco degli utenti registrati (Figura 31). Cliccando sull’icona di modifica (Figura 30 – a) si accede alla modifica del relativo utente; mentre cliccando sull’icona di eliminazione (Figura 30 – b) l’utente viene eliminato. (a) (b) Figura 30: Icona di Modifica (a) – Icona di Eliminazione (B) Infine, cliccando sul pulsante “Aggiungi nuovo operatore” si passerà all’inserimento di un nuovo utente. Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 23 Figura 31: Amministrazione Utenti ‐ Lista Utenti 7.2
Registra Nuovo Utente Cliccando sulla voce del menù “Registra Nuovo Utente”, l’applicazione visualizza la maschera di immissione dei dati relativi al nuovo utente (Figura 32). Figura 32: Registrazione Nuovo Utente Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 24 La parte alta della maschera riporta l’anagrafica dell’operatore; mentre la parte bassa della maschera riporta l’elenco dei servizi presenti nell’applicazione; spuntando queste voci si fornisce all’utente il permesso di utilizzo del servizio corrispondente. Al termine dell’inserimento dei dati, ciccare sul pulsante “Registra” per completare l’operazione di registrazione. 8
Import/Export Il servizio di Import/Export permette all’operatore abilitato di effettuare l’Import della Parte Comune e Parte Specifica di un Accordo di Servizio, l’Import della Parte Specifica di un Accordo di Servizio la cui Parte Comune sia già presente nel Registro SPICCA, l’Export della Parte Comune di un Accordo di Servizio e l’Export della Parte Specifica di un Accordo di Servizio. Figura 33: Import/Export 8.1
Import AS Cliccando sulla voce del menù “Import AS”, l’applicazione visualizza la maschera di Import di un Accordo di Servizio (Figura 34). Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 25 Figura 34: Import AS Si può scegliere la modalità di Import, come indicato in Figura 35: Figura 35: Modalità Import AS Se si sceglie la modalità “Import Accordo di Servizio Completo”, bisogna allegare un file con estensione apc contenente la Parte Comune dell’Accordo di Servizio, un file con estensione aps contenente la Parte Specifica dell’Accordo di Servizio; bisogna, inoltre, selezionare il Soggetto Fruitore e il Profilo di Comunicazione tra quelli presenti nel Registro SPICCA. Se, invece, si sceglie la modalità “Import Parte Specifica”, bisogna allegare un file con estensione aps contenente la Parte Specifica dell’Accordo di Servizio e selezionare il Soggetto Fruitore tra quelli presenti nel Registro SPICCA. 8.2
Export AS Cliccando sulla voce del menù “Import AS”, l’applicazione visualizza la Lista degli Accordi di Servizio, in cui è possibile effettuare l’operazione di Export della Parte Comune o della Parte Specifica di un Accordo di Servizio presente nel Registro SPICCA (Figura 36). Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 26 Figura 36: Export AS Ciccando sull’icona in Figura 37 è possibile effettuare l’Export della Parte Comune o Specifica di un Accordo di Servizio, a seconda se si clicca l’icona nella colonna “Parte Comune” o quella nella colonna “Parte Specifica”. Figura 37: Icona Export AS Registro SPICCA: Manuale utente v.1.0 del 25/08/2009 Pagina 27