Denne integrationsvejledning beskriver hvordan systemer udenfor STAR (Styrelsen for Arbejdsmarked og Rekruttering) kan anvende CV webservice, til at hente en borgeres aktuelle CV fra jobnet.dk.
Introduktion
STAR tilbyder en webservice, som sætter eksterne organisationer i stand til hente en borgeres aktuelle CV, når borgere har givet samtykke hertil.
STAR vil fra ultimo 2020 udstillet denne webservices og den vil erstatte hidtidige løsninger der samtidigt vil bliver udfaset.
Roller
CV webservicen tilbyder en roller til systemer udenfor STAR:
- Afhentning af aktuelt CV fra jobnet.dk
CV snitfladebeskrivelse
Herunder finder du beskrivelse af den tekniske webservicekontrakt (swagger), samt detaljeret beskrivelse af metoder og datafelter i webservicen. Det skal bemærkes at snitfladen indeholder alle metoder
For hele cv strukturen se under Get /v1/Cv
Du kan finde forretningsregler for CV webservicen her:
Du kan finde forretningsbeskrivelse CV her:
Begrænsninger i forhold til CV data
CV webservicen anvendes af flere forskellige systemer, som har forskellige rettigheder i forhold til borgerens CV data.
Systemer uden for STAR har sammen adgang til, som arbejdsgivere kan på Jobnet for arbejdsgivere.:
- CV'er der er søgbare
- CV's indhold
- Relevant ansættelsesbetingelser
Det er kun muligt at hente CV oplysninger på borger vil GetCVOnToken, der kan f.eks. ikke foretages Cv søgning, opdateres i borgers CV m.v.
Model for integration med eksterne systemer
Når en borger ønsker at hente sit CV ned til en trediepart (Kunde til CV) anvendes følgende model
Trin 1 Token hentes
- Borger efterspørger load af CV fra Jobnet
- Trediepartsystem (kundesystem) redirecter borger til dedikeret loginside på Jobnet
- Borger giver Jobnet login informationer
- Hvis Borger login er succesfuldt og trediepart (kundesystem) er kendt i DFDG fås Token med tilbage til trediepartsystem (kundesystem)
Trin 2 CV hentes
- Trediepart (kundesystem) kalder GetCVOnTokeni DFDG, med token
- Hvis Token er valid modtages CV informationer
Processer
Denne model understøtter kun når borger ønsker at upload sit CV til trediepart (kundesystem).
Før trediepart (kundesystem) kan hente et CV skal følgende være opfyldt
- Trediepart (kundesystem) skal har en tilslutningsaftale til DFDG
- Have hentet en token for borgeren
Token
En token udstedes:
- Til en given trediepart (kundesystem)
- På en given borger
- I en given kontekst
- Med en given gyldighedsperioden
Konteksten (tokentypen) vil i denne sammenghæng være "Hent CV"
Gyldighedsperioden vil for at hente CV oplysninger vil være en periode på 24 timer. Dvs. trediepart (kundesystem) kan kun hente CV oplysninger i en 24 timers periode efter token er udstedt.
Bemærk: Kun CV oplysninger der er tilgængelige for trediepart medtages.
Procedure for tilslutning til CV webservice
Nye brugere, der er interesseret i at bruge CV webservice, skal starte med at kontakte STAR og XXXXXX person. Selve tilslutningen vil ske i gennem STAR's systemforvalter
Telefon og mail
En indledende afklaring kan foregå via telefon på XXXXXX, men processen startes først, når der sendes en mail på XXXXXDUG@star.dk. I mailen skal det fremgå:
- Hvem der er den nye kunde, adresse, firmanavn, kontaktperson og kontaktoplysninger
- Hvad webservice adgangen skal bruges til, fx i hvilken sammenhæng Cv oplysningerne ønskes anvendt
Efter modtagelse af mail oprettes en intern sag i STAR, og webservice supporten (systemforvalter) får besked om, at give den nye kunde adgang til relevant web-service test-miljø.
Terdiepart (kunden) går i gang
Den nye terdiepart (kunde) udvikler herefter det software, der skal ende med, at de kan udveksle data med CV webservicer. Udviklingstiden afhænger af de kompetencer og forudsætninger kunden råder over. Styrelsen for Arbejdsmarked og Rekruttering (STAR) udvikler ikke noget i forbindelse med oprettelse af nye web-service kunder, men stiller blot eksisterende webservicer og viden til rådighed.
Support
Alle nye tredieparter (kunder) får fem timers gratis support fra webservice supporten (systemforvalter). De fem timer kan bruges i udviklingsperioden og i den efterfølgende drift. Support ud over fem timer skal godkendes af STAR XXXX Dorthe Uglebjerg. Hvis det fravælges at betale for yderligere support, faktureres denne support mellem den nye kunde og web-service supporten (systemforvalter) og er Styrelsen for Arbejdsmarked og Rekruttering (STAR) uvedkommende.
Testmiljø og integrationstest
Trediepart (kunden) skal have gennemført og dokumenterer en integrationstest overfor STAR og webservice supporten (systemforvalter) inden det er muligt at hente CV oplysninger fra DFDG. Integrationstesten gennemføres på et testmiljø, hvor CV webservicen har følgende endpoint: XXXXX.
Trediepart kan generere og hente CV oplysninger på udvalgte test borgere i det/de aftalte testmiljøet.
Model for testdata til integrationstest
- Trediepart (kunden) oprettes et NemID på en testbruger hos NemID
Efter test
Testen er velgennemført, når webservice supporten meddeler, at der ingen fejl er i udveksling af data mellem kundens system og test-miljøet.
Dorthe Uglebjerg sender herefter pr. mail en Jobnet-webservice kontrakt, der skal underskrives af den nye kunde og derefter sendes retur med posten til Dorthe Uglebjerg.
Når STAR modtager den underskrevne kopi med posten, åbnes der for drifts-miljøet for den nye kunde.
Eksempler
Herunder finder du eksempler på kald af webservicen, dels som SOAP requests og response, dels som et C# projekt.