980.2 JobAD klargøres til KSS og a-kassesystemer

Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning


STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader
Camilla Hagedorn TrolleBjarne Hansen (Edora)2021-31.0KSS, a-kasser




key po fa ux sme eksterne snitflader interne snitflader status labels
Loading...
Refresh

VIR-1102 - Getting issue details... STATUS


Indholdsfortegnelse




Afgrænsning af epic

Afgrænsning

Som en KSS eller a-kasse system

vil jeg kunne oprette flere typer jobannoncer, herunder anonyme jobannoncer

fordi Jobkon udfases

Acceptkriterier



Nr.

Beskrivelse

Relevant for

980.2.1

JobAD tillader at KSS'er og a-kasse systemer kan oprette samme typer jobannoncer, som Jobkon kan i dag

JobAD, KSS, a-kasser

980.2.2

JobAD validerer indhold i jobannoncer, som i dag kun kan oprettes af Jobkon

JobAD, KSS, a-kasser

980.2.3Der er lavet dokumentation til KSS og a-kasser vedrørende udvidede muligheder for jobannoncer i forhold til øvrige systemers anvendelse af JobADJobAD, KSS, a-kasser
980.2.10LastModified Date i søgekriterie og resultat (ønske fra KMD)JobAD, KSS, a-kasser

Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader

Berørte acceptkriterier

Bemærkninger


Acceptkriterie 980.2.1

Acceptkriterie 980.2.2

Acceptkriterie 980.2.3

Acceptkriterie 980.2.4

Acceptkriterie 980.2.5


KSS udvikler jobannoncefunktionalitet til jobcentre baseret på JobAD (version 3)XXX
X
A-kasse leverandører udvikler jobannoncefunktionalitet til a-kasser baseret på JobAD (version 3)XXX
X

Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne

Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår af tabellen.

Summary
Varslingstype
Varslingsnote
Eksterne Snitflader
Interne Snitflader
Project
Dokumentation til a-kasseleverandører vedr. jobannoncer til a-kasser med JobADNyJobAD (version 3) kan anvendes til at a-kasser kan oprette jobannoncer med samme indhold som a-kasserne kan i Jobkon. Denne anvendelse af JobAD dokumenteresA-kasseSFVirkSag
Dokumentation til KSS vedr. jobannoncer til jobcentre med JobADNyJobAD (version 3) kan anvendes til at jobcentre kan oprette jobannoncer med samme indhold som jobcentrene kan i Jobkon. Denne anvendelse af JobAD dokumenteresKSSSFVirkSag
JobAD(version 3).alle - Rolle for a-akasser er tilgængelig for a-kasseleverandørerÆndretDen eksisterende rolle 5, som Jobkon i dag anvender til a-kasser, er tilgængelig for a-kasseleverandører. Ingen egentlige snitfladeændringerA-kasseSFVirkSag
JobAD(version 3).alle - Rolle for jobcentre er tilgængelig for KSS'erÆndretDen eksisterende rolle 1, som Jobkon i dag anvender til jobcentre, er tilgængelig for KSS'er. Ingen egentlige snitfladeændringerKSSSFVirkSag
JobAD(version 3).SearchJobWithLastModifiedDateNyNy metode på JobAD(version 3), som svarer til den eksisterende SearchJob, men med nye kriterie for interval for LastModifiedDate. Efter ønske fra KSSA-kasse, KSSN/AVirkSag

Automatisk oversigt

Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor

summary varslingstype varslingsnote eksterne snitflader interne snitflader project
Loading...
Refresh

Beskrivelse af epic

KSS'er og a-kasser skal implementere jobannoncer med samme muligheder som JobKon kan i dag, idet jobannoncer udfases fra JobKon. JobKon anvender i dag JobAD webservicen til indberette, vedligeholde og søge jobannoncer. JobAD er tilgængelig for eksterne aftagere, men de særlige roller, som JobKon anvender til udvidede jobannoncer , bliver ikke validerede tilstrækkeligt af JobAD til at de kan åbnes for KSS'er og a-kasser. Denne epic handler om at gøre JobAD webservicen tilstrækkelig robust til at de eksisterende roller kan anvendes af KSS'er og a-kasser.

Dette dokument beskriver migration fra JobKon til KSS'er og a-kasser:

Note: STAR (landssupporten) kan ikke længere lave visse jobannoncetyper for virksomheder, når Jobkon udfases. LSS udbygges med funktionalitet til jobannoncer for STAR (landssupporten).

980.2.1 JobAD tillader at KSS'er og a-kasse systemer kan oprette samme typer jobannoncer, som Jobkon kan i dag

Jobkons eksisterende roller i JobAD åbnes for at KSS'er og a-kasser kan anvende rollen. Det omfatter følgende roller:

1: Jobcenter

5: UnemplymentFond

Jf. /wiki/spaces/CITY/pages/77468540 (internt link).

Systemforvalter skal kunne oprette brugerkonti til hhv. KSS og a-kasser baseret på disse roller. Systemforvalter opretter i dag brugerkonti for eksterne virksomheder og det er samme proces, der skal gennemføres, blot en andre roller. JobADs sikkerhedsmodel med userid/password anvendes forsat. 

