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

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.

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}

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}