980.2 JobAD klargøres til KSS og a-kassesystemer
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
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.3 | Der er lavet dokumentation til KSS og a-kasser vedrørende udvidede muligheder for jobannoncer i forhold til øvrige systemers anvendelse af JobAD | JobAD, KSS, a-kasser |
980.2.10 | LastModified 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) | X | X | X | X | ||
A-kasse leverandører udvikler jobannoncefunktionalitet til a-kasser baseret på JobAD (version 3) | X | X | X | 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 JobAD | Ny | JobAD (version 3) kan anvendes til at a-kasser kan oprette jobannoncer med samme indhold som a-kasserne kan i Jobkon. Denne anvendelse af JobAD dokumenteres | A-kasse | SF | VirkSag |
Dokumentation til KSS vedr. jobannoncer til jobcentre med JobAD | Ny | JobAD (version 3) kan anvendes til at jobcentre kan oprette jobannoncer med samme indhold som jobcentrene kan i Jobkon. Denne anvendelse af JobAD dokumenteres | KSS | SF | VirkSag |
JobAD(version 3).alle - Rolle for a-akasser er tilgængelig for a-kasseleverandører | Ændret | Den eksisterende rolle 5, som Jobkon i dag anvender til a-kasser, er tilgængelig for a-kasseleverandører. Ingen egentlige snitfladeændringer | A-kasse | SF | VirkSag |
JobAD(version 3).alle - Rolle for jobcentre er tilgængelig for KSS'er | Ændret | Den eksisterende rolle 1, som Jobkon i dag anvender til jobcentre, er tilgængelig for KSS'er. Ingen egentlige snitfladeændringer | KSS | SF | VirkSag |
JobAD(version 3).SearchJobWithLastModifiedDate | Ny | Ny metode på JobAD(version 3), som svarer til den eksisterende SearchJob, men med nye kriterie for interval for LastModifiedDate. Efter ønske fra KSS | A-kasse, KSS | N/A | VirkSag |
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor
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.