You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 79 Next »

Palvelukortti

Palvelun nimi

eHOKS

Palvelun kuvaus
eHOKS kokoaa opiskelijan henkilökohtaisen osaamisen kehittämissuunnitelman (HOKS) tietoja yhteen paikkaan ja tarjoaa mahdollisuuden katsella niitä Opintopolussa. eHOKS koostuu valtakunnalliseen tietovarantoon siirrettävistä HOKS-tiedoista sekä tietojen katseluun ja hyödyntämiseen tarkoitetuista käyttöliittymistä.

HOKS laaditaan ja siihen liittyvä tieto tuotetaan koulutuksen järjestäjän omissa järjestelmissä, josta valtakunnallisella tasolla tarvittavat tiedot siirretään tietovarantoon rajapintojen kautta. Tietovarannossa olevat eHOKS-tiedot ovat opiskelijan, koulutuksen järjestäjän sekä opiskelijan vastuullisen työpaikkaohjaajan ja osaamisen arvioijan saatavilla siltä osin, kun heillä on oikeus saada tietovarantoon sisältyviä tietoja.

Palvelu on osa  Opetushallituksen toteuttamaa Opintopolku-kokonaisuutta.

eHOKS-palveluun ja tietosisältöön liittyvät säädökset:

Palvelun toiminta, tiedot ja sovellukset on mallinnettu ratkaisuarkkitehtuuriin.

Palvelun omistaja Opetushallituksen Oppijan palvelut -yksikkö
Palvelun kohderyhmä

 Palvelujen käyttäjiä ovat

  • oppijat
  • koulutuksen järjestäjät: erityisesti HOKSeja opiskelijoiden ja työpaikan toimijoiden kanssa laativat, hyväksyvät ja päivittävät henkilöt.
  • työpaikan toimijat: vastuullinen työpaikkaohjaaja, työelämän arvioija osaamisen osoittamisessa
Toiminnallisuudet

 Palvelu koostuu tietojen tallentamiseen ja katseluun tarkoitetuista toiminnallisuuksista:

  • rajapinnat tietojen tallentamiseen opintohallintojärjestelmistä eHOKS-palveluun
  • syöttökäyttöliittymä tietojen tallentamiseen manuaalisesti eHOKS-palvelussa niille toimijoille, joilla ei ole rajapintaratkaisua käytössä
  • käyttöliittymät tietojen katseluun (oppija, koulutuksen järjestäjä)
  • tietojen jakamiseen tarkoitettu toiminnallisuus on kehitteillä.
Palvelun tyyppiDigitaalinen palvelu
Käyttöohjeet

eHOKSia koskeva määräys tietojen tallentamisesta ja ohjeistuksesta annetaan osana Koski-määräystä. 

Ohjeita palvelun käyttöön ja tietojen tallentamiseen kootaan wiki-sivuille: 

ProsessikuvauksetKts. ratkaisuarkkitehtuuri
Tietomalli

Tietoluettelo eHOKS-palveluun tallennettavista tiedoista: eHOKS Tietoluettelo 23.6.2022 v4.0.pdf

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ö

KoodistotKoodistot eHOKS-palvelussa
Käsitteet
Tekninen dokumentaatio


Rajapinnat

API-kuvaus 
https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/json-viewer/index.html

API doc -kuvaus https://github.com/Opetushallitus/ehoks/blob/master/doc/hoks.md

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:
https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/api/v1/validointi )

Yksinkertainen esimerkkijson, jossa vain päätasolla HOKS-tietoja: esimerkkijson_ehoks.json

Koko JSON-rakenne: koko_hoks_rakenne.json

Tietokantakuvaukset
Versioitu lähdekoodi
Tietoturva
Kehitysnäkymä
Julkaisutiedot (release notes)
Raportoidut virheet (bugit)
Linkit palveluun
YmpäristöRooliUrlHuomioita
QAOppijahttps://testiopintopolku.fi/ehoks/
QAVirkailija



QATiedonsiirto

https://virkailija.testiopintopolku.fi/ehoks-virkailija-backend/api/v1/hoks

HOKSin lähetys method POST ja content-type="application/json"


QADokumentaatiot

Skeema:

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#/validointi


PRODVirkailijaKoulutuksen järjestäjän katselunäkymä. Julkaistaan virkailijan Opintopolkuun viimeistään elokuussa 2019.

Tiedonsiirtohttps://virkailija.opintopolku.fi/ehoks-virkailija-backend/api/v1/hoksHOKSin lähetys method POST ja content-type="application/json"

DokumentaatiotSwagger: https://virkailija.opintopolku.fi/ehoks-virkailija-backend/doc/index.html#!/hoks/




Lisensiointi

Yhteystiedot

ehoks@opintopolku.fi



  • No labels