LRMI_FI:n suositeltavat sanastot

LRMI määrittää valikoidun setin konsepteja, joita suositellaan eri ominaisuuksien sisällöksi. Näitä sanstoja on laadittu osaksi LRMI:tä alignmentTypelle, educationalRolelle ja educationalUselle. LRMI_FI laajentaa ja tarkentaa suomalaiseen koulutuksen kontekstiin näitä LRMI:n suosittelemia sanastoja, jonka lisäksi myös muille ominaisuuksille suositellaan käytettävän kontrolloituja sanastoja. Nämä edistävät entisestään eri järjestelmien yhteentoimivuutta ja myös helpottavat implementaatioprosessia.

Suositeltavat sanastot on linkitetty spesifikaation taulukoihin, mutta ne löytyvät lisäinfon kera myös tältä sivulta. Sanastoja on suositeltu seuraaville ominaisuuksille:

• Oppiaine, tutkinnon osa, tieteenala
• Tavoite
• Kohderyhmä
• Käyttötarkoitus
• Materiaalin tyyppi
• EducationalAlignment
• Koulutusaste
• Vaikeustaso
• Saavutettavuusominaisuudet
• Saavutettavuuden esteet
• Saavutettavuuden hallinta
• Asiasanat
• Lisenssi
• Organisaatio
• Kieli

Sanastojen käyttöönoton helpottamiseksi tämä dokumentaatio on listannut sanastot niiden sijaintipaikan mukaisessa järjestyksessä:

Yhteentoimivuusalustan koodistot

Yhteentoimivuusalustan koodistoja voi käyttää avoimia rajapintoja pitkin. Ne on myös ladattavissa eri muotoisina kunkin koodiston osoitteessa ja otettavissa sen avulla eri järjestelmissä käyttöön. Ohjeet rajapinnan käyttööottoon Yhteentoimivuusalustan wikisivuilta. Suorat linkit koodistoihin näet alta. Linkkien takaa löydät sanastot määritelmineen.

Finton YSO-asiasanasto

Yso on käytettävissä Finton avoimen rajapinnan kautta. Mikäli huomaatte kuvailussa että YSO:sta puuttuu keskeisiä termejä, on niitä kannatettavaa ehdottaa Kansalliskirjastolle. Ilmoituskanava uusista termeistä on YSO-sivun alalaidassa.

Opetushallituksen sanastot

Opetushallitus ylläpitää useita koulutuksen yhteentoimivuuteen liittyviä palveluita. LRMI_FI suosittelee ottamaan näistä suositeltuja arvoja oppiaine, tavoite, organisaatio ja kieli -ominaisuuksille. Opetushallituksen ylläpitämät tiedot on saatavilla Opintopolun rajapinnan kautta. Yleinen dokumentaatio ePerusteiden rajapinnoista löytyy Githubista.  Koodistopalvelun dokumentattio on omalla wikisivustollaan ja Organisaatiopalvelun dokumentaatio omalla wikisivustollaan.

Kaikkia näitä Opetushallituksen avoimia rajapintaa hyödyntävien on lisättävä kutsuihinsa Caller-id, josta lisätietoa tässä linkissä.

Seurataksesi ePerusteiden rajapintojen mahdollisia muutoksia, tarkkaile ePerusteiden Githubin muutoslokia.

ePerusteiden rajapinnat sisältävät huomattavan paljon enemmän tietoa kuin mitä LRMI_fi hyödyntää. Saat ePerusteiden rajapinnasta opetussuunnitelman koko tiedot hierarkisessa muodossa. LRMI_fi hyödyntää pääasiassa nimi- ja tunnistetietoja oppiaineille, tavoitteille, sisältöalueille, laaja-alaisen osaamisen alueille, moduuleille, tutkinnoille, tutkinnon osille ja ammattitaitovaatimuksille. Nimitieto on poimittavissa sekä suomeksi että ruotsiksi. Alla olevassa esimerkissä nimitiedot ovat yksinkertaisuuden vuoksi vain suomeksi. Esimerkiksi xml-esimerkistä näet, miten hyödyntämällä kieliatribuutteja samalle tiedolle välitetään useampi kielinen versio. Alta näet koulutusastekohtaisesti, mitä arvoja poimia ePerusteiden rajapinnasta ja miten ne istuvat LRMI:n malliin JSON-LD-muodossa.

Esimerkit ePerustetiedon hyödyntämisestä LRMI_fi:ssä

Perusopetus

Oppiaineet

"educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "educationalFramework": "Perusopetuksen opetussuunnitelman perusteet 2014",
      "targetName": "Matematiikka",
      "targetUrl": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/419550/perusopetus/oppiaineet/466344"      
    },

Tavoiteet, sisältöalueet ja laaja-alaiset osaamisen alueet

"teaches": [
    {
      "@type": "DefinedTerm",
      "name": "T2 kannustaa oppilasta monipuolistamaan ryhmäviestintätaitojaan ja kehittämään taitojaan perustella näkemyksiään sekä kielellisiä ja viestinnällisiä valintojaan",
	  "identifier": "721291"
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "url": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/419550/perusopetus/oppiaineet/oppimaarat/466341"
      }
    },
"teaches": [
    {
      "@type": "DefinedTerm",
      "name": "S2 Tekstien tulkitseminen",
	  "identifier": "466631"
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "url": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/419550/perusopetus/oppiaineet/oppimaarat/466341"
      }
    },
"teaches": [
    {
      "@type": "DefinedTerm",
      "name": "L1 Ajattelu ja oppimaan oppiminen",
	  "identifier": "428670"
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "url": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/419550/perusopetus/laajaalaisetosaamiset/"
      }
    },

LRMI_fi:ssä koulutusaste ilmaistaan erikseen. Joissain tapauksessa materiaali voi kohdistua usean vuosiluokan samalle oppiaineelle ja oppiaineen tarkempia tietoja halutaan erotella tietojen näyttämistä varten. Tunnistetiedon perusteella vuosiluokan voi hakea ePerusteiden tiedoista. Tarvittaessa myös educationalFramework-tietoon voi tarkentaa vuosiluokkakokonaisuuden.

Teachesilla voi ilmaista myös paikallisen opetussuunnitelman mukaisesti sisältöalueiden tarkennuksia. Lisäksi samalla tavalla voidaan ilmaista myös muita, esimerkiksi tarkennettuja tavoitteita ja sisältöalueita. Näissä vapaamuotoisimmissakin tavoitteissa ja sisältöalueissa on hyvä huomioida, että ne olisivat kuvattu ja pysyvillä tunnisteilla varattuja, jotta niitä voitaisiin hyödyntää myös oman käyttötarkoituksen ulkopuolella. Ohessa esimerkki Helsingin yliopiston Viikin Normaalikoulun paikallisesta tarkennuksesta ja sen ilmaisemisesta: 

"teaches": [
    {
      "@type": "DefinedTerm",
      "description: "<p>Looginen ajattelu</p>\n\n<ul>\n\t<li>yhtäläisyyksien erojen ja säännönmukaisuuksien löytäminen</li>\n\t<li>vertailu, luokittelu ja järjestykseen asettaminen</li>\n\t<li>syy-seuraussuhteiden ja yhteyksien havaitseminen</li>\n</ul>\n\n<p>Matemaattisten tilanteiden analysointi</p>\n\n<ul>\n\t<li>matemaattisten ilmiöiden tunnistaminen arkielämän tilanteissa ja niiden analysoiminen matemaattisin käsittein</li>\n</ul>\n\n<p>Ongelmanratkaisutaidot</p>\n\n<ul>\n\t<li>erilaisten ongelmanratkaisustrategioiden harjoittelu ja soveltaminen</li>\n</ul>\n\n<p>Ohjelmointi</p>\n\n<ul>\n\t<li>ohjelmien suunnittelu ja toteutus graafisessa ohjelmointiympäristössä</li>\n</ul>",
	  "identifier": "8606773"
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "url": "https://eperusteet.opintopolku.fi/eperusteet-ylops-service/api/external/opetussuunnitelma/98806"
      }
    },

Lukio

Oppiaineet, oppimäärät ja moduulit

"educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "educationalFramework": "Lukion opetussuunnitelman perusteet 2019",
      "targetName": "Filosofia",
      "targetUrl": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/6828810/lops2019/oppiaineet/6832794"      
    },
"educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "educationalFramework": "Lukion opetussuunnitelman perusteet 2019",
      "targetName": "Johdatus filosofiseen ajatteluun",
      "targetUrl": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/6828810/lops2019/oppiaineet/6832794/moduulit/6833502"      
    },

 Tavoiteet, sisältöalueet ja laaja-alaiset osaamisen alueet

"teaches": [
    {
      "@type": "DefinedTerm",
      "name": "muodostaa käsityksen filosofian luonteesta ja menetelmistä tutustumalla filosofisiin ongelmiin ja niiden mahdollisiin ratkaisuihin",
	  "identifier": "6833594"
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "url": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/6828810/lops2019/oppiaineet/6832794"
      }
    },
