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)

1. Tulostetaan hakukohteiden hakulomake, jossa valintoina:
   
   • Aloitusvuosi (oletus kuluva vuosi)
   • Aloituskausi (oletus syksy/kevät riippuen vuodenajasta, miten?)

2. Haetaan ja listataan hakukohteet

   expand source 

   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)?
   
   

3. 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"
4. 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
     
     
   expand source 

5. 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 siirto­opiskelija ja täydennetään automaattisesti/manuaalisesti lähtöorganisaatio yms. siirto­opiskelua 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.source_reference)
   • 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ä.