KSS og a-kasser kan allerede nu (2021-2) anvende disse roller i testmiljøerne efter aftale med SF. Snitfladen er eksisterende, men der vil blive implementeret ekstra valideringer jf. 980.2.2. Dokumentation:

JobAdService (Version 3, 2021-2)

980.2.2 JobAD validerer indhold i jobannoncer, som i dag kun kan oprettes af Jobkon

JobAD har i dag ikke komplet validering af de jobannoncetyper, som kun kan oprettes af Jobkon. JobADs validering skal udbygges, da der fremadrettet ikke er tale om en intern applikation.

980.2.3 Der er lavet dokumentation til KSS og a-kasser vedrørende udvidede muligheder for jobannoncer i forhold til øvrige systemers anvendelse af JobAD

KSS'ernes og a-kassernes muligheder dokumenteres på en underside til den generelle anvendelse af JobAD. Den generelle anvendelse af JobAD er dokumenteret her:

JobAdService [Erstattes ifm release 2023-3 af ny JobAnnonceService]

Den supplerende dokumentation skal beskrive hvordan de ekstra muligheder i JobAD for hhv. KSS'er og a-kasser kan og skal anvendes.

Den generelle dokumenation af anvendelse af JobAD er forbedret. Alle felter er nu dokumenterede, og der er udarbejdet en side, som dokumenterer mapning fra JobAD til præsentation af jobannoncer på Jobnet:

Integrationsvejledning til JobAD webservice - Mapning fra JobAD til jobannoncer vist på Jobnet

Jobcentre - KSS

Jobcentrene har særlige rettigheder til at oprette jobannoncer. KSS'ernes anvendelse af disse muligheder er dokumenteret på en underside til den generelle integrationsvejledning:

Integrationsvejledning til JobAD webservice for leverandører til jobcentre

Vejledningen har en underside, der beskriver mapning fra Jobkon til JobAD:

Integrationsvejledning til JobAD webservice - Mapning fra Jobkon til JobAD

A-kasser

A-kasser har ikke særlige forretningsregler og kan derfor uændret anvende samme integrationsvejledning som øvrige eksterne:

Integrationsvejledning til JobAD webservice

A-kasserne kan have glæde af beskrivelsen af mapning fra Jobkon til JobAD:

Integrationsvejledning til JobAD webservice - Mapning fra Jobkon til JobAD

980.2.10 LastModified Date i søgekriterie og resultat (ønske fra KMD)

Fra Kenneth Midtgaard ved tilsagn på epic 980.3: 

"17.02.2021: Vi benytter endnu ikke denne service. men planlægger at gøre det efter at nedestående er blevet opfyldt.

Vi har et stor behov for at SearchParameters udvides med:
LastModifiedFrom
LastModifiedTo
Og at SearchResult udvides med:
LastModifiedDate.

Begge ændringer vil minimere resourcetrækket på servicen. Pt. er man nødt til at både udsøge alt og derefter kalde de enkelte annoncer for at se om de er ændret siden man senest læste på dem."


Opdatering 2021-06-11 (Bjarne Hansen):

Denne er ikke relevant, da det under implementering blev konstateret, at funktionalitet allerede findes. De eksisterende “Created” felter ved søgning er IKKE oprettelsestidspunkt, men tidspunkt for seneste opdatering af jobannoncen. Det er en uhensigtsmæssighed i den eksisterende navngivning af felter i JobAD, som ikke kan rettes i version 3. Den misvisende navngivning skyldes formentlig, at tidspunktet for publicerede jobannoncer repræsenterer hvornår jobannoncen blev publiceret på Jobnet med det aktuelle indhold. Vi beskriver derfor dette i dokumentationen af felterne. Dvs: 

SearchParameters

Element

Type

Detaljer

Forekomst

Beskrivelse

SearchParameters

SearchParameters


1



- CreatedFrom

DateTime


0-1

Start date of search window.

Bemærk: Der søges på seneste ændringsdato på jobannoncen.

- CreatedTo

DateTime


0-1

End date of search window.

Bemærk: Der søges på seneste ændringsdato på jobannoncen.

SearchResult

Element

Type

Detaljer

Forekomst

Beskrivelse

SearchResult

SearchResult


1


- Created

DateTime


1

The date the the ad was created in Jobnet.

Bemærk: Feltet repræsenterer seneste ændringsdato på jobannoncen.

Særlige krav til test

Ingen særlige krav til test.

Konsekvenser for drift/idriftsættelse

Ingen særlige krav for drift/idriftsættelse.

Arkitektur- og implementeringsnoter 

Det er afklaret med STARs arkitekter, at JobAD forsætter med den nuværende sikkerhedsmodel, samt at KSS'er og a-kasser skal anvende JobADs sikkerhedsmodel ved integration, selv om den er forskellig fra STAR's sikkerhedsmodel, som KSS'er og a-kasser normalt anvender.