SIDERNE VIL LØBENDE BLIVER OPDATERET AF STAR!

Denne side henvender sig til de eksterne aftagere som fra 7/12-2024 skal benytte den nye JobannonceService version 2, såfremt man som aftager ønsker/skal udstille sine jobannoncer på Jobnet ifm. release 2024-4. Alle eksterne aftager skal bruge den nye version i stedet for JobAnnonceService version 1.

På denne velkomstside kan man finde oplysninger om:

1. Formål med opgraderingBaggrund for ny JobannonceService til erstatning af JobAd Service | JobAnnonceService version 2: En mere tidssvarende jobannonce i nyt domæne

2. Væsentlige ændringer i forhold til JobAnnonceService version 1

3. JobAnnonceService version 2 væsentligste ændringer, se Væsentlige ændringer i JobannonceService (version 2)

4. Hjælp til:

   1. Tilpasning af gammel jobannonceservice til ny (Figma-filer: samt Swagger-kontrakter)

   2. Formidling til brugerne, som vil opleve at deres jobannoncer “forsvinder” ifm. release

   3. Hvordan man kan få bistand fra STAR SPOC ifm. test Roadmap

5. Køreplan

6. Tilslutningsaftaler - fornyelse

7. Spørgsmål og Svar (fra orienteringsmøder med eksterne aftager den 3/4 (dansk) og 5/4 (English) samt KSS og AKS møder), se Spørgsmål og Svar til JobAnnonceService V 2

NB: I forbindelse med release af JobAnnonceService version 2 den 7/12-2024 vil JobAnnonce-databasen blive nulstillet, og alle jobannoncer, som har være publiceret på Jobnet, og som de eksterne aftagere fortsat ønsker, at jobansøgere skal kunne tilgå - genpublicere jobannoncen, ved at genindsende jobannoncen ved brug af JobAnnonceService version 2.

På siden kan man holde sig opdateret med udmeldinger fra STAR, få vejledning til hvordan man som ekstern aftager bl.a. skal forholde sig til nulstilling af JobAnnoncedatabasen, hvis man har lokale datasæt og hjælper sine kunder/brugere.

Jobcentrenes og a-kassernes fagsystemer kan finde samme form for information i Confluence: 1005.17.40.4 JobAD modernisering - Plateau 4

De eksterne aftagere kan se hvordan STAR formidler til virksomhederne omkring nulstilling af JobAnnonceServicen her: https://star.dk/media/jjfdpjgc/2024_10_08_jobag_2024-3r01.pdf

Versionshistorik af betydning for eksterne

Anvendes ved ændringer, der har betydning for eksterne.

Relevante datoer og actions for aftagere af JobannonceService

Yderligere oplysninger

Påvirkning

Procedure for adgang til Test- og Produktionsmiljøer

Før I kan få adgang til STARs produktionsmiljø, skal jeres integration først godkendes i STARs testmiljø. Dette inkluderer validering af jeres webservice kald, samt validering af at I følger STARs sikkerhedsmodel.

Testmiljø

I forbindelse med test mod STARs testmiljøer vil aftagere skulle benytte sig af et testcertifikat i kald til service/servicemetoder. Placering af miljø og hvilket testmiljø, der skal benyttes, vil blive opdateret løbende her på siden / underliggende sider i takt med, at servicemetoderne bliver tilgængelige).

Aftager vil få fremsendt et testcertifikat af STARs systemforvalter i tilfælde af, at man som aftager ikke kan få udstedt et test OCES3 organisations certifikat eller OCES3 system certifikat (se mere herom på undersiden) Procedure for tilslutning: Adgang til testmiljø .

Produktion

Certifikat

I forbindelse med tilgang til STARs webservice/webservicemetoder på jobannonceområdet i Produktion flyttes (fra d. 16-09-2023), vil aftagere skulle benytte sig af et OCES3 organisations certifikat eller OCES3 system certifikat for at tilgå den nye JobannonceService. I den forbindelse er det vigtigt, at certifikatet navngives med CVR-nr+Virksomheds navn+Systemnavn.

I tilfælde af at man er leverandør af et system/applikation til flere kunder, der skal benytte JobannonceService, er det kun påkrævet af have et OCES3 organisations certifikat eller OCES3 system certifikat - men tilladt at have et pr. kunde.

Procedure for tilslutning: Adgang til produktionsmiljø

Support

For support skal I sende en email til systemforvaltning@star.dk, så jeres forespørgsel bliver oprettet i STARs sagsbehandlingssystem.

Ved spørgsmål vedrørende fejlbeskeder og andre problemer med kald til webservices skal STAR i forbindelse med fejlsøgning for det fejlende kald bruge:

• Fuldt request vedhæftet.

• Fuld response vedhæftet.

• Navn på certifikatet brugt til at kalde webservicen.

Funktionscertifikat og adgang

Adgang til webservices i testmiljøerne kræver:

• Whitelisting af anvendte IP adresser.

• Oprettelse af funktionscertifikat.

Test

Whitelist af IP adresser vil blive oprettet som en del af jeres onboarding i systemet. Hvis der skal ændres i jeres whitelistede IP adresser skal I oprette en support sag.

