Kuvaus Opetushallituksen Opintopolku –järjestelmän tuottamasta siirtotiedostosta vastaanottavalle oppilaitokselle.

HAKIJAT JA VALITUKSI TULLEET

Koulutukseen hakeneiden ja valituksi tulleiden tiedot ammatilliseen koulutukseen ja lukiokoulutukseen yhteishaussa vuonna 2014

Opintopolku-järjestelmä tuottaa opiskelijoita vastaanottaville koulutuksen järjestäjille ja oppilaitoksille XML -muotoisen siirtoaineiston kaikista jollakin hakutoiveella vastaanottavan koulutuksen järjestäjän oppilaitoksiin valituksi tulleista henkilöistä. Tiedot on mahdollista saada myös JSON ja .xls -esitysmuodoissa sekä suoraan ohjelmallisesti rajapinnan kautta. Tiedot voidaan siirtää suoraan oppilashallinto-ohjelmiin, jos ohjelmistoihin on rakennettu vastaanotto-ominaisuus.

...

Siirtotiedosto muodostetaan Opintopolussa ja sen tekee koulutuksen järjestäjän tai oppilaitoksen henkilö, jonka käyttäjätunnukselle on Opintopolku-järjestelmän käyttäjähallintaan määritelty valintapalvelun käyttöön oikeuttava käyttöoikeusryhmä. Siirtotiedosto sisältää sen oppilaitoksen tai niiden oppilaitosten tiedot, joiden tietojen käsittelyyn siirron tekevällä käyttäjällä on valtuudet. Valtuus määritellään Opintopolun käyttäjähallinnassa ilmoitetulla organisaatiotiedolla: koulutuksen järjestäjän y-tunnuksena (tällöin on oikeus käsitellä kaikkien kyseisen koulutuksen järjestäjän oppilaitosten tietoja) tai oppilaitoskohtaisena koodina, joka on Tilastokeskuksen 5-numeroinen tunnus (tällöin on oikeus käsitellä mainitun/mainittujen oppilaitosten tietoja).

XML-Siirron formaatin määrittävät tässä esitellyt xml-skeemat:

common.xsd

common_koodisto.xsd

hakijat.xsd

KOODISTOT:

kausi.xsd

kieli.xsd

kunta.xsd

...

pohjakoulutustoinenaste.xsd

posti.xsd

sukupuoli.xsd

Keskeisimmät tässä esiteltynä:

Code Block

