SERVICE BROWSER. Versione 1.0

Transcript

1 SERVICE BROWSER Versione /09/2008

2 Indice dei Contenuti 1. Scopo del documento Introduzione Accordi di Servizio Servizi Servizio: Schede Erogatori Servizio: Schede Fruitori... 13

3 1. Scopo del documento Il presente manuale descrive il servizio di Service Browser fornito dal portale CART destinato agli sviluppatori in ambito CART, a supporto delle attività di configurazione e sviluppo dei servizi. 2. Introduzione Il Service Browser è un applicazione web che espone gli Accordi di Servizio (AdS parte comune) ed i Servizi (la parte specifica degli AdS) presenti sul Registro CART, e visualizza i dati di configurazione significativi per gli sviluppatori dei servizi applicativi. Le funzionalità del Service Browser sono integrate del Portale CART e vi si accede tramite specifiche opzioni del menù delle sezioni (barra laterale destra). Sulla barra del menu è possibile selezionare il tipo di informazione da ricercare: gli Accordi di Servizio o i Servizi. In particolare sono presenti due diverse istanze del service browser, una relativa ai servizi configurati nell ambiente di staging, l altra per l ambiente di produzione.

4 3. Accordi di Servizio E possibile ricercare gli accordi di servizio mediante un motore di ricerca come mostrato in figura. Le chiavi di ricerca degli AdS sono: una ricerca libera sul nome dell Accordo l area di intervento per cui l AdS è catalogato la RFC di riferimento Nella pagina di dettaglio di ogni AdS sono visibili le seguenti informazioni relative all accordo di servizio, inclusi alcuni dettagli di configurazione dell infrastruttura: la descrizione la RFC di riferimento il tipo di profilo eventuali WSDL (definitorio, concettuale, logico erogatore/fruitore) eventuali WSBL (definitorio, concettuale, logico erogatore/fruitore) la possibilità di invocare il servizio senza specificare una azione se sul servizio è presente un filtro di eventuali buste egov duplicate se è abilitata la funzione di conferma ricezione, ovvero se per il servizio è prevista la consegna affidabile se al servizio deve essere associato un identificativo di Collaborazione se per il servizio è prevista la consegna in ordine delle buste egov appartenenti ad una stessa collaborazione

5 Sono inoltre descritte tutte le possibili Azioni dell AdS. Infine è presente un link per vedere la lista di tutti i Servizi (AdS parte specifica) implementati a partire dall AdS corrente. 4. Servizi In modo analogo a quanto realizzato per gli accordi di servizio, è presentato un motore di ricerca che consente di poter eseguire ricerche nel registro CART. Le chiavi di ricerca dei Servizi sono: una ricerca libera sul nome del Servizio una ricerca libera sul nome dei soggetti erogatori/fruitori di Servizi con la possibilità di selezionare i soggetti Erogatori e quelli Fruitori

6 l area di intervento a cui, tramite gli Accordi, i servizi sono collegati la RFC di riferimento a cui, tramite gli Accordi, i servizi sono collegati l Accordo di Servizio associato Dopo aver attivato la ricerca otterremo una pagina dei risultati ottenuti i base ai criteri selezionati e cliccando sul titolo del servizio si accede al dettaglio del servizio. Per ogni Servizio sono visibili i seguenti campi: il nome del Soggetto che eroga il Servizio l AdS ad esso relativo la RFC di riferimento l indicazione se il Servizio è il correlato di un altro

7 gli eventuali WSDL implementativi (erogatore/fruitore) E presente l elenco delle Azioni previste nell AdS. Solo nel caso di Servizi in ambiente di staging sono presenti i link al Log Viewer, per visualizzare i log relativi al servizio. Quindi è mostrato l elenco dei soggetti Erogatori e dei soggetti Fruitori del Servizio.

8 5. Servizio: Schede Erogatori Cliccando sul nome dell erogatore si apre una finestra di dettaglio, nella quale vengono riprese, in forma sintetica, tutte le informazioni di configurazione necessarie per la erogazione del servizio presenti sulle schede di attivazione compilate dal Gestore dell Infrastruttura. Soggetto SPCoop Nome SIL Tipo/Nome del soggetto SPCoop erogatore Nome del SIL erogatore E possibile che siano definiti più erogatori del servizio (ad es. nel caso dei paradigmi di comunicazione Publish&Subscribe gestiti tramite il Broker JMS), in tal caso avremo una scheda distinta per ogni erogatore. INVOCAZIONE DEL SERVIZIO Nella scheda sono sempre presenti le informazioni di integrazione per l invocazione del servizio che variano a seconda della modalità supportata

