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.
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)
EscoStarDataService(Version 1[UDV], 2021-2)- EscoStarDataService(Version 1[UDV], 2021-2)
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)
- BIDataService (Version 2 [UDV], 2021-1)
- BIDataService (Version 2 [UDV], 2021-1)
- BIDataService (Version 2 [UDV], 2021-1)
Ovenstående service oprettes som ny version af BiDataservice i DFDG
BIDataService (Version 2, 2021-2)
Ny version af service / servicemetode, heraf løft af de resterende servicemetoder på servicen.
CitizenJoblogService (Version 5 [UDV], 2021-2)
Oprettes som ny version i DFDG, hvor version 4 holdes i live så eksterne kan opgradere når de finder tid til det
CitizenJoblogService (Version 5, 2021-2)
CitizenJoblogService (v4).GetOccupationsFromJobSearchEntries lukkes af, så denne servicemetode ikke længere kan kaldes.
976.15.4 Brugergrænseflader understøtter ESCO-STAR i stedet for DISCOAMS
Til rettelse i aftagersystemers visninger, herunder Jobnet og JobAG der gør brug af ovenstående services, herunder Jobnet service der udstiller PDF af borgers dashboard.
Jobnet.CitizenDashboardService (v2)
Indhold kan ændres, da det er nye webservicemetoder der bliver kaldt i genereringen af denne PDF.
Overvej for hvert acceptkriterie hvilke systemer der berøres af ændringen:
- DFDG
- Services
- WSRMer
- Kodelister
- PersonStatusService (PSS)
- PersonHistoryService (PHS)
- LSS (Landssupportsystem) og herunder Registerudtræk (hvis STAR har dataejerskab og der er lavet PHS på domænet)
- Jobnet
- VITAS
- JobKon
- JobAG
- BI integrationsplatform
- Alle områder
- Nye batchjobs
- Dokumentation af jobbet til SF (jf. skabelon: xxx link til skabelon)
- Dataløft
- Hvis der i Databaser tilføjes eller fjernes kolonner med personfølsomme data (f.eks. person navne, adresser, email, telefonumre etc.), så skal SF informeres så disse data fremadrettet tilføjes eller fjernes fra scrambling.
- Nye batchjobs
- Kommunalt sagsbehandlingssystem
- A-kasse sagsbehandlingssystem
- Kommunalt bookingsystem
- JobcenterPlanner (JCP)
- WorkForcePlanner (WFP)
- Kommunalt ydelsessystem
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
- skal der køres konvertering
- Skal der køres databasescripts for opdatering af tabeller i databasen
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
- Nye snitflader
- Nye komponenter
- Nye miljøer
- Nye teknologier
- Nye aftagertyper
- Eller afvigelser fra principperne
- Eventuelle behov for reduktion af teknisk gæld skal afdækkes
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.