Kokako - projekti
Vaatimusmäärittely
Honkonen Tapio
Lamminen Turo
Räsänen Tuomas
Väärämäki Tapio
Versio 0.53
Julkinen
1. huhtikuuta 2006
Jyväskylän Yliopisto
Tietotekniikan Laitos
Jyväskylä
|
Hyväksyjä |
Päivämäärä |
Allekirjoitus |
Nimenselvennys |
|
Projektipäällikkö |
___.___.2006 |
|
|
|
Tilaaja |
___.___.2006 |
|
|
|
Tilaaja |
___.___.2006 |
|
|
|
Ohjaaja |
___.___.2006 |
|
|
Tietoa dokumentista
Tekijät:
Dokumentin nimi: Kokako-projekti,
Vaatimusmäärittely
Sivumäärä: 23
Tiedosto: Vaatimusmaarittely.doc
Tiivistelmä: Dokumentti on vaatimusmäärittely
Jyväskylän yliopiston tietotekniikan laitoksella toteutettavaan Kokako-sovellusprojektiin.
Vaatimusmäärittely kuluu olennaisena osana projektin suunnitteluun ja
läpivientiin. Dokumentissa selvitetään sovelluksen taustaa sekä sille
asetettavia tavoitteita ja vaatimuksia. Sovelluksen käyttötapaukset on kuvattu
tässä dokumentissa.
Avainsanat: käyttötapaukset, vaatimusmäärittely, opinto-opas,
julkaisuprosessin koostaminen
Muutoshistoria
|
Versio |
Päivämäärä |
Muutokset |
Tekijät |
|
0.1 |
25.2.2006 |
Vaatimusmäärittelyn
teko aloitettiin. |
Väärämäki Tapio |
|
0.15 |
1.3.2006 |
Prosessikaavion
ja käyttötapauskaavioiden laadinta aloitettiin. |
Väärämäki Tapio |
|
0.2 |
6.3.2006 |
Prosessikaaviota
ja käyttötapauskaavioita muokattiin. |
Väärämäki Tapio |
|
0.22 |
9.3.2006 |
Vaatimusmäärittelyä
kirjoitettiin. |
Väärämäki Tapio |
|
0.25 |
15.3.2006 |
Vaatimusmäärittelyä
kirjoitettiin. |
Väärämäki Tapio |
|
0.28 |
16.3.2006 |
Prosessikaavio
ja käyttötapauskaavio viimeisteltiin ja lisättiin vaatimusmäärittelyyn. |
Väärämäki Tapio |
|
0.3 |
17.3.2006 |
Vaatimusmäärittelyn
ulkoasu ja teksti yhdenmukaistettiin projektisuunnitelman kanssa ja
dokumentti oikoluettiin. |
Honkonen Tapio |
|
0.31 |
20.3.2006 |
Dokumentin
tuomiseen liittyvä käyttötapaus lisättiin ja käyttötapauskaavioita muokattiin. |
Väärämäki Tapio |
|
0.5 |
23.3.2006 |
Dokumentti
oikoluettiin ja sen ulkoasu hiottiin. |
Honkonen Tapio |
|
0.51 |
30.3.2006 |
Projektin
vastaavan ohjaajan esittämien muutosten tekeminen dokumenttiin. |
Väärämäki Tapio |
|
0.52 |
31.3.2006 |
Tilaajan
esittämät korjaukset lisättiin. |
Väärämäki Tapio |
|
0.53 |
1.4.2006 |
Muutosten
esittäminen vanhoihin opas-versioihin nähden –käyttötapaus lisätty. |
Väärämäki Tapio |
Tietoa Projektista
Kokako-projekti edelleenkehittää opinto-oppaan koostamistyökalua Jyväskylän yliopiston
Informaatioteknologian tiedekunnalle. Työkalusta on tarkoitus laatia niin
yleis- ja helppokäyttöinen, että sitä on mahdollista käyttää vastaaviin
tarkoituksiin esimerkiksi muissa tiedekunnissa. Ensisijaisesti on tarkoitus
toteuttaa ympäristö opinto-oppaaseen tulevien XML-dokumenttien luontiin ja
niiden tyyppimääritysten muuntaminen Xoo-projektin luoman luku.dtd:n mukaiseksi. Tämän jälkeen on tarkoitus
toteuttaa olemassa olevaan koostamistyökaluun helppokäyttöisempi käyttöliittymä
sekä dokumenttien käsittelyyn tarvittava versionhallinta.
Tekijät:
Tilaaja:
·
Ihanainen Eija opintoasiat@it.jyu.fi 014 260 2791
·
Auer
Antti auer@jyu.fi 014 260
4319
·
Honkaranta Anne anne.honkaranta@it.jyu.fi 014 260 3041
·
Nurminen Miika minurmin@jyu.fi 014 260 2530
·
Lappalainen Vesa vesal@mit.jyu.fi 014 260 2722
Ohjaajat:
Yhteystiedot:
kokako_opis.group@korppi.jyu.fi
https://korppi.jyu.fi/list-archive/kokako06_opetus
Sisältö
1.2 Toteutettavan sovelluksen taustaa ja tavoitteita
2 Projektiin liittyvä termistö
3 Sovelluksen käyttäjäryhmät..
3.1 Käyttäjäryhmien määrittely..
3.2 Sisällöntuottajan toiminnot.
4.1 Julkaisuprosessin kulku vaiheittain
4.1.1 Vaihe 1: Sisällöntuottajat aloittavat
opinto-oppaan sisältöjen tuottamisen
4.1.2 Vaihe 2: Sisältö tallennetaan
versionhallintajärjestelmään
4.1.3 Vaihe 3: Koostaja aloittaa
koostamisprosessin
4.1.4 Vaihe 4: Koostaja valitsee opinto-oppaaseen sisällytettävät dokumentit
4.1.5 Vaihe 5: Koostaja koostaa valituista lähdedokumenteista XML-muodossa
olevan opinto-oppaan
4.2 Eroavaisuudet nykytilanteen ja tavoitteena olevan julkaisuprosessin välillä
5 Sisällöntuottajan käyttötapaukset
5.2 Sisällöntuottajan käyttötapausten kuvaukset
5.2.3 Uuden dokumentin laatiminen
5.2.4 Olemassa olevien dokumenttien muokkaaminen
5.2.5 Väärin tyylimääritellyn dokumentin
tuominen
5.2.6 Muokatun dokumentin tallentaminen
5.2.7 Editorikäyttöliittymän sulkeminen
5.2.8 XML-muodossa olevien dokumenttien
esikatselu
5.2.9 Dokumentin vieminen
versionhallintajärjestelmään
6.2 Koostajan käyttötapausten kuvaukset
6.2.1 Uuden opinto-opas -dokumentin laatiminen
6.2.2 Olemassa olevan opinto-opas -dokumentin
muokkaaminen
6.2.3 Koosteeseen sisällytettävien dokumenttien
valinta
6.2.4 Opinto-oppaan koostaminen valituista
dokumenteista
6.2.5 Opinto-oppaan julkaiseminen halutussa
formaatissa
Kuvaluettelo
Kuva
1: Opinto-oppaan julkaisuprosessi
Kuva 2: Sisällöntuottajan käyttötapaukset
Kuva
3: Koostajan käyttötapaukset
Taulukkoluettelo
Taulukko
1: Sovelluksen avaaminen
Taulukko
2: Sisäänkirjautuminen
Taulukko 3: Uuden sisällön tuottaminen
Taulukko 4: Olemassa olevien dokumenttien
muokkaaminen
Taulukko
5: Muokatun dokumentin tallentaminen
Taulukko
6: Editorikäyttöliittymän sulkeminen
Taulukko 7: XML-muodossa olevien
dokumenttien esikatselu
Taulukko 8: Dokumentinen vieminen
versionhallintajärjestelmään
Taulukko
9: Sovelluksen sulkeminen
Taulukko 10: Uuden opinto-opas-dokumentin
laatiminen
Taulukko 11: Olemassa olevan opinto-opas-dokumentin
muokkaaminen
Taulukko 12: Koosteeseen sisällytettävien
dokumenttien valinta
Taulukko 13: Opinto-oppaan koostaminen
valituista dokumenteista
Taulukko 14: Opinto-oppaan julkaiseminen
halutussa formaatissa
Kokako-projekti
on kevään -06 Jyväskylän yliopiston Tietotekniikan laitoksen sovellusprojekti.
Projekti kehittää opinto-oppaan laatimis- ja koostamistyökalua Jyväskylän yliopiston
informaatioteknologian tiedekunnalle. Työkalusta on tarkoitus laatia niin
yleis- ja helppokäyttöinen, että sitä on mahdollista käyttää vastaaviin
tarkoituksiin esimerkiksi muissa tiedekunnissa. Sitä tulee käyttämään kaksi eri
käyttäjäryhmää, dokumentin sisällöntuottaja ja koostaja. Työkalun tarkoituksena
on tehdä lähdedokumenteista yhtenäisiä, ja täten helpottaa koostajan työtä
automatisoimalla koostamisprosessia.
Kokako-projekti
on jatkoa XooZoo- ja Xoo-projekteille. XooZoo-projektin tehtävänä oli
IT-tiedekunnan opinto-oppaan hallinan, sisällön ja rakenteen kehittäminen.
Projekti keskittyi tutkimukseen ja suunnitteluun. Käytännön toteutukselle jäi vähemmän
aikaa, ja niinpä projekti jatkui Xoo-jatkoprojektilla, jonka tehtävänä oli
viedä XooZoo-projektissa aloitettu työ loppuun.
Xoo-projekti
koosti IT-tiedekunnalle opinto-oppaan XooZoo-projektissa saatujen tuloksien
pohjalta. Koostamistyössä havaittiin kuitenkin vielä useita puutteita, joista
halutaan eroon. Nyt Kokako-projektin tehtävänä on jatkaa koostamisjärjestelmän
kehittämistä edelleen.
Kokako-projektin
kesto on neljä kuukautta, ja se on valmis viimeistään 31.5.2006. Ensisijaisesti
on tarkoitus toteuttaa ympäristö opinto-oppaaseen tulevien XML-dokumenttien
luontiin ja niiden tyyppimääritysten muuntaminen Xoo-projektin luoman luku.dtd:n mukaiseksi. Tämän jälkeen on tarkoitus
totetuttaa olemassa olevaan koostamistyökaluun helppokäyttöisempi
käyttöliittymä sekä dokumenttien käsittelyyn tarvittava versionhallinta.
Tämä dokumentti
määrittää sovellukselle asetettavat vaatimukset ja rajoitteet, jotka määrittelevät
sovelluksen tarjoamat tiedot, tilat ja toiminnot. Sovellus suunnitellaan ja
toteutetaan näiden tietojen perusteella. Tietoja käytetään myös testaussuunnitelman
laatimiseen.
Jyväskylän
yliopiston Informaatioteknologian tiedekunta (myöhemmin tekstissä IT-tiedekunta) on julkaissut vuosittain
opinto-oppaan uusille ja vanhoille opiskelijoille. Opinto-oppaan laatiminen
koostuu useasta eri työvaiheesta, joita ovat mm. sisällöntuotanto ja
koostaminen. Käytännössä opinto-oppaan laatimisprosessi käynnistyy sisällöntuottamisella,
jossa kukin sisällöntuottajat laatii oman osuutensa opinto-opasta varten. Tämän
jälkeen koostaja kokoaa erilliset dokumentit yhdeksi kokonaisuudeksi ja
huolehtii samalla dokumentin taittamisesta. Koostamisprosessi on ollut melko
työläs, koska sisällöntuottajat ovat toimittaneet omat osadokumenttinsa
erilaisilla tyylimäärittelyillä varustettuna, ja niistä on pitänyt koostaa yksi
yhtenäinen dokumentti. Koostamisvaiheessa on siten jouduttu tekemään paljon
manuaalista työtä, joka on koettu varsin raskaaksi ja ehkäpä hieman turhaksikin.
Opinto-oppaan eri
luvut kirjoitetaan XML-muotoon, mutta se on havaittu liian työlääksi ja
vaikeaksi tavallista käyttäjää ajatellen.
Nyt on tarve kehittää editorikäyttöliittymä, jonka avulla käyttäjät
pystyvät kirjoittamaan XML-dokumentteja ilman erityistä XML-osaamista.
Varsinaisen
sisällöntuotannon lisäksi sovelluksella pitää pystyä koostamaan useat eri
XML-dokumentit yhdeksi yhtenäiseksi dokumentiksi. Tarvittaessa koostamis- ja
sisällöntuotantotyökalut saattavat olla täysin erillisiäkin sovelluksia.
Tavoitteena on
luoda sellainen sovelluskokonaisuus, jonka avulla sisällöntuottajien on
mahdollista luoda tyylimäärittelyiltään yhtenäisiä dokumentteja opinto-opasta
varten. Sovelluksen tulee pystyä myös koostamaa nämä dokumentit automaattisesti
– tai korkeintaan hyvin pienellä manuaalisella työllä – yhdeksi suureksi XML-dokumentiksi,
ja muuntaa tämä XML-dokumentti joko PDF- tai HTML-muotoon.
Sovelluksen
luonteesta johtuen sen käyttömahdollisuudet eivät rajoitu vain opinto-oppaan
tuottamisprosessiin. Koostamis- ja sisällöntuotanto-ominaisuuksia on
mahdollista hyödyntää kaikissa sellaisissa prosesseissa, joissa on tarvetta
koostaa yksi dokumentti useasta pienemmästä osadokumentista. Opinto-oppaan
lisäksi tällaisia dokumentteja ovat ainakin valintaoppaat, ja totta kai myös
kaikkien muiden tiedekuntien vastaavat oppaat.
Tässä luvussa
kuvataan vaatimusmäärittelyssä esille tulevia termejä.
|
XML(eXtensible Markup Language |
Tämä on
metakieli, jolla määritellään rakenteellisia merkkauskieliä. Tässä on tärkeä
ero XML:n ja HTML:n välillä, HTML on merkkauskieli, XML:llä luodaan
merkkauskieliä. Varsinaisesti ei ole edes olemassa XML-dokumenttia, jokainen
XML-dokumentti on aina kirjoitettu jollain XML:n avulla määritellyllä
kielellä. |
|
DTD(Document Type
Definition) |
Tämä kuvaa rakenteellisen asiakirjan muodollisen syntaksin. Tämän avulla
XML-kääntäjälle kerrotaan millaisia elementtejä tai attribuutteja kukin
elementti saa sisältää, missä järjestyksessä ne saavat ilmetä ja mitkä ovat
niiden keskinäiset suhteet. Rakenteiden merkitys esitetään erikseen
luonnollisella kielellä. |
|
Luku.dtd |
Tämä on opinto-oppaan koostamistyökalun käyttämä DTD. |
|
OpenOffice 2.0 |
Tämä on Microsoft Officen kaltainen työkalu, josta löytyy hyvin pitkälti
samat ominaisuudet. OpenOfficea on tarkoitus käyttää dokumenttien tuottamis-
ja muokkaustyökaluna opinto-oppaan tuottamisprosessissa. |
|
XSLT(Extensible StyleSheet Language
Transformations) |
Tämä on standarditekniikka XML-muotoisen aineiston muuntamiseen.
Tyypillisiä XSLT:n sovelluskohteita ovat XML-aineiston muunnokset toiseen
XML-formaattiin. |
Luvussa
esitellään sovelluksen käyttäjäryhmät ja sovelluksen heille tarjoamat
toiminnot.
Sovelluksella on kaksi
eri loppukäyttäjäryhmää, sisällöntuottajat ja koostajat. Nämä käyttäjäryhmät
tarvitsevat sovellukselta osin toisistaan poikkeavia toimintoja.
Sisällöntuottajat
keskittyvät tuottamaan aineistoa opinto-opasta varten, eli heidän työnsä
koostuu pääasiassa kirjoittamisesta ja kuvien yms. objektien liittämisestä
dokumenttiin. Sisällöntuottajille on tärkeää, että he pystyvät kirjoittamaan
yksinkertaisesti ennakkoon tehdyn tyylimäärittelyn mukaisia dokumentteja.
Sisällöntuottajia ovat mm. amanuenssi, ainejärjestöt ja dekaani.
Koostajien
tehtävänä on koostaa sisällöntuottajien laatimista dokumenteista yksi yhtenäinen
kokonaisuus. Koostamisprosessin tulee olla mahdollisimman automatisoitu eikä se
saa vaatia merkittävää manuaalista työtä koostajilta. Koostajat julkaisevat
opinto-oppaan joko HTML- tai PDF-muodossa, hieman käyttötarpeesta riippuen.
HTML-muotoa käytetään ensisijaisesti verkkojulkaisussa ja PDF-muotoa
kirjallista painoversiota tehtäessä.
Sisällöntuottajille
on tärkeää, että he kykenevät kirjoittamaan tekstiä yksinkertaisesti ja liittämään
siihen tarvittaessa kuvia tai taulukoita. Tähän asti sisällöntuottajien
toimittamien dokumenttien ongelmana on ollut niiden epäyhtenäinen
tyylimäärittely. Kukin sisällöntuottajat on toimittanut dokumenttinsa itse
valitsemassa tiedostomuodossaan esimerkiksi DOC, RTF tai TXT, minkä lisäksi
ulkoasuun liittyvät valinnat, kuten tekstissä käytettävä fontti, ovat olleet
käyttäjän itse päättämiä. Näiden dokumenttien koostaminen on vaikeaa, koska jokainen
dokumentti pitää käydä erikseen läpi ja määrittää ulkoasultaan yhtenäiseksi.
Käyttäjän pitää
siis pystyä kirjoittamaan editorikäyttöliittymän avulla oikein muotoiltua
tekstiä mahdollisimman vaivattomasti. Sopiva tapa toteuttaa tällainen
käyttöliittymä on tehdä dokumenttipohja tekstinkäsittelyeditoriin, jossa
käyttäjä saa muotoilla tekstiä vain ennalta määritetyillä tyyleillä. Muiden
tyylien tai tyyleistä riippumattomien muotoiluiden käyttäminen pitää olla kiellettyä
tai estettyä.
Tekstin
valmistuttua käyttäjä tallentaa tekstinsä versionhallintajärjestelmään, josta
koostaja kerää kaikki sisällöntuottajien laatimat dokumentit.
Editorikäyttöliittymässä pitää olla siis liitäntä versionhallintajärjestelmään.
Sen käyttämisen tulee olla yhtä yksinkertaista kuin normaali tiedoston
tallentaminen tekstinkäsittelyohjelmassa. Mikäli samaa tiedostoa yrittää
tallentaa kaksi sisällöntuottajaa samaan aikaan, pitää
versionhallintajärjestelmän ilmoittaa asiasta käyttäjälle.
Koostajan pitää
pystyä noutamaan dokumentit versionhallintajärjestelmästä, jonne sisällöntuottajat
ovat ne tallentaneet. Varsinaisen dokumentin koostamiseen on jo olemassa komentorivipohjaisia
skriptejä, jotka koostavat useasta eri XML-dokumentista yhden XML-dokumentin.
Koostamisskriptien käyttö on tällä hetkellä monimutkaista, vaikka käytön
helpottamiseksi on kehitetty erillinen WWW-käyttöliittymä. Selkeämmän graafisen
käyttöliittymän kehittäminen koostamisskritpien käyttämistä varten on eräs
projektin tavoite.
Kuten aiemmin jo
mainittiin, tapahtuu koostaminen XML-muodossa olevien dokumenttien ympärillä.
XML-dokumenttien kirjoittaminen on kuitenkin tavallisia sisällöntuottajia ajatellen
liian vaikeaa. Sisällöntuottajat tallentavat omat dokumenttinsa tekstieditorilla
kirjoitettuna OpenOfficen natiiviin dokumenttimuotoon, ja dokumenttien
muotoilussa käytetään ennakkoon määritettyjä tyylitietoja. Koostajan
sovelluksen pitää pystyä muuntamaan OpenOfficella tuotetut dokumentit
XML-muotoon, ja sen jälkeen koostaa muunnetut XML-tiedostot yhdeksi suureksi
XML-dokumentiksi eli opinto-oppaaksi. Tämä on sovelluksen tärkein toiminto
koostajan näkökulmasta.
Koostajien pitää
pystyä muutamaan XML-muodossa oleva opinto-opas myös PDF- ja HTML-muotoihin,
jotta opinto-opas voidaan liittää tiedekunnan verkkosivuille.
Koostamiskäyttöliittymän
pitää olla selkeä käyttää, ja siitä tulee olla helposti nähtävissä, että mitä
dokumentteja opinto-oppaaseen sisällytetään. Tarvittaessa dokumentteja pitää
voida poistaa tai lisätä.
Toteuttavan
sovelluksen toimintaympäristön hahmottamiseksi on luotu alla oleva kaaviokuva
(kuva 1.). Se kuvaa opinto-oppaan julkaisuprosessia Kokako-projektissa
kehitetyn sovelluksen avulla.
Kuva 1: Opinto-oppaan julkaisuprosessi
Sisällöntuottajat
ryhtyvät kirjoittamaan opinto-oppaan sisältöä, eli tuottamaan oppaan eri
lukuja. Kirjoittaminen tapahtuu Kokako-projektissa kehitettävän
editorikäyttöliittymän avulla, joka mahdollistaa tyylimäärittelyltään yhtenäisten
dokumenttien kirjoittamisen. Dokumentit tallennetaan OpenOfficen natiiviin
dokumenttimuotoon, josta ne muunnetaan XSLT-muunnoksen avulla XML-tiedostoiksi.
XSLT-muunnos tehdään aina kun dokumentti tallennetaan.
Kun
sisällöntuottajat ovat saaneet dokumenttinsa valmiiksi, tallennetaan ne editorikäyttöliittymän
välityksellä versionhallintajärjestelmään. Versionhallintajärjestelmän käyttömahdollisuuden
integrointi osaksi editorikäyttöliittymää on alustavien tietojen mukaan haastava
tehtävä, joten tämän toiminnallisuuden toteutumiseen kannattaa suhtautua
varauksella. Vaihtoehtona on, että käyttäjät tallentavat valmiit dokumentit
manuaalisesti verkkolevylle tai lähettävät ne suoraan koostajalle.
Koostaja on
saanut tiedon siitä, että kaikki opinto-oppaaseen tarkoitetut dokumentit ovat
versionhallintajärjestelmässä tai muussa halutussa tallennusjärjestelmässä. Sisällöntuottajien
laatimien dokumenttien lisäksi opinto-oppaaseen tulee kurssikuvauksia
Korppi-järjestelmästä ja henkilökunnan yhteystietoja IT-tiedekunnan
kotisivuilta. Koostaminen tapahtuu koostamiskäyttöliittymän välityksellä.
Koostaja aloittaa varsinaisen
koostamistyön, eli valitsee ne dokumentit jotka halutaan sisällyttää opinto-oppaaseen.
Erityyppiset dokumentit, kuten kurssikuvaukset ja sisällöntuottajien
kirjoittamat luvut sijaitsevat eri tallennusjärjestelmissä, mikä aiheuttaa oman
haasteensa dokumenttien tuomiseen koostamissovellukseen.
Valittuaan halutut dokumentit
opinto-oppaaseen, ryhtyy koostaja koostamaan niitä yhdeksi XML-dokumentiksi.
Tämän työvaiheen lopputuloksena on XML-muodossa oleva opinto-opas.
Oppaan halutusta jakelutavasta
riippuen XML-muotoisesta opinto-opas -dokumentista on mahdollista tehdä joko
PDF- tai HTML-julkaisu, tarvittaessa myös molemmat. PDF-julkaisu tehdään
painoversiota varten, ja HTML-julkaisu verkkolevitykseen. XML à PDF- tai XMLà HTML –muunnokset tapahtuvat
automaattisesti muunnosskriptien avulla. Skriptien käyttämisen tulee onnistua
graafisen käyttöliittymän avulla koostamissovelluksesta käsin.
Eräs Kokako-projektin
käynnistämiseen merkittävästi vaikuttanut tekijä on ollut tarve automatisoida
ja helpottaa opinto-oppaan julkaisuprosessin tämänhetkistä toimintamallia. Erityisesti
XSLT-muunnokset ja XML-dokumentin koostaminen ovat vaatineet joko paljon
manuaalista työtä tai merkittävää komentorivitason osaamista. Manuaalista työtä
pitää tietysti pyrkiä välttämään niin paljon kuin mahdollista, jos vaihtoehtona
on automatisoitu toiminta. Manuaalisella työllä tarkoitetaan tässä tapauksessa
myös XML-koodin kirjoittamista, joka on liian vaikeaa ja hidasta tavalliselle
käyttäjälle.
Komentorivipohjainen
käyttöliittymä on puolestaan varsin tehokas, mutta se vaatii useimmiten
sellaista osaamista, jota peruskäyttäjällä – tässä tapauksessa koostajalla – ei
ole. Koostamista varten on olemassa myös WWW-pohjainen käyttöliittymä, mutta se
on liian kömpelö.
XSLT-muunnoksien vaatiman
manuaalisen työn vähentäminen on mahdollista, mikäli XSLT-skripti kykenee
tulkitsemaan sisällöntuottajien laatimia dokumentteja ja muuntamaan niitä
XML-muotoon. Ongelmana muunnoksissa on tähän asti ollut muunnettavien
dokumenttien heterogeenisyys, kun jokainen sisällöntuottaja on itse valinnut
dokumentin tyylimäärittelyn ja tallennusmuodon. Lähdedokumenttien saattaminen
yhtenäiseen muotoon on mahdollista, mutta se vaatii ohjeistuksen lisäksi yhtenäistä
dokumenttipohjaa, johon käyttäjät eivät voi tehdä ns. ”kiellettyjä”
tyylimäärittelyitä tai muita merkintöjä.
XML-koostaminen tapahtuu kuvan
1. osatehtävässä 6. Aiemmin tämä työvaihe perustui komentorivipohjaisiin
skripteihin tai kömpelöön WWW-käyttöliittymään. Kumpikin vaihtoehto on
loppukäyttäjää ajatellen huono. Kokako-projektin tavoitteena on integroida koostamistyökaluun
selkeä ja tehokas graafinen käyttöliittymä muunnosskriptien käyttämistä varten.
Näin komentorivikäyttöliittymään tottumatonkin käyttäjä pystyy tekemään tehokkaasti
XML-koosteen.
XML-muodossa oleva opinto-opas
julkaistaan joko HTML- tai PDF-muodossa. Aiemmin nämä muunnokset ovat tehty
komentorivipohjaisilla skripteillä, aivan kuten XML-kooste. Tilaaja haluaa
koostamiskäyttöliittymään sellaisen toiminnon, jolla HTML- ja PDF-muunnokset
ovat yksinkertaisia tehdä ilman komentorivin käyttämistä.
Useisiin työvaiheisiin
liittyvä parannusehdotus on lähdedokumenttien ja eri opasversioiden
tallentamisen keskittäminen ja kehittäminen. Tällä hetkellä dokumentteja
tallennetaan mm. WWW-palvelimelle, mutta esimerkiksi versionhallintajärjestelmä
on todettu huomattavasti paremmaksi tallennuspaikaksi opinto-oppaan
dokumentteja ajatellen. WWW-palvelin näkyy käyttäjille jaettuna verkkolevynä,
jonka tiedostojen päällekkäinen käyttö aiheuttaa konflikteja.
Versionhallintajärjestelmällä näitä konflikteja pystytään välttämään.
Luvussa
esitellään sovelluksen sisällöntuottajille tarkoitetut käyttötapaukset
käyttötapauskaavioiden ja niiden kuvauksien avulla.
Sovelluksen
kahdesta erilaisesta käyttäjäryhmästä johtuen myös käyttötapauskaavioita on
kaksi erilaista. Sovelluksessa on sisällöntuottajaa ja koostajaa varten omat
toiminnot. Koostajan on mahdollista käyttää myös sisällöntuottajalle
tarkoitettuja toimintoja, mutta sama asia ei onnistu toisinpäin.
Kuva 2: Sisällöntuottajan käyttötapaukset
|
Käyttötapaus |
Sovelluksen
avaaminen |
|
Ehdot |
- |
|
Kuvaus |
Käyttäjä avaa
sovelluksen käyttöjärjestelmästä. |
|
Jälkitilanne |
Sovellus on
käynnistetty sisäänkirjautumistilaan. |
|
Poikkeukset |
Sovellus ei käynnisty. |
Taulukko 1: Sovelluksen avaaminen
|
Käyttötapaus |
Sisäänkirjautuminen |
|
Ehdot |
Verkkoyhteyden
pitää olla käytettävissä käyttäjätunnuksien tarkistamista varten. |
|
Kuvaus |
Käyttäjä
kirjautuu sisään sovellukseen. Salasanan ja tunnuksen lisäksi käyttäjän pitää
valita myös käyttäjäryhmä, johon hän kuuluu. Käyttäjäryhmän valinta määrittää
sen millainen käyttöliittymä käyttäjälle avautuu. |
|
Jälkitilanne |
Valitun
käyttäjäryhmän mukainen käyttöliittymä on avattu käyttäjälle. |
|
Poikkeukset |
Kirjautuminen ei onnistu, jos käyttäjätunnus,
salasana tai käyttäjäryhmä syötetään väärin. Virhetilanteessa annettaan
käyttäjälle virheilmoitus ja palataan takaisin kirjautumisruutuun. |
Taulukko 2: Sisäänkirjautuminen
|
Käyttötapaus |
Uuden sisällön
tuottaminen. |
|
Ehdot |
|
|
Kuvaus |
Käyttäjä painaa Uusi dokumentti
-painiketta, minkä jälkeen sovellus kysyy uuden dokumentin nimeä. |
|
Jälkitilanne |
Uutta
dokumenttia on mahdollista ryhtyä laatimaan. |
|
Poikkeukset |
- |
Taulukko 3: Uuden sisällön tuottaminen
|
Käyttötapaus |
Olemassa
olevien dokumenttien muokkaaminen. |
|
Ehdot |
Sovellus on
auki peruskäyttöliittymässä. |
|
Kuvaus |
Käyttäjä painaa
Muokkaa dokumenttia -painiketta,
minkä jälkeen valittu dokumentti aukeaa editorikäyttöliittymään. |
|
Jälkitilanne |
Valittua
dokumenttia on mahdollista ryhtyä muokkaamaan. |
|
Poikkeukset |
- |
Taulukko 4: Olemassa olevien dokumenttien
muokkaaminen
|
Käyttötapaus |
Tyylimäärittelyltään
virheellisen dokumentin tuominen. |
|
Ehdot |
Sovellus on
auki editorikäyttöliittymässä. |
|
Kuvaus |
Käyttäjä painaa
Tuo dokumentti -painiketta, jolloin
hänelle tarjoutuu mahdollisuus avata muilla editoreilla muokattu dokumentti
editorikäyttöliittymään. Editorikäyttöliittymä muokkaa dokumentin ensin
XML:ksi ja avaa sen takaisin ODT-muotoon. Tämän jälkeen käyttäjä voi lisätä dokumenttiin
haluamansa tyylimäärittelyt. |
|
Jälkitilanne |
Tuotua
dokumenttia on mahdollista ryhtyä muokkaamaan. |
|
Poikkeukset |
- |
Taulukko 5: Tyylimäärittelyltään virheellisen dokumentin
tuominen
|
Käyttötapaus |
Muokatun
dokumentin tallentaminen |
|
Ehdot |
Käyttäjällä on editorikäyttöliittymässä
dokumentti avattuna. |
|
Kuvaus |
Käyttäjä painaa
Tallenna-painiketta, jolloin
käyttäjän muokkaama dokumentti tallennetaan. Tallennuksen yhteydessä
OpenOfficen ODT-dokumenttimuoto muunnettaan XSLT-muunnoksella
XML-dokumentiksi. |
|
Jälkitilanne |
Tallennettava
dokumentti on tallennettu XML-muodossa. |
|
Poikkeukset |
- |
Taulukko 6: Muokatun dokumentin tallentaminen
|
Editorikäyttöliittymän sulkeminen |
|
|
Ehdot |
Käyttäjällä on editorikäyttöliittymä avattuna. |
|
Kuvaus |
Käyttäjä sulkee editorikäyttöliittymän Lopeta-painiketta painamalla. Sovellus
palaa peruskäyttöliittymä-tilaan. Mikäli käyttäjällä on tallentamaton
tiedosto avattuna, niin ohjelma kysyy haluaako käyttäjä tallentaa tiedostoon
tehdyt muutokset. |
|
Jälkitilanne |
Sovellus on peruskäyttöliittymä-tilassa. |
|
Poikkeukset |
- |
Taulukko 7: Editorikäyttöliittymän sulkeminen
|
Käyttötapaus |
XML-muodossa
olevien dokumenttien esikatselu. |
|
Ehdot |
Käyttäjä on
peruskäyttöliittymässä. |
|
Kuvaus |
Käyttäjä voi
esikatsella tuottamiaan dokumentteja HTML-muodossa valitsemalla
esikatseltavan tiedoston Tiedostot-näkymästä.
Esikatselu näyttää dokumentit luku-DTD:n mukaisella ulkoasulla, eli
sellaisena miltä ne tulevat näyttämään opinto-oppaassa. Esikatselu avautuu peruskäyttöliittymään,
joten mitään erillistä katselmointiohjelmaa ei tätä varten käynnistetä.
HTML-muodon lisäksi käyttäjällä on mahdollisuus esikatsella tiedostoa myös
PDF-versiona painamalla Esikatsele PDF –painiketta. |
|
Jälkitilanne |
Sovellus on
peruskäyttöliittymässä, ja näyttää viimeksi esikatseltavaksi valittua dokumenttia.
PDF-esikatselun yhteydessä esikatseltava PDF-tiedosto on avattu erilliseen
ikkunaan. |
|
Poikkeukset |
- |
Taulukko 8: XML-muodossa olevien dokumenttien
esikatselu
|
Käyttötapaus |
Dokumentin
vieminen versionhallintajärjestelmään. |
|
Ehdot |
Käyttäjällä on peruskäyttöliittymä
avattuna. |
|
Kuvaus |
Käyttäjä
valitsee haluamansa tiedoston tiedostot-näkymästä ja painaa Commit –painiketta. Tämän jälkeen
valittu dokumentti tallennetaan versionhallintajärjestelmään. |
|
Jälkitilanne |
Käyttäjän
valitsema tiedosto on tallennettu versionhallintajärjestelmään. |
|
Poikkeukset |
Käyttäjällä ei ole mitään tiedostoa valittuna.
Tilanteesta annetaan virheilmoitus käyttäjälle. |
Taulukko 9: Dokumentinen vieminen
versionhallintajärjestelmään
|
Käyttötapaus |
Sovelluksen
sulkeminen. |
|
Ehdot |
Käyttäjä on
peruskäyttöliittymässä. |
|
Kuvaus |
Käyttäjä sulkee
sovelluksen painamalla Lopeta-painiketta. |
|
Jälkitilanne |
Käyttäjä on
takaisin käyttöjärjestelmässä. |
|
Poikkeukset |
Mikäli muokattuja dokumentteja ei ole tallennettu
versionhallintajärjestelmään, niin sovellus ehdottaa tallennusta. |
Taulukko 10: Sovelluksen sulkeminen
Luvussa
esitellään sovelluksen sisällöntuottajille tarkoitetut käyttötapaukset
käyttötapauskaavioiden ja niiden kuvauksien avulla.
Sisällöntuottajan
toimintojen lisäksi koostajalla on käytössä koostajalle tarkoitetut toiminnot.
Kuva 3: Koostajan käyttötapaukset
|
Käyttötapaus |
Uuden
opinto-opas-dokumentin laatiminen. |
|
Ehdot |
Käyttäjä on
koostajille mukautetussa peruskäyttöliittymä-tilassa. |
|
Kuvaus |
Käyttäjä painaa
Uusi kooste -painiketta, minkä
jälkeen sovellus kysyy uuden koosteen nimeä. |
|
Jälkitilanne |
Uutta koostetta
on mahdollista ryhtyä koostamaan. |
|
Poikkeukset |
Käyttää ei anna kelvollista nimeä tai peruutta
toimenpiteen. Virheellisesti nimestä annetaan virheilmoitus. |
|
|
|
Taulukko 11: Uuden opinto-opas-dokumentin laatiminen
|
Käyttötapaus |
Olemassa olevan
opinto-opas -dokumentin muokkaaminen. |
|
Ehdot |
Käyttäjä on
koostajille mukautetussa peruskäyttöliittymä-tilassa. |
|
Kuvaus |
Käyttäjä
valitsee peruskäyttöliittymän tiedosto-listasta halutun opas-dokumentin ja
painaa Muokkaa koostetta -painiketta,
minkä jälkeen koostamiskäyttöliittymään aukeaa valittu kooste. |
|
Jälkitilanne |
Valittua
koostetta on mahdollista ryhtyä muokkaamaan. |
|
Poikkeukset |
Mitään koostetta ei ole valittu, jolloin
sovellus ei reagoi käyttäjän napinpainallukseen millään tavoin. |
Taulukko 12: Olemassa olevan opinto-opas-dokumentin
muokkaaminen
|
Käyttötapaus |
Koosteeseen sisällytettävien
dokumenttien valinta |
|
Ehdot |
Käyttäjällä on
koostamiskäyttöliittymä avattuna. |
|
Kuvaus |
Käyttäjä voi
liittää koosteeseen uusia dokumentteja, poistaa niitä sekä vaihtaa dokumenttien
keskinäistä järjestystä opinto-oppaassa. |
|
Jälkitilanne |
Opinto-opasta on
muokattu käyttäjän tekemillä muutoksilla. |
|
Poikkeukset |
- |
Taulukko 13: Koosteeseen sisällytettävien
dokumenttien valinta
|
Käyttötapaus |
Opinto-oppaan
koostaminen valituista dokumenteista |
|
Ehdot |
Koosteeseen on
liitetty vähintään yksi dokumentti. |
|
Kuvaus |
Käyttäjä painaa
Laadi kooste -painiketta, jolloin kooste
koostetaan yhdeksi XML-dokumentiksi. Koostamisen aloituksen yhteydessä käyttäjältä
kysytään, että minkä nimiseen tiedostoon XML-dokumentti tallennetaan
versionhallintajärjestelmässä. |
|
Jälkitilanne |
Yhdeksi
XML-tiedostoksi koostettu opinto-opas on tallennettu versionhallintajärjestelmään. |
|
Poikkeukset |
Jos koosteeseen ei ole valittu yhtään
dokumenttia, niin koostamista ei ole mahdollista aloittaa. Tilanteesta
annetaan virheilmoitus käyttäjälle. |
Taulukko 14: Opinto-oppaan koostaminen valituista
dokumenteista
|
Käyttötapaus |
Muutosten esittäminen vanhoihin opas-versioihin
nähden |
|
Ehdot |
Opinto-oppaasta on olemassa vähintään yksi
aiempi versio |
|
Kuvaus |
Käyttäjä painaa Näytä muutokset -painiketta, jolloin käyttäjälle avautuu lista
saman dokumentin aiemmista versioista. Valittuaan haluamansa version, sovellus
näyttää vertailtavien dokumenttien väliset eroavaisuudet. |
|
Jälkitilanne |
Käyttäjälle on esitetty vertailtavien
dokumenttien väliset eroavaisuudet. |
|
Poikkeukset |
Käyttäjä yrittää
katsoa muutoksia, vaikkei hänellä ole aiempia versioita opinto-oppaasta.
Tilanteesta annetaan virheilmoitus käyttäjälle. |
Taulukko
15: Muutosten esittäminenn vanhoihin
opas-versioihin nähden
|
Käyttötapaus |
Opinto-oppaan
julkaiseminen halutussa formaatissa. |
|
Ehdot |
Käyttäjällä on
opinto-opas avattuna. |
|
Kuvaus |
Käyttäjä
julkaisee opinto-oppaan HTML- tai PDF-versiona. Julkaisu tapahtuu painamalla Julkaise HTML- tai Julkaise PDF -painiketta, minkä
jälkeen opinto-opas muunnetaan käyttäjän valitsemaan julkaisumuotoon. HTML-julkaisu
tallennetaan versionhallintajärjestelmään ja tarvittaessa myös WWW-palvelimelle.
PDF-julkaisu tallennetaan ainoastaan versionhallintajärjestelmään. |
|
Jälkitilanne |
Julkaisuformaatista
riippuen, julkaistu opinto-opas on tallennettu joko versionhallintajärjestelmään
ja/tai WWW-palvelimelle. |
|
Poikkeukset |
Julkaisu ei ole mahdollista, jos käyttäjällä ei
ole opinto-opas-dokumenttia valittuna. Tilanteesta annetaan käyttäjälle virheilmoitus. |
Taulukko 16: Opinto-oppaan julkaiseminen halutussa
formaatissa
Sovellukselle on
asetettu seuraavat tekniset vaatimukset:
T1 Sovellus toimii Windows-ympäristössä.
T2 Sovellus toimii Linux-ympäristössä
T3 Sovellus on määritetty työasemasovellukseksi.
T4 Sovelluksen pitää pystyä käyttämään versionhallintajärjestelmää.
T5 Sovelluksen pitää pystyä kommunikoimaan Korppi-järjestelmän kanssa.
T6 Sovelluksen pitää pystyä keräämään tietoa tiedekunnan WWW-sivuilta.
T7 Sovelluksen editorikäyttöliittymä perustuu OpenOfficeen.