Denne integrationsvejledning beskriver hvordan systemer udenfor STAR (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 ultimo 2020 udstillet fra [tidspunkt] udstillet denne webservices og den vil erstatte hidtidige løsninger der samtidigt vil bliver udfaset. 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 roller 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

• Produktionversion
• Testmiljø T1
• Testmiljø (seneste udviklingsversion - kun intern brug i STAR)
• T3 testmiljø (release-next) (pr. 24.09-2020 med 2020-3 kode): https://jobsearcht3.jobnettest.dk/swagger/index.html?urls.primaryName=Cv%20V1
• T4 testmiljø (release next-next) (pr. 24.9.2020 med 2020-4 kode): https://jobsearcht4.jobnettest.dk/swagger/index.html?urls.primaryName=Cv%20V1
  

For hele cv strukturen se under Get /v1v3/Cv

Du kan finde forretningsregler for CV webservicen her:

• CVService (2020-3) - Den nye!JobSearch.CvService

Du kan finde forretningsbeskrivelse CV her:

• Curriculum vitae - CV FRA 2020-4CV livsforløb og arbejdsgangs omkring CV set fra sagsbehandler / jobkonsulent

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.:

...

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
• Relevant Relevante ansættelsesbetingelser

Det er kun muligt at hente CV oplysninger på borger vil GetCVOnToken, der via metoden GetCVOnToken. Der kan f.eks. ikke adgang til foretages Cv 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 efterspørger load af ø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 Borger Borgers login er succesfuldt og trediepart (kundesystem) er kendt i DFDG fås Token med tilbage til trediepartsystem trediepartsystemet (kundesystemkundesystemet) 

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 når , at borger ønsker at upload hente sit CV til trediepart (kundesystem).

Før trediepart (kundesystem) kan hente et CV, skal følgende være opfyldt:

• Trediepart (kundesystem) skal har 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 gyldighedsperiodengyldighedsperiode

Konteksten (tokentypen) vil i denne sammenghæng sammenhæng være "Hent CV"

Gyldighedsperioden vil for at hente CV oplysninger vil være en periode på (fx) 24 timer. Dvs. trediepart (kundesystem) kan kun hente CV oplysninger i en 24 timers timers periode efter token er udstedt. Bemærk: Kun CV oplysninger der er tilgængelige for trediepart medtages Ø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 STAR og XXXXXX personteamchef 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å  XXXXXX72217560, men processen startes først, når der sendes en mail på XXXXXDUG@star teamchef Kirsten Vestergaard på e-mail kiv@star.dk. I  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 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) får besked om, at give den nye kunde adgang til relevant web-service test-miljø. 

...

Trediepart (kunden) går i gang

Den nye terdiepart trediepart (kunde) udvikler herefter det software, der skal ende med, at de kan udveksle data med CV webservicerwebservice. 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 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 skal godkendes af STAR XXXX Dorthe Uglebjerg. Hvis det fravælges at betale for yderligere support, faktureres denne support mellem faktureres mellem den nye kunde og web-service supporten (systemforvalter) og er Styrelsen for Arbejdsmarked og Rekruttering ( STAR ) uvedkommende.

Testmiljø og

...

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.

...

test

STAR stiller testmiljø til rådighed og har nedestående forslag til testcase.

Testcase

1. Trediepart (kunden) oprettes opretter et test NemID på en testbruger hos NemID
2. Dette test NemID anvendes af Trediepart trediepart (kunden) til  til at logge ind på Jobnet på det aftalte testmiljø.
3. På Jobnet oprettes Trediepart opretter trediepart (kunden) et  et CV med alle de ønskede oplysninger. Bemærk CVCV'et behøver ikke at være søgbart, for at det kan hentes
4. Når CV'et er oprettet går Trediepart går trediepart (kunden) på eget system og aktiverer sin funktion til at hent hente CV
5. På Jobnet Jobnets dedikerede side til at hente en token logge Trediepart , logger trediepart (kunden) ind med test NemID , og token modtages herefter
6. Med Token token hentes test borgers CV oplysninger af Trediepart af trediepart (kunden)
7. Trediepart (kunden) verificerer nu af , at de forventede CV oplysninger modtageser modtaget

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 kundeNå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.

...