976.3 ESCO STAR skema og webservice til taxonomi for stillingsbetegnelser (Kun EU's ESCO)

Owned by Bjarne Hansen (Edora)
Last updated: Nov 19, 2020 by Jesper BrunholmVersion comment
11 min read

Til KSS og a-kasse: Denne epic er en del af STAR ISB 976 ESCO STAR og skal ses i sammenhæng med følgende epic: 

(star) Bemærk fordeling af epic om anvendelse af ESCO STAR i release 2021-2 og 2012-3 er foreløbig og kan ændres undevejs 

Som det kan ses, vil etableringen af ESCO STAR overfor KSS og a-kasse ske løbende over 2 releases nemlig 2021-2 og 2021-3.

Det betyder, at KSS og a-kasse i forbindelse med release 2021-1 skal give tilsagn til den samlede løsning, men først i forbindelse med de enkelte release give endelig leverancetilsagn pr. epic, Der vil for KSS og a-kasse køre en dedikeret tilsagnsprocessen for ESCO STAR.

Læsevejledning til KSS og a-kasse:

Følgende epic indeholder information om selve ESCO STAR, snitflader og mapning til DiscoAMS og danne dermed grundlaget for den efterfølgende udrulning af ESCO STAR til de enkelte forretningsområder:

Disse tre epics udgør kernen i ESCO STAR løsningen og det er disse KSS og a-kasse primært skal forholde sig til i forhold til et tilsagn til den samlede løsningsmodel, de efterfølgende epics er den praktisk indførelses i de berørte forretningsområder og skal som sædvanligt have et leverancetilsagn i forhold de enkelte releases.

De følgende epic indeholder information om den efterfølgende udruldningen af ESCO STAR på de enkelte forretningsområder. Disse epic er lavet over den sammen løsningsskabelon der i forhold overordnet består af 

  1. Specifikation af præcise hvad det pågældende forretningsområde omfatter herunder hvilke servicesnitflader der berøres
  2. Konvertering fra DiscoAMS til ESCO STAR   

Epic til udruldning

STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader
Thor Herlev Jørgensen (STAR)

Carsten Olsen

Bjarne Hansen (Edora)

2020-41.0N/A



key po fa ux sme eksterne snitflader interne snitflader status labels
Refresh

BI-753 - Getting issue details... STATUS VIR-869 - Getting issue details... STATUS DS-2631 - Getting issue details... STATUS

Indholdsfortegnelse



Afgrænsning af epic

Afgrænsning

Som en STAR 

vil jeg have at ESCO-STAR Silo anvender STAR's ESCO-STAR schema i database, forretningslogik og webservices, samt har initielt dataindhold baseret på EU's ESCO data uden STAR modifikationer

for at eksterne systemer efterfølgende kan tilpasses til ESCO-STAR med foreløbigt dataindhold

Acceptkriterier

Nr.BeskrivelseRelevant for
976.3.1Der er udarbejdet et schema for ESCO-STAR, som understøtter STARs forretningsmæssige behov for stillingsbetegnelserESCO-STAR
976.3.2ESCO-STAR Silo anvender schema for ESCO-STAR gennem alle lagESCO-STAR
976.3.3ESCO-STAR Silo udstiller webservices, der understøtter de forretningsmæssige og tekniske behov for aftagersystemerne (Jobnet, JobAG, VITAS, KSS'er, a-kassesystemer)ESCO-STAR
976.3.4EU's ESCO stillingsbetegnelser er konverteret til ESCO-STAR og indlæst i ESCO-STAR SiloESCO-STAR
976.3.5ESCO-STAR webservices er tilgængelige i testmiljøer og i produktionsmiljø, men anvendes ikke til produktionESCO-STAR
Kriterier for tilsagn til serviceaftager i forhold til STARs snitfladerBerørte acceptkriterierBemærkninger
Ikke relevant





Oversigt over berørte webservices 

Manuel oversigt som er synlig for eksterne (links i listen virker kun med STAR Jira konto):


Automatisk oversigt (vi arbejder på løsning på at gøre den synlig)

summary varslingstype varslingsnote eksterne snitflader interne snitflader project
Refresh


Beskrivelse af epic


976.3.1 Der er udarbejdet et schema for ESCO-STAR, som understøtter STARs forretningsmæssige behov for stillingsbetegnelser

STAR skal fastlægge kravene til schema for ESCO-STAR, hvorefter der skal udarbejdes et formelt schema for ESCO-STAR. Schemaet skal definere mulighederne for at tilpasse ESCO-STAR i forhold til ESCO, samt for at kunne lave afgrænsede udtræk af ESCO-STAR til forskellige formål.

Schema for ESCO-STAR antages at tage udgangspunkt i schema for ESCO, men med tilføjelser, som beskriver STARs forretningsmæssige og tekniske behov.

Input til workshop vedr. schema for ESCO-STAR:

Krav til ESCO-STAR schema

Note (Bjarne): Jeg har ikke fundet det autoritative ESCO schema. Nedenstående er udledt af udtræk.

IDBeskrivelse
1ESCO-STAR har altid én aktiv version, men indeholder også historiske versioner.
2En ESCO-STAR version indeholder den ESCO-version (EU), som den er baseret på.
3Ethvert niveau i hierarkiet betegnes som en stillingsbetegnelse.
4

En stillingsbetegnelse i ESCO-STAR har følgende attributter: 

Fra ESCO - kan ikke rettes i ESCO-STAR:

  • conceptUri (ID fra EU, kan ikke ændres)
  • iscoGroup (ISCO kode fra EU, kun ved ESCO extensions)
  • code (ISCO kode, kun ved de 4 øverste niveauer, som er ISCO)
  • preferredLabel (dansk stillingsbetegnelse fra EU)
  • altLabels (synonymer fra EU)
  • hiddenLabels (formål ?)
  • description (beskrivende tekst fra EU)
  • status (ESCO status fra EU)
  • modifiedData
  • regulatedProfessionNote
  • scopeNote
  • definition
  • inScheme

ESCO-STAR attributter:

  • parent (ID på ovenliggende stillingsbetegnelse i hierarkiet)
  • Stillingsbetegnelse (tekst, som vises i STARs systemer. Som udgangspunkt identisk med preferredLabel, men kan rettes af STAR)
  • Beskrivelse (beskrivende tekst, som vises i STARs systemer. Som udgangspunkt identisk med description, men kan rettes af STAR)
  • Synonymer (= alias): 0 til mange pr. stillingsbetegnelse: Hvert synonym har en kort beskrivende tekst, der som udgangspunkt er identisk med altLabel, men kan rettes af STAR)
    • Referende ESCO kode (optional) for danske
  • ESCO-STAR-Status (En af følgende værdier: Aktiv, Inaktiv, Fravalgt)
  • ESCO-STAR-extension (true / false. Hvis true er der tale om en dansk stillingsbetegnelse, som ikke findes i ESCO. ESCO-felter er null). 
  • Supplerende viden (fritekstfelt uden struktur)
  • DK type (Faglært, ikke faglært, Elev, Lærling) kan være null  Default: Udefineret/null)
