ESCOSTARService (2020-4)


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.:

  1. ESCO STAR stillingsbetegnelser
  2. 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.


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}

Henter en specifik ESCO STAR stillingsbetegnelse (conceptUri skal URL Encodes).  Findes den angivne conceptUri ikke, returneres null.

Input

Element
Type
Detaljer
Forekomst
Beskrivelse
GetEscoStarOccupationByUriRequestGetEscoStarOccupationByUriRequest
1
-    conceptUriconceptUri
Base: string

1ConceptUri for stillingsbetegnelse

Output

Element
Type
Detaljer
Forekomst
Beskrivelse
GetEscoStarOccupationByUriResponseGetEscoStarOccupationByUriResponse
1Response indeholdende occupation
-    occupationoccupationType
0-1Stillingsbetegnelsen, hvis conceptUri findes, ellers null
- -  parentConceptUriDa string
0-1Forælders conceptUri.  Null ved top-level ISCO
- -   escoStatusstring
0-1Status givet af EU
- -   escoStarType
EscoStarTypeCodeList

1Angiver uddannelses niveauet for stillingsbetegnelsen 
- -   iscoGroupint (ændres til string i FB213047)
0-1Indeholder den sidste forekomst af en isco kode efter lag 4 er passeret
- -   iscoCodestring
0-1Koden der identificere hvor i isco hierarkiet stillingsbetegnelsen er
- -   preferredlabelEustring
1Stillingsbetegnelse angivet af EU
- -   preferredlabelDastring
1Stillingsbetegnelse angivet af DK
- -   descriptionEustring
0-1Beskrivelse af stillingsbetegnelsen angivet af EU
- -   descriptionDastring
0-1Beskrivelse af stillingsbetegnelsen angivet af DK
- -   scopeNotestring
0-1Ikke i brug i ESCO STAR
- -   definitionstring
0-1Ikke i brug i ESCO STAR
- -   additionalInformationstring
0-1Supplerende viden angående stillingsbetegnelsen
- -   modifiedByEuDateTimestring
1Dato for hvornår EU sidst ændrede på stillingsbetegnelsen
- -   schemesschemeType[]
1Array af schemes. Ikke i brug i ESCO STAR
- - -  schemeschemeType
0-*
- - - - schemestring
1Scheme Uri. Ikke i brug i ESCO STAR
- -   aliasesaliasType[]
1Array af altLabel/Alias

- - -  alias

AliasType
0-*
- - - - idint
1Internt ID
- - - - alternativeLabelEustring
0-1AltLabel EU
- - - - alternativeLabelDastring
1Alias i ESCO STAR
- - - - conceptUriDastring
1ConceptUri DK
- - - - escoStarStatus
EscoStarStatusCodeList

1Status på alias angivet af DK
- - - -  conceptUriEustring
0-1ConceptUri EU
- -   conceptUriDastring
1Dansk concepturi for stillingsbetegnelsen
- -   escoStarStatus
EscoStarStatusCodeList

1Status på stillingsbetegnelsen angivet af DK
- -   conceptUriEustring
1Eu concepturi for stillingsbetegnelsen

Fejlkoder

Ingen

GET /v1/EscoStar/occupations

Henter alle ESCO STAR stillingsbetegnelser.

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.

GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings/{discoAms08Id}

Henter en specifik ESCO STAR mapning.

GET /v1/EscoStar/occupations/discoAms08ConceptUriMappings

Henter alle ESCO STAR mapninger.


Codelists

GET /v1/CodeLists/{name}

Henter specifik kodeliste


GET /v1/CodeLists

Henter alle kodelister

GET /v1/CodeLists/ErrorCodeList

Henter ErrorCode kodelisten.