Specifica tecnica dei servizi di integrazione

Transcript

1 Specifica tecnica dei servizi di integrazione Skillview prevede la dei moduli per l invocazione remota del test, la restituzione dei risultati ad un sistema esterno, la possibilità di verificare la compilazione di un questionario e di vedere il dettaglio di un questionario compilato. Invocazione del test Skillview L invocazione del test avviene attraverso la chiamata ad un URL con il passaggio in POST di un insieme di parametri di anagrafica e di alcuni attributi per garantire la sicurezza dell invocazione. L URL da invocare per l accesso al test è: e riceverà in POST i seguenti parametri: Nome Cognome Nome dell utente che accede al test Cognome dell utente che accede al test Si 37051a763d79eb0acf1097a1bc68b565 No Mario No Rossi Genere Genere del candidato (M/F) No M DataNascita Data di nascita nel formato aaaa-mm-gg No StatoResidenza 1 Stato di residenza No Italy RegioneResidenza 1 ProvinciaResidenza 1 Regione di residenza (solo se Italy) Provincia di residenza (solo se Italy) No Emilia Romagna No Bologna Parameter1 1 Contiene la sede preferita No Centro Universitario Internazionale Parameter2 1 Contiene l area preferita No Human Resources Parameter3 1 Contiene il ruolo preferito No Human Resources Specialist Lingua 2 CALLBACK Lingua in cui il test deve essere compilato Url da invocare al termine del test e a cui fare una PUSH dei risultati sintetici del test No it Sì cuted 1

2 Per ogni azienda verrà definito un seed che verrà utilizzato per comporre il codice di verifica (). L hash sarà calcolato utilizzando la funzione MD5 sulla composta concatenando questi campi: seed + + CALLBACK (senza aggiungere dei blank). Ponendo il caso che il seed da usare sia SkiLLvieWPlatF0rM, il codice di controllo sarà così calcolato: MD5(SkiLLvieWPlatF0rM http:// d) = 37051a763d79eb0acf1097a1bc68b565 ( 1 ) I valori devono corrispondere esattamente al nome presente nella piattaforma Skillview ( 2 ) Le lingue disponibili nella piattaforma sono it (italiano), en (inglese), bg (bulgaro), de (tedesco) Push dei risultati del test di Skillview al chiamante Al termine del test Skillview l applicazione dovrà fare una push dei risultati al chiamante. L Url da invocare è quello che è stato ricevuto all atto nell inizializzazione del test nel campo CALLBACK e i parametri che il chiamante si aspetta sono i seguenti: TIMESTAMP (ricevuto sempre in post all atto dell inizializzazione del test) Data/Ora di ultimazione del test in formato ISODATE Sì T08:35:30 TIPO_TEST ESITO Identificativo della piattaforma di test (costante) Esito del test in un vettore di coppie etichette / valore. Per valori decimali si usa il. come separatore fra le unità e le cifre decimali. Non si usano separatori delle migliaia. Sì skillview Sì P1=1.32 P2=4.56 La soluzione è quella di invocare un web-service REST in POST esposto dal chiamante inserendo nel body una struttura dati JSON. Esempio: POST e includerà nel body la seguente struttura dati JSON { " ": "13f6b8e5bf6d5fff1322f2b ba", "": " ", "TIMESTAMP": " T08:35:30", "TIPO_TEST": "skillview", 2

3 } "ESITO": [ {"name": "P1", "value": "1.32"}, {"name": "P2", "value": "4.56"}, {"name": "P3", "value": "6.21"}, {"name": "P ", "value": " "} ] Il SEED che andremo ad utilizzare nelle chiamate di risposta al servizio deve essere concordato con l azienda. L è calcolato utilizzando la funzione MD5 sulla composta dalla concatenazione dei seguenti campi: SEED + TIPO_TEST + + TIMESTAMP. I campi vengono concatenati senza l aggiunta di spazi. Ponendo il caso che il seed da usare sia ExTeRnAlSiTeSeEd, il codice di controllo sarà così calcolato: MD5(ExTeRnAlSiTeSeEdskillview T08:35:30) = c160560d1a120292ef c9cb4 Il servizio restituirà in output sempre in formato JSON una struttura dati composta da un intero e da una. L intero conterrà un identificativo in caso di successo o -1 in caso di errore. La conterrà il dettaglio dell errore. In caso di successo la può essere ignorata. Esempio di risposta JSON restituito dal Web Service REST: {"CODE":"1","DESCRIPTION":"Salvataggio Eseguito Correttamente"} Verifica di compilazione di un questionario La piattaforma di test di Skillview può essere interrogata per chiedere conferma della presenza di un test. La risposta viene inviata con le stesse modalità con cui viene inviata al termine di un test (vedi paragrafo Push dei risultati del test di Skillview al chiamante ). L URL chiamato per questa funzione sarà un URL del tipo: dove avremo i seguenti parametri passati in GET: CALLBACK Url da invocare in risposta alla richiesta Sì externalsystem.it/testexecuted L hash sarà calcolato utilizzando la funzione MD5 sulla composta concatenando questi campi: seed + + CALLBACK (senza aggiungere dei blank) 3

4 Ponendo il caso che il seed da usare sia SkiLLvieWPlatF0rM, il codice di controllo sarà così calcolato: MD5(SkiLLvieWPlatF0rM http:// d) = 37051a763d79eb0acf1097a1bc68b565 L applicazione Skillview, dopo aver verificato la rispondenza dell hash ricevuto a quello calcolato, fornirà la risposta effettuando la chiamata all URL specificato nel parametro CALLBACK. Nel caso non risultino compilati dei test per l passato come parametro, il campo ESITO non conterrà alcun elemento e il campo TIMESTAMP risulterà vuoto. Esempio di PUSH dei risultati alla callback URL in caso di test non ancora eseguito POST e includerà nel body la seguente struttura dati JSON: { } "": "37051a763d79eb0acf1097a1bc68b565", "": " ", "TIMESTAMP": "", "TIPO_TEST": "skillview", "ESITO": [] Accesso al report dettagliato del test La piattaforma Skillview dovrebbe consentire anche l accesso ad un report dettagliato del test eseguito dall utente direttamente su pagina web attraverso l invocazione di un url specifico. L URL chiamato per questa funzione sarà un URL del tipo con i seguenti parametri passati in GET alla chiamata: altri parametri e di un seed PARAMS Eventuali parametri addizionali da utilizzare per personalizzare il report No Profile=P1 L hash sarà calcolato utilizzando la funzione MD5 sulla composta concatenando semplicemente il seed all : seed + (senza aggiungere dei blank) 4

5 Ponendo il caso che il seed da usare sia SkiLLvieWPlatF0rM, il codice di controllo sarà così calcolato: MD5(SkiLLvieWPlatF0rM ) = 5384e4aef3a44e0f0048c580479bd1b9 L applicazione Skillview, dopo aver verificato la corrispondenza dell hash ricevuto a quello calcolato, restituirà il report PDF delle competenze aziendali con i dettagli del test effettuato dall utente. Test multipli sul medesimo utente Se viene invocato un test su un già censito i parametri anagrafici vengono sovrascritti e l utente accede alla compilazione di un nuovo test. L esito comunicato alla fine del test, invocando l indirizzo di callback, farà riferimento al nuovo test. La richiesta di visualizzazione farà riferimento all ultimo test compilato. 5