Specifica tecnica dei servizi di integrazione

Транскрипт

1 Specifica tecnica dei servizi di integrazione OriginalSkills prevede 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. Per ogni azienda verranno definiti due seed utilizzati per comporre il codice di verifica () da utilizzare nella chiamate. Il codice OriginalSkills deve essere utilizzato per tutte le chiamate a OriginalSkills mentre il codice azienda sarà usato da OriginalSkills per le chiamate verso l azienda. Invocazione del test OriginalSkills 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: Azienda EseguiTest Nome Cognome Hash di verifica funzione degli altri parametri e di un seed stringa Codice dell azienda che invoca il servizio che compila il test Campo booleano che indica se deve essere eseguito il test OriginalSkills (true) oppure no (false) Nome dell utente che accede al test Cognome dell utente che accede al test Si ac924dca27ceff53eeb5cd3d66ce0391 Si WebRatioTest Si true No Mario No Rossi Genere Genere del candidato (M/F) No M AnnoNascita Anno di nascita del candidato No 1964 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 WebRatio Parameter2 1 Contiene l area preferita No Human Resources 1

2 Parameter3 1 Contiene il ruolo preferito No Human Resources Specialist CodicePaese 2 Codice del paese riferito alla lingua in cui il test deve essere compilato No IT LingueConosciute 3 Lingua conosciuta dal candidato No Inglese LivelliLingue 4 CVFileName 5 CVFileBase64 CALLBACK Livello della lingua conosciuta dal candidato Campo di testo che indica il nome del file da utilizzare per il curriculum Campo di testo contenere il file in formato Base64 Url da invocare al termine del test e a cui fare una PUSH dei risultati sintetici del test No A2 - Elementare No cv.doc No Sì del candidato Sì [email protected] TipoCandidatura 1 AnniEsperienza 6 LivelloIstruzione 6 Tipologia di candidatura del Candidato Anni di esperienza del Candidato Livello di istruzione del Candidato Sì Nuova candidatura Sì meno di 1 Sì Nessun diploma 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 stringa composta concatenando questi campi: seed + + CALLBACK (senza aggiungere dei blank). Ponendo il caso che il seed da usare sia OriginalSkills, il codice di controllo sarà così calcolato: MD5(OriginalSkills = ac924dca27ceff53eeb5cd3d66ce0391 ( 1 ) I valori devono corrispondere esattamente al nome presente nella piattaforma OriginalSkills. Inviare il nome inserito dall amministratore dell azienda e non il nome in lingua. ( 2 ) I codici paese disponibili nella piattaforma sono IT (Italia), US (Inghilterra), BG (Bulgaria), DE (Germania), ES (Spagna), FR (Francia), LB (Libano), MA (Marocco), UY (Uruguay) ( 3 ) Campo di testo ripetibile n volte per specificare tutte le lingue conosciute dal candidato ( 4 ) Campo di testo ripetibile n volte per specificare il livello di conoscenza. I valori devono corrispondere esattamente al nome presente nella piattaforma OriginalSkills ( 5 ) Quando viene inviato questo parametro deve essere obbligatoriamente aggiunto nel body dalla POST il binario del file oppure essere inviato il parametro CVFileBase64. Nel caso in cui per errore venga inviato sia il binario che il Base64 il sistema considererà solo il Base64 ( 6 ) I valori devono corrispondere esattamente al nome presente nella piattaforma OriginalSkills in lingua. Le voci cioè presentate quando si compila il questionario SkillView. 2

3 Push dei risultati del test di OriginalSkills al chiamante Al termine del test OriginalSkills 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 TIPO_TEST Hash di verifica funzione degli altri parametri e di un seed stringa che compila il test (ricevuto sempre in post all atto dell inizializzazione del test) Data/Ora di ultimazione del test in formato ISODATE Identificativo della piattaforma di test (costante) Si 36c20f04648aa59c5cce517ae0cad8ec Sì T08:35:30 Sì originalskills ESITO 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ì 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 { } " ": " 36c20f04648aa59c5cce517ae0cad8ec", "": " ", "TIMESTAMP": " T08:35:30", "TIPO_TEST": "originalskills", "ESITO": [ {"name": "P1", "value": "1.32"}, {"name": "P2", "value": "4.56"}, {"name": "P3", "value": "6.21"}, {"name": "P ", "value": " "} ] Il SEED stringa che andremo ad utilizzare nelle chiamate di risposta al servizio deve essere concordato con l azienda. 3

4 L è calcolato utilizzando la funzione MD5 sulla stringa 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(ExTeRnAlSiTeSeEdoriginalskills T08:35:30) = 36c20f04648aa59c5cce517ae0cad8ec Il servizio restituirà in output sempre in formato JSON una struttura dati composta da un intero e da una stringa. L intero conterrà un identificativo in caso di successo o -1 in caso di errore. La stringa conterrà il dettaglio dell errore. In caso di successo la stringa 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 OriginalSkills 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 OriginalSkills al chiamante ). L URL chiamato per questa funzione sarà un URL del tipo: dove avremo i seguenti parametri passati in GET: Azienda Hash di verifica funzione degli altri parametri e di un seed stringa Codice dell azienda che invoca il servizio che compila il test Si ac924dca27ceff53eeb5cd3d66ce0391 Si WebRatioTest CALLBACK Url da invocare in risposta alla richiesta Sì L hash sarà calcolato utilizzando la funzione MD5 sulla stringa composta concatenando questi campi: seed + + CALLBACK (senza aggiungere dei blank) Ponendo il caso che il seed da usare sia OriginalSkills, il codice di controllo sarà così calcolato: MD5(OriginalSkills = ac924dca27ceff53eeb5cd3d66ce0391 L applicazione OriginalSkills, dopo aver verificato la rispondenza dell hash ricevuto a quello calcolato, fornirà la risposta effettuando la chiamata all URL specificato nel parametro CALLBACK. 4

5 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: { } "": " 36c20f04648aa59c5cce517ae0cad8ec", "": " ", "TIMESTAMP": "", "TIPO_TEST": "originalskills", "ESITO": [] Accesso al report dettagliato del test La piattaforma OriginalSkills 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: Azienda Hash di verifica funzione degli altri parametri e di un seed stringa Codice dell azienda che invoca il servizio che compila il test Si 0d321d0e06d21cf33a2f6cad1cd603b8 Si WebRatioTest PARAMS Eventuali parametri addizionali da utilizzare per personalizzare il report No Profile=P1 L hash sarà calcolato utilizzando la funzione MD5 sulla stringa composta concatenando semplicemente il seed all : seed + (senza aggiungere dei blank) Ponendo il caso che il seed da usare sia OriginalSkills, il codice di controllo sarà così calcolato: MD5(OriginalSkills ) = 0d321d0e06d21cf33a2f6cad1cd603b8 L applicazione OriginalSkills, 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. 5

6 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. Come utilizzare i seed OrignalSkills utilizza 2 codici diversi per calcolare e verificare gli hash. Per il calcolo degli hash nelle chiamate che OrignalSkills effettua verso sistemi esterni viene utilizzata la chiave azienda. Mentre per la verifica della chiamate che OrignalSkills riceve viene utilizzata la chiave OrignalSkills 6