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.
| Table of Contents |
|---|
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
...
Begrænsninger i forhold til CV data
CV webservicen anvendes af flere forskellige systemer, som har forskellige rettigheder i forhold til borgerens CV data.
...
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
...
- 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).
...
- 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
...
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å:
...
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 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 oprettes Trediepart (kunden) et CV med alle de ønskede oplysninger. Bemærk CV'et behøver ikke at være søgbart for det kan hentes
- Når CV'et er oprettet går Trediepart (kunden) på eget system og aktiverer sin funktion til at hent CV
- På Jobnet dedikerede side til at hente en token logge Trediepart (kunden) ind med test NemID, token modtages herefter
- Med Token hentes test borgers CV oplysninger af Trediepart (kunden)
- Trediepart (kunden) verificerer nu af de forventede CV oplysninger modtages
Efter test
Testen er velgennemført, når webservice supporten (systemforvalter) meddeler, at der ingen fejl er i udveksling af data mellem kundens system og test-miljøet.
...
Når STAR modtager den underskrevne kopi med posten, åbnes der for drifts-miljøet for den nye kunde.
Eksempler
På denne side /wiki/spaces/ISB/pages/2091188585 finder du eksempler på kald af CV webservicen.
...