9 a) Nel caso della modalità trasparente è il NAL che invoca il servizio applicativo esposto dal SIL per consegnare i messaggi applicativi relativi alle richieste da elaborare URL del SIL Erogatore Tipo autenticazione url che il NAL deve invocare nessuna, BASIC, HTTPS In caso di autenticazione BASIC Username nome utente Password ****** In caso di autenticazione HTTPS Subject certificato ****** b) Nel caso della modalità Integration Manager è il SIL Erogatore che invoca il servizio Integration Manager esposto dal NAL per ricevere le richieste che deve elaborare. URL Integration Manager Tipo autenticazione Url del servizio di integration manager relativa al nome del NAL. Per ottenere l indirizzo effettivo sarà necessario sostituire il nome del NAL con il suo indirizzo IP o col nome completo del dominio. nessuna, BASIC, HTTPS In caso di autenticazione BASIC Username nome utente Password ****** In caso di autenticazione HTTPS Subject certificato ******

10 La Url del Integration Manager da invocare indicata nella scheda deve essere completata, sostituendo il nome del <NAL> con il suo indirizzo IP o col nome completo del dominio. RISPOSTA ASINCRONA Nel caso di un profilo di collaborazione di tipo Asincrono Asimmetrico con richiesta sincrona il servizio applicativo invocato (erogatore), oltre alle informazioni necessarie per ricevere le richieste (invocazione del servizio), deve specificare anche le informazioni di integrazione per ricevere le richieste relative allo stato del servizio (risposta asincrona). Anche in questo caso le informazioni di integrazione variano a seconda della modalità supportata c) Nel caso della modalità trasparente è il NAL che invoca il servizio applicativo esposto dal SIL per consegnare i messaggi applicativi relativi alle richieste da elaborare URL del SIL Erogatore Tipo autenticazione In caso di autenticazione BASIC Username url che il NAL deve invocare nessuna, BASIC, HTTPS nome utente

11 Password ****** In caso di autenticazione HTTPS Subject certificato ****** d) Nel caso della modalità Integration Manager è il SIL Erogatore che invoca il servizio Integration Manager esposto dal NAL per ricevere le richieste che deve elaborare. URL Integration Manager Tipo autenticazione Url del servizio di integration manager relativa al nome del NAL. Per ottenere l indirizzo effettivo sarà necessario sostituire il nome del NAL con il suo indirizzo IP o col nome completo del dominio. nessuna, BASIC, HTTPS In caso di autenticazione BASIC Username nome utente Password ****** In caso di autenticazione HTTPS Subject certificato ****** TEST SIL EROGATORE Nella pagina di dettaglio del servizio, cliccando sul link Visualizza Contenuto della Message Box è possibile visualizzare gli eventuali messaggi inviati sull infrastruttura del CART e presenti nella message box del SIL erogatore. Tale funzionalità è disponibile solo per l ambiente di staging del CART.

12 Nella pagina di test del SIL erogatore è possibile specificare i seguenti parametri: a) Password SIL Erogatore: se prevista; b) Filtro su Fruitore: è possibile selezionare i Fruitori di tale servizio in modo da visualizzare solo i messaggi inviati dal fruitore selezionato; c) Azione: se l accordo è configurato per l utilizzo solo con azione, sarà necessario selezionare un azione e quindi verranno visualizzati solo i messaggi inviati per tale azione; mentre se l accordo è configurato per l utilizzo senza azione, sarà possibile anche non selezionare l azione, visualizzando in tal caso tutti i messaggi presenti nella Message box a prescindere dall azione con cui il messaggio è stato inviato dal fruitore.

13 La pagina si aggiorna mostrando: i dati di riepilogo della richiesta inviata; l elenco di tutti i messaggi presenti nella Message Box; la possibilità di accedere al dettaglio del singolo messaggio applicativo; la possibilità di eliminare il messaggio dalla Message Box. 6. Servizio: Schede Fruitori Cliccando sul nome del fruitore si apre una finestra di dettaglio, nella quale vengono riprese, in forma sintetica, tutte le informazioni di configurazione necessarie per la fruizione del servizio presenti sulle schede di attivazione compilate dal Gestore dell Infrastruttura. Ogni scheda è caratterizzata da un titolo così composto <Tipo/Nome Soggetto Fruitore> (sil <nome SIL fruitore>) Servizio Tipo/Nome del servizio

