JOHDANTO
- Järjestelmän tarkoitus
- Tiivis kuvaus siitä mistä on kyse.
- Millaisen toiminnan tukemiseen järjestelmä on tarkoitettu.
- Mitkä ovat järjestelmän tavoitteet.
- Nämä tiedot saa yleensä tehtäväkuvauksesta.
- Toimintaympäristö
- Missä laite ja ohjelmistoympäristössä järjestelmän on tarkoitus toimia.
- Rajaukset
- Mahdolliset rajaukset koskien määrittelyn, suunnittelun ja toteutuksen laajuutta.
- Toteutusympäristö
- Missä ympäristössä työ toteutetaan.
YLEISKUVA JÄRJESTELMÄSTÄ
- Sidosryhmäkaavio
- Käyttäjäryhmät
Sidosryhmäkaavio näyttää järjestelmän sidosryhmät ja niiden yhteydet järjestelmään. Tällä kursilla kehitettävissä järjestelmissä sidosryhminä ovat enimmäkseen järjestelmän käyttäjäryhmät. Käyttäjäryhmien ja järjestelmän välisinä yhteyksinä kuvataan tällöin järjetelmän käyttötapaukset karkealla tasolla. Käyttötapaukset ovat järjestelmän käyttäjilleen tarjoamia palveluita. Käyttäjäryhmät voidaan esittää vapaamuotoisina symboleina. Käyttäjäryhmien ja järjestelmän väliset viivat esittävät käyttötapauksia. Viivojen päähän voidaan laittaa nuolenkärki osoittamaan palvelun tarjoajaan (eli yleensä järjestelmään - vain tapauksessa, jossa sidosryhmänä on toinen järjestelmä, jonka palveluja käytetään hyväksi, osoittaa nuoli tuohon toiseen järjestelmään).
Sekä
käyttötapaukset että käyttäjäryhmät kuvataan erikseen
tekstinä. Alla esimerkki:
Kuva:1: Esimerkki kaaviosta (kaavio laadittu Power Point:lla)
Määritellään sidosryhmäkaaviossa esiintyvät käyttäjät
Esimerkki
Jokamies
- Jokamiehellä tarkoitetaan ketä tahansa,
joka Internetin välityksellä tulee lukemaan KatonAlle yhtiön
www-sivuja. Kaikki seuraavat luokat kuuluvat myös jokamies luokkaan.
- Asiakas on rekisteröitynyt käyttäjä.
- Vuokranantaja on rekisteröitynyt henkilö,
joka on antanut asunnon KatonAlle yhtiölle välitettäväksi.
- Työntekijä on KatonAlle yhtiön
palveluksessa oleva henkilö.
- Johdolla tarkoitetaan työntekijöitä,
joiden tehtävänä on tehtävien anto ja asioista päättäminen.
KÄYTTÖTAPAUKSET
Käyttötapauksella tarkoitetaan järjestelmän avulla hoidettavaa tavoitteellista tehtäväkokonaisuutta, esimerkiksi tilauksen kirjaus, tilauksen peruutus, asiakkaan kirjaus, asiakkaan poistaminen, laskun tulostus, kuukausiyhteenvedon laatiminen ovat tehtäväkokonaisuuksia, joita on luonnollista mallintaa käyttötapauksina. Kustakin käyttötapauksesta kuvataan sen sisältö: mitä käyttötapauksessa tehdään. Raporttien kohdalta kerrotaan, mitä tietoja raporttiin sisältyy. Tässä vaihessa ei vielä ratkaista sitä, miten käyttötapaus viedään teknisesti läpi, millainen ulkoasu näytöllä on ja mitä näppäimiä painetaan. Jotain yleisiä periaatteita näistäkin voi toki kertoa. Tarkoituksena on, että suunnittelu etenee karkeammalta tasolta kohti yhä enemmän ykstyiskohtia sisältäviä kuvauksia. Käytötapausten läpivienti käyttöliittymän avulla kuvataan käyttöliittymän hahmottelun yhteydessä myöhemmin.
Käyttötapausten avulla määritellään järjestelmän toiminnallisuus eli, mitä järjestelmällä tehdään. Voit luonnostella käyttötapauksia esimerkkitapausten avulla. Esimerkkitapauksessa toiminnan kohde on kiinnitetty, esimerkiksi 'ilmoittautuminen Informaatiojärjestelmät kurssin harjoitusryhmään 3' on esimerkkitapaus käyttötapauksesta 'luentokurssille ilmoittautuminen'. Voit esittää esimerkkitapauksia myös dokumentissa havainollistaaksesi käyttötapauksia. Käyttötapaukset voi esittää tärkeysjärjestyksessä, aakkosjärjestyksessä tai käyttäjittäin ryhmiteltyinä. Seuraavassa esimerkissä on kuvattu kenelle tahansa tarkoitetut käyttötapaukset asunnonvuokrausjärjestelmässä.
Esimerkki:
Jokamiehen käyttötapaukset
Yritysinfon lukeminen
- Kuka tahansa voi käydä lukemassa
yrityksen mainos- ja yleistietoja mm. työntekijöiden puhelinnumerot
ja toimistojen sijainnit.
- Käyttäjälle näytetään, minkä
tyyppisiä asuntoja kullakin alueella kyselyn suoritushetkellä
on tarjolla vuokralle ja kuinka monta näitä on tarjolla.
Esimerkki: Millaisia asuntoja on tarjolla Kruunuhaassa?
- Rekisteröitymisessä käyttäjä
ilmoittautuu yrityksen asiakkaaksi päästen näin yrityksen
muiden asiakaspalveluiden käyttäjäksi ja asiakastiedotteiden saajaksi.
Jokamiehestä tulee asiakas. Hän antaa henkilötietonsa ja
saa asiakastunnuksen, joka on avain
asiakkaille tarkoitettuihin palveluihin. Prototyypissä asiakastunnus
aktivoituu heti. Aktivoinnin voisi kytkeä myös
rekisteröintimaksun maksamiseen.
JÄRJESTELMÄN TIETOSISÄLTÖ
Järjestelmän tietosisältö kuvataan luokkakaavion alulla. Kaavio voidaan laatia jollakin piirrosohjelmalla tai erityisellä tällaisten kaavioiden laadintaan tarkoitetulla työkalulla. Laitoksella on käytössä erityistyökaluna Windows ympäristössä toimiva Plastic Lite ja Rational Rose Student edition sekä Nokian tutkimuskeskuksen Mermaid. Näillä saa UML-tekniikan mukaisia kaavioita (Plasticilla vain luokkakaavioita). Linux KDE ympäristöstä löytyy luokkakaaavioiden tekoon kuml.
Esimerkki luokkakaaviosta (tehty Plastic Lite:lla)
Kaavion lisäksi täytyy kuhunkin luokkaan liittää selitys, jossa määritellään kyseinen kohde. Attribuutitkin täytyy määritellä ellei merkitys ole nimen perusteella itsestäänselvä. Jos attribuutilla on koodiarvoja tai rajattu arvojoukko, on arvojen merkitys myös selitettävä. Myös yhteydet täytyy määritellä. Alla on esimerkkinä yhden luokan määrittely.
Esimerkki luokan kuvauksesta:
Luokka: varustelukuvaus
Attribuutti Arvojoukko Kuvailu huoneisto viite huoneistoon tunnistava yhteys laatimis_aika paivays sisäinen tunniste laatija viite virkailijaan jääkaappi merkki K/E (kyllä/ei) pakastin merkki K/E (kyllä/ei) astianpesukone merkki K/E (kyllä/ei) liesituuletin merkki K/E (kyllä/ei) lasitettu_parveke merkki K/E (kyllä/ei) kylpyamme merkki K/E (kyllä/ei) parketti merkki K/E (kyllä/ei) sauna merkki K/E (kyllä/ei) viinikaappi merkki K/E (kyllä/ei) muuta pitkä teksti Jokaiseen huoneistoon voi liittyä monta varustelukuvausta, joista vain viimeisin on voimassa. Varustelukuvaus laaditaan huoneiston arvioinnin yhteydessä. Varustelukuvaus identifioidaan huoneiston ja laatimisajan perusteella. Ensimmäinen varustelukuvaus perustuu huoneiston omistajan ilmoitukseen. Varustelukuvaus kuvaa huoneiston kunnon ja varustelun. Yleisimmille varusteille on varattu oma attribuutti, jonka arvona on 'k' jos varuste on tarjolla, muulloin arvona on 'e'. Varsinainen kuntokuvaus on pitkässä vapaamuotoisessa tekstikentässä muuta. Attribuutti laadittu ilmaisee kuvauksen laatimisajan.
Varustelukuvaus on yhteydessä
- huoneistoon, jota se kuvaa,
- virkailijaan joka on sen laatinut
(HUOM: Yllä oleva ratkaisu ei ole varustelun suhteen kovin hyvä. Uusien varusteiden mukaanottaminen edellyttää kannan rakenteiden ja ohjelmien muuttamista)
Jos haluat varmistua siitä, että oliomallisi ja käyttötapauksesi sopivat yhteen ja mallit ovat kattavia voit laatia riippuvuusmatriisin kuvaamaan olioiden käsittelyä käyttötapauksissa. Riippuvuusmatriisin sarakkeina ovat olioluokat ja yhteydet. Riveinä ovat käyttötapaukset. Kuhunkin sarakkeeseen merkitään, mitä käyttötapauksessa tehdään ko. luokan olioille (C=create, R=read, D=delete, U=update). Jokaisen käyttötapauksen täytyy käsitellä jotain luokkia. Luokan olioille täytyy mahdollistaa riittävät käsittelyoperaatiot käyttötapausten kautta.
KÄYTTÖLIITTYMÄN HAHMOTELMA
Käyttöliittymän hahmotelmassa luonnostellaan järjestelmän käyttöliittymä toteutettavaksi ajatellussa laajuudessa. Hahmotelmaan voi kuulua luonnoksia raporttien ja näyttöjen ulkoasusta sekä näihin liittyviä selityksiä. Erityisen tärkeää on luoda kokonaiskuva käyttöliittymästä.
Luonnoksia käyttöliittymästä voi tehdä jollakin piirrosohjelmalla. Tekstinkäsittelyjärjestelmät piirrostoiminnot riittävät yleensä hahmotelman laatimiseen. Joistakin näytöistä ja raporteista riittää sanallinen hahmotelma. Taustakuvia ja vastaavia hienouksia ei tässä vaiheessa ole tarpeen esitellä.
- miten käyttötapaukset suhtautuvat näyttöihin ja raportteihin
- miten tietyn käyttötapauksen yhteydessä toimitaan
- miten näyttöjen välillä liikutaan
- miten raportit kytkeytyvät näyttöihin
Näyttöjen välisiä yhteyksiä on luontevaa esittää kaavioina. Seuraavassa kuvassa on esimerkki tällaisesta kaaviosta.
.
Käyttöliittymän sivujen väliset yhteydet (tehty Plastic Lite:lla).Käyttötapausten ja käyttöliittymäkomponenttien välisiä yhteyksiä voi selittää tekstimuodossa. Jos useat käyttötapaukset käyttävät yhteisiä käyttöliittymäkomponentteja tai käyttötapauksen yhteydessä tarvitaan monia käyttöliittymäkomponetteja, voi riippuvuuksia kuvata matriiseina.
RELAATIOTIETOKANTAKAAVIO
Relaatiotietokantakaavio esitetään SQL:n create table lauseina. Kaavioon täytyy sisältyä taulujen välisten viiteyhteyksien ja avainten määritykset. Kaaviota voi havainnollistaa myös esittämällä taulujen väliset viiteriippuvuudet kuvana, mutta tämä ei ole pienen tietokannan osalta välttämätöntä. Jos relaatiokaaviossa on attribuutteja, jotka eivät esiinny käsitemallissa tai jonkin käsitemallin attribuutti on karsittu tai sen muotoa on muutetettu on tästä erikseen mainittava. Yleissääntönä on, että relaatiotietokantakaavion tulee olla yhteensopiva käsitemallin kanssa.
Teknisesti tämän kohdan voi toteuttaa sisällyttämällä varsinaiseen dokumenttitekstiin vain taulujen nimet, sekä lyhyen selityksen taulujen tarkoituksesta. Create table -lauseet voi antaa liitteenä.
Voit liittää tähän yhteyteen myös kuvan, josta käy esiin taulujen rakenne ja taulujen väliset viiteavaimet. Alla esimerkki kuvasta. Kuvassa nuolet lähtevät viiteavain sarakkeen kohdalta, pk= priumary key, fk= foreign key. Tämkin kuva on tehty Plastic Lite:llä. Muita mainittuja työkaluja voi samoin käyttää monipuolisesti eri tarkoituksiin.
