Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
Indholdsfortegnelse
Afgrænsning af epic
Afgrænsning | ||
---|---|---|
Som en bruger af Krav til jobsøgning vil jeg skifte fra DISCOAMS koder til ESCO-STAR koder for at understøtte ESCO-STAR | ||
Acceptkriterier | ||
Nr. | Beskrivelse | Relevant for |
976.9.1 | Som STAR/A-kasse/Jobcenter vil jeg have datamodel udvidet og data konverteret fra DISCOAMS til ESCO-STAR ud fra konverteringmapning. | DFDG |
976.9.2 | Som STAR og eksterne service aftager vil jeg have en ny version af JobSearchDefinitionService, der understøtter ESCO-STAR i stedet for DISCOAMS bl.a. for jeg kan komme hurtigt i gang med min afledte udvikling | DFDG |
976.9.3 | Som borger og STAR vil jeg have brugergrænseflader (Jobnet) understøtter ESCO-STAR i stedet for DISCOAMS | Jobnet |
976.9.4 | Som VOA og BI vil jeg have tilpasset min dataleverance til at inkluderer ESCO-STAR | BI |
976.9.5 | Som STAR vil jeg have, at LSS understøtter ESCO-STAR i stedet for DISCOAMS | DFDG (LSS) |
976.9.6 | Som STAR vil jeg have, at LatestJobSearchDefinitionInfo i PersonStatusService (version 20) returnerer et tomt resultat. | DFDG |
Intern STAR kommentar: Acceptkriterie 976.11.4, 976.11.5 og 976.11.7 er på tværs af flere epic og skal løsningsmæssigt samtænkes.
Bemærk der er ikke ændring i forbindelse med Joblog og denne del er derfor taget ud.
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
976.9.2 | 976.9.6 | ||||
KSS og a-kasser ibrugtager i 2020-3 nye versioner af webservices med ESCO-STAR | X | ||||
Som KSS/a-kasse vil jeg gerne have en tidlig (pre. at det det skal anvendes i prod) ny version af JobSearchDefinitionService (v3) på testmiljøer så jeg tidligt kan gå i gang med mine lokale til rettelser | X | DFDG laver dette priomo 21-3 release | |||
Hvis jeg som a-kasse har en lokal kopi af krav til jobsøgningsdata i mit fagsystem vil jeg har disse konvertering | X | ||||
KSS og a-kasser er opmærksomme på, at krav til jobsøgning ikke længere udstilles i PersonStatusService. I stedet anvendes Get-metode i JobSearchDefinitionService | 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 i tabellen.
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
---|---|---|---|---|---|
CodeListService (Version 5).GetTaxonomiOccupation | Udgået | Collection LatestJobSearchDefinition gøres tom, | A-kasse, KSS | Jobnet | D+S |
CodeListService (Version 5).TradeForJobSearchTypeIdentifier | Ændret | Ny kodelisteværdi i for ESCO STAR | A-kasse, KSS | Jobnet | D+S |
ESCOSTARService (Version 1).GetOccupations | Ny | Ny metoder til at hente ESCO STAR stillingsbetegnelser | A-kasse, KSS | Jobnet | D+S |
JobSearchDefinitionService (Version 1).Alle | Udgået | Serviceversion udgår i 2021-3 til fordel for version 3 | A-kasse | Jobnet | D+S |
JobSearchDefinitionService (Version 2).Alle | Udgået | Serviceversion udgår i 2021-3 til fordel for version 3 | A-kasse, KSS | Jobnet | D+S |
JobSearchDefinitionService (Version 3).DeleteJobSearchDefinition | Ændret | Metoder rette til således at ESCO STAR anvendes | A-kasse, KSS | Jobnet | D+S |
JobSearchDefinitionService (Version 3).GetJobSearchDefinitions | Ændret | Metoder rette til således at ESCO STAR anvendes | A-kasse, KSS | Jobnet | D+S |
JobSearchDefinitionService (Version 3).GetJobSearchDefinition | Ændret | Metoder rette til således at ESCO STAR anvendes | A-kasse, KSS | Jobnet | D+S |
PersonStatusService (Version 20).GetVariablePersonStatus | Ændret | Collection LatestJobSearchDefinition gøres tom, | A-kasse, KSS | Jobnet | D+S |
Automatisk oversigt
Ikke synlig for eksterne. Indhold er kopieret til den manuelle oversigt ovenfor.
Beskrivelse af epic
Beskrivelse til KSS og a-kasser
Stillingsbetegnelser fra ESCO STAR information til KSS og a-kasser og andre interessenter
Som en del af denne epic og grundlaget for de nye ESCO STAR stillingsbetengelser anvendes servicen og metoder der udstilller selve taxonomien for ESCO STAR.
For en mere detaljeret oversigt over disse service og metoder henvises til:
Taxonomy.EscoStarService (2021-1)
Der indeholder ESCO STAR stilllingsbetegnelser og alias på metoderne:
GetOccupation (GET /v1/EscoStar/occupations/{conceptUri})
GetOccupations (GET /v1/EscoStar/occupations)
Der indeholder mapningen fra de gamle DiscoAMS stillingsbetegnelser til de nye ESCO STAR stillingsbetegnelser i metoderne:
GetDiscoAms08ConceptUriMapping (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings/{discoAms08Id})
GetDiscoAms08ConceptUriMappings (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings)
Stillingstagen for, hvorvidt stillingsbetegnelsen kan benyttes
Hvis stillingsbetegnelse har en IscoGroup defineret er det en stillingsbetegnelse.
Til information: Stillingsbetegnelser i hierarkiet er i niveau fem eller under.
Hvis stillingsbetegnelse er Aktiv og validFrom og validTo, er indenfor tidspunktet registreringen omhandler, kan denne benyttes.
Taxonomy.CodeListsService
De kodelister og deres værdi der anvendes i forbindelse med ESCO STAR kan findes under Taxonomy.CodeListsService
Det skal bemærkes at der i forbindelse med releasen til 2021-2 sker en forretningsmæssig opdatering og:
Taksonomien tilrettes uden ændringer af grænseflader.
Nye, fravalgte og ændrede stillingsbetegnelser.
Nye, fravalgte og ændrede aliaser.
Kommentar til servicesændringer
Service | Version | Metode | Element | Beskrivelse | Bemærkning |
---|---|---|---|---|---|
CodeListService | 5 | GetTaxonomiOccupation | Udgår | Erstattes af en ny kodeliste fra Silo GetOccupations | |
JobSearchDefinitionService | 3 | CreateJobSearchDefinition | Omlægges til ESCO-STAR (DiscoAMS08) | Fagområde defineret ud fra DiscoAms08-kode. | Det skal afklares med STAR hvordan fagområde håndteres |
Omlægges til ESCO-STAR (DiscoAMS08CodeLevel) | Stillingsbetegnelse – niveau | Det skal afklares med STAR hvordan niveau håndteres | |||
Omlægges til ESCO-STAR (DiscoAMS08Code) | Stillingsbetegnelse | ||||
ErrorCode 8248 | A minimum of at least 1 Disco code is required | Opdateres | |||
ErrorCode 8281 | Occupation key does not exist | Opdateres | |||
ErrorCode 8282 | Occupation key is out of date | Opdateres | |||
DeleteJobSearchDefinition | ErrorCode 8281 | Occupation key does not exist | Opdateres | ||
ErrorCode 8282 | Occupation key is out of date | Opdateres | |||
GetJobSearchDefinition | Omlægges til ESCO-STAR (DiscoAMS08Collection) | Liste af DiscoAms08-koder. | |||
Omlægges til ESCO-STAR (DiscoAMS08) | Fagområde defineret ud fra DiscoAms08-kode. | Det skal afklares med STAR hvordan fagområde håndteres | |||
Omlægges til ESCO-STAR (DiscoAMS08CodeLevel) | Stillingsbetegnelse – niveau | Det skal afklares med STAR hvordan niveau håndteres | |||
Omlægges til ESCO-STAR (DiscoAMS08Code) | Stillingsbetegnelse | ||||
Omlægges til ESCO-STAR (DiscoAMS08CodeDe scription) | Stillingsbeskrivelser. | ||||
ErrorCode 8281 | Occupation key does not exist | Opdateres | |||
ErrorCode 8282 | Occupation key is out of date | Opdateres | |||
GetJobSearchDefinitions | Omlægges til ESCO-STAR (DiscoAMS08Collection) | Liste af DiscoAms08-koder. | |||
Omlægges til ESCO-STAR (DiscoAMS08) | Fagområde defineret ud fra DiscoAms08-kode. | Det skal afklares med STAR hvordan fagområde håndteres | |||
Omlægges til ESCO-STAR (DiscoAMS08CodeLevel) | Stillingsbetegnelse – niveau | Det skal afklares med STAR hvordan niveau håndteres | |||
Omlægges til ESCO-STAR (DiscoAMS08Code) | DiscoAms08-kode. | ||||
Omlægges til ESCO-STAR (DiscoAMS08CodeDescription) | Stillingsbeskrivelser. | ||||
ErrorCode 8281 | Occupation key does not exist | Opdateres | |||
ErrorCode 8282 | Occupation key is out of date | Opdateres | |||
PersonStatusService | 20 | GetVariablePersonStatus | Omlægges til ESCO-STAR (DiscoAMS08Collection) | Under TradeForJobSearch Hvad skal borgeren søge arbejde som | |
Omlægges til ESCO-STAR (DiscoAMS08Type) | |||||
Omlægges til ESCO-STAR (DiscoAMS08Level) | |||||
Omlægges til ESCO-STAR (DiscoAMS08Identifier) | |||||
WsrmMessageService | 10 | GetJobSearchDefinitionEventVersion1 | Ingen ændringer Det er allerede en tynd WSRM. |
Særtilfælde vedrørende Krav til Jobsøgning og ESCO STAR
I forbindelsen med jobmål og krav til jobsøgning kan der være nogle tilfælde, hvor DFDG ikke har registreret stillingsbetegnelser i jobmål og krav for en borger. I et sådan tilfælde vil DFDG i konverteringen sætte en fiktiv ESCO STAR kode "Stillingen er ikke aktiv længer, vælg en ny"*. Denne ESCO STAR stillingsbetegnelse er ikke aktiv og ikke knyttet til andre stillingsbetegnelser eller ISCO grupper i hierarkiet. Denne specielle ESCO STAR kode vil kun blive sat af STAR, men aftageren skal kunne vise den for sagsbehandlere i Jobcentre og A-kasser.
02.07.2021
*Bemærk STAR har nu set på navngivning og anvendelse af ESCO STAR kode "Stillingen er ikke aktiv længer, vælg en ny" i forbindelse med 2021-3, og navngivningen ændres til ”Stillingsbetegnelsen er udgået”.
976.9.1 Som STAR/A-kasse/Jobcenter vil jeg have datamodel udvidet og data konverteret fra DISCOAMS til ESCO-STAR ud fra konverteringmapning
Database inkl. konvertering omlægges efter model beskrevet under ESCO STAR datamodel og snitflade principper.
Håndtering af eksisterende krav til jobsøgning data.
- Der konverteres lokalt dvs. i DFDG og lokalt i a-kassen (og i KSS). Der sendes ikke WSRM fra DFDG på disse konverteringer
- Der findes krav, der er registreret fra DiscoAMS niveau 1 og 2. Disse udgår og a-kassen skal derfor selv være opmærksom på, at jobkonsulenterne bliver opmærksom på de skal ind og registrere nye krav
STAR beskriver her hvordan en DiscoAMS kode på niveau 1 og 2 kan identificeres
Konvertering af lokal kopi af Krav til jobsøgning hos KSS og a-kasse
I forbindelse med konvertering af data i egne fagsystemer hos KSS og a-kasser, følges den samme konverteringsmodel på alle dataområder.
Da STAR ikke har kendskab til implementering og hvorvidt der er data i de lokale fagssystemer, der behøver at blive konverteret, sker identifikationen at et sådan behov hos KSS og a-kasser selv og konverteringen sker separat i de forskellige systemer, dog koordineret igennem STAR systemforvaltning.
Konverteringen skal sker på følgende måde:
- I DFDG's data vha. af et internt DFDG konverteringsscript lavet af BI, der i forbindelse med releasen konverterer alle DiscoAMS stillingsbetegnelser til ESCO STAR stillingsbetegnelser. Konverteringen gælde både aktuelle data og alle historiske data. Der sendes ikke WSRM på disse konverteringer fra DFDG. DFDG's konvertering baserer sig på mapningen der fåes i /wiki/spaces/GI/pages/2352480306.GetDiscoAms08ConceptUriMappings (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings)
- I eget lokalt fagsystem hos KSS eller a-kasse sker konverteringen efter egen model og grundlaget for konverteringen fås ved hjælp af service og metoden /wiki/spaces/GI/pages/2352480306.GetDiscoAms08ConceptUriMappings (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings)
Begge konverteringer bruger dermed det samme konverteringsgrundlag i form af /wiki/spaces/GI/pages/2352480306.GetDiscoAms08ConceptUriMappings (GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings), der er den autoritative kilde til mapning fra DiscoAMS til ESCO STAR. Konverteringen koordineres i forhold til produktion til at sker på release aften.
I forhold til udvikling og test er det op til KSS og a-kasse, hvornår der laves konvertering i eget test fagsystem. Dog med forudsætning om at en konvertering sker i forbindelse med at servicesversionen, der anvender ESCO STAR samtidigt tages i brug, i denne epic JobSearchDefinitionService (Version 3).
I DFDG sker konverteringen i forhold til testmiljøer i forbindelse med udviklingen af de nye versioner af servicesnitflader. Der vil derfor være testdata til rådighed på de nye serviceversioner umiddelbart i forlængelse at bliver færdiggjort.
Til inspiration for KSS og a-kasse benytte DFDG modellen "Løsningsmodel for at tilføje ESCO STAR til DFDG database model og snitflader" i forbindelse med datamodel og konvertering.
I nogle forretningsmæssige situationer anvendes DiscoAMS på niveau 1 og 2 disse er ikke repræsenteret i ESCO STAR. Disse DiscoAMS koder skal mappes til ESCO STAR stillingen "Stillingen er ikke aktiv længer, vælg en ny". Der kan anvendes følgende reglen: "hvis der for en DiscoAMS kode ikke er en mapning til en ESCO STAR kode via mapningstabellen, mappes denne til ESCO STAR dummy stillingsbetegnelsen" Denne regel kan anvendes da der til alle lovlige DiscoAMS niveau 3 er en mapning til en ESCO STAR kode, det vil fanger alle niveau 1 og 2 samt har den sidegevinst at skulle der være hullet/fejl i data vil disse også blive håndteret.
976.9.2 Som STAR og eksterne service aftager vil jeg have en ny version af JobSearchDefinitionService, der understøtter ESCO-STAR i stedet for DISCOAMS bl.a. for at jeg kan komme hurtigt i gang med min afledte udvikling
Felter i eksisterende serviceversion omlægges efter model beskrevet under: ESCO STAR datamodel og snitflade principper.
Forretningsmæssig afklaring for alle metoder
- Det skal afklares med STAR, hvordan niveau og fagområde skal håndteres f.eks. hvilke niveauer i i ESCO STAR der må anvendes.
/wiki/spaces/GI/pages/2176680402(Version 1 og 2)
Version 1 og 2 udgår i 2021-3.
Hvis DFDG etablerer version 3 tidligere end 2021-3 (f.eks. i 2021-2) må version 3 indtil release 2021-3 kun bruges i testmiljøer. Version 3 må først bruges i produktionssammenhæng fra release 2021-3.
JobSearchDefinitionService (Version 3)
For metoderne:
- DeleteJobSearchDefinition
- GetJobSearchDefinition
- GetJobSearchDefinitions
gælder følgende:
- DiscoAMS08 felter udfases
- ConceptUriDa og AliasIdentifier indsættes
- Fejlkode navne opdateres
- Feltlængden for OtherExpectationsForJobSearch øges til 5000 tegn
se JobSearchDefinitionService (Version 3)
Vær opmærksom på, at der i forbindelse med forretningsafklaringen vedr. Faggruppe og Niveau kan ske ændringer eks. at felterne udgår.
/wiki/spaces/GI/pages/2767913133
TradeForJobSearch collection gøres tom.
Alternativt gøres objektet LatestJobSearchDefinitionInfo tomt.
/wiki/spaces/GI/pages/2767683645
GetJobSearchDefinitionEventVersion1
Beholdes uændret.
Beskeden indeholder ikke stillingsbetegnelser.
/wiki/spaces/GI/pages/2767913079
GetTaxonomiOccupation
Udgår til fordel for GetOccupations.
Identifikator | Navn | Beskrivelse | Startdato | Slutdato |
---|---|---|---|---|
1 | DiscoAms08 | Fagområdet er en DiscoAms08-kode | 28-04-2015 | 01-07-2100 |
2 | TradeDescription | Fagområdet er en fritekst | 28-04-2015 | 01-07-2100 |
3 | ESCO STAR | Fagområdet er en ESCO STARkode | 01-04-2021 | 01-07-2100 |
/wiki/spaces/GI/pages/2352185416
GetOccupations (GET /v1/EscoStar/occupations)
Ny metode til at hente ESCO STAR stillingsbetegnelser, erstatter CodeListService (Version 5).GetTaxonomiOccupation
976.9.3 Som borger og STAR vil jeg have brugergrænseflader (Jobnet) understøtter ESCO-STAR i stedet for DISCOAMS
Intern STAR acceptkriterium.
Jobnets GUI relaterede opgaver er løst i 976.14 Min plan mål, inkl udkast til Min plan, VITAS m.v.
976.9.4 Som VOA og BI vil jeg have tilpasset min dataleverance til at inkluderer ESCO-STAR
Intern STAR acceptkriterium.
Leverance til VOA tilpasses således at ESCO STAR stillingsbetegnelser medtages.
976.9.5 Som STAR vil jeg have LSS understøtter ESCO-STAR i stedet for DISCOAMS
Intern STAR acceptkriterium.
Kollektion i LSS der omhandler Krav til jobsøgning opdateres til at kalde den nye version af servicen.
NB. Oprettelse af Nyt krav til Jobsøgning vil ikke ændre serviceversion før release af 2020-2.
>>>>>>>>
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
* Batchjobs
- bør testes både med delta og fuldt load,
- bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden
- bør testes i samarbejde med teams som har afhængigheder
- kørselstid, særligt hvis det er en del af NightlyBatch
Konsekvenser for drift/idriftsættelse
I forbindelse med idriftsættelse:
- Skal der køres et fuldt dataload ved første kørsel af et batchjob - aftal med SF hvornår load skal køres Nej
- Skal der køres konvertering: Ja
BI laver en konverteruing fra DiscoAMS til ESCO STAR og konverteringen følger de tidligere modeller fra 2021-2. - Skal der køres databasescripts for opdatering af tabeller i databasen Ja
Efter idriftsættelse:
Arkitektur- og implementeringsnoter
Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:
- Nye dataområder Nej
- Nye snitflader Nej
- Nye komponenter Nej
- Nye miljøer Nej
- Nye teknologier Nej
- Nye aftagertyper Nej
- Eller afvigelser fra principperne Nej
- Eventuelle behov for reduktion af teknisk gæld skal afdækkes N/A
Der gives en beskrivelse af hvorledes disse tænkes håndteret/implementeret i løsningen og om dette har været vendt med STAR arkitekten.