"teaches": [
    {
      "@type": "DefinedTerm",
      "name": "mitä filosofia on, filosofinen kysymyksenasettelu sekä ajattelu filosofian perinteessä ja ajankohtaisissa aiheissa",
	  "identifier": "6833599"
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "url": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/6828810/lops2019/oppiaineet/6832794"
      }
    },

Ammatillinen koulutus

Tutkinnot ja tutkinnon osat

"educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "educationalFramework": "Stadin AO: Ajoneuvolana perustutkinto 2022",
      "targetName": "Ajoneuvoalan perustutkinto",
      "targetUrl": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/3397336"      
    },
"educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "targetName": "Huolto- ja korjaustyöt",
      "targetUrl": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/3397336/perusteenosa/3489900"      
    },

Huomioi myös, että esimerkissä näkyvän paikallisen perusteen tiedot eivät ole saatavilla esimerkin rajapinnasta vaan tieto on yhdistettävä id-tiedon avulla, joka vastaa paikallisissa toteutussuunnitelmissa olevaa perusteid-tietoa. EducationalFramework ei ole pakollinen tieto, mutta voi olla hyödyllinen joissain toteutuksissa. Saat tiedot paikallisista toteutussuunnitelmista seuraavien rajapintakutsujen kautta:

• Kaikki toteutussuunnitelmat: https://eperusteet.opintopolku.fi/eperusteet-amosaa-service/api/external/opetussuunnitelmat
• Tietyn tutkinnon toteutussuunnitelmat: https://eperusteet.opintopolku.fi/eperusteet-amosaa-service/api/external/opetussuunnitelmat?perusteId=${perusteid} 
  
  • Esimerkiksi Ajoneuvoalan perustutkinnon toteutussuunnitelmat: https://eperusteet.opintopolku.fi/eperusteet-amosaa-service/api/external/opetussuunnitelmat?perusteId=3397336
• Tietyn toteutussuunnitelman tarkemmat tiedot:  https://eperusteet.opintopolku.fi/eperusteet-amosaa-service/api/external/opetussuunnitelma/${tutkintosuunnitelmanid}
  • Esimerkiksi Stadin AO:n ajoneuvoalan perustutkinnon toteutussuunnitelman tiedot https://eperusteet.opintopolku.fi/eperusteet-amosaa-service/api/external/opetussuunnitelma/702471

Paikallisissa toteutussuunnitelmissa voi olla tietoja, joita halutaan välittää LRMI_fi:n avulla. Esimerkiksi paikalliset tutkinnon osat voidaan välittää perusteiden tutkinnon osien tavoin educationalSubject-tiedolla ja muun tarkentavan tiedon esimerkiksi hyödyntämällä teaches-ominaisuutta.

Ammatillisen koulutuksen tutkinnot päivittyvät usein. Monessa järjestelmässä onkin tarve hallinnoida tähän liittyvää tietoa. Ammatillisten koulutusten osalta voikin olla tarpeen säilöä myös unix-aikaa ilmaisevat voimassaoloAlkaa, voimssaoloLoppuu ja siirtymaPaattyy -tietoja, jotta eri prosesseissa näytetään oikeaa tietoa. Tutkintojen osalta on hyvä huomioida, ettei tutkinnon nimi välttämättä muutu sen päivittyessä, mutta id muuttuu. Voimassa olevilla tutkinnoilla on vain voimassaoloAlkaa-tieto ja muut tiedot päivittyvät tutkinnolle kun kyseisen tutkinnon korvaava tutkinto on asetettu, tiedot pitää siis myös päivittää aika-ajoin rajapinnasta. Tieto voi olla relevantti paitsi järjestelmän toimijoille, myös käyttäjille. Esimerkiksi aoe.fi:ssä oppimateriaalin kuvailijalle ja etsijälle näytetään tieto, onko tutkinto siirtymäajalla (esim. "Autoalan perustutkinto (Siirtymäajalla)") vai voimassa oleva (esim. "Ajoneuvoalan perustutkinto").

Ammattitaitovaatimukset

"teaches": [
    {
      "@type": "DefinedTerm",
      "name": "tunnistaa musiikkialan keskeiset toimijat",
	  "identifier": "2255"
      "inDefinedTermSet": {
        "@type": "DefinedTermSet",
        "url": "https://virkailija.opintopolku.fi/eperusteet-service/api/external/peruste/7846219"
      }
    },