5Det er ikke muligt at slette en stillingsbetegnelse, som tidligere har været aktiv, men man kan deaktivere en stillingsbetegnelse, så den ikke kan vælges ved nye data, men kan bruges ved eksisterende data (styres af applikationerne baseret på status)
6Det er muligt at slette synonymer (alias), selv om de har været idriftsat
7Det er muligt at tilføje nye synonymer til en stillingsbetegnelse
8En stillingsbetegnelse kan have en af følgende statusser: Aktiv, Inaktiv (EU har inaktiveret stillingsbetegnelsen), Fravalgt (Danmark har valgt,at den ikke skal kunne vælges). Note: Applikationer formodes at sikre, at stillingsbetegnelser med status Inaktiv eller Fravalgt ikke kan ses eller vælges i brugergrænsefladerne, men at applikationerne kan vise stillingsbetegnelserne, hvis der er eksisterende data med stillingsbetegnelserne
9Det er muligt at ændre den brugerrettelse tekst på en stillingsbetegnelse (for at gøre den mere brugervenlig)
10Det er muligt at ændre beskrivelsen på en stillingsbetegnelse
11Det er muligt at tilføje en stillingsbetegnelse til ESCO-STAR, som ikke findes i ESCO. Det er kun muligt at lægge danske stillingsbetegnelser under ESCO stillingsbetegnelser og ikke under ISCO. Derved kan danske stillingsbetegnelser altid mappes til en mere generel ESCO stillingsbetegnelse. 
12ESCO-STAR har en dansk nøgle (key), som data bindes op på. Det vil betyde, at ESCO nøgle er en property, som kan afledes af ESCO-STAR key. Fordele: Man kan senere flette danske stillingsbetegnelser sammen med den samme ESCO stillingsbetegnelse, hvis ESCO tilføjer den. Ulemper: Man anvender ikke ESCO nøgler direkte (men det er heller ikke muligt, hvis man skal kunne anvende danske tilføjelser). Advarsel: Det kræver disciplin i STAR at undgå, at ESCO-STAR bliver en ny DISCOAMS.
13Det er ikke muligt at tilføje en dansk stillingsbetegnelse over en ESCO stillingsbetegnelse. Dvs. man kan ikke bryde ESCO hierarkiet.