firstline	1
title	common.xsd
linenumbers	true

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
           targetNamespace="http://service.henkilo.sade.vm.fi/types/common"
           xmlns="http://service.henkilo.sade.vm.fi/types/common"
           elementFormDefault="qualified">
    <xs:simpleType name="VUOSI">
        <xs:restriction base="xs:int">
            <xs:pattern value="[0-9]{4}"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="LUOKKA">
        <xs:restriction base="xs:string">
            <xs:minLength value="1"/>
            <xs:maxLength value="50"/>
        </xs:restriction>
    </xs:simpleType>

    <xs:simpleType name="HETU">
        <xs:restriction base="xs:string">
            <xs:pattern value="[0-9]{6}(|[0-9]{2}|[-A][0-9]{3}[0123456789ABCDEFHJKLMNPRSTUVWXY])" />
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="SUKUNIMI">
        <xs:restriction base="xs:string">
            <xs:maxLength value="40"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ETUNIMET">
        <xs:restriction base="xs:string">
            <xs:maxLength value="40"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="KUTSUMANIMI">
        <xs:restriction base="xs:string">
            <xs:maxLength value="40"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="LAHIOSOITE">
        <xs:restriction base="xs:string">
            <xs:maxLength value="50"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="PUHELINNUMERO">
        <xs:restriction base="xs:string">
            <xs:maxLength value="20"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ERA">
        <xs:restriction base="xs:string">
            <xs:pattern value="PKERA[0-9]_[0-9]{4}[SK]_[0-9]{5}"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="TODISTUS">
        <xs:restriction base="xs:int">
            <xs:pattern value="1|2"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="TYYPPI">
        <xs:restriction base="xs:string">
            <xs:pattern value="[BC]{1}"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ARVOSANA_4_10">
        <xs:restriction base="xs:int">
            <xs:minInclusive value="4"/>
            <xs:maxInclusive value="10"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- haku ja valinta -->
    <xs:simpleType name="HAKUJONO">
        <xs:restriction base="xs:int">
            <xs:minInclusive value="1"/>
            <xs:maxInclusive value="5"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="OPETUSPISTENIMI">
        <xs:restriction base="xs:string">
            <xs:minLength value="1"/>
            <xs:maxLength value="180"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="BOOLEANX">
        <xs:restriction base="xs:string">
            <xs:pattern value="|X"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="BOOLEAN10">
        <xs:restriction base="xs:int">
            <xs:pattern value="0|1"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="AINEIDENKESKIARVO">
        <xs:restriction base="xs:float">
            <xs:minInclusive value="0"/>
            <!--<xs:maxExclusive value="1000"/> max arvon laittaminen ei liene tarpeellista? -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="HARKINNANVARAISUUSPERUSTE">
        <xs:restriction base="xs:int">
            <xs:minInclusive value="1"/>
            <xs:maxInclusive value="9"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="OPPIJANUMERO">
        <xs:restriction base="OidStringType"/>
    </xs:simpleType>
    <xs:simpleType name="SAHKOPOSTI">
        <xs:restriction base="xs:string">
            <xs:pattern value="[^@]+@[^\.]+\..+"/>
            <xs:maxLength value="100"/>
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="OidStringType">
        <xs:restriction base="xs:string">
            <xs:pattern value="[0-9\.]*" />
            <xs:minLength value="14" />
            <xs:maxLength value="30" />
        </xs:restriction>
    </xs:simpleType>
</xs:schema>

...

Code Block

firstline	1
title	JSON-esitysmuoto
linenumbers	true

{
  "hakijat": [
    {
      "hakemus": {
        "pohjakoulutus": "",
        "kausi": "",
        "julkaisulupa": false,
        "lahtokoulunnimi": "",
        "luokka": "",
        "todistusvuosi": "",
        "hakemusnumero": "",
        "lahtokoulu": "",
        "lisapistekoulutus": "",
        "lukiontasapisteet": 0,
        "yhteisetaineet": 0,
        "hakutoiveet": [
          {
            "opetuspisteennimi": "",
            "urheilijanammatillinenkoulutus": "",
            "hakujno": 0,
            "koulutus": "",
            "lasnaolo": "",
            "opetuspiste": "",
            "vastaanotto": "",
            "aiempiperuminen": false,
            "kaksoistutkinto": false,
            "valinta": "",
            "terveys": "",
            "yhteispisteet": 0,
            "harkinnanvaraisuusperuste": "",
            "oppilaitos": ""
          }
        ],
        "yleinenkoulumenestys": 0,
        "luokkataso": "",
        "painotettavataineet": 0,
        "vuosi": ""
      },
      "aidinkieli": "",
      "postitoimipaikka": "",
      "sukupuoli": "",
      "sukunimi": "",
      "postinumero": "",
      "lahiosoite": "",
      "sahkoposti": "",
      "kutsumanimi": "",
      "kansalaisuus": "",
      "maa": "",
      "oppijanumero": "",
      "matkapuhelin": "",
      "hetu": "",
      "kotikunta": "",
      "etunimet": "",
      "koulutusmarkkinointilupa": false
    }
  ]
}

...

Tiedon nimi

Sisältö

Pituus

Kuvaus

Huom!

Hetu

999999-999x

tai

999999A999x

11

Hakijan henkilötunnus

syntymäaika muodossa ppkkvv-xxxx

tai

ppkkvv-xxxx

Tunnusosan erotinmerkki.

