Matematiikan oppifoorumi Käyttöohje Versio 1.0 Carl Johansson Jukka Kariola Outi Marttila Helena Venäläinen Sampsa Virtanen Ohjaaja Jukka Eskola Ohjelmistotuotantoprojekti 17.12.1999 HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos
Sisältö 1 Johdanto tuotteeseen 1 1.1 Tuotteen käyttötarkoitus 1 1.2. Oletettu käyttäjäprofiili ja käyttötapa 1 1.3. Käyttöympäristö 1 1.4. Viitteet muihin käytössä mahdollisesti tarvittaviin dokumentteihin 2 2 Tuotteen käyttö 2 2.1 Alustavat toimenpiteet ja ohjelmiston käynnistys 2 2.2 Pikaopas 3 2.3 Rekisteröityminen ja sisäänkirjoittautuminen 3 2.4 Kurssin valinta ja kurssin pääsivu 4 2.5 Keskustelu 5 2.6 Harjoitukset 6 2.7 Kaavaeditori 7 3 Virheilmoitukset 10 4 Toiminnalliset erot erilaisissa erilaisissa käyttöympäristöissä 10 5 Asennusohje 10
1 1 Johdanto tuotteeseen (OM) 1.1 Tuotteen käyttötarkoitus Matematiikan oppifoorumi (MatWO) on korkeakouluopiskelijoille suunnattu järjestelmä, joka mahdollistaa matematiikan opiskelun Internetin välityksellä. Järjestelmä sisältää matematiikan kursseja, joihin liittyen opiskelija voi lukea materiaalia sekä tehdä harjoituksia. Lisäksi jokaiseen kurssiin liittyy keskustelufoorumi, jossa on mahdollista esittää kysymyksiä ja kommentteja kurssin aihepiiriin liittyen. 1.2. Oletettu käyttäjäprofiili ja käyttötapa Tyypillisen järjestelmän käyttäjän oletetaan olevan korkeakouluopiskelija tai muu korkeakoulutasoisesta matematiikan opiskelusta kiinnostunut henkilö, joka järjestelmän avulla kehittää matematiikan taitojaan. Käyttäjältä ei odoteta erityistä tietoteknistä osaamista, vaan järjestelmän on tarkoitus tarjota helppokäyttöinen väline opiskeluun. Käyttäjän oletetaan lukevan kurssin materiaalia kappale kappaleelta. Lukemisen jälkeen tai sen ohessa käyttäjä voi testata osaamistaan tekemällä lukuun liittyviä harjoituksia. Samalla käyttäjä voi myös kysyä neuvoa keskustelufoorumin välityksellä tai vastata muiden opiskelijoiden esittämiin kysymyksiin. 1.3. Käyttöympäristö MatWO toimii client-server periaatteella Internetin tai intranetin kautta. Ohjelmisto ja tietokanta sijaitsevat palvelimella, johon käyttäjät ovat yhteydessä WWW-selainten avulla (kuva 1.1). Tuote vaatii JSP-yhteensopivan WWWpalvelimen, JDBC-yhteensopivan tietokannan sekä JavaScript-yhteensopivan selaimen.
2 Kaavojen näyttämistä varten selaimeen tulee olla asennettuna IBM Techexplorer plug-in, joka on saatavilla seuraaville käyttöjärjestelmille: Windows 95/98, Windows NT, Linux ja useimmat Unixit. Plug-inista saa ilmaisen version osoitteesta http://www-4.ibm.com/software/network/ techexplorer/downloads. MatWO- toimintaympäristö Palvelin Internet/Intranet WWW-selain HTML-sivut JSP-sivut Tietokanta JSP-kääntäjä Kuva 1.1 MatWO-toimintaympäristö 1.4. Viitteet muihin käytössä mahdollisesti tarvittaviin dokumentteihin Järjestelmän ylläpitoon liittyvät ohjeet on esitetty dokumentissa Matematiikan oppifoorumi, Ylläpito-ohjeet. 2 Tuotteen käyttö (OM) 2.1 Alustavat toimenpiteet ja ohjelmiston käynnistys Järjestelmä käynnistetään avaamalla selaimella URL http://db.cs.helsinki.fi/~cjjohans/login.html. Ennen käyttöä selaimeen on asennettava IBM Techexplorer plug-in. Asennukseen liittyvät ohjeet on kuvattu luvussa 5.
3 2.2 Pikaopas Järjestelmään pääseee sisään antamalla käyttäjätunnuksen ja salasanan ensimmäisellä sivulla. Käyttäjätunnuksen saa rekisteröitymällä käyttäjäksi. Kurssisivulta valitaan haluttu kurssi, jonka jälkeen päästään kurssin pääsivulle. Kurssin pääsivulla lukuja voi lukea ja selata sisällysluettelon avulla. Luettavana olevaan lukuun liittyvät viestit ja harjoitukset näkyvät ikkunan oikeassa reunassa. Viesti-ikkunan voi avata klikkaamalla jonkin viestin otsikkoa ja vastaavasti harjoitusikkunan klikkaamalla harjoituksen otsikkoa. Nämä ikkunat avautuvat uusiin ikkunoihin, jolloin kurssin pääsivu pysyy koko ajan taustalla. Keskustelufoorumin viestit on jaoteltu luvuittain. Eri lukujen otsikot saa näkyviin klikkaamalla sisällysluettelosta luvun otsikkoa. Viestin saa luettavaksi ikkunan alaosaan klikkaamalla viestin otsikkoa. Uusi viesti- ja Vastaa-painikkeet avaavat viestieditorin uuden viestin tai vastausviestin kirjoittamista varten. Harjoituksia voi selata sisällysluettelon avulla. Harjoituksissa edetään valitsemalla oikea vastausvaihtoehto kysymykseen, jolloin päästään seuraavaan kysymysvaiheeseen. Väärän vastauksen tapauksessa kysymykseen voi vastata uudelleen. Kun harjoituksessa on edetty viimeiseen kysymysvaiheeseen, oikean vastauksen jälkeen siirrytään automaattisesti seuraavaan harjoitukseen. 2.3 Rekisteröityminen ja sisäänkirjoittautuminen Järjestelmän aloitussivulla kysytään käyttäjältä käyttäjätunnus ja salasana. Jos käyttäjä ei ole vielä rekisteröitynyt, rekisteröitymään pääsee Rekisteröidy-linkillä. Rekisteröitymislomakkeen kentistä vahvennetulla tekstillä kirjoitetut ovat pakollisia. Kenttien täyttämisen jälkeen rekisteröityminen vahvistetaan OKpainikkeella. Mikäli annettu käyttäjätunnus on jo käytössä, tunnusta on muutettava.
4 2.4 Kurssin valinta ja kurssin pääsivu Sisäänkirjoittautumisen jälkeen tullaan kurssilistasivulle. Käyttäjä valitsee listasta haluamansa kurssin, ja pääsee kurssin pääsivulle. Kurssin pääsivulla (kuva 2.1) vasemmassa reunassa on lukujen sisällysluettelo, jonka avulla käyttäjä voi valita keskellä olevaan kehykseen eri lukuja luettavaksi. Sivun oikeassa yläkulmassa näkyvät luettavana olevaan lukuun liittyvien viestien otsikot. Otsikon klikkaus avaa valitun viestin luettavaksi keskusteluikkunaan. Oikeassa alakulmassa on luettavana olevaan lukuun liittyvien harjoitusten otsikot. Klikkaamalla otsikkoa käyttäjä voi avata harjoitusikkunan. Kuva 2.1 Kurssin pääsivu
5 2.5 Keskustelu Keskusteluikkuna (kuva 2.2) avautuu klikkaamalla viestin otsikkoa pääikkunan oikeassa yläkulmassa olevasta viestilistasta, jossa luettavana olevaan lukuun liittyvät viestit näkyvät. Kuva 2.2 Keskusteluikkuna Keskusteluikkunan vasemmassa reunassa on sisällysluettelo luvuista, josta valitsemalla tietyn luvun saa kyseiseen lukuun liittyvät viestit näkyviin pääkehyksen yläosaan. Klikkaamalla viestin otsikkoa sen sisältö näkyy otsikoiden alla. Uuden viestin kirjoittaminen tapahtuu Uusi viesti painikkeella, joka avaa viestieditorin (kuva 2.3). Jos halutaan vastata johonkin viestiin, se tapahtuu valitsemalla viesti luettavaksi ja painamalla Vastaa-painiketta, joka avaa viestieditorin, jonka Otsikko-kenttään on lisätty valmiiksi oletusotsikko (Re: alkuperäisen viestin otsikko) ja Viesti-kenttään kyseisen viestin teksti.
6 Viesti hyväksytään painamalla Valmis-painiketta, jolloin avautuu ikkuna, jossa viestiin voi liittää kaavoja. Ikkunan voi sulkea, jos kaavoja ei haluta liittää viestiin. Kaavaeditori-painike avaa kaavaeditorin, josta kaavan tallennus automaattisesti lisää kaavan nimen Kaava-kenttään. Lisää kaava-painikkeella kaava liitetään viestiin. Kuva 2.3 Viestieditori 2.6 Harjoitukset Harjoitusikkuna (kuva 2.4) avautuu klikkaamalla linkkiä pääikkunan oikeassa alanurkassa olevasta harjoitusten listasta. Listassa näkyy parhaillaan luettavana olevan luvun harjoitukset. Harjoitusikkunassa lukuun liittyvistä harjoituksista on linkkilista ikkunan vasemmassa laidassa. Linkkien avulla voi siirtyä suoraan eri harjoituksiin. Yksi harjoitus koostuu useasta kysymysvaiheesta. Kysymysvaiheesta toiseen edetään
7 valitsemalla oikea vaihtoehto kysymyksen alla olevista vaihtoehdoista ja vahvistamalla valinta painamalla Etene-painiketta. Väärän vastauksen jälkeen kysymysvaihe pysyy samana. Vastaukseen voi liittyä vihje, joka näkyy vastauksen antamisen jälkeen vaihtoehtojen alapuolella. Kun käynnissä olevan harjoituksen viimeiseen kysymykseen on vastattu oikein, siirrytään automaattisesti seuraavaan harjoitukseen, jos harjoituksia on vielä jäljellä. Harjoitusten tekemisen voi lopettaa sulkemalla harjoitusikkunan. Kuva 2.4 Harjoitusikkuna 2.7 Kaavaeditori Kaavaeditorilla (kuva 2.5) voidaan tallettaa kaavoja MathML-muotoon, jota selain osaa näyttää plug-inin avulla.
8 Kuva 2.5 Kaavaeditori Kaava syötetään Kaava-kenttään. Laskutoimitusten syöttöön käytetään näppäimistöstä löytyviä merkkejä (esim. numerot, +, - ja *) sekä erikoismerkintöjä, jotka näkyvät editorin yläosassa. Jokaiseen erikoismerkintään liittyy painike, jossa on kyseisen merkinnän nimi, jolla se esitetään kaavassa. Painikkeella merkinnän saa lisättyä kaavatekstin loppuun. Painike lisää myös merkinnän vaatimat parametrit, joita eri merkinnöillä on vaihteleva määrä. Parametrit annetaan sulkeiden sisällä ja ne erotetaan toisistaan välilyönnillä. Kaikille merkinnän parametreille on annettava jokin arvo. Merkintä, jolla ei ole yhtään parametria (alpha, beta, neq jne.) erotetaan muusta kaavasta välilyönnillä. Muussa tapauksessa välilyöntejä ei saa laittaa merkkien väliin. Kaavojen laskujärjestyksen määrämiseen voi käyttää sulkeita. Jos erikoismerkinnän parametriksi annetaan kaava, se on asetettava sulkeiden sisään.
9 Seuraavissa esimerkeissä kaavojen jälkeen on esitetty merkintä, jolla kaava saadaan tuotettua editorilla. 2 x + 1 = 1 root(2 (x + 1)) = 1 x + 1 β x 6 (x + 1)/6* beta leq x Esikatsele-painikkeella kaavan saa näkymään editorin alaosaan. Kaava talletetaan Tallenna-painikkeella. Ennen talletusta annetaan Nimi-kenttään kaavan nimi ilman tiedostopäätettä. Jos samanniminen kaava on jo olemassa, siitä varoitetaan ja kaavalle on annettava jokin toinen nimi.
10 3 Virheilmoitukset (OM) Taulukossa 3.1 on lueteltu järjestelmän antamat virheilmoitukset, niiden syyt ja toimintaohjeet virhetilanteisiin. Taulukko 3.1 Virheilmoitukset Virheilmoitus Virheen syy Toimintaohje Viestillä täytyy olla otsikko Uudelle viestille ei ole annettu otsikkoa. Viestille kirjoitetaan otsikko Otsikko-kenttään. Anna kaavalle nimi Kaava on yritetty tallettaa antamatta kaavalle nimeä. Kaavalle annetaan nimi kaavaeditorin nimikenttään. Kirjoita kaava Kaava on yritetty tallettaa kirjoittamatta kaavaa. Kaava kirjoitetaan kaavaeditorin kaavakenttään. Talletus epäonnistui Annetulla nimellä on jo olemassa kaava. Kaavalle annetaan jokin toinen nimi ja talletusta yritetään uudelleen. 4 Toiminnalliset erot erilaisissa erilaisissa käyttöympäristöissä (OM) Järjestelmän toimintaa on testattu Linuxissa Netscape 4.6 selaimella ja Windows 95/98 ympäristössä Netscape 4.7 ja Internet Explorer 5 selaimilla. Merkittäviä eroja toiminnan tai käyttöliittymän ulkoasun suhteen ei eri käyttöympäristöissä ole havaittu. 5 Asennusohje (OM) Järjestelmän käyttäjäosuus (client) ei vaadi erityistä asennusta lukuunottamatta kaavojen näyttämiseen tarkoitetun IBM Techexplorerin asennusta selaimeen.
11 Plug-in voidaan asentaa joko käyttäjäasennuksena tai jaettuna asennuksena, jolloin se on automaattisesti kaikkien käytettävissä. Plug-inin asennukseen liittyvät toimenpiteet kuten oikean väritilan asetus Linuxissa ja MIME-tyyppien lisäys on selostettu plug-inin asennuspaketin mukana tulevassa dokumentaatiossa. Järjestelmän asennus palvelimelle vaatii tietokannan, siihen sopivan JDBC-ajurin sekä JSP:tä tukevan WWW-palvelimen. Tarkemmat ohjeet järjestelmän palvelinosuuden asennuksesta ja ylläpidosta on selostettu dokumentissa Matematiikan oppifoorumi, Ylläpito-ohje. Tietokannan taulujen luonnissa tarvittavat lauseet ovat dokumentin Matematiikan oppifoorumi, Toteutusdokumentti liitteenä.