eHOKS HOKS laaditaan ja siihen liittyvä tieto tuotetaan koulutuksen järjestäjän omissa järjestelmissä, josta valtakunnallisista opinto- ja tutkintorekistereistä annetussa laissa säädetyt tiedot tallennetaan eHOKS-palveluun. Opiskelija ja koulutuksen järjestäjä voivat katsoa HOKS-tietoja eHOKS-palvelussa. Tavoitteena on avata eHOKS-palveluun näkymä myös opiskelijan työpaikalla järjestettävään osaamisen hankkimiseen ja osoittamiseen osallistuville nimetyille vastuullisille työpaikkaohjaajille ja osaamisen arvioijille. eHOKSiin tallennettuja tietoja hyödynnetään säännöllisesti myös ammatillisen koulutuksen valtakunnallisen opiskelijapalautteen ja työelämäpalautteen keräämisessä ja Opetushallinnon tilastopalvelu Vipusessa julkaistavilla raporteilla. eHOKS on osa Opetushallituksen toteuttamaa Oma Opintopolku -kokonaisuutta. eHOKS-palveluun ja tietosisältöön liittyvät säädökset: Palvelun toiminta, tiedot ja sovellukset on mallinnettu ratkaisuarkkitehtuuriin. Tietosuojaseloste: https://opintopolku.fi/konfo/fi/sivu/ehoks-palvelun-tietosuojaseloste Palvelujen käyttäjiä ovat eHOKS-palveluun tallennettuja tietoja hyödyntäminen: Palvelu koostuu tietojen tallentamiseen ja katseluun tarkoitetuista toiminnallisuuksista: eHOKSia koskeva määräys tietojen tallentamisesta ja ohjeistuksesta annetaan osana Koski-määräystä. Wikisivusto: Tietoluettelo eHOKS-palveluun tallennettavista tiedoista: eHOKS Tietoluettelo 23.6.2022 v4.0 / ePUK Uppgiftsförteckning 23.6.2022 v4.0 eHOKSiin tallennettavien tietojen tietomalli: https://virkailija.opintopolku.fi/ehoks-virkailija-backend/json-viewer/index.html Kuvaukset ja ohjeita eHOKSiin tallennettavista tiedoista eHOKSin wikissä olevien ohjeiden Tietosisältö-osiossa: Tietosisältö API-kuvaus API doc -kuvaus https://github.com/Opetushallitus/ehoks/blob/master/doc/hoks.md Rajapintojen kuvaukset https://virkailija.opintopolku.fi/ehoks-virkailija-backend/doc/index.html#/ Tiedonsiirron rajapintojen kehittäjille on validointi-api, jossa voi testata dataa tietomallin skeemaa vastaan: https://testiopintopolku.fi/ehoks-virkailija-backend/doc/index.html#!/validointi/post_ehoks_backend_api_v1_validointi (Tätä voi myös testata lähettämällä bodyssa HOKSin JSON-dataa: Yksinkertainen esimerkkijson, jossa vain päätasolla HOKS-tietoja: esimerkkijson_ehoks.json Koko JSON-rakenne: koko_hoks_rakenne.json https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/api/v1/hoks HOKSin lähetys method POST ja content-type="application/json" Skeema: Yhteystiedot ehoks@opintopolku.fiPalvelukortti
Palvelun nimi Palvelun kuvaus Linkki palveluun https://opintopolku.fi/ehoks/ Palvelun omistaja Opetushallituksen Valtakunnalliset tietovarannot -yksikkö Palvelun kohderyhmä ja palveluun sisältyviä tietoja hyödyntävät toimijat Toiminnallisuudet Palvelun tyyppi Digitaalinen palvelu Käyttöohjeet Prosessikuvaukset Kts. ratkaisuarkkitehtuuri Tietomalli Koodistot Koodistot eHOKS-palvelussa Käsitteet Tekninen dokumentaatio Rajapinnat
https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/json-viewer/index.html
https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/api/v1/validointi )Tietokantakuvaukset Versioitu lähdekoodi Tietoturva Kehitysnäkymä Julkaisutiedot (release notes) Raportoidut virheet (bugit) Linkit palveluun Ympäristö Rooli Url Huomioita QA Oppija https://testiopintopolku.fi/ehoks/ QA Virkailija QA Tiedonsiirto QA Dokumentaatiot
https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/json-viewer/index.html
Swagger:
https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/doc/index.html#!/hoks/
Validointi-api:
https://testiopintopolku.fi/ehoks-oppija-backend/doc/index.html#/validointiPROD Virkailija Koulutuksen järjestäjän katselunäkymä. Julkaistaan virkailijan Opintopolkuun viimeistään elokuussa 2019. Tiedonsiirto https://virkailija.opintopolku.fi/ehoks-virkailija-backend/api/v1/hoks HOKSin lähetys method POST ja content-type="application/json" Dokumentaatiot Swagger: https://virkailija.opintopolku.fi/ehoks-virkailija-backend/doc/index.html#!/hoks/ Lisensiointi