Integrationsvejledning til CV webservice - tredieparter

Owned by Carsten Olsen
Last updated: Mar 31, 2022 by Knud de Place (STAR)
4 min read

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 [tidspunkt] udstillet denne webservices og den vil erstatte hidtidige løsninger. Tidligere løsninger blev udfaset i december 2020, hvor det nye CV på Jobnet blev idriftsat.

Denne vejledning gælder for trediepart der ønsker at tilgå CV oplysninger uden at kende borgers CPR nr.

Denne service skal således ikke anvendes af a-kasser og jobcentre eller disses databehandlere, der integrerer til DFDG generelt.

Roller

CV webservicen tilbyder en rolle 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 /v3/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

  1. Borger ønsker at hente sit CV fra Jobnet
  2. Trediepartsystem (kundesystem) redirecter borger til dedikeret loginside på Jobnet
  3. Borger giver Jobnet login informationer
  4. Hvis Borgers login er succesfuldt og trediepart (kundesystem) er kendt i DFDG fås Token med tilbage til trediepartsystemet (kundesystemet) 

Trin 2 CV hentes

  1. Trediepart (kundesystem) kalder GetCVOnTokeni DFDG, med token
  2. 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 sammenhæng være "Hent CV"

Gyldighedsperioden vil for at hente CV oplysninger være en periode på (fx) 24 timer. Dvs. trediepart (kundesystem) kan kun hente CV oplysninger i en 24 timers periode efter token er udstedt. Ønsker borger efter de 24 timer 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 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

  1. Trediepart (kunden) opretter et test NemID på en testbruger hos NemID
  2. Dette test NemID anvendes af trediepart (kunden) til at logge ind på Jobnet på det aftalte testmiljø.
  3. 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
  4. Når CV'et er oprettet går trediepart (kunden) på eget system og aktiverer sin funktion til at hente CV
  5. På Jobnets dedikerede side til at hente en token, logger trediepart (kunden) ind med test NemID og token modtages herefter
  6. Med token hentes test borgers CV oplysninger af trediepart (kunden)
  7. 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.



Tilgængelighed: https://starwiki.atlassian.net/was