Jos hakija on ulkomaalainen eikä hänellä ole suomen kansalaisuutta, tietona on pelkkä syntymäaika (ppkkvv).

Oppijanumero

1.2.246.562.24.64926617821

	26	Henkilön oppijanumero	OID-standardin mukainen yksilöivä oppijanumero.
Sukunimi	Anonyymi

40

Hakijan sukunimi

Esitystapa: Virtanen


Etunimet

Antti Juhani

40

Hakijan etunimet

Esitystapa: Aila Inkeri


Kutsumanimi

Antti

40

Hakijan kutsumanimi

Esitystapa: Inkeri

Lahiosoite

Jokukatu 2

50

Hakijan lähiosoite

Turvaoppilailla ei ole osoitetietoa.

Hakijan ilmoittama osoite

Postinumero

99999

5

Hakijan postinumero

Turvaoppilailla postinumerona on 00000 (Ei tiedossa). Koodisto ladattavissa:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/posti/koodi

Postitoimipaikka

	HELSINKI	30	Postitoimipaikka	Ei tarvita, jää pois
Maa

999

3

Hakijan maatieto, virallinen Tilastokeskuksen ylläpitämä maakoodisto

246 = Suomi

SFS-EN ISO 3166-1 koodisto.

Maa tarkoittaa oppilaan asuinmaata. Koodisto ladattavissa:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/maatjavaltiot2/koodi

Kansalaisuus

999

3

Hakijan kansalaisuus, virallinen Tilastokeskuksen ylläpitämä maakoodisto

246 = Suomi

SFS-EN ISO 3166-1 koodisto.

https://virkailija.opintopolku.fi/koodisto-service/rest/json/maatjavaltiot2/koodi

Matkapuhelin

99

20

Hakijan matkapuhelinnumero

Muupuhelin

99

20

Hakijan muu puhelinnumero


Sahkoposti

xx

100

Hakijan sähköpostiosoite


Kotikunta

999

3

Hakijan kotikunta, virallinen Tilastokeskuksen ylläpitämä kuntakoodisto

Turvaoppilailla voi olla 999 (Ei tiedossa).

Koodisto:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/kunta/koodi

Sukupuoli

9

1

Hakijan sukupuoli

1 = mies

2 = nainen

Koodisto:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/sukupuoli/koodi

Aidinkieli

xx

2

Hakijan äidinkieli, virallinen Tilastokeskuksen ylläpitämä kielikoodisto

SFS ISO639-1 koodisto.

FI = suomi

SV = ruotsi

99 = tuntematon

koodisto:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/kieli/koodi

Koulutusmarkkinointilupa

x

1

X = on lupa


Vuosi

9999

4

Vuosiluku

Koulutuksen alkamisvuosi

Kausi

x

1

Koulutuksen alkukauden tunnus

S = syksy

K = kevät

Koodisto:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/kausi/koodi

Hakemusnumero

9999

7

11

Hakemuksen tunniste

Merkkimäärää kasvatettava.

Lahtokoulu

99999

5

Lähettävän koulun oppilaitoskoodi

Tilastokeskuksen antama 5-numeroinen koodi

Koodisto ladattavissa:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/oppilaitosnumero/koodi

Lahtokoulunnimi

xx

180

Lähettävän koulun (oppilaitoksen nimi) nimi


Luokka	9x

5

10

Oppilaitoksen sisäisesti käyttä luokkatunnus. Numero, tekstiä tai sekä että.

Tähän tulee oppilaitoksen itsensä käyttämä luokkatieto. esim. 9A

Luokkataso

99

2

HUOM! Vain numero, joka ilmaisee oppilaan luokkatason. Sallitut arvot: 9 tai 10

NUMERO (luokkataso)

kertoo onko kyseessä ysi- vai kymppiluokkalainen

Pohjakoulutus

9

1

Hakijan pohjakoulutus

1 = Perusopetuksen oppimäärä

2 = Perusopetuksen osittain yksilöllistetty oppimäärä

