976.15 Dash board
- Bjarne Hansen (Edora)
- Carsten Olsen
- Kenneth Ingemann Larsen (KEIL)
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
Læsevejledning til eksterne
I denne udgave er det alene relevant at KSS og a-kasser forholder sig til afsnittene
- Afgrænsning af epic, herunder Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader
- Oversigt over berørte webservices
Øvrige afsnit er endnu ikke relevante, at læse på nuværende tidspunkt, da de tekniske snitflader ift. ændring fra DISCOAMS til ESCOSTAR ikke er beskrevet.
Indholdsfortegnelse
Afgrænsning af epic
| Afgrænsning | ||
|---|---|---|
Som en bruger af Dashboard vil jeg skifte fra DISCOAMS koder til ESCO-STAR koder for at understøtte ESCO-STAR | ||
| Acceptkriterier | ||
| Nr. | Beskrivelse | Relevant for |
| 976.15.1 | Som DFDG vil jeg have dataleverencen i BI tilrettet til at anvende ESCO STAR i stedet for DISCOAMS | DFDG, BI |
| 976.15.2 | Data er konverterede fra DISCOAMS til ESCO-STAR med konverteringstabel | BI |
| 976.15.3 | Webservices understøtter ESCO-STAR i stedet for DISCOAMS | DFDG, Jobnet, JobAG |
| 976.15.4 | Brugergrænseflader understøtter ESCO-STAR i stedet for DISCOAMS | Jobnet, JobAG |
| Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
| 976.15.1 | 976.15.2 | 976.15.3 | 976.15.4 | ||
Hvis det er et ønske for aftagersystemer at tage de nye services i brug forud for 2020-2 skal aftagere bemærke at de skal kalde med ESCO-STAR fremfor DiscoAms. | X | ||||
| KSS og a-kasser overgår til serviceversioner med ESCO-STAR | X | Se berørte services nedenfor | |||
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 |
|---|---|---|---|---|---|
| BIDataService (v1).Alle | Udgået | Udgår i 2020-2 med henblik på at aftagere skal benytte sig af version 2 | A-kasse KSS | BI JobAG Jobnet | D+S |
| BIDataService (v2).Alle | Ny | Ny version af servicen. Udskiftning af DiscoAms til fordel for ESCO-STAR | N/A | BI JobAG Jobnet | D+S |
| BIDataService (v2).GetUnsolicitedCompanies | Ny | Ny version af servicen og servicemetode som kan benyttes af eksterne aftagere (udskiftning af DiscoAms til fordel for ESCO-STAR) | A-kasse KSS | N/A | D+S |
| CitizenJoblogService (v4).Alle | Beholdes | Det er frivilligt fr de eksterne om de vil løft til version 5 | A-kasse | BI Jobnet | D+S |
| CitizenJoblogService (Version 5).Alle | Ny | Ny version af servicen, nb ingen snitflade ændringer på metoder eksterne har adgang til | A-kasse(t.o.) | BI Jobnet | D+S |
| CitizenJoblogService (v4).GetOccupationsFromJobSearchEntries | Udgået | Lukkes af, så specifik metode ikke længere kan kaldes. | N/A | Jobnet | D+S |
| DiscoCodesService (v6) metoder udfases til fordel for ny service | Ændret | Servicemetoder udfases til fordel for ny service som fremadrettet indeholder metoderne. | A-kasse KSS | Jobnet | D+S |
| Jobnet.CitizenDashboardService (v1).GetDashboardCardsAsPdf | Udgået | Tidligere er varslet, at Jobnet.CitizenDashboardService ville komme i en version 2, hvor PDF byggede på EscoSTAR værdier. Denne beslutning er om gjort efter dialog på WSmøder. Der kommer ingen version 2. Og version 1 udgår. | A-kasse KSS | Jobnet | D+S |
| Ny service til at indeholde metoder fra DiscoCodesService (v6) | Ny | Ny service muligvis i ny silo, afklaring pågår, hvor den skal placeres. NB. GetDiscoCodes medtages ikke. | 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 serviceændringer
| Service | Version | Metode | Element | Beskrivelse | Bemærkning |
|---|---|---|---|---|---|
| BIDataService | 2 | Der pågår forretningsafklaring, hvorvidt dette skal være en ny version af eksisterende service eller om det bliver en helt ny service i en anden silo. | |||
| GetCompanyMetricData | MetricValue | Værdien for den pågældende kodelisteværdi matchet op imod brugerens identifikator Der kan her returneres en Disco værdi, hvis BI har fyldt tabellen. Intern STAR servicemetode | |||
| GetLatestRelevantCvs | OccupationNameId | Stillingsbetegnelse nummer (DiscoAms08). For stillingsbetegnelse indeholdt i DiscoAms08 er denne sammensat af identifikation af hovedgruppe og fagområde samt fagnummer. Er ikke udfyldt for stillingsbetegnelse der ikke er indeholdt i DiscoAms08 | Bliver også trukket på baggrund af en BI tabel som BI står for at synkronisere med data. Intern STAR servicemetode | ||
| GetUnsolicitedCompanies | OccupationNameId | Stillingsbetegnelse nummer (DiscoAms08). For stillingsbetegnelse indeholdt i DiscoAms08 er denne sammensat af identifikation af hovedgruppe og fagområde samt fagnummer. Er ikke udfyldt for stillingsbetegnelse der ikke er indeholdt i DiscoAms08 | Bliver også trukket på baggrund af en BI tabel som BI står for at synkronisere med data. NB! BI får disse data fra VOA! Omlægges til ESCO-STAR | ||
| GetUnsolicitedTemporaryEmploymentAgencies | OccupationNameId | Stillingsbetegnelse nummer (DiscoAms08). For stillingsbetegnelse indeholdt i DiscoAms08 er denne sammensat af identifikation af hovedgruppe og fagområde samt fagnummer. Er ikke udfyldt for stillingsbetegnelse der ikke er indeholdt i DiscoAms08 | Bliver også trukket på baggrund af en BI tabel som BI står for at synkronisere med data. NB! BI får disse data fra VOA! Intern STAR servicemetode | ||
| CitizenJoblogService | 5 | GetOccupationsFromJobSearchEntries | OccupationNameId | DiscoAmsCode | Der bliver joinet over imod en støttetabel fra BI Tekst/Beskrivelse på felt ændres. Intern STAR servicemetode |
| Count | Antallet af ansøgninger i perioden på DiscoAmsCoden | Tekstuel ændring der skal til. Beskrivelse på felt ændres. | |||
| DiscoCodesService | 7 | Der pågår forretningsafklaring, hvorvidt dette skal være en ny version af eksisterende service eller om det bliver en helt ny service i en anden silo. | |||
| GetSimilarOccupations | SimilarOccupationId | Stillingsbetegnelse nummer (DiscoAms08). For stillingsbetegnelse indeholdt i DiscoAms08 er denne sammensat af identifikation af hovedgruppe og fagområde samt fagnummer. Er ikke udfyldt for stillingsbetegnelse der ikke er indeholdt i DiscoAms08. Bliver mappet op imod en tabel fra BI Omlægges til ESCO-STAR | |||
| GetOtherPersonsSearchedOccupations | SimilarOccupationId | Stillingsbetegnelse nummer (DiscoAms08). For stillingsbetegnelse indeholdt i DiscoAms08 er denne sammensat af identifikation af hovedgruppe og fagområde samt fagnummer. Er ikke udfyldt for stillingsbetegnelse der ikke er indeholdt i DiscoAms08. Bliver mappet op imod en tabel fra BI NB. ikke den samme tabel som ovenstående men samme struktur. Omlægges til ESCO-STAR |
976.15.1 Som DFDG vil jeg have dataleverencen i BI tilrettet til at anvende ESCO STAR i stedet for DISCOAMSDFDG, BI
Dataleverance fra BI enten udskiftes med ESCO-STAR fremfor DiscoAms. Alternativt oprettes ny dataleverance, hvis det er et ønske at holde dem begge kørende hen over 2021-1 og først lukke den indeholdende DiscoAms fra 2021-2.
BI sikrer, at tabellen CitizenCards, når 21-2 går i luften, ikke rummer kort for borgere relateret til forskernes forsøg, der afslutter i 21-2.
976.15.2 Data er konverterede fra DISCOAMS til ESCO-STAR med konverteringstabel
Database inkl. konvertering omlægges efter model beskrevet under ESCO STAR datamodel og snitflade principper.
Ovenstående benyttes i aftager systemer, hvis man vil kalde den nye service forud for 2020-2 i produktion.
976.15.3 Webservices understøtter ESCO-STAR i stedet for DISCOAMS
Fælles for nedenstående vil være udskiftningen af DiscoAms til ESCO-STAR i service snitfladerne herunder ændret navngivning på felterne.
Ny service som indeholdende servicemetoder fra:
DiscoCodesService (v6) tilrettelse af navn på service
EscoStarDataService(Version 1[UDV], 2021-2)
- EscoStarDataService(Version 1[UDV], 2021-2)#1)-GetSimilarOccupations
EscoStarDataService(Version 1[UDV], 2021-2)#1)-GetOtherPersonsSearchedOccupations- EscoStarDataService(Version 1[UDV], 2021-2)#1)-GetOtherPersonsSearchedOccupationsUsingStarAlgorithm
Ovenstående service oprettes i DFDG
EscoStarDataService (Version 1, 2021-2)
Ny version/ny service af service indeholdende servicemetoder fra:
BIDataService (Version 2 [UDV], 2021-1) evt. ny service i ny silo
- BIDataService (Version 2 [UDV], 2021-1)#1)-GetCompanyMetricData
- BIDataService (Version 2 [UDV], 2021-1)#1)-GetLatestRelevantCvs
- BIDataService (Version 2 [UDV], 2021-1)#1)-GetUnsolicitedCompanies
- BIDataService (Version 2 [UDV], 2021-1)#1)-GetUnsolicitedTemporaryEmploymentAgencies
Ovenstående service oprettes som ny version af BiDataservice i DFDG
/wiki/spaces/GI/pages/3461185759
Ny version af service / servicemetode, heraf løft af de resterende servicemetoder på servicen.
/wiki/spaces/GI/pages/2392457354
Oprettes som ny version i DFDG, hvor version 4 holdes i live så eksterne kan opgradere når de finder tid til det
/wiki/spaces/GI/pages/3594387482
CitizenJoblogService (v4).GetOccupationsFromJobSearchEntries lukkes af, så denne servicemetode ikke længere kan kaldes.
Jobnet.CitizenDashboardService (v1).GetDashboardCardsAsPdf udgår. Tidligere er varslet, at Jobnet.CitizenDashboardService ville komme i en version 2, hvor PDF byggede på EscoSTAR værdier. Denne beslutning er om gjort efter dialog på WSmøder. Der kommer ingen version 2. Og version 1 udgår.
Jobnet løftes til versioner på relevante services, der understøtter EscoSTAR.
976.15.4 Brugergrænseflader understøtter ESCO-STAR i stedet for DISCOAMS
Jobnets brugergrænseflader tilrettes, så de brødfødes af de fra 976.15.3 løftede snitflader funderet på EscoSTAR værdier. Visuelt er der ikke ændringer i forhold til tidligere kort. Det er blot "datakilden" der nu er EscoSTAR, hvor den før var discoAMS. Derved vil det være ordlyden for EscoSTAR stillingen der fremgår.
Ved logon vælges fortsat en tilfældig stilling fra borges "Jeg søger job som". Koden anvendes til at initialisere de kort, som borger i tabellen CitizenCards har registeret at skulle forevises. Bemærk: de nedlagte stillingsbetegnelser, der er oprettet i EscoSTAR, omend som udgåede, kan fortsat anvendes til at initialisere dashboardkort. Helt bevidst er de ikke filtreret fra i denne anvendelse, da de stadig kan lede borgers tanker på alternativer til borgers egne udgåede stilligner.
Søgeprofil mod Ankiro rettes til, således at kortene der viser "antal ledige stillinger" og "søgt afstand" (Doughnut kortet) afspejler EscoSTAR tilpasningerne.
Særlige krav til test
Det er ikke ukompliceret at få dannet testdata til DashBoardKort. Her er en vejledning til dannelse for udvalgte kort: /wiki/spaces/CITY/pages/2817130718.
| 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:
Når vi går i luften med EscoSTAR, så vil der på Jobnet være dashboardkort som Jobnet ikke har tilpasset i forhold til EscoSTAR. Det drejer sig om kortene relateret til forskerforsøg. Det er ufarlig teknisk gæld at have liggende på Jobnet forudsat – og det er her BI kommer ind i billedet – at disse kort ikke forsøges kaldt.
Efter idriftsættelse:
For en række borgere der har deltaget i forskernes forsøg gælder, at de ved gentilmelding, automatisk kommer gruppen der får vist forsekrnes kort. Der er en opgave for BI i at sikre, at der fra release 21-2 ikke længere er – eller kommer borgere – i CitizenCards, som skal have et eller flere af forskernes kort vist.
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: Ja
- 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.