Bemærkninger:

"Jobtitler" indgår ikke i den nye nomenklatur. Disse kan tilføjes som alias til stillingsbetegnelser.

Synonymer (= alias) anvendes i de tilfælde hvor oversættelsen i ESCO ikke rammer den stillingsbetegnelser der er på det danske arbejdsmarked. Således ændres ordlyden for de danske brugere.

STAR: Hvad byder dette: 

I de tilfælde hvor der er overlap mellem indholdet (konceptet for en stilling) mellem en stilling i ESCO og en stilling, der ønskes tilføjet ESCO-STAR, kan der oprettes et alias. Dette gør det muligt for brugerne at få en ekstra stillingsbetegnelse, der i højere grad matcher den sprogbrug, der anvendes i virksomhederne. Dog vil dataindsamlingen her referere til den ESCO-stillingsbetegnelse, der allerede eksisterer. I overvågningsøjemed vil både ESCO-stillingsbetegnelsen og aliaset udgøre datagrundlaget for ESCO-stillingen, og de data der sendes til EU, vil referere til ESCO-stillingsbetegnelsen.

Stillingsbetegnelser der minder om hinanden skal være beslægtede/relaterede.

Et centralt element af ESCO-STAR er muligheden for tilføjelse af nye "midlertidige" danske stillingsbetegnelser til ESCO med henblik på at tilgodese specifikke behov i en dansk kontekst. Dette kan være i situationer, hvor det vurderes, at der mangler en stillingsbetegnelse i en allerede eksisterende opdeling i ESCO (figur 1a) eller, at der mangler en opdeling af et overordnet niveau (figur 1b).

Det er vigtigt, at STAR beskriver procedurer for tilføjelse af danske stillingsbetegnelser for at undgå at muligheden anvendes i utilsigtet omfang, hvilket vil give kompatibilitetsproblemer med ESCO (svarende til kompatibilitetsproblemer mellem DISCO og DISCOAMS).


Figur 1a: Tilføjelse af yderligere kategori i eksisterende opdeling

Figur 1b: Tilføjelse af ny opdeling af overordnet ESCO-niveau

I forbindelse med optagelse af stillingsbetegnelser i ESCO-STAR, vil disse blive indmeldt til EU-Kommissionen med henblik på optagelse i den fælles ESCO. Når dette sker, skal overgangen til ESCO ske uden databrud.

Indhold om beslægtede stillinger m.m. skal udfyldes for den nyoprettede stillingsbetegnelse. Bemærk: mangler i schema, skal afklares nærmere.

Det undersøges om det er korrekt at alt skal mappes til ESCO. Dvs. ingen behov for at der skal kunne mappes til ISCO-koder…. (STAR - Daniel undersøger….)

I fase 2 (pt. ikke i scope) skal der suppleres med a) Nødvendige færdigheder og kompetencer, b) Supplerende færdigheder og kompetencer.

Se også:

ESCO Service platform - data model:

https://ec.europa.eu/esco/portal/document/da/87a9f66a-1830-4c93-94f0-5daa5e00507e

ESCO STAR skema 

Skemaet indeholder de data der udgør de data der.

ElementTypeDetaljerForekomstESCO basisBeskrivelse

ESCO-STAR






-  ECSO-STARInfo

1
ESCO STAR stillingsbetengelser
-    -    ECCO-STARconceptUri

1

Unik ESCO STAR identifikation defineret at STAR.

For ESCO STAR koder der også er i ESCO er denne identifikation den samme som conceptUri 

-    -    conceptUri 



1XUnik ESCO identifikation af ID (kommer fra EU, kan ikke ændres)

-    -    iscoGroup 



0 - 1
ISCO kode fra EU, kun ved ESCO extensions

-    -    code



0 - 1
ISCO kode, kun ved de 4 øverste niveauer, som er ISCO

-    -    preferredLabel




XDansk stillingsbetegnelse fra EU
-    -   altLabels


XSynonymer fra EU
-    -   hiddenLabels



formål ?
-    -   description


XBeskrivende tekst fra EU
-    -   status


XESCO status fra EU
-    -   modifiedData




-    -   regulatedProfessionNote




-    -   scopeNote




-    -   definition




-    -   inScheme




Specifikke STAR ESCO elementer




-    -  parent



ID på ovenliggende stillingsbetegnelse i hierarkiet
-    - ESCO-STARpreferredLabel



Stillingsbetegnelse (tekst, som vises i STARs systemer. Som udgangspunkt identisk med preferredLabel, men kan rettes af STAR)

-    - ESCO-STARdescription