Alle kald til webservices skal valideres med funktionscertifikatet. Som beskrevet i Procedure for tilslutning: Adgang til testmiljø | 2. Adgang til testmiljø kan funktionscertifikat til testmiljø blive oprettet af STARs Systemforvaltning eller I kan oprette jeres eget. I begge tilfælde vil Systemforvaltningen give certifikatet de nødvendige rettigheder til at tilgå webservices for jeres CVR koder.

Hvis I selv opretter et certifikat skal det have navnestandarden “Test + Virksomhedens navn + CVR-nr”, fx “Test Star 55568510”, som beskrevet under Procedure for tilslutning: Adgang til testmiljø | 2. Adgang til testmiljø . Certifikatets navn må højest være på 50 karakterer.

Ved adgang til produktionsmiljøet skal I selv udstede OCES3 organisations- eller systemcertifikat, jvf. Procedure for tilslutning: Adgang til produktionsmiljø | Aftager bliver efter gennemført test orienteret om:. Bemærk: Certifikatet I udsteder skal følge navnstandarden “Virksomhedens navn + CVR-nr”, fx “Star 55568510”, og må højest være på 50 karakterer.

Ved installation skal jeres funktionscertifikat placeres i “local machine/personal store” og jeres CA certifikat skal installeres i Trusted Root Certification Authority.

Se desuden Startpakke tilslutning til DFDG | Testcertifikat.

Produktion

Efter godkendt test skal I følge Procedure for tilslutning: Adgang til produktionsmiljø, for at få adgang til produktionsmiljøet.

JobannonceService Guide

I kan finde guide specifikt til JobannonceService i JobannonceService version 2 - Guide, som beskriver de forskellige muligheder for at tilgå systemet. Der findes i alt 4 modeller i skrivende stund (juli 2024).

Tilgangen til systemet sker på baggrund af, hvilke og hvor mange CVR numre, man ønsker adgang til. Siden indeholder eksempler på brugen af disse forskellige modeller samt brugen af disse med Postman.

I kan også finde en guide til fejlhåndtering ved at følge dette link: Fejlhåndtering

Kontroller indsendte jobannoncer

Al test af JobannonceService v2 foregår pt. på STARs T4 testmiljø, som har STARs Release 2024-3 kode installeret.

Frem til STARs Release 2024-4 kode installeres på T4 testmiljøet kan jobannoncer kun kontrolleres ved at bruge Virksomhedsindsats.JobannonceService (Version 2, 2024-3) | GetJobannonce (GET /v2/Jobannonce/{id}) på GUID som I modtager når I opretter et jobannonce.

Efter STARs release 2024-4 kode installeres på T4 testmiljøet, forventet enten i slutningen af september 2024 eller starten af oktober 2024, kan jobannoncer også findes via https://jobt4.jobnettest.dk/CV.

Denne dokumentation bliver opdateret når STARs release 2024-4 kode er tilgængelig på T4 testmiljøet.

Webservices

JobAnnonceService v2

JobAnnonceServicen v2 erstatter den tidligere JobannonceService v1.

Den fulde dokumentation over JobAnnonceService v2 kan findes på siden Virksomhedsindsats.JobannonceService (Version 2, 2024-3)

En liste over alle webservices samt eksempler på dem kan findes på siden

Brug af eksempler fra Postman (version 2)

Test

JobAnnonceService v2 kan tilgås via følgende swagger endpoints i test.

• https://virksomhedsindsatst4.startest.dk/swagger/index.html?urls.primaryName=Jobannonce V2

• https://virksomhedsindsatst4.startest.dk/swagger/index.html

Og I skal bruge dette URL som jeres [API Url], som angivet i dokumentationen:

• https://virksomhedsindsatst4.startest.dk

Produktion

JobAnnonceService v2 kan tilgås via følgende Swagger endpoint i produktion fra release 2024-4 d. 7. december

• https://virksomhedsindsats.bm.dk/swagger/index.html?urls.primaryName=Jobannonce%20V2

• https://virksomhedsindsats.bm.dk/swagger/index.html

Og I skal bruge dette URL som jeres [API Url], som angivet i dokumentationen:

• https://virksomhedsindsats.bm.dk

EscoStar Service

EscoStar servicen kan bruges til at hente stillingsbetegnelser til brug i jeres jobannoncer.

Denne service kræver, at I benytter samme certifikat, som I bruger til at kalde JobannonceService.

Se Taxonomy.EscoStarService for fuld dokumentation, og Anvendelse af ESCO-STAR klassifikation til jobannoncer.

Se desuden EscoStar Service eksempler.

Test

EscoStar service kan tilgås via følgende endpoints i test.

• https://taxonomyt4.startest.dk/swagger/index.html

• https://taxonomyt4.startest.dk/v2/EscoStar/occupations

• https://taxonomyt4.startest.dk/v2/EscoStar/occupations/discoAms08ConceptUriMappings

Produktion

EscoStar service kan tilgås via følgende endpoints i produktion:

• https://taxonomy.bm.dk/swagger/index.html

• https://taxonomy.bm.dk/v2/EscoStar/occupations

• https://taxonomy.bm.dk/v2/EscoStar/occupations/discoAms08ConceptUriMappings