ESCOSTARService (2020-4)
- Carsten Olsen
- Torben Clemmensen (Edora)
- Rolf Marcher Arndt
DENNE SIDE ER UNDER KONSTRUKTION I FORHOLD TIL NYT ESCO STAR
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 til Swagger pr. d. 11-11-2020
https://taxonomyt10.startest.dk/swagger/index.html
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.
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
- 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
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 forrretningsmæ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 samenkobling 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
Link til forretningsbeskrivelser
Found 10 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}
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
| GetEscoStarOccupationByUriRequest | GetEscoStarOccupationByUriRequest | 1 | ||
| - conceptUri | conceptUri Base: string | 1 | ConceptUri for stillingsbetegnelse |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
| GetEscoStarOccupationByUriResponse | GetEscoStarOccupationByUriResponse | 1 | Response indeholdende occupation | |
| - occupation | occupationType | 0-1 | Stillingsbetegnelsen, hvis conceptUri findes, ellers null | |
| - - parentConceptUriDa | string | 0-1 | Forælders conceptUri. Null ved top-level ISCO | |
| - - escoStatus | string | 0-1 | Status givet af EU | |
| - - escoStarType | EscoStarTypeCodeList | 1 | Angiver uddannelses niveauet for stillingsbetegnelsen | |
| - - iscoGroup | int (ændres til string i FB213047) | 0-1 | Indeholder den sidste forekomst af en isco kode efter lag 4 er passeret | |
| - - iscoCode | string | 0-1 | Koden der identificere hvor i isco hierarkiet stillingsbetegnelsen er | |
| - - preferredlabelEu | string | 1 | Stillingsbetegnelse angivet af EU | |
| - - preferredlabelDa | string | 1 | Stillingsbetegnelse angivet af DK | |
| - - descriptionEu | string | 0-1 | Beskrivelse af stillingsbetegnelsen angivet af EU | |
| - - descriptionDa | string | 0-1 | Beskrivelse af stillingsbetegnelsen angivet af DK | |
| - - scopeNote | string | 0-1 | Ikke i brug i ESCO STAR | |
| - - definition | string | 0-1 | Ikke i brug i ESCO STAR | |
| - - additionalInformation | string | 0-1 | Supplerende viden angående stillingsbetegnelsen | |
| - - modifiedByEuDateTime | string | 1 | Dato for hvornår EU sidst ændrede på stillingsbetegnelsen | |
| - - schemes | schemeType[] | 1 | Array af schemes. Ikke i brug i ESCO STAR | |
| - - - scheme | schemeType | 0-* | ||
| - - - - scheme | string | 1 | Scheme Uri. Ikke i brug i ESCO STAR | |
| - - aliases | aliasType[] | 1 | Array af altLabel/Alias | |
- - - alias | AliasType | 0-* | ||
| - - - - id | int | 1 | Internt ID | |
| - - - - alternativeLabelEu | string | 0-1 | AltLabel EU | |
| - - - - alternativeLabelDa | string | 1 | Alias i ESCO STAR | |
| - - - - conceptUriDa | string | 1 | ConceptUri DK | |
| - - - - escoStarStatus | EscoStarStatusCodeList | 1 | Status på alias angivet af DK | |
| - - - - conceptUriEu | string | 0-1 | ConceptUri EU | |
| - - conceptUriDa | string | 1 | Dansk concepturi for stillingsbetegnelsen | |
| - - escoStarStatus | EscoStarStatusCodeList | 1 | Status på stillingsbetegnelsen angivet af DK | |
| - - conceptUriEu | string | 1 | Eu concepturi for stillingsbetegnelsen |
Fejlkoder
Ingen
GET /v1/EscoStar/occupations
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
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
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)
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
Create og update alias
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.
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.
GET DiscoAms To EscoStar Mapping
GET discoAms08ConceptUriMappings henter én eller alle mapninger. GET discoAms08ConceptUriMappings kan kaldes med parameter eller uden parameter som vist herunder.