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

Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)

Anvendes ved ændringer, der har betydning for eksterne.

Interne links (indhold i links ikke relevant for eksterne)

DS-8819 - Getting issue details... STATUS

Indholdsfortegnelse

Afgrænsning af epic

Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne

Denne epic ændre ikke ved snitflader overfor de eksterne, men er alene STAR arbejdsgang og IT understøttelse af   

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.

(kopiér og indsæt manuelt i tabellen)

Automatisk oversigt

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

Beskrivelse af epic

Baggrund

Her udfylder PO oplysninger om baggrund for epic'en, herunder fx om der ligger politisk aftale eller lovgivning bag. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Regler

Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.

Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer

Her beskriver PO overordnet, hvordan epic'en forventes at påvirke aftagerne. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.

Acc.kr. 976.28.1 - Som STAR / VOA vil jeg have en komponent der kan hente set nyeste ESCO datasæt fra EU 

Løsningsmodel

De mulige løsningemodeller for at hente opdateringer fra EU:

1. Nye ESCO stillingsbetegnelser kommer via flad fil (CSV) der hentes fra EU's ESCO siden
2. Nye  ESCO stillingsbetegnelser kommer via EU ESCO webservice snitflade. Se:
   1. https://www.esco-projects.eu/esco/portal/api?resetLanguage=true&newLanguage=da#ESCO_Web_Services_API
   2. https://audiovisual.ec.europa.eu/en/video/I-161740 
   3. https://ec.europa.eu/esco/api/doc/esco_api_doc.html#api-BulkOperation-getOccupationByUri

Umiddelbart er mulighed 2 langt at fortrække, bl.a. fordi vores erfaringer med CSV filen er, at den krævede en del efterbehandling, inden den kunne anvendes - og det vil ikke muligt at automatisere afhentning af CVS filern. Den skal downloades manuelt. Dette er denne model, der er den er vores arbejdsantagelse for denne epic

Det vil altid være de nyeste data - på hentningstidspunktet - der hentes fra EU.
OBS hvis vi altid henter den seneste version til rådighed, vil vi undgå at skulle håndterer en del problemstillinger

Når data hentes fra EU vil der være en ETL proces, inden de sættes ind i ESCO STAR til VOA's behandling (976.28.3). Det betyder, at der etableres de relevante load tabeller.

Der sker en verificering af ESCO data for at sikre data lever op til forventerningerne så vi ikke får smadret ESCO STAR pga. en fejlbehæftet leverance fra EU. Identificeres et problem, startes en manuel proces. Problemstillinger der kontrollere for er f.eks.

• Der ikke er er nogle stillingsbetegnelser, der ligger forkert i hierarkiet
• Der ikke er er nogle stillingsbetegnelser, der har flyttet plads i hierarkiet
• XXXXX - andre ubehageligheder

For beskrivelse af flow se Load af opdateret ESCO fra EU til ESCO STAR

Acc.kr. 976.28.2 - Som STAR / VOA vil jeg have en komponent, der kan loade nye ESCO datasæt fra EU ind i ESCO STAR (som ubehandlet)