3 = Perusopetuksen yksilöllistetty oppimäärä, opetus järjestetty toiminta-alueittain

6 = Perusopetuksen pääosin tai kokonaan yksilöllistetty oppimäärä

7 = Oppivelvollisuuden suorittaminen keskeytynyt

9 = Lukion suorittanut, ylioppilas tai abiturientti

0 = ulkomainen todistus

Koodisto ladattavissa:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/pohjakoulutustoinenaste/koodi

Todistusvuosi

9999

4

Päättötodistuksen saantivuosi


Julkaisulupa	x	1	X = lupa	Lupa julkaista tiedot internetissä
Yhteisetaineet

999.99

4,2

Lukuaineidenkeskiarvo

erotinmerkkinä piste (.)

Lukiontasapisteet

999.99

4,2

Lukion tasapistekeskiarvo

erotinmerkkinä piste (.)

Yleinenkoulumenestys

999.99

4,2

Yleisen koulumenestyksen keskiarvo

erotinmerkkinä piste (.)

Lisapistekoulutus

XXXXXXX

30

LISAKOULUTUS_KYMPPI LISAKOULUTUS_VAMMAISTEN LISAKOULUTUS_TALOUS LISAKOULUTUS_AMMATTISTARTTI LISAKOULUTUS_KANSANOPISTO LISAKOULUTUS_MAAHANMUUTTO LISAKOULUTUS_MAAHANMUUTTO_LUKIO LISAKOULUTUS_VALMA LISAKOULUTUS_TELMA

LISAKOULUTUS_KYMPPI= Kymppiluokka (perusopetuksen lisäopetuksen oppimäärä, vähintään 1100 tuntia)

LISAKOULUTUS_VAMMAISTEN=Valmentava ja kuntouttava opetus ja ohjaus (vähintään 20 opintoviikkoa)

LISAKOULUTUS_TALOUS = Kotitalousopetus (muuna kuin ammatillisena peruskoulutuksena järjestettävä kotitalousopetus, vähintään 20 opintoviikkoa)

LISAKOULUTUS_AMMATTISTARTTI= Ammattistartti (ammatilliseen peruskoulutukseen ohjaava ja valmistava koulutus, vähintään 20 opintoviikkoa)

LISAKOULUTUS_KANSANOPISTO= Kansanopiston lukuvuoden mittainen linja

LISAKOULUTUS_MAAHANMUUTTO = Maahanmuuttajien ammatilliseen peruskoulutukseen valmistava koulutus (vähintään 20 opintoviikkoa)

LISAKOULUTUS_MAAHANMUUTTO_LUKIO = Maahanmuuttajien lukioon

valmistava koulutus

LISAKOULUTUS_VALMA = Ammatilliseen peruskoulutukseen valmistava

koulutus

LISAKOULUTUS_TELMA = Työhön ja itsenäiseen elämään valmentava

koulutus.

Painotettavataineet

	999.99	4,2	Painotettavien aineiden keskiarvo	erotinmerkkinä piste (.)
Hakutoiveet

Hakijan kaikki hakutoiveet numerojärjestyksessä


Hakujno	9

	1	Hakutoiveen järjestysnumero	1 – 5
Oppilaitos	99999

5

Hakutoiveen oppilaitoksen tunnus (Tilastokeskuksen 5- numeroinen koodi)

Tilastokeskuksen käyttämä 5-numeroinen koodi, jossa tarvittaessa tulee olla mukana myös etunollat (ei yhteishakukoodi). Esim jos oppilaitoksen koodi on 1234, tähän laitetaan 01234.

Koodisto:

https://virkailija.opintopolku.fi/koodisto-service/rest/json/oppilaitosnumero/koodi

Opetuspiste

99

9999999

	2 6	Hakutoiveen opetuspisteen numero	https://virkailija.opintopolku.fi/koodisto-service/rest/json/opetuspisteet/koodi