Beskrivelse (beskrivende tekst, som vises i STARs systemer. Som udgangspunkt identisk med description, men kan rettes af STAR)

-    - ESCO-STARaltLabel



Synonymer (= alias): 0 til mange pr. stillingsbetegnelse: Hvert synonym har en kort beskrivende tekst, der som udgangspunkt er identisk med altLabel, men kan rettes af STAR)

-    - ESCO-STAR-Status



En af følgende værdier: Aktiv, Inaktiv, Fravalgt)

-    - ESCO-STAR-extension  



(true / false. Hvis true er der tale om en dansk stillingsbetegnelse, som ikke findes i ESCO. ESCO-felter er null).






ESCO-STAR metadata










ESCO STAR snitflader

Løsningsmodel for stillingsbetegnerlser (grovskitse)

  • Etablering af "Taxonomi" silo, der kommer til at være dataejer af ESCO STAR
  • Etablering af ESCO STAR database
    • Der benytte en ESCO STAR nøgle for alle stillingsbetegnelser (den fra ESCO og de ESCO STAR som STAR oprette) 
    • Der kan indeholde den gældende version af ESCO STAR
    • Der kan indeholde den kommende ESCO version indtil den frigives XXXX???
    • Der kan indeholder historiske version af ESCO STAR
    • Der laves revisionshistorik XXXX???
  • Admin snitflader
    • Snitflade til at load af ny ESCO version fra EU
    • Snitflade til at oprette/opdaterer ESCO STAR stilingsbetegnelse
    • Snitflade til at oprette/opdaterer/slette ESCO STAR alias
    • Snitfalde til at hente en fuld ESCO STAR stillingsbetegnelse (f.eks. for editering) 
  • Generelle snitflader
    • Snitfalde til at hente ESCO STAR liste (til at lave STAR ESCO tre) (list til både admin og de eksterne)
    • Snitfalde til at hente en ESCO STAR stillingsbetegnelse (kun til at slå navn op) måske ikke relevant


Navngivning er foreløbig og bare et draft og er her oversigt på tværs af alle 976 epics af hensyn til overblik.

Hent ESCO STAR

GetESCOSTAROJobTitles (GET /v1/escostarjobtitles)

Metode der henter alle STAR ESCO stillingsbetegnelser

Etableres i denne epic.

Vedligeholdse af ESCO STAR stillingsbetegnelser 

CreateESCOSTAROJobTitle (POST /v1/escostarjobtitle)

Metode der opretter en ESCO STAR stillingsbetegnelse der ikke er repræsenteret i ESCO.

Etableres i epic 976.7 Admin værktøj inkl. snitflade til stillingsbetegnelser på ESCO STAR

UpdateESCOSTAROJobTitle (PUT /v1/escostarjobtitle)

Metode der opdateret en eksisterende ESCO STAR stillingsbetegnelse.  Metoden arbejder både på ESCO STAR stillingsbetegnelse der ikke er repræsenteret i ESCO og ESCO STAR stillingsbetegnelse der ikke er repræsenteret.

Etableres i epic 976.7 Admin værktøj inkl. snitflade til stillingsbetegnelser på ESCO STAR

Vedligeholdse af ESCO STAR alias til stillingsbetegnelser 

CreateESCOSTAROAlias (POST /v1/escostaralias)

Metode der opretter en ESCO STAR alias på en stillingsbetegnelse.

Etableres i epic 976.7 Admin værktøj inkl. snitflade til stillingsbetegnelser på ESCO STAR

UpdateESCOSTAROAlias (PUT /v1/escostaralias)

Metode der opretter en ESCO STAR alias på en stillingsbetegnelse

Etableres i epic 976.7 Admin værktøj inkl. snitflade til stillingsbetegnelser på ESCO STAR

DeleteESCOSTAROAlias (DELETE /v1/escostaralias/guid)

Metode der opretter en ESCO STAR alias på en stillingsbetegnelse

Etableres i epic 976.7 Admin værktøj inkl. snitflade til stillingsbetegnelser på ESCO STAR

Load af ny ESCO version 

CreateESCO (POST /v1/esco)

Metode der loader en ny ESCO version til STAR ESCO.

Etableres i epic 976.7 Admin værktøj inkl. snitflade til stillingsbetegnelser på ESCO STAR

 


>>>>>>>>>>>>>>>>>>>>>>>>>>>>

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.
  • Kommunalt sagsbehandlingssystem
  • A-kasse sagsbehandlingssystem
  • Kommunalt bookingsystem
    • JobcenterPlanner (JCP)
    • WorkForcePlanner (WFP)
  • Kommunalt ydelsessystem

Særlige krav til test

Test scenarieBerø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.





Tilgængelighed: https://starwiki.atlassian.net/was