Løsningsmodel (gælder også for alle acceptkriterier fra 976.28.1 til 976.28.3

Da omkostningerne til at lave decideret kladdemodel for ESCO ændringer, der skal ind i ESCO STAR, var omfattende, er en sådan fravalgt. Men der stadig er en behov for at ændringer lige verificeres, inden de bliver en del af ESCO STAR. Denne MVP model bygger på grundprincippet om at ændringer fra EU skal verificere,s inden de slippe løs i ESCO STAR. Den omfatter følgende trin (i skitseform):

1. Et load område, hvor ny ESCO version loades 1 til 1 ind og det kan verificeres, at data liver op til forventerningerne (976.28.1)
   1. Load sker via ESCOs REST API
2. Der laves en ændringsliste 1,der viser ændringer fra EU inkl. hvilke, der kan loades og dermed kan/skal processeres i STAR via Admin tool (976.28.1) og hvilke der er problemer med.
   1. I tilfælde af, at der er elementer, der ikke kan loades, men skal håndteres, klares dette via Fogbugz fra VOA til BI
      Baggrunden er, at der kan være specielle situationer som vi ikke ønsker at understøtte i admin toolet og som bedre/mere fornuftigt kan håndteres ved manuel behandling
      STAR/VOA skal lige være med til at afklare, hvordan ændringsliste 1 skal materialiserer sig
3. EU Data loades ind i ESCO STAR, men ændringer kan ikke ses fra eksterne og der sendes ikke WSRM.
   Load er efter følgende regler (p.t. kun skitse)(976.28.2)
   1. Ny ESCO stilling får et særligt flag ift om den ikke er behandlet (EUESCOStatusType sættes til "Ny fra EU ESCO" Id 2)
      1. ESCO STAR får stillinger får default EU navn, beskrivelse og alias som forslag til de danske
         (Dette vil ikke blive medtage på ESCO STAR snitfladen, undtagen hvis det er admin toolet, der skal bruge data) 
   2. Ny ESCO stilling, hvor der findes en dansk udgave (EUESCOStatusType sættes til "Ny fra EU ESCO" Id 2) 
      Det er ikke muligt automatisk at afgøre, at dette er tilfældet. En sådan behandles i load sammenhæng derfor som under punkt a og får et særligt flag om den ikke er behandlet
      
      1. ESCO STAR får stilling default EU navn, beskrivelse og alias som forslag til de danske
      (Disse vil ikke blive medtage på ESCO STAR snitfladen, undtagen hvis det er admin toolet, der skal bruge data)
   3. Eksisterende ESCO stillinger, der ændres, får:
      1. Hvis navn (PreferredlabelEU) ændres, fås et nye EU navn i ESCO STAR (der ændres ikke ved det danske navn (PreferredlabelDK)  
      2. Hvis beskrivelse ændres, fås en ny EU beskrivelse i ESCO STAR (der ændres ikke ved den danske beskrivelse)
      3. ESCO STAR stillingen får et særligt flag om de skal behandles (EUESCOStatusType sættes til "Ændring fra EU ESCO" Id 3)
         Der skal tage stilling til, om ændringen fra EU giver anledning til at ændre det danske navn og den danske beskrivelse
         Obs Nyt EU navn og / eller ny beskrivelse (PreferredlabelEU/descriptionEu) kommer med ud på snitfladen, men disse data bruges ikke i dansk sammenhæng og er derfor ikke at betragte som en ændring i forhold til de eksterne
   4. Eksisterende ESCO stillinger, der inaktivere, får:
      
      1. ESCO STAR stillingen får et særligt flag om den skal behandles, men den inaktiveres ikke i dansk sammenhæng (EUESCOStatusType sættes til "Inaktivering fra EU ESCO" Id 4)
         Der skal tage stilling til, om inaktiveringen fra EU skal have effekt for den danske udgave 
   5. Nyt alias på ESCO stillinger får et særligt flag, om den ikke er behandlet (EUESCOStatusType sættes til "Ny fra EU ESCO" Id 2)
      1. Alias (alternativeLabelDk) danske navn får default EU's navn (alternativeLabelEu)
         (Disse vil ikke blive medtage på ESCO STAR snitfladen, undtagen hvis det er admin toolet, der skal bruge data)
         Hvis EU's navn allerede findes som dansk alias, indsættes blot EU navnet
         Der skal tage stilling til, om aliaset fra EU giver anledning til at
         1. Det skal merges med et eksisterende dansk alias
         2. Der skal bruges i dansk sammenhæng og om det skal have dansk alias navn
   6. Eksisterende alias på ESCO stillinger, der ændres, får:
      1. Denne situation kan ikke opstå, da EU blot har en liste af tekster som alias. Ændrer de stavemåden i et alias betragtes det som ny i ESCO STAR sammenhæng
   7. Eksisterende alias på ESCO stillinger der fjernes fra EU (EUESCOStatusType sættes til "Inaktivering fra EU ESCO" Id 4)
      1. Hvis der findes et ESCO STAR alias med et EU navn (alternativeLabelEu), der ikke mere er med fra EU, får det særligt flag, om det skal behandles, men der sker ikke noget i dansk sammenhæng
   8. Der laves en ændringsliste 2 over, hvad der er loadet, som skal gennemgås i STAR med henblik på opdatering via Admin tool
4.  I Vedligehold i Admin toolet kan man se flag for hvilke ESCO STAR stillingen, der er berørt af ændringer på skærmbilledet med stillingsbetegnelser (976.28.3) (UX Design mangler) 
   Dette svarer ændringsliste, der er lavet ved loadet
5. Godkendelse af ændring i Admin tool og besked til aftagere. Når en ESCO STAR stilling eller alias er behandlet i admin toolet fjernes flag for behandler (976.28.3)
   1. Hvis der er ændringer, sendes en WSRM på ændringen
   2. Der laves en ændringsliste 3 til serviceaftager over de samlede ændringer der er publiceret i ESCO STAR 

Ovenstående er blot hovedprincipper. Der er en række detaljer, der ikke er beskrevet p.t.

Ovenstående behandler EU alias selvom disse p.t. ikke er loadet til ESCO STAR, med formodningen er det kommer med. 

Acc.kr. 976.28.3  - Som STAR / VOA vil jeg have at jeg kan behandle ESCO EU ændringer, inden de kommer med i ESCO STAR til de eksterne

Løsningsmodel

Se model under 976.28.2 under punkt 4 og 5

Taxonomy.EscoStarService (Version 2 [UDV], 2021-3)

GetOccupation (GET /v2/EscoStar/occupations/{conceptUri}) og GetOccupations (GET /v2/EscoStar/occupations)

Ny EU ESO status (EUESCOStatusType) på stillingsbetegnelser og alias.

Forretningsregler (Nye)

• Hvis EU ESCO status (EUESCOStatusType) er "Ny fra EU ESCO" Id 2, medtages rækken (stillingsbetegnelsen eller aliaset) ikke, men medmindre den kaldende myndighed er STAR og kaldende system er Taxnomy (id 16)
  • Alle andre service aftagere skal se bort fra  EU ESCO status (EUESCOStatusType), da attributten alene anvendes internt ti STAR

CreateOccupation (POST /v2/EscoStar/occupations)

Forretningsregler (nye og ændret)

• Ved oprettelse af ny stillingsbetegnelse sættes EU ESCO status (EUESCOStatusType) default til "Opdateret i forhold til EU ESCO" (Id 1)

UpdateOccupation (PUT /v2/EscoStar/occupations)

Forretningsregler (nye og ændret)

• Ved opdatering af stillingsbetegnelse er det muligt at sætte EU ESCO status (EUESCOStatusType) til "Opdateret i forhold til EU ESCO" (Id 1), hvis den er forskellig fra "Opdateret i forhold til EU ESCO" (Id 1). Dette gøres, når den nye eller nye revision er klar til at blive offentliggjort til serviceaftagerne. 
• Hvis EU ESCO status (EUESCOStatusType) er forskellig fra "Opdateret i forhold til EU ESCO" (Id 1) på en stillingsbetegnelse og der rettes
  • i dansk titel (preferredLabelDa),
  • gyldig fra (validFrom),
  • Gyldig til (validTo)
  • dansk beskrivelse (descriptionDa),
  • status (escoStatus)

skal EU ESCO status (EUESCOStatusType) sættes til "Opdateret i forhold til EU ESCO" (Id 1) for at sikre, at serviceaftagere kan se de opdateret data og får besked om ændringen (WSRM) 

CreateAlias (POST /v1/EscoStar/occupations/alias)

Forretningsregler (nye og ændret)

• Ved oprettelse af nyt alias sættes EU ESCO status (EUESCOStatusType) default til "Opdateret i forhold til EU ESCO" (Id 1)

UpdateAlias (PUT /v1/EscoStar/occupations/alias)

Forretningsregler (nye og ændret)

• Hvis EU ESCO status (EUESCOStatusType) er forskellig fra "Opdateret i forhold til EU ESCO" (Id 1) på et alias og der rettes
  • i dansk titel (alternativeLabelDa),
  • status (escoStatus)

skal EU ESCO status (EUESCOStatusType) sættes til "Opdateret i forhold til EU ESCO" (Id 1) for at sikre de service aftagere kan se de opdateret data og for besked om ændring (WSRM)

Acc.kr. 976.28.4 - Som STAR / VOA vil jeg have at jeg initierer et hente fra EU 

Løsningsmodel

De mulige løsningsmodeller afhænger af, hvilken model, der vil blive anvendt under 976.28.2.

1. Nye ESCO stillingsbetegnelser kommer via flad fil (CSV) der hente fra EU's ESCO siden
   Denne model vil kræve en manuel arbejdsgang
   1. VOA laver Fogbugzsag til BI om at et nyt EU load
   2. BI henter de nyest EU data / den ønskede version som CSV fil 
   3. BI anvender deres EU ESCO loadscript ( det fra 976.28.1)
   4. BI anvender loadkomponent der ligger data ind i ESCO STAR (det fra 976.28.2)
   5. BI danner en "actionliste" over resultatet og sender til VOA
   6. Data ligger klar til VOA's videre arbejde i Admin tool
   7. BI udtrækker en ændringslog og sender til de eksterne i FB
2. Nye  ESCO stillingsbetegnelser kommer via EU ESCO webservice snitflade
   Denne model vil kunne initieres direkte fra VOA uden arbejdsopgaver i BI (men den kan også følge en manuel arbejdsgang som i model 1)
   1. VOA initierer f.eks, i Admin toolet et nyt EU load
      VOA skal selv her styre, hvornår det skal ske i forhold til, hvad EU har releaset
   2. BI's loadproces startes der henter de nyeste EU data (det fra 976.28.1)
   3. BI's loadkomponent, der ligger data ind i ESCO STAR, køres (det fra 976.28.2)
   4. BI danner en "actionliste" over resultatet og denne kan tilgås i Admin tool af VOA
   5. Data ligger klar til VOA's videre arbejde i Admin tool
   6. VOA's kan lave en ændringslog oversigt til eksterne i Admin tool og sender f.eks. via FB

Der er formuleret to muligheder men der nogle varianter over temaet 

Acc.kr. 976.28.5 Som STAR / VOA vil jeg have loadet alle EU alias men sat dem inaktiv i forhold til ESCO STAR

Løsningsmodel

1. Alle EU ESCO alias loades ind i ESCO STAR som inaktive
   1. Hvis et alias allerede eksisterer, indsættes kun EU navn

Særlige krav til test

* 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: 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: Ikke relevant 

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.

Husk GDPR stillingtagen

Ingen personfølsomme data i epics

Opbevaring af oplysninger i STARs it-systemer

Ikke relevant, Taxonomidata

Hvem må tilgå oplysningerne?

Afsnittet må ikke blot slettes, hvis det vurderes ikke relevant. Det skal dokumenteres at man har forhold sig til nedenstående.

Husk det er hensynet til borgeren der tæller højst. Der skal være hjemmel til at sagsbehandler må tilgå oplysninger. Formålet skal være som led i administrationen af beskæftigelsesreglerne eller ydelsesadministration.  

Korrekte sikkerhedsattributter på services

N/A

A-kasse filtrering

N/A

Sagsbehandlerlogin på Jobnet - tag stilling til adgang!

N/A