Taxonomy.EscoStarService (2024-3)
Forretningsbeskrivelse
Denne service anvendes til at hente taxonomi for ESCO STAR. Disse ESCO STAR taxonomidata omfatter bl.a.:
- ESCO STAR stillingsbetegnelser
- Mapning mellem DiscoAMS og ESCO STAR
Adgang og filtrering
Data er rene taxonomi baseret data og indeholder ikke personhenførbare oplysninger, for alle get metoder gælder derfor der ikke er adgangsbegrænsninger i forhold til dataindhold.
På metoder til at ændre i taxonomidata er det alene STAR der har adgang.
Når STARs ESCO STAR admin tool anvender service vil også ikke behandlede ændringer fra nye ESCO version fra EU blive medtaget.
Forhold mellem ESCO og ESCO STAR stillingsbetegnelser og tilhørende alias
ESCO er den officielle del af hierarkiet fra EU, ESCO STAR er ESCO inklusiv det danske tillæg. STAR udstiller alene ESCO STAR.
For eksisterende ESCO gælder at ESCO STAR arver ESCO værdier, dog sådan at STAR kan
- Vælge om den konkrete stillingsbetegnelse eller alias er relevant i dansk sammenhæng
- Tilføje ekstra data herunder
- Type af stillingsbetegnelse (ikke relevant, faglært, ufaglært, elev, lærling)
- Dansk stillingsbetegnelsens
Dansk udgave at ESCO stillingsbetegnelsens (preferredLabel), som udgangspunkt vil disse være identiske - Dansk beskrivelse
Dansk udgave at ESCO beskrivelse description, som udgangspunkt vil disse være identiske - Supplerende viden
Fritekstfelt uden struktur - Dansk status (En af følgende værdier: Aktiv, Inaktiv, Fravalgt) både for stillingsbetegnelse og alias
- Aktiv er angives hvis værdien er aktiv i dansk sammenhæng
- Inaktiv er angives hvis værdien er inaktiv i dansk sammenhæng. dvs. anvendes ikke mere
- Fravalgter angives hvis værdien er fravalgt i dansk sammenhæng, er kun mulig hvis det er en ESCO koder fra EU
- Gyldighedsperiode
Den periode hvor stillingsbetegnelsen er aktiv i dansk sammenhæng - Oprindelse, dvs. oplysninger om stillingsbetegnelsen kommer fra ESCO eller udelukkende er dansk
- Omkring alias
- Nye danske alias betegnelser til stillingsbetegnelse
- Ændret ESCO alias betegnelser
Dansk udgave at ESCO alias (altLabel), som udgangspunkt vil disse være identiske - Oprindelse, dvs. oplysninger om alias kommer fra ESCO eller udelukkende er dansk
- Dansk status
Se beskrivelse ovenfor - Refererende ESCO stillingsbetegnelse, kun på danske alias
Hvis det danske alias er lavet ud fra anden ESCO stillingsbetegnelse- Dette til brug til analyseformål.
- Flere aliasser kan pege på samme fravalgte ESCO stillingsbetegnelse, da et eventuelt brugsmønster, vil være at benytte en fravalgt stillingsbetegnelse som holdeplads, for fravalgte aliasser, hvor man eks. ønsker at aktivere den tidligere fravalgte stillingsbetegnelse disse aliasser pegede på.
Yderligere beskrivelse af felterne:
For feltet iscoCode i servicesnitfladen, er denne værdi tiltænkt, at være til visning af opbygningen nedenstående eksempel:
XXXX.Y...N
XXXX = ISCO gruppen stillingsbetegnelsen er tilknyttet.
Y = Tal indikator for hvilken stillingsbetegnelse den underliggende stillingsbetegnelse er tilknyttet.
N = Dette er så ens betydende med at man ud fra den fulde nummerkombination med punktummer, har mulighed for at aflæse i hvilken del af hierarkiet en given stillingsbetegnelse er placeret, lidt som det "gamle" DiscoAms hierarki.
Dette giver dog udfordringer ved rene dansk oprettede stillingsbetegnelser, da disse ikke vil være påført andet end ISCO gruppen, da man ikke kan generere tallet, grundet det kan være det fremadrettet vil blive brugt, af en kommende EU stillingsbetegnelse.
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.
Nye og opdateringer til ESCO Versioner fra EU
Når en ny version at ESCO publiceres fra EU vil den blive indarbejdet i ESCO STAR.
Nye Stillingsbetegnelser fra ESCO
Før en ny ESCO stillingsbetegnelse gøres tilgængelig i ESCO STAR vurderes den af STAR forretningsmæssigt. Denne vurdering kan resulterer i at stillingsbetegnelsen enten medtages i ESCO STAR eller fravælges i dansk sammenhæng. Medtages den nye ESCO stillingsbeskrivelse vil den inden den bliver tilgængelig få relevante danske udvidelse, dette inklusiv eventuelle danske alias.
Danske stillingsbetegnelser der ophøjes til ESCO stillingsbetegnelser
Hvis en dansk ESCO STAR stillingsbetegnelse efterfølgende bliver en del af ESCO fra EU, vil den danske ESCO STAR stillingsbetegnelse blive koblet sammen ESCO fra EU. dog sådan den den bevare sin nøgle. Dvs. en sådan sammenkobling påvirker ikke registrerede data.
Opdatering af stillingsbetegnelser fra ESCO herunder nye alias
Før en opdatering af en eksisterende ESCO stillingsbetegnelse gøres tilgængelig i ESCO STAR vurderes den af STAR forrretningsmæssigt. Dette gælder også ny alias.
ESCO stillingsbetegnelser der udgår
Hvis en ESCO stillingsbetegnelser fra udgår EU vil den også udgå i dansk sammenhæng. Dvs. den ikke fremadrette kan anvendes, men eksisterende registreringer forbliver uændret.
Ny og opdateringer til danske ESCO STAR stillingsbetegnelser
Nye danske ESCO STAR stillingsbetegnelser er det STAR selv der administrerer
Nye danske stillingsbetegnelser i ESCO STAR
En dansk ESCO STAR stillingsbetegnelser etableres på baggrund af en af STAR forrretningsmæssigt vurdering
Opdatering af dansk stillingsbetegnelser i ESCO STAR herunder nye alias
En dansk ESCO STAR stillingsbetegnelser kan opdateret på baggrund af en af STAR forrretningsmæssigt vurdering, dette er inklusiv de tilhørende alias
Danske ESCO STAR stillingsbetegnelser der udgår
Hvis en dansk ESCO STAR stillingsbetegnelser udgår sker det på baggrund af en af STAR forrretningsmæssigt vurdering. Dvs. den ikke fremadrette kan anvendes, men eksisterende registreringer forbliver uændret.
Link til snitfladebeskrivelser
Confluence
Swagger
Link til forretningsbeskrivelser
Found 0 search result(s) for CVTaxonomyService.
Metoder
GET occupations
GET occupations henter én eller alle stillingsbetegnelser. GET occupations kan kaldes med parameter eller uden parameter som vist herunder.
GET /v1/EscoStar/occupations/{conceptUri}
Forretningsregler:
- Hvis EU ESCO status (EUESCOStatusType) er "Ny fra EU ESCO" Id 2 medtages rækken (stillingsbetegnelsen eller aliaset) ikke, men med mindre den kaldende myndighed er STAR og kaldende system er Taxonomy (id 16)
- Alle andre service aftagere skal se bort fra EU ESCO status (EUESCOStatusType), da attributten alene anvendes internt ti STAR
GET /v1/EscoStar/occupations
Forretningsregler:
- Hvis EU ESCO status (EUESCOStatusType) er "Ny fra EU ESCO" Id 2 medtages rækken (stillingsbetegnelsen eller aliaset) ikke, men med mindre den kaldende myndighed er STAR og kaldende system er Taxonomy (id 16)
- Alle andre service aftagere skal se bort fra EU ESCO status (EUESCOStatusType), da attributten alene anvendes internt ti STAR
Fejlkoder
Ingen
Create og update occupation
Opret en ny ESCO STAR stillingsbetegnelse. POST create skal kaldes med parameter som vist herunder.
Create POST /v1/EscoStar/occupations/create/{requestDto}
Opretter en specifik ESCO STAR stillingsbetegnelse (conceptUriDa skal URL Encodes).
Forretningsregler:
- Det er kun muligt at oprette ESCO STAR stillingsbetegnelser under
- En niveau 4 ISCO stillingsbetegnelse
- En anden ESCO eller ESCO STAR stillingsbetegnelse
- Det er kun muligt at oprette en ESCO STAR stillingsbetegnelse med reference til en stillingsbetegnelse, hvis den refererede stillingsbetegnelse eksisterer
- Gyldig fra (ValidFrom) må ikke være før 1/1-1920. For stillingsbetengelser det initielt oprettes sættes gyldig fra til 1/1-1920
- Gyldig fra (ValidTo) sættes automatisk når stillingsbetegnelsen inaktiveres eller fravælges
- Gyldig fra (ValidFrom) skal være mindre eller lig (<=) Gyldig fra (ValidTo)
- En stillingsbetegnelse kan kun have en gyldighedsperiode, "genoplives" en stillingsbetengelse vil den nye gyldihedsperiode gælde
- Ved oprettelse af ny stillingsbetegnelse udsendes et OccupationCreatedEvent (Star.Taxonomy.EscoStar.Events.OccupationCreatedEvent)
- Ved oprettelse af ny stillingsbetegnelse sættes EU ESCO status (EUESCOStatusType) default til "Opdateret i forhold til EU ESCO" (Id 1)
Update PUT /v1/EscoStar/occupations/update/{requestDto}
Opdaterer en specifik ISCO, ESCO eller ESCO STAR stillingsbetegnelse (conceptUriDa skal URL Encodes).
Forretningsregler:
- Det er kun muligt at rette i følgende ISCO/ESCO attributter for stillingsbetegnelse, disse omfatter
- Om stillingen er faglært, ufaglært, elev, lærling (escoStarType)
- Den danske stillingsbetegnelse (preferredLabelDa)
- Beskrivelse til den danske stillingsbetegnelse (descriptionDa)
- Status i dansk sammenhæng (escoStarStatus)
- Forældre i givet ISCO/ESCO hierarki (parentConceptUriDa), dog kun ved danske ESCO STAR stillingsbetegnelser
- Hvis ren dansk ESCO STAR stillingsbetegnelse vil ESCO attributter være tomme (Null)
- Gyldig fra (ValidFrom) må ikke være før 1/1-1920. For stillingsbetengelser det initielt oprettes sættes gyldig fra til 1/1-1920
- Gyldig fra (ValidTo) sættes automatisk når stillingsbetegnelsen inaktiveres eller fravælges
- Gyldig fra (ValidFrom) skal være mindre eller lig (<=) Gyldig fra (ValidTo)
- En stillingsbetegnelse kan kun have en gyldighedsperiode, "genoplives" en stillingsbetengelse vil den nye gyldihedsperiode gælde
- Ved opdatering af en eksisterende stillingsbetegnelse udsendes et OccupationUpdatedEvent (Star.Taxonomy.EscoStar.Events.OccupationUpdatedEvent
- 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 de service aftagere kan se de opdateret data og for besked om ændring (WSRM)
Opret et nyt ESCO STAR alias til en ISCO, ESCO eller ESCO STAR stillingsbetegnelse. POST alias Create skal kaldes med parameter som vist herunder.
Create POST /v1/EscoStar/occupations/alias/create/{requestDto}
Opretter et specifik ESCO STAR alias.
Forretningsregler:
- Ved oprettelse af nyt alias sættes EU ESCO status (EUESCOStatusType) default til "Opdateret i forhold til EU ESCO" (Id 1)
Update PUT /v1/EscoStar/occupations/alias/update/{requestDto}
Opdaterer en specifik ISCO, ESCO eller ESCO STAR alias. OK resultat returneres ved succesfuld opdatering.
Forretningsregler:
- Det er kun muligt at rette i følgende ISCO/ESCO attributter på alias, disse omfatter
- Dansk alias (alternativeLabelDa)
- Status i dansk sammenhæng (escoStarStatus)
- Reference til ESCO stillingsbetegnelse aliaset er lavet på baggrund af (conceptUriEu)
Denne anvendes kun i forbindelse med at man i dansk sammenhæng vælger ikke at bruger et given ESCO stillingsbetegnelse i dansk sammenhæng, men ønsker i stedet de optræder som et alias. - Både ved oprettelse og ved opdatering af aliases, udsendes et OccupationUpdatedEvent (Star.Taxonomy.EscoStar.Events.OccupationUpdatedEvent)
- 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)
GET DiscoAms To EscoStar Mapping
GET discoAms08ConceptUriMappings henter én eller alle mapninger. GET discoAms08ConceptUriMappings kan kaldes med parameter eller uden parameter som vist herunder.
GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings/{discoAms08Id}
GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings
CreateTag (POST /v1/EscoStar/occupation/tag)
Opretter et tag på en specifik STAR ESCO stillingsbetegnelse.
Forretningsregler:
- Det er kun muligt at lave det samme tag en en gang på en ESCO STAR stillingsbetegnelse.
Deletetag (DELETE /v1/EscoStar/occupation/tag)
Slettet et tag på en specifik STAR ESCO stillingsbetegnelse.
Forretningsregler:
- Det er kun muligt at fjerne et tag der eksisterer en ESCO STAR stillingsbetegnelse.
Create preferredLabelForeign (POST /v2/EscoStar/occupation/preferredLabelForeign)
Opretter en udenlandsk label på en specifik STAR ESCO stillingsbetegnelse.
Forretningsregler:
- Det er kun muligt at lave det samme sprog en en gang på en ESCO STAR stillingsbetegnelse.
UpdatepreferredLabelForeign (PUT /v2/EscoStar/occupation/preferredLabelForeign)
Opdater en udenlandsk label på en specifik STAR ESCO stillingsbetegnelse.
Forretningsregler:
- Det er kun muligt at opdater navnet på et sprog der eksisterer en ESCO STAR stillingsbetegnelse.
DeletepreferredLabelForeign (DELETE /v2/EscoStar/occupation/preferredLabelForeign)
Slettet en udenlandsk label på en specifik STAR ESCO stillingsbetegnelse.
Forretningsregler:
- Det er kun muligt at fjerne et sprog der eksisterer en ESCO STAR stillingsbetegnelse.