14 Soggetto SPCoop Nome SIL Tipo/Nome del soggetto SPCoop fruitore Nome del SIL fruitore INVOCAZIONE SERVIZIO Nel caso del fruitore è sempre il SIL che deve invocare un servizio esposto dal NAL per inviare le richieste di esecuzione del servizio. Sono supportate due diverse modalità di integrazione: la modalità trasparente e l Integration Manager. Le informazioni di integrazione variano a seconda della modalità supportata. Il service browser mostra le informazioni per entrambe la modalità, lasciando così scelta libera al programmatore di utilizzare quella più adatta ai suoi scopi. a) Nel caso della modalità trasparente vengono visualizzate le url delle porta delegate (possono essere più di una); nel caso in cui l AdS preveda la presenza di più di un azione la url da invocare è specifica per ogni azione. URL di Invocazione Modalità Trasparente url della porta delegata composta con ogni singola azione, ad es b) Nel caso della modalità Integration Manager si visualizza solo la url di questo servizio URL di Invocazione Integration Manager Url del servizio di integration manager relativa al nome del NAL. Per ottenere l indirizzo effettivo sarà necessario sostituire il nome del NAL con il suo indirizzo IP o col

15 nome completo del dominio. In entrambi i casi bisogna fornire le informazioni di autenticazione con cui il SIL si autentica presso il NAL. Tipo autenticazione nessuna, BASIC, HTTPS In caso di autenticazione BASIC Username nome utente Password ****** In caso di autenticazione HTTPS Subject certificato ****** RISPOSTA ASINCRONA Nel caso di un profilo di collaborazione di tipo Asincrono Simmetrico con richiesta sincrona il servizio applicativo invocante (fruitore) deve anche definire al suo interno un elemento risposta asincrona, che specifichi la modalità di consegna della risposta asincrona simmetrica al servizio applicativo da parte della Porta di Dominio.

16 Anche in questo caso le informazioni di integrazione variano a seconda della modalità supportata c) Nel caso della modalità trasparente è il NAL che invoca il servizio applicativo esposto dal SIL per consegnare i messaggi applicativi relativi alle richieste da elaborare URL del SIL Erogatore Tipo autenticazione url che il NAL deve invocare nessuna, BASIC, HTTPS In caso di autenticazione BASIC Username nome utente Password ****** In caso di autenticazione HTTPS Subject certificato ****** d) Nel caso della modalità Integration Manager è il SIL Erogatore che invoca il servizio Integration Manager esposto dal NAL per ricevere le richieste che deve elaborare. URL Integration Manager Tipo autenticazione Url del servizio di integration manager relativa al nome del NAL. Per ottenere l indirizzo effettivo sarà necessario sostituire il nome del NAL con il suo indirizzo IP o col nome completo del dominio. nessuna, BASIC, HTTPS In caso di autenticazione BASIC Username nome utente Password ****** In caso di autenticazione HTTPS Subject certificato ******

17 TEST SIL FRUITORE Nella pagina di dettaglio del servizio, cliccando sul link Invia messaggio di Test è possibile inviare sull infrastruttura del CART, messaggi di test, impersonando il SIL fruitore. Tale funzionalità è disponibile solo per l ambiente di staging del CART. Nella pagina di test del SIL fruitore è possibile specificare i parametri del test: a) Erogatore: selezionandolo dalla lista degli erogatori; b) Tipo di messaggio: è possibile scegliere fra SOAP envelope in formato SOAP 1.1 solo il contenuto applicativo c) Modalità di input del messaggio: è possibile scegliere fra caricare dal file system un file di testo contenente il messaggio inserire il testo del messaggio in una textarea Nota: il testo del messaggio sarà interpretato in base al tipo di messaggio prescelto. d) Password SIL Fruitore: se prevista;

18 e) Azione: nel caso in cui sia configurata l invocazione della PdD con azione obbligatoria (configurazione dell accordo di servizio in modalità Utilizzo Senza Azione non settata), sarà necessario selezionare una fra le azioni configurate per il servizio, mentre nel caso in cui sia consentito l utilizzo senza azione ( flag Utilizzo Senza Azione settata), sarà possibile anche non specificare l azione. Il messaggio viene inoltrato verso la PdD del soggetto di riferimento per il SIL fruitore selezionato e la pagina si aggiorna mostrando: i dati di riepilogo della richiesta inviata; l esito della richiesta ricevuto dall infrastruttura; un link per accedere ai dettagli del tracciamento del messaggio inoltrato. La funzionalità è disponibile solo per i SIL per i quali sia prevista una modalità di autenticazione di tipo basic (username e password) o none (nessuna autenticazione). Il NAL fruitore deve essere raggiungibile dal CRIC di staging all indirizzo IP specificato nella console, ed il servizio di integration manager deve essere attivo alla url nal specificato in console>:8080/cart/integrationmanager