Denne integrationsvejledning beskriver hvordan systemer udenfor Styrelsen for Arbejdsmarked og Rekruttering (STAR) 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 primo 2021 udstillet denne webservices og den vil erstatte hidtidige løsninger, der samtidigt vil bliver udfaset.
Denne vejledning gælder for trediepart der ønsker at tilgå CV oplysninge uden at kende borgers CPR nr. Den gælder således ikke for a-kasser, Jobcentre m.f. der integrere til DFDG generelt.
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
- Produktionversion
- Testmiljø T1
- Testmiljø (seneste udviklingsversion - kun intern brug i STAR)
- T4 testmiljø (pr. 24.9.2020 med 2020-4 kode): https://jobsearcht4.jobnettest.dk/swagger/index.html?urls.primaryName=Cv%20V1
- T3 testmiljø ((pr. 24.09-2020 med 2020-3 kode): https://jobsearcht3.jobnettest.dk/swagger/index.html?urls.primaryName=Cv%20V1
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.
Borger kan hente sine CV oplysninger ned til det pågældende eksterne system. De CV oplysninger der bliver tilgængelige omfatter:
- CV's indhold
- Relevante ansættelsesbetingelser
Det er kun muligt at hente CV oplysninger på borger via metoden GetCVOnToken. Der kan f.eks. ikke adgang til 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 ønsker at hente sit CV fra Jobnet
- Trediepartsystem (kundesystem) redirecter borger til dedikeret loginside på Jobnet
- Borger giver Jobnet login informationer
- Hvis Borgers login er succesfuldt og trediepart (kundesystem) er kendt i DFDG fås Token med tilbage til trediepartsystemet (kundesystemet)
Trin 2 CV hentes
- Trediepart (kundesystem) kalder GetCVOnTokeni DFDG, med token
- Hvis Token er valid modtages CV informationer
Processer
Denne model understøtter kun, at borger ønsker at hente sit CV til trediepart (kundesystem).
Før trediepart (kundesystem) kan hente et CV, skal følgende være opfyldt:
- Trediepart (kundesystem) skal have 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 gyldighedsperiode
Konteksten (tokentypen) vil i denne sammenghæng være "Hent CV"
Gyldighedsperioden vil for at hente CV oplysninger være en periode på 24 timer. Dvs. trediepart (kundesystem) kan kun hente CV oplysninger i en 24 timers periode efter token er udstedt. Ønsker borger at hente sit CV igen udstedes en ny token.
Procedure for tilslutning til CV webservice
Nye brugere, der er interesseret i at bruge CV webservice, skal starte med at kontakte teamchef Kirsten Vestergaard på e-mail kiv@star.dk. Selve tilslutningen vil ske i gennem STAR's systemforvalter
Telefon og mail
En indledende afklaring kan foregå via telefon på 72217560, men processen startes først, når der sendes en mail på teamchef Kirsten Vestergaard på e-mail kiv@star.dk. I mailen skal det fremgå:
- Hvem der er den nye kunde, adresse, firmanavn, CVR nr, 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 der sendes en tilslutningsaftale til trediepart (kunden) til underskrift. Når den underskrevne tilslutningsaftale er modtaget i STAR, får webservice supporten (systemforvalter) besked om, at give den nye kunde adgang til relevant web-service test-miljø.
Trediepart (kunden) går i gang
Den nye trediepart (kunde) udvikler herefter det software, der skal ende med, at de kan udveksle data med CV webservice. Udviklingstiden afhænger af de kompetencer og forudsætninger, kunden råder over. STAR udvikler ikke noget i forbindelse med oprettelse af nye web-service kunder, men stiller blot eksisterende webservice 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 faktureres mellem den nye kunde og web-service supporten (systemforvalter) og er STAR uvedkommende.
Testmiljø og test
STAR stiller testmiljø til rådighed og har nedestående forslag til testcase.
Testcase
- Trediepart (kunden) opretter et test NemID på en testbruger hos NemID
- Dette test NemID anvendes af trediepart (kunden) til at logge ind på Jobnet på det aftalte testmiljø.
- På Jobnet opretter trediepart (kunden) et CV med alle de ønskede oplysninger. Bemærk CV'et behøver ikke at være søgbart, for at det kan hentes
- Når CV'et er oprettet går trediepart (kunden) på eget system og aktiverer sin funktion til at hente CV
- På Jobnets dedikerede side til at hente en token, logger trediepart (kunden) ind med test NemID og token modtages herefter
- Med token hentes test borgers CV oplysninger af trediepart (kunden)
- Trediepart (kunden) verificerer nu, at de forventede CV oplysninger er modtaget
Efter test
Når trediepart (kunden) har gennemført sin test kontaktes teamchef Kirsten Vestergaard på e-mail kiv@star.dk med henblik at idriftsætte løsningen.
Eksempler
På denne side /wiki/spaces/ISB/pages/2091188585 finder du eksempler på kald af CV webservicen.