Opetuspisteennimi	xx	180	Hakutoiveen opetuspisteen nimi	Toimipisteen nimi
Yhkoulu	9999	4	Hakutoiveen yhteishaun koulukoodi	JÄÄ POIS. Ei ole enää.
Koulutus	999

3

Hakutoiveen hakukohdekoodi

HAKUKOHDEKOODI

Joustoperuste

Harkinnanvaraisuusperuste

9

1

~~Hakutoiveen mahdollinen joustoperuste:~~

1 = Terveydelliset syyt

2 = Oppimisvaikeudet

3 = Ammatillisen peruskoulutuksen puuttuminen

4 = Koulutodistuksen vertailuvaikeudet

5 = Harrastustoimintaan liittyvät syyt

6 = Urheilijan ammatillisen koulutuksen järjestäminen

7 = Sosiaaliset syyt

8 = Työllistymisen turvaamiseen liittyvät syyt

9 = Muu syy

Harkinnanvaraisuuden peruste:

1= oppimisvaikeudet

2=sosiaaliset syyt

3=Koulututodistusten vertailuvaikeudet

KORVAUTUNUT TIETO.

Harkinnanvaraisuuden peruste.

1= oppimisvaikeudet

2=sosiaaliset syyt

3=Koulututodistusten vertailuvaikeudet

4=todistusten puuttuminen

Urheilijan ammatillinen koulutus

9

1

1 = kyllä

0=Ei

Hakeeko hakija urheilijan ammatilliseen koulutukseen

Yhteispisteet

999.99

4,2

Hakutoiveen yhteispisteet

erotinmerkkinä piste (.)

Valinta

9

1

Hakutoiveen valintatieto:

Valinnan tilat (=sijoittelun tulos)

1=hyväksytty

2=varalla

3=hylätty

4=peruuntunut

5=peruutettu

tyhjä

Tila-koodisto muuttunut

Vastaanotto

9

1

Hakutoiveen vastaanottotieto:

Vastaanottotilat

1 = Kesken

2 = Ilmoitettu

3 =Vastaanottanut

4 =Perunut

5 =Ei vastaanottanut määräaikana

6 = Peruutettu

tyhjä

Tila-koodisto muuttunut


Lasnaolo	9	1	Läsnäolotieto: 1 = Läsnä 2 = Poissa tyhjä	Tila-koodisto muuttunut
Terveys	x	1	X = hakijalla on terveyteen liittyviä lisätietoja	Vrt. ns. SORA lainsäädäntö
Aiempiperuminen	x	1	X = aikaisemman opiskelupaikan peruminen	Vrt. ns. SORA lainsäädäntö
Kaksoistutkinto	X	1	X=kiinnostunut suorittamaan kaksoistutkinnon	Henkilö on kiinnostunut suorittamaan kaksoistutkinnon (= ammatillinen perustutkinto+ylioppilastutkinto)

Space shortcuts

Page tree

Versions Compared

Old Version 22

New Version Current

Key

Kuvaus Opetushallituksen Opintopolku –järjestelmän tuottamasta siirtotiedostosta vastaanottavalle oppilaitokselle.

Koulutukseen hakeneiden ja valituksi tulleiden tiedot ammatilliseen koulutukseen ja lukiokoulutukseen yhteishaussa vuonna 2014

XML-Siirron formaatin määrittävät tässä esitellyt xml-skeemat:

KOODISTOT:

Keskeisimmät tässä esiteltynä:

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 22

New Version Current

Key

Kuvaus Opetushallituksen Opintopolku –järjestelmän tuottamasta siirtotiedostosta vastaanottavalle oppilaitokselle.

Koulutukseen hakeneiden ja valituksi tulleiden tiedot ammatilliseen koulutukseen ja lukiokoulutukseen yhteishaussa vuonna 2014

XML-Siirron formaatin määrittävät tässä esitellyt xml-skeemat:

KOODISTOT:

Keskeisimmät tässä esiteltynä: