Hakijoiden ja ilmoittautumisten tuonti perusrekisteriin
Oheismateriaali
Opintopolun rajapinnan käyttöä varten on olemassa valmista koodia:
- KSHJ:ta lukevan palvelun toteutuksessa voi ottaa mallia PHP-luokasta OpintopolkuClient.php, jota käytetään OILIssa.
- Hoitaa CAS-autentikoitumisen tarvittaessa. Handlaa istunnot.
- Cachettaa hakutuloksia paikalliseen mysql:ään.
- OPH tarjoaa myös java-esimerkin.
Hakijoiden tuominen KSHJ:sta saapumisryhmään (s. 12)
- Tulostetaan hakukohteiden hakulomake, jossa valintoina:
- Aloitusvuosi (oletus kuluva vuosi)
- Aloituskausi (oletus syksy/kevät riippuen vuodenajasta, miten?)
Haetaan ja listataan hakukohteet
Huom. Ryhmitellään hakutulokset alaorganisaatioittain, hakutavan ja hakuOid:n mukaan.
Riittääkö, että tulostetaan hakutapa (esim. Yhteishaku) vai tulisiko hausta olla tarkat tiedot (eli haut erikseen hakuOid:n perusteella KSHJ:sta tai paikallisesta koodistosta/cachesta)?- Valitaan listalta yksi tai useampi hakukohde (esim. 1.2.246.562.20.72702672378 / "Kulttuurituottaja (ylempi AMK), kulttuurituotanto")
- Listalla valitse kaikki / poista valinnat
- Klikataan "Näytä hakijat"
- Haetaan ja listataan hakijat (hakukohteittain mikäli valintoja oli ed. vaiheessa useita).
- Kälissä lisärajaukset: vain valitut (oletus=true), vain paikan vastaanottaneet (true), vain ilmoittautuneet (?)
- Listalla valitse kaikki / poista valinnat (hakukohteittain)
- Listalla tieto, onko opiskelija jo Perusrekisterissä (Liekö erikseen tarpeen?)
- Listalla tieto, onko opiskelijalla opiskeluoikeuksia
- Näytetään opiskeluoikeuksien tiedot + valinta "Liitä opiskeluoikeuteen"
- Korostus, mikäli opiskeluoikeus luotu n kk sisällä (esim. 3 kk, ks. vaatimusmäärittely)
- Hakukohteittain lomakekentät, joilla hakukohde yhdistetään olemassa olevaan saapumisryhmään (poiminta) tai uuteen saapumisryhmään (nimi automaattisesti hakukohteen nimestä + aloitusvuodesta + lukukaudesta, lisäksi valittavissa/valittava ainakin toimipiste)
- Ks. tarkemmin vaatimusmäärittelyn kohta A006b1
Lomakkeen lähetys
Talletetaan saapumisryhmät, opiskelijat, opiskeluoikeudet Perusrekisterin tietokantaan. Talletetaan opiskeluoikeuden liitos saapumisryhmään.
Poikkeus: mikäli valittu "Liitä opiskeluoikeuteen", ks. vaatimusmäärittely s. 12–13 ja s. 22."merkitään opiskelijan läsnäoloriville tieto että kyseessä on siirtoopiskelija ja täydennetään automaattisesti/manuaalisesti lähtöorganisaatio yms. siirtoopiskelua koskevat tiedot (tarkemmin kohdassa A012)"- Opiskelijatiedot / henkilötiedot lisätään / päivitetään kaikille poimituille hakijoille.
- Merkitään hakukohteen id uusien (prosessissa luotujen) saapumisryhmien tietoihin (TODO esim. group.)
- Merkitään uusien opiskelijoiden ja opiskelijaoikeuksien statukseksi INCOMPLETE tai APPLICANT
- TODO: lisätään tietokantaan student.status ja study_entitlement.status -kentät
- KSHJ:sta saadaan tässä yhteydessä myös pohjakoulutus (ks. s. 58)
Tulostetaan lista tuoduista opiskelijoista saapumisryhmittäin. Näytetään linkit opiskelijatietojen / opiskeluoikeuksien muokkaukseen.
Lukukausi-ilmoittautuminen ja läsnäolotiedot
Perusrekisteriin tarvittaneen tuki sekä valtakunnalliseen lukukausi-ilmoittautumiseen (OILI) että rajapinta, johon ilmoittautuminen kirjataan muusta (korkeakoulun omasta) järjestelmästä.
OILI
Oili lähettää automaattisesti tiedon lukukausi-ilmoittautumisesta / maksuista korkeakoulun määrittelemään osoitteeseen. Lisäksi Oili tarjoaa rest-rajapinnan ilmoittautumisten hakuun (sekä vastaavan graafisen käyttöliittymän). Näin ollen Perusrekisterissä on toteutettava:
- Palvelu (url), jolle OILI lähettää tiedon uudesta ilmoittautumisesta
- Asiakasohjelma ("OILIClient"), joka lukee ilmoittautumistiedon OILIn tarjoamasta rest-rajapinnasta
Huom! Lähitulevaisuudessa OILIn kautta hoidetaan ainoastaan uusien opiskelijoiden ilmoittautumiset. Tilanne voi olla Perusrekisterin käyttöönoton yhteydessä jo toinen.
KSHJ
- Uusien opiskelijoiden tuonnin yhteydessä läsnäolotieto saadaan suoraan myös Opintopolun rajapinnasta (hakemus.ilmoittautumistieto). Ks. yllä. vrt. s. 17.
Muut järjestelmät
- Tarvitaan palvelu / rajapinta ilmoittautumisten tuontiin. Käytetään samaa rajapintaa kuin mihin Oili toimittaa ilmoittautumistiedon.
Kysymyksiä
- Miten KSHJ:sta saatavat koulutusta/hakukohdetta koskevat tiedot mäppäytyvät Perusrekisteriin?
- Onko hakukohde = opiskeluoikeus = saapumisryhmä?
- Onko koulutus (komoId) = opiskeluoikeuden jakso = tutkinto-ohjelma?
- Mikäli KSHJ:sta tulevassa hakukohteessa on useita koulutuksia, luodaanko näille erilliset opiskeluoikeudet? Ainakin yliopistomaailmassa mahdollista esim. hakukohde sisältää LuK & FM -koulutukset. Tällöin hoidettava kaiketi opiskelijaroolien linkitys tavalla tai toisella.
- Ks. myös opiskeluoikeuden jakso.
- VIRTA: Tarvitseeko läsnäolotietoja hakea (muuten kuin migraatiossa) VIRTA-palvelusta? Ilmeisesti VIRTA-kyselyt on ennen kaikkea ilmoittautumissovelluksen tehtävä.