1 Johdanto
Kaakkuri on Jyväskylän yliopiston tietotekniikan laitoksella toteutettu sovellusprojekti. Projekti toteutti tietotekniikan laitokselle sovelluksen, jonka avulla voidaan laatia lukukauden luentolukujärjestys. Lukujärjestyksen laatimiseksi täytyy ottaa huomioon useita rajoitteita, jotka hankaloittavat suunnittelutyötä. Sovelluksen avulla on tarkoitus helpottaa tätä suunnittelutyötä, sekä tehdä salivaraukset suoraan Korppi-järjestelmään.
Tässä käyttöohjeessa kerrotaan Kaakkuri-sovelluksen ominaisuuksista ja annetaan neuvoja Kaakkuri-sovelluksen käyttämiseen. Lisäksi dokumentti sisältää sovelluksen asennusohjeen.
2 Termejä
Luvussa selitetään muutamia aihealueeseen liittyviä termejä ja lyhenteitä.
Blokki Blokki on apuväline säännöllisen kurssin luentojen sijoittamisessa. Blokkia kuvataan isolla kirjaimella: A, B, C jne. Blokki sitoo yhteen tiettyjä kellonaikoja, tiettyinä päivinä viikossa (blokki A voi siis olla esimerkiksi seuraavanlainen: ma 10-12 ja ti 12-14). Blokkiin A sijoitetut kurssit siis toistuvat joka viikko blokkiin kiinnitettyinä ajankohtina.
Tapahtumaryhmä
Tapahtumaryhmä sisältää tietyn tyyppistä tapahtumaa (luento, demo, ohjaus…) niin monta kappaletta kuin kyseinen tyyppi kurssissa kestää viikoissa. Tämä tieto voidaan laskea, kun tiedetään kuinka monta kyseisen tyypin tapahtumaa kurssissa on ja kuinka monta kertaa viikossa.
Java Java on oliopohjainen, laitteistoriippumaton ohjelmointikieli, mikä mahdollistaa Javalla kirjoitettujen sovellusten ajamisen useilla eri laitteistoarkkitehtuureilla.
Korppi Korppi on
opintotietojärjestelmä, joka tarjoaa tietoa ja työvälineitä mm. opiskelijoille
ja opettajille. Korppi-järjestelmän avulla voidaan mm. ilmoittautua kursseille
ja tentteihin, varata opetusta varten saleja ja muita työvälineitä.
Korppi-järjestelmä löytyy osoitteesta: https://korppi.jyu.fi/
3
Sovelluksen käyttöliittymän yleiskuvaus
Luvussa käydään läpi sovelluksen käyttöliittymän yleiskuvaa.
3.1 Käyttöliittymän yleiskuvaus
Perustilassaan sovelluksen käyttöliittymä näyttää seuraavanlaiselta:
4 3 1 2
Kuva 1 Käyttöliittymän yleiskuva
- Lukujärjestysnäkymä, josta nähdään varsinainen suunniteltu lukujärjestys.
- Puunäkymä, joka sisältää kaikki suunnittelussa käytettävät kurssit, kurssiin kuuluvat luentoryhmät ja luennot.
- Kurssin inforuutu, joka näyttää lisätietoja kulloinkin puunäkymässä 1 valittuna olevasta kurssista.
- Virheilmoitusruutu, josta nähdään lukujärjestyksen suunnitteluvaiheessa esiintyvät mahdolliset ristiriitaisuudet kurssien sijoittelussa.
Käyttöliittymän eri osien kokoa suhteessa toisiinsa voidaan muuttaa siirtämällä näiden erottimena toimivaa liukupalkkia. Liukupalkin avulla voidaan myös tarvittaessa piilottaa osia kokonaan näkymättömiin. Tämän vuoksi sovellus ei välttämättä näytä täysin samalta kuin Kuva 1. Tarkemmat kuvaukset käyttöliittymän osista ja niiden toiminnasta löytyy seuraavasta luvusta.
3.2 Käyttöliittymän osat
Luvussa käydään läpi käyttöliittymän yksittäiset osat, niiden toiminta ja käyttö.
3.2.1 Lukujärjestys
Kuva 2 Lukujärjestysnäkymä
Tässä osassa nähdään varsinainen lukujärjestys jota ollaan suunnittelemassa. Kussakin taulukon solussa nähdään tiettyyn ajankohtaan suunnitellut opetustapahtumat. Opetustapahtumista näytetään kurssin tunnus, viikot joilla tapahtuma järjestetään kyseisenä ajankohtana, sekä tapahtumalle suunniteltu sali. Mikäli blokkijärjestelmä (luku 5.1) on käytössä, näkyvissä on lisäksi sen blokin tunnus johon solu kuuluu.
Käytettävissä on kaksi erilaista suunnittelutilaa, viikkonäkymä ja periodinäkymä. Käytettävä tila voidaan valita lukujärjestyksen yläreunassa olevien välilehtien avulla. Mikäli valittu näkymä on viikko, lukujärjestyksessä näkyy yksittäisen viikon tapahtumat. Jos taas valittu tila on periodi, lukujärjestyksessä näkyy kaikki kyseiselle periodille, eli useammasta viikosta koostuvalle ajanjaksolle suunnitellut tapahtumat. Kulloinkin näkyvissä olevaa viikkoa/periodia voidaan vaihtaa lukujärjestyksen yläpuolella olevien nuolien avulla, tai kirjoittamalla haluttu arvo suoraan tekstikenttään.
3.2.2 Puunäkymä
Kuva 3 Puunäkymä
Tässä näkymässä esitetään puumaisessa rakenteessa kaikki suunnittelussa käytettävät kurssit, tapahtumaryhmät ja yksittäiset tapahtumat. Puu on jaettu kahteen osaan, ”Sijoittamattomat kurssit” ja ”Sijoitetut kurssit”. Mikäli kaikille kurssiin kuuluville tapahtumille on määrätty aika, esitetään kyseinen kurssi ”Sijoitetut kurssit” -haaran alla. Muussa tapauksessa kurssi näkyy ”Sijoittamattomat kurssit” –haarassa.
Puu rakentuu siten, että kunkin kurssin alla oleva ensimmäisen tason haara pitää sisällään kaikki tietyn tyyppiset opetustapahtumat. Esimerkiksi ”Luennot” niminen haara sisältää kaikki Luento-tyyppiset tapahtumat. Tämän haaran alla esitetään tapahtumaryhmät. Tapahtumaryhmän avulla voidaan kuvata esimerkiksi yhtä viikkoluentoa. Tämän alla taas esitetään kaikki yksittäiset opetustapahtumat.
Puunäkymässä tapahtumien ja tapahtumaryhmien nimen edessä olevien neliöiden värien avulla ilmaistaan kyseisen kohteen tilaa. Värien merkitykset ovat seuraavat:
§ Vihreä: Tapahtumalle/tapahtumaryhmälle on määrätty aika ja paikka.
§ Keltainen: Tapahtumalle/tapahtumaryhmälle on määrätty aika, mutta ei paikkaa.
§ Punainen: Tapahtumalle/tapahtumaryhmälle ei ole määrätty aikaa eikä paikkaa.
3.2.3 Inforuutu
Kuva 4 Inforuutu
Inforuudun avulla saadaan tarvittaessa lisätietoja kulloinkin puunäkymässä valittuna olevasta kurssista. Inforuudun välilehtien avulla voidaan valita näytettävä informaatio. Info -välilehdeltä nähdään mm. kurssin laajuus ja yleinen kurssikuvaus. Toiveet -välilehden tarkoituksena on näyttää mahdollisia toiveita, joita kyseisestä kurssista vastaava opettaja on esittänyt. Ryhmät -välilehdeltä nähdään luettelo niistä kurssiryhmistä, joihin kurssi kuuluu (katso luku Kurssiryhmät).
3.2.4 Virheilmoitusruutu
Virheilmoitusruudun avulla sovelluksen käyttäjä saa palautetta mahdollisista virhetilanteista ja varoituksista liittyen lukujärjestyksen suunnitteluun. Esimerkiksi tilanteessa, jossa käyttäjä yrittää sijoittaa kaksi saman kurssin luentoa samaan aikaan, ilmestyy virheilmoitusruutuun kyseisestä tilanteesta kertova ilmoitus. Virheilmoitusruudussa voi olla näkyvissä useampi varoitus samanaikaisesti, ja kukin tiettyyn tilanteeseen liittyvä varoitus kokonaisuudessaan muodostaa yhden virheilmoitusryhmän. Näille ryhmille on annettu otsikko, joka on erotettu varsinaisesta virhetekstistä eri värillä. Otsikko sisältää myös virheilmoitusryhmän numeron, jonka avulla haluttu varoitus voidaan tarvittaessa poistaa näkyvistä käyttämällä Poista -painiketta.
4 Valikkorakenne
Luvussa käsitellään Kaakkuri-sovelluksen päävalikon rakenne, ja esitellään valikosta löytyvien toimintoja tarkempi toiminta.
4.1 Päävalikon yleiskuvaus
Sovelluksen päävalikon rakenne ja eri toimintojen selitykset on esitetty seuraavassa:
Tiedosto
Hae Korpista Hakee kurssien tiedot Korppi-järjestelmästä
Vie Korppiin Tallentaa suunnitellun lukujärjestyksen tiedot tiedostoon vietäväksi Korppi-järjestelmään.
Avaa Avaa tiedostosta aikaisemmin tallennetun tilanteen.
Tallenna Tallentaa suunnittelun tilanteen tiedostoon.
Tulosta Tulostaa näkyvillä olevan lukujärjestyksen.
Sivun asetukset Muokkaa tulostuksessa käytettäviä sivun asetuksia.
Lopeta Sulkee Kaakkuri-sovelluksen.
Muokkaa
Muokkaa blokkeja Käynnistää blokkieditorin, jonka avulla voidaan muokata suunnittelussa käytettävää blokkirakennetta. (katso luku 4.2)
Muokkaa kursseja Näyttää kurssien muokkausdialogin.
Muokkaa kurssiryhmiä Käynnistää editorin, jonka avulla voidaan muodostaa kurssiryhmiä.
Muokkaa omat salit Toiminnon avulla voidaan valita kaikista saatavilla olevista saleista vain halutut salit käyttöön.
Asetukset
Vaihda salinäkymä Toiminnon avulla voidaan vaikuttaa lukujärjestyksessä näkyvissä oleviin tapahtumiin, mikäli lukujärjestyksen yläpuolella olevasta luettelosta on valittu sali käyttöön.
4.2 Blokkieditori
Blokkieditorin avulla voidaan muodostaa halutunlainen blokkirakenne (katso luku 5.1). Blokkieditoria päästään käyttämään valitsemalla sovelluksen päävalikosta Muokkaa/Muokkaa Blokkeja.
Kuva 5 Blokkieditori
Blokkieditorin vasemmassa reunassa sijaitsee luettelo käytettävissä olevista blokeista. Uusia blokkeja voidaan lisätä luetteloon antamalla blokille vapaavalintainen tunniste luettelon yläreunassa olevaan tekstikenttään, ja valitsemalla Lisää. Vastaavasti Poista -painikkeen avulla voidaan poistaa blokkeja.
Blokkiluettelon oikealla puolella näkyy varsinainen blokkirakenne. Taulukossa on merkitty vihreällä ne solut, joita ei ole valittu kuuluvaksi mihinkään blokkiin. Vastaavasti varatut solut, eli ne, jotka on jo valittu kuuluvaksi johonkin blokkiin, on merkitty punaisella taustavärillä.
Blokkien muokkaaminen tapahtuu siten, että blokkiluettelosta valitaan blokki, jota halutaan muokata. Tällöin kyseiseen blokkiin kuuluvat solut korostetaan taulukossa keltaisella taustavärillä. Tämän jälkeen taulukon soluja klikkailemalla voidaan muodostaa blokkirakenne. Klikkaaminen vihreän solun päällä lisää solun valittuna olevaan blokkiin. Vastaavasti klikkaaminen solun päällä, joka jo kuuluu kyseiseen blokkiin(keltainen), poistaa solun blokista. Huomaa, että solu ei voi kuulua yhtäaikaisesti useaan blokkiin, joten varattuja (punaisia) soluja ei voi valita.
Kun blokkien muokkaaminen on saatu valmiiksi, blokkieditori voidaan sulkea valitsemalla Ok, jolloin blokkirakenne tallennetaan. Vastaavasti kaikki blokkirakenteeseen tehdyt muutokset voidaan perua valitsemalla Peruuta.
4.3 Omien salien valinta
Omien salien valinta –toiminnon avulla voidaan kaikista käytettävissä olevista saleista valita pienempi joukko omaan käyttöön. Ikkuna, jonka avulla salien valitseminen voidaan tehdä, näyttää seuraavalta:
Kuva 6 Omien salien valinta
Ikkuna sisältää kaksi luetteloa, joista vasemmanpuoleinen Salit –luettelo pitää sisällään kaikki käytettävissä olevat salit. Ne salit, jotka käyttäjä on valinnut omaan käyttöönsä, esitetään oikealla puolella olevassa Omat salit –luettelossa.
Käyttäjä voi valita haluamansa salit käyttöönsä valitsemalla kyseiset salit vasemmasta luettelosta ja klikkaamalla ’->’ painiketta, jolloin valitut salit kopioituvat oikealla näkyvään luetteloon. Vastaavalla tavalla saleja voidaan poistaa luettelosta ’<-’ painikkeen avulla.
Tarvittaessa saleille voidaan myös antaa lempinimi. Mikäli salille on annettu lempinimi, näytetään se mm. sovelluksen päänäkymän lukujärjestysnäkymässä varsinaisen nimen sijaan. Lempinimien avulla saleille voidaan antaa helpommin muistettavat nimet. Lempinimet mahdollistavat myös sen, että niiden avulla pitkien salien nimet voidaan esittää lyhyemmässä muodossa. Lempinimen antaminen salille tapahtuu valitsemalla ensiksi luettelosta sali, jolle lempinimi halutaan antaa. Tämän jälkeen haluttu nimi kirjoitetaan lempinimelle varattuun kenttään ikkunan alareunassa ja valitaan aseta. Asetettu lempinimi ilmenee saliluettelossa kunkin salin perässä lainausmerkeillä ympäröitynä. Salille annettu lempinimi voidaan poistaa antamalla salin lempinimeksi tyhjä merkkijono, eli tyhjentämällä lempinimelle varatusta ruudusta kaikki merkit ja valitsemalla Aseta.
4.4 Muokkaa kurssiryhmiä
Tämän toiminnon avulla voidaan muokata kurssiryhmiä. Kurssiryhmä on useammasta kurssista koostuva joukko, johon kuuluvat kurssit liittyvät jollakin tavalla toisiinsa. Tällaisia voivat olla esimerkiksi tietyn opintolinjan kurssit, tietyn vuoden opiskelijoille tarkoitetut kurssit, kevään/syksyn kurssit jne. Kurssiryhmien avulla voidaan helpottaa suunnittelutyötä siten, että sovellus näyttää lukujärjestystä laadittaessa kaikkien samaan kurssiryhmään kuuluvien kurssien ajat, jolloin voidaan välttää kyseisten kurssien järjestäminen samanaikaisesti.
Kuva 7 Kurssiryhmien muokkaaminen
Uuden kurssiryhmän lisääminen tapahtuu klikkaamalla lisää kurssiryhmä -painiketta. Käytössä olevat kurssiryhmät näkyvät laatikoina ikkunan oikealla puolella. Kullekin kurssiryhmälle voidaan antaa vapaavalintainen nimi, kirjoittamalla se nimelle varattuun kenttään kunkin kurssiryhmän otsikkopalkissa. Lisäksi otsikkopalkissa on Näytä – valintalaatikko, jonka avulla kursseja ja niihin liittyviä tapahtumia voidaan suodattaa pois näkyvistä sovelluksen päänäkymässä.
Kurssien lisääminen kurssiryhmiin tapahtuu raahaamalla kurssi haluttuun kurssiryhmään ikkunan vasemmassa laidassa sijaitsevasta luettelosta. Lisäksi kurssiryhmiin on mahdollista lisätä kokonaisia toisia kurssiryhmiä tarttumalla kurssiryhmän otsikkopalkista ja raahaamalla tämä haluttuun ryhmään.
Yksittäisen kurssin poistaminen ryhmästä, sekä kokonaisen kurssiryhmän poistaminen voidaan tehdä kunkin kurssiryhmälaatikon kohdalla, hiiren oikean napin avulla aukeavan pop-up valikon avulla.
5 Lukujärjestyksen suunnitteleminen
Tämä luku sisältää yksityiskohtaiset ohjeet mm. siihen, kuinka opetustapahtumille voidaan määrätä haluttuja aikoja ja paikkoja.
5.1 Blokkijärjestelmä
Blokkijärjestelmän tarkoituksena on helpottaa lukujärjestyksen suunnittelemista. Yksi blokki muodostuu yhdestä tai useammasta aikavälistä. Blokkien avulla suunnittelutyötä voidaan helpottaa siten, että kurssi voidaan valita kuuluvaksi haluttuun blokkiin. Tällöin kaikille kurssiin kuuluville tapahtumaryhmille löydetään paikat lukujärjestyksessä samaan blokkiin kuuluvien aikavälien perusteella. Ts. kun yksi kurssin tapahtumaryhmistä sijoitetaan kuuluvaksi tiettyyn blokkiin, sijoitetaan kurssin muut tapahtumaryhmät kyseisen blokin muihin aikaväleihin. Blokkirakenteen muokkaamista on käsitelty tarkemmin luvussa 4.2.
5.2 Suunnitteluvaiheet
Lukujärjestyksen suunnitteleminen aloitetaan muodostamalla ensiksi haluttu blokkirakenne. Mikäli käytetään samaa blokkirakennetta lukukaudesta toiseen, tätä vaihetta ei tarvitse tehdä kuin kerran, vaan voidaan käyttää jo olemassa olevaa blokkirakennetta. Mikäli blokkijärjestelmää ei aiota käyttää, voidaan blokkirakenteen muodostaminen jättää väliin. Seuraava vaihe on suunniteltavien kurssien tietojen hakeminen Korppi-järjestelmästä (luku 7.1). Tällöin Korppi-järjestelmästä saadaan myös käytettävissä olevien salien tiedot ja seuraava vaihe onkin omien salien valitseminen käyttöön (luku 4.3). Tämän jälkeen päästään suunnittelemaan varsinaista lukujärjestystä sijoittelemalla opetustapahtumia lukujärjestykseen halutuille paikoille ja haluttuihin saleihin. Mikäli kurssien tiedoissa on tapahtunut muutoksia, voidaan päivitetyt tiedot hakea tarvittaessa Korppi-järjestelmästä useampia kertoja suunnittelun edetessä. Lopuksi valmis lukujärjestys voidaan siirtää Korppi-järjestelmään.
5.3 Opetustapahtumien sijoitteleminen lukujärjestykseen
Opetustapahtumien lisääminen lukujärjestykseen haluttuun paikkaan tapahtuu raahaamalla kohde puunäkymästä haluttuun lukujärjestyksen soluun. Samalla kun puunäkymässä klikataan kurssia tai kurssiin liittyvää tapahtumaa, näyttää sovellus lukujärjestyksessä ne paikat, joihin on jo sijoitettu kyseisen kurssin tapahtumia. Samoin sovellus näyttää ne paikat, joihin on sijoitettu samaan kurssiryhmään kuuluvien kurssien tapahtumia. Kyseiset paikat erotetaan lukujärjestyksessä solun tummemmalla taustavärillä. Mitä tummempi taustaväri, sitä enemmän tulisi päällekkäisiä tapahtumia, mikäli kurssi sijoitettaisiin kyseiseen ajankohtaan.
Puunäkymästä raahattava kohde voi olla joko yksittäinen tapahtuma, tapahtumaryhmä tai tapahtumatyyppiä kuvaava puun haara. Näiden merkitykset ja toiminta lukujärjestykseen sijoitettaessa on kuvattu seuraavana:
Yksittäisen opetustapahtuman sijoittaminen
Yksittäisen opetustapahtuman sijoittaminen voidaan tehdä ainoastaan silloin, kun lukujärjestystilassa on näkyvillä kalenterinäkymä, eli yhden yksittäisen viikon lukujärjestys. Periodinäkymässä tapahtuman sijoittaminen ei ole mahdollista, koska tällöin tapahtumalle ei voida määrätä yksikäsitteisesti viikkoa.
Tapahtumaryhmän sijoittaminen
Kokonainen tapahtumaryhmä, eli esimerkiksi yhtä viikkoluentoa vastaava rivi voidaan sijoittaa sekä kalenteri- että periodinäkymässä. Mikäli sijoittaminen tehdään kalenterinäkymässä, sovellus sijoittaa kaikki kyseiseen ryhmään kuuluvat tapahtumat alkaen viikosta, joka on näkyvissä kalenterinäkymässä sijoittamishetkellä. Jos taas sijoittaminen tehdään periodinäkymässä, kysyy sovellus mistä viikosta eteenpäin sijoittaminen tehdään.
Kokonaisen tapahtumatyypin sijoittaminen
Sovelluksen avulla voidaan myös sijoittaa samalla kertaa kokonainen tapahtumatyyppi, eli kaikki tiettyyn tapahtumalajiin kuuluvat tapahtumat. Tällöin puusta valitaan tapahtumatyypin ilmaiseva haara, ja raahataan se lukujärjestyksen sellaiseen soluun, joka kuuluu johonkin blokkiin. Tällöin sovellus sijoittelee automaattisesti kaikki kyseiseen tyyppiin kuuluvat tapahtumaryhmät muihin samaan blokkiin kuuluviin soluihin. Myös tapahtumatyyppi voidaan sijoittaa sekä viikko- että periodinäkymässä, ja toiminta vastaa muilta osin tapahtumaryhmän sijoittamista.
5.4 Salin määrittäminen opetustapahtumille
Opetustapahtumille voidaan määritellä sali joko heti sijoitettaessa tapahtumaa määrättyyn kelloaikaan, tai myöhemmin tapahtuman ollessa jo sijoitettuna lukujärjestykseen.
Salin valitseminen sijoitettaessa tapahtumaa lukujärjestykseen
Mikäli sali halutaan valita jo heti sijoitusvaiheessa, valitaan haluttu sali ennen tapahtuman raahaamista puunäkymästä lukujärjestysnäkymään. Salin valitseminen tehdään Lukujärjestyksen yläpuolella sijaitsevasta luettelosta, joka sisältää kaikki käyttöön valitut salit (luku 4.3). Kun haluttu sali on valittu luettelosta, voidaan tapahtuma sijoittaa lukujärjestykseen, kuten on kuvattu luvussa 5.3. Tällöin tapahtuman saliksi tulee edellä valittu sali. Mikäli taas saliluettelosta valittiin kaikki salit, tapahtumalle ei määritetä salia. Tässä tapauksessa salin valitseminen voidaan tehdä myöhemmin.
Salin valitseminen sijoitetulle tapahtumalle
Sali voidaan määrittää tapahtumalle myös siinä vaiheessa, kun tapahtuma on jo sijoitettu lukujärjestykseen. Tällöin lukujärjestysnäkymässä halutun tapahtuman kohdalla hiiren oikealla napilla avautuvasta ponnahdusvalikosta valitaan Valitse sali. Nyt aukeavasta ikkunasta voidaan valita haluttu sali kyseiselle tapahtumalle, tai tapahtumaryhmän tapauksessa kullekin ryhmään kuuluvalle tapahtumalle.
5.5 Tapahtumien poistaminen ja siirtäminen
Lukujärjestykseen sijoitettuja tapahtumia voidaan siirtää toiseen ajankohtaan, sekä poistaa sijoitus kokonaan.
5.5.1
Tapahtuman
sijoituksen poistaminen
Klikkaa lukujärjestysnäkymässä halutun tapahtuman kohdalla hiiren oikeaa nappia. Avautuvasta ponnahdusvalikosta voidaan valita poista sijoitus, jolloin kyseisen tapahtuma/tapahtumaryhmä poistetaan sille määrätyltä paikalta lukujärjestyksessä. Valitsemalla poista koko kurssin sijoitus, voidaan poistaa samalla kertaa kaikkien kyseiseen kurssiin kuuluvien tapahtumien sijoittelu lukujärjestyksestä.
5.5.2
Tapahtuman
siirtäminen toiseen ajankohtaan
Tapahtuma/tapahtumaryhmä voidaan siirtää suoraan toiseen ajankohtaan tarttumalla tapahtuman nimestä lukujärjestysnäkymässä, ja raahaamalla se haluttuun paikkaan.
6 Suunnitelman avaaminen ja tallentaminen
Haluttu suunnittelutilanne voidaan tallentaa valitsemalla päävalikosta Tiedosto/Tallenna. Tällöin avautuvaan ikkunaan annetaan tallennettaessa käytettävä nimi, ja valitaan Tallenna. Tilanne voidaan myös tallentaa jonkin aikaisemmin tallennetun tilanteen päälle, valitsemalla käytettävä tallennusnimi suoraan luettelosta, mikä sisältää kaikki aikaisemmin tallennetut tilanteet.
Vastaavasti levylle tallennettu tilanne voidaan avata valitsemalla päävalikosta Tiedosto/Avaa. Tällöin avautuvassa ikkunassa näytetään luettelossa kaikki levylle tallennetut tilanteet. Valitse luettelosta haluamasi vaihtoehto, ja valitse Avaa.
7 Yhteys Korppi-järjestelmään
Tässä luvussa käsitellään sovelluksen toimintaa Korppi-järjestelmään liittyen.
7.1 Tietojen hakeminen Korpista
Sovellukseen on mahdollista hakea suunniteltavien kurssien tiedot suoraan Korppi-järjestelmästä. Lisäksi käytettävissä olevien salien tiedot saadaan Korppi-järjestelmästä. Tietojen hakeminen sovellukseen voidaan tehdä valitsemalla päävalikosta Tiedosto/Hae Korpista, jolloin aukeaa seuraavanlainen ikkuna:
Kuva 8 Tietojen hakeminen Korpista
Ikkunan avulla voidaan valita, minkä laitoksen kurssit haetaan sovelluksen käyttöön. Laitos voidaan valita käyttäen listassa valmiina olevia vaihtoehtoja, tai kirjoittamalla haluttu laitos suoraan tekstikenttään Korppi-järjestelmän tunnistamassa muodossa. Tämän jälkeen tietojen hakeminen aloitetaan valitsemalla Hae Korpista. Huomaa, että tietojen hakeminen saattaa kestää jonkin aikaa, riippuen mm. Korppi-järjestelmän kuormituksesta.
Mikäli sovelluksessa on jo avoinna osittain suunniteltu lukujärjestys, päivitetään sovellukseen muuttuneet kurssien tiedot, kuten opetustapahtumien lukumäärän muutokset, uudet ja poistetut kurssit jne. Jo sijoitellut opetustapahtumat pysyvät kuitenkin paikoillaan. Näin ollen tietojen hakeminen kurssista voidaan tehdä jo olemassa olevan suunnittelun päälle tuhoamatta suunnittelua.
7.2 Tietojen vieminen Korppiin
Sovelluksen avulla voidaan tallentaa tiedosto vietäväksi Korppi-järjestelmään. Tiedosto sisältää suunnitellun lukujärjestyksen tiedot niiden tapahtumien osalta, joissa on tapahtunut muutoksia sen jälkeen kun tiedot on edellisen kerran haettu Korppi-järjestelmästä.
Tiedoston muodostaminen Korppi-järjestelmään vietäväksi tapahtuu valitsemalla päävalikosta Tiedosto/Vie Korppiin. Tällöin sovellus tallentaa levylle korppiin.txt –nimisen tiedoston. Tiedosto tallennetaan samaan hakemistoon mistä sovellus on käynnistetty. Korppiin.txt –tiedosto sisältää kaikkien muuttuneiden tapahtumien tiedot tekstimuodossa siten, että yhdellä rivillä on aina yhden tapahtuman tiedot. Yksittäisen rivin formaatti on seuraavanlainen:
event_id|start_time|end_time|Sali
Rivi koostuu neljästä kentästä tolppamerkeillä erotettuna. Kenttien selitykset ovat:
Event_id = tapahtuman Korppi-järjestelmän antama id-numero.
Start_time = tapahtuman aloitusaika (muodossa vvvv-kk-pp tt:mm:ss)
End_time = tapahtuman lopetusaika (muodossa vvvv-kk-pp tt:mm:ss)
Sali = Tapahtumalle määrätty salin id-numero, tai tyhjä, jos salia ei ole määrätty.
8
Sovelluksen asentaminen
Kaakkuri-sovellus toimitetaan zip–muotoon pakattuna tiedostona. Asenna sovellus purkamalla zip-paketti haluamaasi hakemistoon. Paketti sisältää ajettavan ohjelmatiedoston, sekä muutaman muun tiedoston, joita sovellus tarvitsee toimiakseen. Sovellus ei siis vaadi erillistä asentamista, vaan toimii sellaisenaan. Koska sovellus on tehty käyttämällä Java-kieltä, asennettuna täytyy myös olla Java Runtime Environment (JRE). Sovelluksen toimiakseen vaatimat tiedostot ajettavan ohjelmatiedoston lisäksi ovat:
Kaakkuri.ico = Sovelluksen työpöytäikoni.
Kaakkuricon16.gif = Sovelluksen ikoni pienemmässä koossa.
Kaakkuri_splash.jpg = Sovelluksen käynnistyksen yhteydessä näytettävä kuva.
8.1 Periodien määrittäminen
Käytettävät periodit, sekä periodien alku- ja loppuajat on asetettava oikeiksi ennen kuin sovellusta aletaan käyttää. Tämä tehdään muokkaamalla tiedostoa periods.txt. Periodeja voidaan muokata tarvittaessa myös myöhemmin. periods.txt -tiedosto sisältää tekstitietona kullakin rivillä yhden periodin määrittelyn, ja yhden rivin rakenne on seuraavanlainen:
[Nimi];[alkuviikko],[alkuvuosi]-[loppuviikko],[loppuvuosi]
Esimerkki periods.txt -tiedostosta löytyy tämän dokumentin liitteenä.
9
Kesällä 2005 valmistuneet lisäominaisuudet
Tässä luvussa esitellään Kaakkuriin kesän 2005 työharjoittelun aikana valmistuneet lisäominaisuudet.
9.1 Omien periodien muokkaus
Kaakkurissa on dialogi omien periodien luontia ja muokkausta varten. Dialogin saa esille valitsemalla Muokkaa ja Muokkaa periodit.
Kuva 9 Periodien muokkaus dialogi
Periodille voi määrittää nimen lisäksi alkamis- ja loppumisajankohdan viikon ja vuoden.
- Korvaa-painike: muuttaa jo luodun aktiiviseksi valitun periodin tietoja käyttäjän määrittelemien tietojen perusteella.
- Lisää-painike: luo uuden periodin käyttäjän määrittelemien tietojen mukaan.
- Poista-painike: poistaa aktiiviseksi valittu periodin.
- Ok-painike, tallentaa periodit ja sulkee dialogin.
- Peruuta-painike: sulkee dialogista tallentamatta.
9.2 Mahdollisuus ottaa demot ja ohjaukset mukaan suunnitteluun
Kuvassa 8 näkyvään dialogiin on tehty muutoksia uusia ominaisuuksia silmälläpitäen. Myös dialogin otsikko ”Valitse laitos” –termi on muutettu ”Hae Korpista” –termiksi ja pudotusvalikon otsikko on muutettu muotoon ”Valitse haettavat kurssit”. Tämä dialogi tulee esille sovelluksen päävalikosta Hae Korpista –kohdasta. Dialogiin voi nyt merkitä haettavaksi myös demot ja ohjaukset sekä salivaraukset.
Kuva 10 Hae Korpista
Demot ja ohjaukset tulevat näkyviin kurssipuuhun luentojen tapaan. Lukujärjestysnäkymään demot ja ohjaukset tulevat keltaisella taustavärillä luentojen jälkeen. Demot ja ohjaukset käyttäytyvät sijoittelussa luentojen tapaan sillä erolla, että demoja ja ohjauksia voi laittaa päällekkäin saman kurssin demojen ja ohjauksien kanssa. Luentojen kanssa samaan ajankohtaan ei voi sijoittaa kyseisen kurssin muita tapahtumia.
Kuva 11 Demojen, ohjausten ja varausten esittäminen lukujärjestyksessä
9.3 Salivarauksien näyttäminen käyttäjälle
Sovelluksen päävalikon kohdasta Hae Korpista valittaessa esiin tulevasta kuvan 10 mukaisesta dialogista voi demojen ja ohjauksien lisäksi valita näytettäväksi salivaraukset. Dialogiin tulee merkitä päivämäärä, johon saakka varaukset haetaan. Varaukset haetaan sen hetkisestä päivästä käyttäjän dialogiin määrittämään päivään saakka. Hakuun Korpista liitetään jo tehdyt salivaraukset niiden salien osalta, jotka on valittu omiksi saleiksi luvun 4.3 mukaisesti. Huomaa, että jos et ole valinnut omia saleja, ei Kaakkuri hae varauksia ollenkaan. Salivaraukset esitetään lukujärjestysnäkymässä demojen alla vihreällä taustavärillä, kuten kuvassa 11 näkyy. Kun Korpista on haettu varaukset, ei käyttäjä pysty sijoittamaan varauksien saleihin muita tapahtumia varauksien ajankohtina.
9.4 Lukujärjestyksen generointi html-muotoon
Kaakkuri osaa muuttaa lukujärjestysnäkymässä näkyvän lukujärjestyksen taulukoksi html-muotoon automaattisesti, jotta luentolukujärjestyksen saa halutessaan näkyviin nettiin. Kyseinen toiminto onnistuu valitsemalla päävalikosta kohdan Tee HTML-sivu. Tällöin Kaakkuriin aukeaa tallennusdialogi, johon voi määrittää luotavan html-tiedoston nimen ja tallennushakemiston. Luotu tiedosto on xhtml 1.1 standardin mukainen. Generaattori jättää html-sivusta pois demot, ohjaukset ja varaukset, joten jäljelle jäävät vain luennot.
9.5 Dynaaminen kalenteri
Tämä uusi ominaisuus on käyttäjälle näkymätön. Uusi kalenteri luo kalenteriin uusia vuosia sitä mukaa kuin niitä käytössä tarvitaan, jolloin säästyy muistia eikä käyttäjän tarvitse huolehtia kalenterin loppumisesta kesken.
9.6 Lisää informaatiota kurssiryhmistä puuhun
Jos kurssi kuuluu johonkin käyttäjän luomista kurssiryhmistä, näkyy kurssiryhmän nimi kurssipuussa kurssin nimen perässä hakasuluissa. Huomaa, että yhdellä kurssilla voi olla useampi kuin yksi kurssiryhmä. Tällöin kurssiryhmät tulevat pilkulla erotettuna kurssin nimen perään kurssipuuhun.
Kuva 12 Kurssiryhmät puussa
9.7 Lisää informaatiota tapahtumien pituuksista
Jos tapahtuma on poikkeuksellisen pitkä, eli vaatii aikaa enemmän kuin kaksi tuntia, näkyy tapahtuman perässä kurssipuussa tapahtuman pituus hakasuluissa tasatunneiksi ylöspäin pyöristettynä.
Kuva 13 Pitkät tapahtumat puussa
9.8 Kurssien sijoitusten vienti korppiin ilman käsityötä
Sijoitettujen kurssien aikataulutuksen, salivaraukset voi viedä Kaakkurista Korppi-järjestelmään automatisoidusti valitsemalla päävalikosta Vie Korppiin, jonka jälkeen avautuvasta dialogista valitaan, että halutaanko Korppiin viedä luentojen ja seminaarien, demojen ja ohjauksien vai molempien ajat ja salivaraukset. Talleta korppiin.txt-painikkeesta kiintolevylle tallentuu Kaakkurin hakemistoon tiedosto korppiin.txt. Tiedostoon tallentuvat vain sijoitettujen kurssien tapahtumien Korppiin vietävät tiedot. Painikkeesta Avaa Korppi avautuu Windows-käyttöjärjestelmän oletusselaimeksi valittuun nettiselaimeen Korpin sivu, josta Kaakkurin korppiin.txt-tiedostoon tallentamat tiedot voidaan viedä automatisoidusti Korppi-järjestelmään. Dialogi näyttää käyttäjälle myös sijoitettujen ja sijoittamattomien tapahtumien lukumäärät.
Kuva 14 Korppiin vienti dialogi
9.9 Huomioitavaa Korpin osoitetiedoista Kaakkurissa
Kaakkuri ei näytä Korppi-järjestelmän osoitetietoja käyttäjälle. Kaakkurin tarvitsemia Korpin osoitteita voidaan muokata Kaakkurin hakemistossa sijaitsevista tekstitiedostoista.
Päävalikon Hae Korpista -kohdasta avautuvan dialogin valikon, josta valitaan haettavat kurssit, valintaoptiot voi muokata tiedostoon korppiurl.txt. Tässä tiedostossa jokainen rivi muodostaa yhden vaihtoehdon Kaakkurin Hae Korpista dialogin valikkoon. Rivin alkuun kirjoitetaan haluttu teksti, joka näkyy Kaakkurin valikossa. Tämän jälkeen tulee erotinmerkiksi ”;”. Erotinmerkin jälkeen tulee korpin osoite, josta haluttu data saadaan.
Tiedostoon korppiin_vienti_url.txt voi määrittää Korpin osoitteen, jossa sijaitsee Korpin tapahtumien aikojen päivittäminen Kaakkurin korppiin.txt-tiedostosta. Kaakkuri tarkistaa Korpin osoitteen korppiin_vienti_url.txt-tiedostosta aina kun käyttäjä painaa Avaa Korppi -painiketta Kaakkurin Korppiin vienti dialogissa.
Liitteet
Esimerkki
periodien määrittämiseen käytettävästä periods.txt –tiedostosta.
Jakso
1;36,2004-44,2004
Jakso
2;45,2004-52,2004
Jakso
3;1,2005-11,2005
Jakso
4;12,2005-22,2005
Syksy;36,2004-52,2004
Kevät;1,2005-22,2005
Lukuvuosi;36,2004-22,2005