Tietotekniikan Sovellusprojekti
Vaatimusmäärittely 1.0
10.3.2004
TIETOTEKNIIKAN LAITOS
Tekijät: Hanna Alm, Kari Arkko, Pentti Nakari, Lassi Paavolainen
Työnnimi: Vaatimusmäärittely
Työ: Coma-Sovellusprojekti
Sivumäärä: 17
Tilaaja: Jyväskylän yliopisto, Tietotekniikan laitos
Tiivistelmä: Dokumentti sisältää ECCOMAS2004-konferenssin CD-ROM-proceedingsin ja konferenssisovelluksen vaatimus-määrittelyn. Vaatimusmäärittelyssä on kuvattuna CD-ROM-proceedingsin ja konferenssisovelluksen toiminnalliset ja tekniset vaatimukset sekä konferenssisovelluksen eri käyttötapauksien kuvaukset.
Avainsanat: proceedings, ECCOMAS2004
Versiohistoria
Versio |
Pvm |
Kuvaus |
Tekijä |
0.1 |
09.02.2004 |
Vaatimusmäärittelyn hahmotus |
LP |
0.2 |
13.02.2004 |
Versiota 0.1 korjattu |
LP |
0.3 |
16.02.2004 |
Lisätty käyttötapaukset |
LP, KA |
0.4 |
23.02.2004 |
Lisätty yleiskuvaus, tietokannan vaatimukset ja riippuvuuskaavio. Muokattu lukuja 4.2, 5.2 ja 6.2 |
LP, KA |
0.5 |
24.02.2004 |
Muutettu käyttötapauskaaviota |
KA |
0.6 |
02.03.2004 |
Korjattu virheitä, muokattu kuvia, lisätty yhteenveto, listattu testattavat selaimet ja tarkennettu käyttötapauksia. |
LP, KA, HA |
0.7 |
04.03.2004 |
Korjattu virheitä, lisätty käyttäjäryhmien esittely ja oikeudet. |
LP |
0.7.1 |
08.03.2004 |
Korjattu virheitä |
LP, KA |
1.0 |
10.03.2004 |
Korjattu kirjoitusvirheitä |
LP |
Tekijät
HA – Hanna Alm
KA – Kari Arkko
PN – Pentti Nakari
LP – Lassi Paavolainen
Coma-projekti
Projektiryhmä: Hanna Alm haalm@cc.jyu.fi
Kari
Arkko ktarkko@cc.jyu.fi
Pentti
Nakari pjen@cc.jyu.fi
Lassi
Paavolainen lopaavol@cc.jyu.fi
Tilaaja: Jyväskylän yliopisto, Tietotekniikan laitos
Kirsi
Majava majkir@mit.jyu.fi
Pekka
Neittaanmäki pn@mit.jyu.fi
Tuomo
Rossi tro@mit.jyu.fi
Vastaava ohjaaja: Markus Inkeroinen marink@mit.jyu.fi
Tekninen ohjaaja: Tero Toivonen tptoivon@cc.jyu.fi
Visuaalinen konsultti: Jaana Rannanpää jaelrann@cc.jyu.fi
Käytettävyyskonsultti: Katja Kaario kaario@mit.jyu.fi
Työtila: Huone AgC 223.4, p. 014-260 4966
Kotisivu: http://sovellusprojektit.it.jyu.fi/coma/
sähköposti: coma@korppi.jyu.fi
Laitteet: Neljä PC-konetta, joissa kahdessa on käyttöjärjestelmänä Windows XP professional, ja kahdessa Linux.
Tiivistelmä: Coma-projekti on Jyväskylän yliopiston
tietotekniikan laitoksella kevään 2004 aikana toteutettava Sovellusprojekti.
Coma-projekti suunnittelee ja toteuttaa konferenssisovelluksen
konferenssi-proceedings CD-ROM-levyn tekemiseen.
Sisällys
4.1. ECCOMAS2004 CD-ROM-proceedings
5.1. ECCOMAS2004 CD-ROM-proceedings
5.1.2. Muita teknisiä vaatimuksia
5.2.2. Kokoomajulkaisun generoiva sovellus
6.2. Käyttötapauskaavio ja käyttötapausten riippuvuudet
6.3. Käyttötapausten sanalliset kuvaukset
6.3.1. Käyttötapaus: Luo tietokanta
6.3.2. Käyttötapaus: Lisää/muokkaa järjestelijä
6.3.3. Käyttötapaus: Lisää/muokkaa/poista aihealue
6.3.4. Käyttötapaus: Lisää/muokkaa/poista sessioiden tyyppi
6.3.5. Käyttötapaus: Anna/muokkaa
artikkelin tiivistelmä sekä kirjoittajien tiedot
6.3.6. Käyttötapaus: Siirrä artikkeli
6.3.7. Käyttötapaus: Anna artikkeli
6.3.8. Käyttötapaus: Luo/muokkaa aikataulu
6.3.9. Käyttötapaus: Luo/muokkaa ulkoasu
6.3.10. Käyttötapaus: Esikatsele ulkoasua
6.3.11. Käyttötapaus: Luo levyjako
6.3.12. Käyttötapaus: Luo levyjen hakemistorakenne ja HTML-sivut
Taulukko 1. Versiohistoria................................................................................................. I
Kuva 1. Projektin tuottama kokonaisuus......................................................................... 3
Kuva 2.
Konferenssisovelluksen käyttötapauskaavio................................................. 11
Coma-projekti toteuttaa kevään 2004 aikana Jyväskylässä 24–28.7 järjestettävään ECCOMAS2004 (European Congress on Computational Methods in Applied Sciences and Engineering) -konferenssiin liittyvän kokoomajulkaisun eli proceedingsin CD-ROM-muotoisena. Lisäksi projektin on tarkoitus luoda konferenssisovellus, jota voidaan käyttää tulevaisuudessa konferenssi-proceedingsien tekemisessä. CD-ROM-proceedingsin on valmistuttava viimeistään heinäkuuhun mennessä, jotta se voidaan jakaa konferenssin aikana siihen osallistuville painettavan tiivistelmäjulkaisun välissä.
Projekti on aloitettu tilaajan tarpeesta saada kesän ECCOMAS2004-konferenssin kokoomajulkaisu eli proceedings CD-ROM-muotoisena. Samalla on mietitty voisiko projektin yhteydessä tehdä yleiskäyttöisen sovelluksen, jonka avulla proceedingsit voitaisiin luoda myös tulevaisuudessa järjestettävistä konferensseista ja tapahtumista melko helposti. Tämän takia projektiryhmältä on tilattu ECCOMAS2004-konferenssin CD-ROM-proceedings sekä konferenssisovellus.
Vaatimusmäärittely sisältää sekä CD-ROM-proceedingsin että konferenssisovelluksen toteutettavat vaatimukset ja jatkokehitykseen jätettäviä vaatimuksia. Vaadittavat ominaisuudet tulee olla toteutettuna ECCOMAS2004-konferenssin CD-ROM-proceedingsissa ja konferenssisovelluksessa ennen projektin päättymistä. Toivottavat ominaisuudet toteutetaan mikäli ryhmällä jää siihen aikaa projektin puitteissa. Toivottavia ominaisuuksia voidaan mahdollisesti jatkokehittää kesätöinä. Projektin vähimmäisvaatimuksena on, että kesän konferenssia varten saadaan tehtyä CD-ROM-proceedings-julkaisu, viimeistään 10 työpäivää ennen konferenssin alkua.
Luvussa 2 kuvataan vaatimusmäärittelyyn
liittyvät termit. Luvussa 3 esitetään projektiryhmän tekemän kokonaisuuden
yleiskuvaus. Luvussa 4 on kuvattu CD-ROM-proceedingsin ja
konferenssisovelluksen toiminnalliset vaatimukset sekä luvussa 5 niiden
tekniset vaatimukset. Luvussa 6 kuvataan konferenssisovelluksen
käyttötapaukset.
Termit
Luvussa selitetään vaatimusmäärittelyssä esille tulevia termejä.
ECCOMAS2004 CD-ROM-proceedingsiin liittyvät termit:
Contributed Sessiotyyppi, joka sisältää konferenssissa järjestettävät tavalliset luennot.
Keynote Sessiotyyppi, joka sisältää konferenssiin luennoimaan kutsuttujen henkilöiden luennot. Tässä sessiotyypissä pidettäviä esitelmiä on monta samaan aikaan. Keynote-sessioissa on pienempi osallistujamäärä kuin Plenary-sessioissa.
Minisymposium Sessiotyyppi, johon järjestäjien valtuuttama henkilö on järjestänyt puhujat luennoimaan tietystä aiheesta.
Plenary Sessiotyyppi, joka sisältää konferenssiin luennoimaan kutsuttujen henkilöiden luennot. Suurempia tilaisuuksia kuin Keynote-sessiot. Vain yksi esitelmä kerrallaan.
Poster Sessiotyyppi, johon kuuluvista artikkeleista ei järjestetä luentoa ollenkaan. Valmistetaan seinäjuliste, joka laitetaan näytteille.
Proceedings Tieteellisistä artikkeleista koostuva kokoomajulkaisu.
Round Table Sessiotyyppi, joka sisältää konferenssissa järjestettävät paneelikeskustelut.
Sessio Tietyssä paikassa tiettyyn aikaan pidettävä luentosarja, jossa kaikki luennot ovat samasta aihealueesta.
STS Sessiotyyppi, joka sisältää konferenssissa teollisuuden sovelluksista pidettävät luennot.
Validaattori HTML-sivujen
standardinmukaisen rakenteen tarkistava ohjelma. Löytyy esimerkiksi
Internet-osoitteesta: http://validator.w3.org/
Konferenssisovellukseen liittyvät termit:
HTML-4.0 HTML
on WWW:ssä käytettävien dokumenttien rakenteen määrittelyyn tehty kieli.
Standardi löytyy Internet-osoitteesta: http://www.w3.org/TR/html4/
Konferenssisovellus Yleiskäyttöinen sovellus, jonka avulla voidaan luoda konferenssien kokoomajulkaisuja.
Perl Tulkattava ohjelmointikieli.
Skripti Tulkattava komentojono.
Luvussa kuvataan projektiryhmän tuottaman järjestelmän yleiskuvaus. Kuvassa 1 on hahmotelma projektiryhmän tuottamista sovelluksista.
Projektiryhmä toteuttaa kolme eri ohjelmaa, joista kaksi kuuluu konferenssisovellukseen ja yksi on erillinen. Erillisen osa siirtää ECCOMAS2004-konferenssin nykyisestä tiedostorakenteesta tiedot tietokantaan ja takaisin. Konferenssisovellukseen kuuluvista osista käyttöliittymäosalla hallitaan tietokannan tietoja ja lisätään tietokantaan konferenssiin liittyvät tiedot. Tämän lisäksi toteutetaan erillinen sovellus, joka generoi kokoomajulkaisun hakemistorakenteen tietokannan tietojen pohjalta.
Kuva 1. Projektin tuottama kokonaisuus.
Luvussa kuvataan ECCOMAS2004 CD-ROM-proceedingsin eri toiminnot sekä toiminnalliset vaatimukset. Lisäksi kuvataan konferenssisovelluksen toiminnalliset vaatimukset.
Konferenssin CD-ROM-proceedingsin vaadittavat ominaisuudet ovat:
· Artikkelien selaus kirjoittajan nimen alkukirjaimen mukaan.
· Artikkelien selaus aihealueen mukaan (kaikki aihealueen artikkelit listattu aakkosjärjestykseen tai sessiotyyppien mukaiseen järjestykseen, ensin Contributed-artikkelit, sitten Minisymposium jne.).
· Artikkelin nimen perään linkki sessioon, jossa artikkeli on esitetty.
· Sessioiden listaus aihealueittain (kaikki samassa tai erottelu sessiotyypin mukaan).
· Sessiosta linkki, josta pääsee selaamaan kyseisessä sessiossa esitettyjä artikkeleita.
· Artikkelin esittäjä merkitään näkyviin.
Näiden lisäksi konferenssin CD-ROM-proceedings voi sisältää seuraavia toivottavia ominaisuuksia, jotka toteutetaan siinä järjestyksessä kuin ne on lueteltu, mikäli projektiryhmällä jää projektin puitteissa siihen aikaa:
1. Konferenssin ohjelma, jonka pohjalta voi selailla tiettyyn aikaan olleita sessioita ja niissä esitettyjä artikkeleita.
2. Artikkelien haku ja lajittelu kirjoittajan antamien avainsanojen mukaan.
Proceedingsin verkkojulkaisua varten jätetään toteutettavaksi artikkelien haku asiasanan mukaan artikkelin otsikosta ja session haku asiasanan mukaan session nimestä. Verkkojulkaisun tekeminen ei kuulu projektiryhmän tehtäviin.
ECCOMAS2004-proceedings tulee jakaa kahdelle CD-ROM-levylle siten, että ensimmäinen sisältää Contributed, Keynote, Poster ja Plenary sessioiden artikkelit ja toinen Minisymposium, STS (ja mahdollisesti tulevat Round Table) sessioiden artikkelit. Levyjaossa on kuitenkin pidettävä koko ajan mielessä, että jako voi vielä muuttua ennen lopullista versiota. Molemmille levyille sijoitetaan kaikki selaustoiminnot. On myös varauduttava siihen, että kaikki tieto ei mahdu kahdelle levylle, jolloin jakoa levyjen kesken on mietittävä uudelleen. Levyjen välillä tulee olemaan ristiinviittauksia. Ristiinviittauksissa tulee ilmoittaa käyttäjälle, että etsitty artikkeli löytyy toiselta levyltä.
Artikkeleiden lisäksi levyille tullaan sijoittamaan tietoa ECCOMAS-organisaatiosta sekä Jyväskylästä. Edellä mainittujen lisäksi proceedings-julkaisun editorit, ISBN-numero ja julkaisija on kerrottava jossakin kohtaa julkaisua.
Konferenssisovelluksen avulla voidaan koostaa konferenssi-proceedingseja tulevaisuudessa järjestettävistä konferensseista. Sovelluksen avulla tuotetut proceedingsit tulee olla pienillä muutoksilla julkaisukelpoisia.
Konferenssisovelluksen tulee toimia siten, että konferenssin järjestelijä voi ensin syöttää sovellukselle tarvittavat tiedot. Tämän jälkeen sovelluksen luomien keräyssivujen avulla artikkeleiden kirjoittajat voivat syöttää tiivistelmänsä sovellukselle. Järjestelijä jakaa kyseiset tiivistelmät arvioitavaksi ja hyväksyttyjen artikkeleiden kirjoittajia pyydetään toimittamaan valmiit artikkelit. Kun kaikki artikkelit on saatu, voi järjestelijä jakaa artikkelit sessioihin. Tämän jälkeen järjestelijä voi syöttää sovellukselle loput haluamistaan tiedoista, jonka jälkeen sovelluksen avulla voidaan luoda proceedingsit. Tämän jälkeen proceedingsia voi halutessaan muokata käsin ja julkaista haluamassaan paikassa, kuten CD-ROM-levyllä tai WWW-sivuilla.
Konferenssin järjestelijä syöttää sovellukselle seuraavat tiedot:
1. Konferenssin aihealueet.
2.
Sessiotyyppien nimet ja hallintatapa, eli
hoitaako järjestelijä kyseisen sessiotyypin artikkelien hyväksynnät vai tekeekö
ulkopuolinen henkilö sen (vrt. Contributed ja Minisymposium).
3. Artikkeleiden jako arvioitavaksi.
4. Artikkelin hyväksyntä (järjestelijä ei tee, mikäli kyseessä jonkun muun henkilön järjestämä sessio vrt. Minisymposium).
5. Artikkelien jako sessioihin (järjestelijä ei tee, mikäli kyseessä jonkun muun henkilön järjestämä sessio vrt. Minisymposium).
6. Konferenssin aikataulu.
7. Mahdollinen jako eri CD-ROM-levyille.
8. Proceedingsin ulkoasu.
Näistä projektiryhmä toteuttaa kohdat 1, 2 (ei hallintatapaa), 7 ja 8. Kohta 6 toteutetaan mikäli ryhmällä jää siihen aikaa projektin yhteydessä. Kohtien 3, 4 ja 5 toteuttaminen jätetään jatkokehitykselle tehtäväksi.
Artikkelien kirjoittajat syöttävät sovellukselle:
1. Artikkelin sessiotyypin.
2. Artikkelin aihealueen.
3. Artikkelin kirjoittajien tiedot.
4. Artikkelin tiivistelmän.
5. Artikkelin otsikon ja avainsanat.
6. Valmiin artikkelin.
Artikkelien kirjoittajien syöttämät tiedot tallennetaan sovelluksen tietokantaan. Tietojen kerääminen artikkelien kirjoittajilta ja niiden tallentaminen tietokantaan jätetään jatkokehitykselle.
Luvussa kuvataan CD-ROM-proceedingsin ja konferenssisovelluksen tekniset vaatimukset sekä tietokannan vaatimukset.
Luvussa kuvataan ECCOMAS2004 CD-ROM-proceedingsin tekniset vaatimukset.
Data koostuu noin 1000:sta tieteellisestä artikkelista. Artikkelit ovat 4–20 sivun pituisia ja PDF-muodossa.
Artikkeleita on kuudenlaisia, jaoteltuna sen mukaan minkä tyyppisessä sessiossa ne esitetään konferenssissa. Suurimman osan artikkeleista muodostavat Contributed ja Minisymposium artikkelit. Muut artikkelityypit ovat Keynote, Poster, Plenary, STS (ja mahdollisesti Round Table). Sessiot on jaoteltu seuraavasti:
·
Contributed:
Tavalliset luennot.
· Keynote: Konferenssiin luennoimaan kutsuttujen henkilöiden luennot. Pienempi tilaisuus kuin Plenary. Useita samaan aikaan.
· Minisymposium: Konferenssin järjestelytoimikunnan valtuuttama henkilö on järjestänyt puhujat luennoimaan tietystä aiheesta.
· Poster: Ei järjestetä luentoa ollenkaan. Valmistetaan seinäjuliste.
· Plenary: Konferenssiin luennoimaan kutsuttujen henkilöiden luennot. Suurempi tilaisuus kuin Keynote. Vain yksi kerrallaan.
· STS: Teollisuuden sovelluksista pidettävät luennot.
· Round Table: Paneelikeskustelut.
Sessioiden tyypin lisäksi artikkelit on jaoteltu kymmeneen eri aihealueeseen:
1.
Computational
Solid and Structural Mechanics
2.
Computational
Fluid Mechanics
3.
Computational
Acoustics
4.
Computational
Electromagnetics
5.
Computational
Chemistry
6.
Computational
Mathematics and Numerical Methods
7.
Inverse
Problems
8.
Optimization
and Control
9.
Computational
Methods in Life Sciences
10. Industrial Applications
Artikkelit sijaitsevat palvelimella hakemistorakenteessa, jossa jokaisen artikkelin tiedot ovat omassa hakemistossa. Artikkeleista on talletettu hakemistoon:
· Sessiotyyppi
· Aihealue
· Kirjoittajat
· Esittäjä
· Tiivistelmä
· Otsikko
· Avainsanat
· Onko artikkeli hyväksytty
· Artikkeli PDF-muodossa
· Tieto siitä missä sessiossa esitetään
· Järjestysnumero kyseisessä sessiossa
· Esityksen kesto
Konferenssi-proceedings tullaan sijoittamaan konferenssin jälkeen saataville konferenssin verkkosivuille. Tämän takia proceedings tulee tehdä helposti WWW-sivuille siirrettävään muotoon.
CD-ROM-levyjen käyttö ei saa vaatia ohjelmien asennusta, vaan levyjä pitää pystyä käyttämään suoraan selaimella. CD-ROM-levyjen käytöstä tehdään niin helppoa, ettei erillistä ohjekirjaa tarvita. Toivottavaa olisi, että CD-ROM-levyt olisivat parempia ja helpompia käyttää kuin mitkään tähän asti julkaistuista proceedings-levyistä.
CD-ROM-levyille tulevat HTML-sivut toteutetaan HTML-4.0 standardin mukaisesti. Standardi on yleisesti tuettu uusissa selaimissa. HTML-sivujen tulee mennä validaattorista läpi ilman virheitä. HTML-sivujen toimiminen tulee testata seuraavilla selaimilla:
·
Firefox
0.8 (Windows, Linux)
·
Internet
Explorer 6.0 (Windows)
·
Konqueror
3.1 (Linux)
·
Lynx
2.8 (Unix)
·
Mozilla
1.5 (Windows, Linux)
·
Netscape
7.0 (Windows, Linux)
·
Omniweb
4.5 (MacOS)
·
Opera
6.0 (Windows, Linux)
· Safari 1.2 (MacOS)
· Galeon 1.3 (Linux)
Testattavan selaimen perässä on mainittu käyttöjärjestelmä jossa kyseistä selainta testataan. Mikäli selaimesta on versioita useille eri käyttöjärjestelmille, kuten Mozillasta, testataan sitä eri käyttöjärjestelmillä.
Konferenssin proceedings-julkaisun kieli on englanti. Tämän takia kaikki CD-ROM-levyille päätyvä materiaali tulee olemaan englanniksi.
Konferenssisovellus koostuu kahdesta eri osasta, jotka ovat käyttöliittymäsovellus sekä hakemistorakenteen ja HTML-sivut generoiva sovellus.
Konferenssisovelluksen on tarkoitus generoida konferenssijulkaisu HTML-muodossa, jotta se olisi sellaisenaan siirrettävissä sekä CD-ROM-levylle että WWW-muotoon. Sovellus sisältää WWW-pohjaisen käyttöliittymän, jonka avulla konferenssin rakenne voidaan luoda ja myöhemmin muokata.
Konferenssisovelluksen rajapintojen ja tietorakenteiden tulee olla sellaiset, että sovelluksen käyttö ja jatkokehittäminen tulevaisuudessa olisi yksinkertaista. Ohjelmointikielen vaatimuksena on helppo jatkokehittäminen. Tästä syystä ohjelmointikieleksi on päätetty Perl ja ohjelmakoodi kirjoitetaan englanniksi. Lisäetuna on se, että Perl-ohjelmat siirtyvät vain pienillä muutoksilla käyttöjärjestelmästä toiseen. Konferenssisovelluksen täytyy toimia Linux-ympäristössä, mutta Windows toiminnallisuutta ei vaadita.
Konferenssisovelluksen tulee ottaa huomioon se, ettei kaikki tieto mahdu yhdelle CD-ROM-levylle, vaan artikkeleita voidaan joutua jakamaan usealle eri levylle.
Käyttöliittymäsovellus sisältää käyttöliittymän tietokannan hallintaan. Käyttöliittymän avulla voidaan tietokantaan määritellä aihealueet, sessiotyypit, konferenssin aikataulu, kokoomajulkaisun ulkoasu sekä jako eri CD-ROM-levyille.
Kokoomajulkaisun generoivaa sovellusta käytetään kokoomajulkaisun hakemistorakenteen ja HTML-sivujen tekemiseen tietokantaan tallennettujen tietojen pohjalta. Generoivaa sovellusta on tarkoitus käyttää vasta siinä vaiheessa kun kaikki tieto, joka tulee konferenssin proceedings-julkaisuun, on kerätty. Ajettaessa generoiva sovellus luo halutun hakemiston alle jokaiselle CD-ROM-levylle oman hakemiston ja näihin hakemistoihin kyseiselle levylle tulevan hakemistorakenteen ja HTML-sivut.
Kokoomajulkaisun tarvitsema data sijoitetaan tietokantaan, jonka avulla hakujen generoiminen levylle on helpompaa. Lisäksi verkkosivuille toteutettavaksi jätetyt asiasanan mukaiset haut on helpompi tehdä tietokannan avulla.
ECCOMAS2004-konferenssin data sijaitsee hakemistorakenteessa. Konferenssisovellusta varten pitää data siirtää tietokantaan. Siirron tekemiseksi luodaan skripti. Ylläpidon vaatimuksen mukaan skriptin pitää toimia molempiin suuntiin, jolloin tietokanta on myös mahdollista kääntää takaisin alkuperäiseksi rakenteeksi. Konferenssin tietojen kerääminen suoraan tietokantaan jätetään jatkokehityksen tehtäväksi.
Tietokantaan tallennetaan:
· Aihealueiden nimet
· Sessiotyyppien nimet
· Sessiotyyppien hallintatapa (sisäinen vai ulkoinen, ei tule ECCOMAS2004-tietokantaan)
· Sessioiden nimet
· Sessioiden aihealueet ja tyypit
· Artikkelin kirjoittajien tiedot (nimi ja yhteystiedot)
· Artikkelin esittäjä
· Mihin aihealueeseen ja sessiotyyppiin artikkeli kuuluu
· Artikkelin otsikko
· Artikkelin tiivistelmä (ei ECCOMAS2004-tietokantaan)
· Artikkelin avainsanat
· Tieto siitä onko artikkeli hyväksytty (ei ECCOMAS2004-tietokantaan)
· Missä sessiossa artikkeli esitetään
· Järjestysnumero kyseisessä sessiossa
· Esityksen kesto (ECCOMAS2004-tietokantaan, mikäli projektiryhmä toteuttaa selauksen aikataulusta)
· Viite artikkeliin
· Konferenssin aikataulu (ECCOMAS2004-tietokantaan, mikäli projektiryhmä toteuttaa selauksen aikataulusta)
· Levyjako
Luvussa kuvataan konferenssisovelluksen käyttäjäryhmät ja heidän oikeudet sekä eri käyttötapaukset.
Konferenssisovelluksen käyttäjäryhmät ovat ylläpitäjä, järjestelijä sekä artikkelin kirjoittaja.
Ylläpitäjä on konferenssin järjestäjän palveluksessa oleva tietokonejärjestelmistä vastaava henkilö. Ylläpitäjän tulee luoda tietokanta konferenssisovelluksen käyttöön ja siihen ainakin yksi järjestelijä, jolle myönnetään oikeudet uusien järjestelijöiden lisäämiseen.
Järjestelijä on konferenssin järjestelyistä vastaava henkilö. Järjestelijällä on oikeus määritellä konferenssin rakenne tietokantaan ja luoda sovellukseen uusia järjestelijöitä. Järjestelijällä on oikeus muuttaa artikkeleiden kirjoittajien syöttämiä tietoja sekä lähettää artikkelin kirjoittajalle käyttäjätunnus ja salasana.
Kolmanteen käyttäjäryhmään voi kuulua kuka tahansa, sillä tiivistelmien syöttämistä konferenssisovellukseen ei ole rajoitettu. Mikäli artikkelin kirjoittaja hyväksytään konferenssiin, saa hän yksilöivän tunnuksen ja salasanan sivuille, joiden avulla valmis artikkeli voidaan syöttää sovellukselle. Artikkelin kirjoittajalla ei ole oikeuksia muuhun kuin omien tietojensa muokkaamiseen.
Luvussa esitetään konferenssisovelluksen käyttötapauskaavio ja eri käyttötapausten riippuvuudet toisistaan. Kuvassa 2 on esitetty konferenssisovelluksen käyttötapauskaavio.
Käyttötapaukset kulkevat seuraavassa järjestyksessä. Ensin ylläpitäjän pitää luoda tietokanta konferenssia varten ja luoda siihen käyttöoikeudet ainakin yhdelle järjestelijälle. Tämä järjestelijä voi myöhemmin jakaa käyttöoikeuksia muille. Kun tietokanta on luotu, voi järjestelijä lisätä siihen aihealueet ja sessiotyypit sekä määritellä tyypeille hallintatavaksi ulkoinen tai sisäinen. Ulkoinen hallintatapa tarkoittaa sitä, että artikkelien keräyksen ja hyväksymisen hoitaa joku konferenssitoimikunnan ulkopuolinen henkilö (vrt. Minisymposium). Sisäisessä hallintatavassa artikkeleiden keräyksen, arvioimiseen antamisen ja hyväksymisen suorittaa konferenssin järjestelijä. Samalla kun aihealueita ja sessiotyyppejä lisätään, konferenssisovellus luo dynaamisesti tiedonkeräykseen liityvät WWW-sivut. Seuraavaksi artikkeleiden kirjoittajat antavat henkilötietonsa ja artikkelin tiivistelmän konferenssisovellukselle. Tämän jälkeen seuraa osuus, jonka aikana artikkelit jaetaan arvioitavaksi ja ne arvioidaan. Konferenssiin hyväksyttyjen artikkeleiden kirjoittajia pyydetään toimittamaan artikkelista lopullinen versio, joka tallennetaan tietokantaan. Kun tietokanta on lopullisesti valmis, syöttää konferenssin järjestelijä sovellukselle loput tiedot, joita ovat konferenssin aikataulu, kokoomajulkaisun ulkoasu ja jako eri CD-ROM-levyille. Tämän jälkeen voidaan sovelluksen avulla luoda hakemistorakenne ja HTML-sivut.
Kuva 2. Konferenssisovelluksen käyttötapauskaavio.
Luvussa esitellään kuvaukset konferenssisovelluksen eri käyttötapauksille.
Yhteenveto: Ylläpitäjä luo tietokannan.
Aktori: Ylläpitäjä.
Kuvaus: Ylläpitäjä luo ensin sovellukselle tietokannan. Kyseiseen tietokantaan tullaan myöhemmin tallentamaan kaikki konferenssin kokoomajulkaisuun tarvittavat tiedot.
Yhteenveto: Konferenssin järjestelijä lisää/muokkaa järjestelijöitä.
Aktori: Konferenssin järjestelijä.
Edellytykset: Tietokanta luotu.
Kuvaus: Järjestelijä lisää tietokantaan uusia järjestelijöitä ja määrittelee heidän oikeudet. Järjestelijä voi myöhemmin muokata itse luomiensa järjestelijöiden oikeuksia.
Yhteenveto: Konferenssin järjestelijä lisää/muokkaa/poistaa aihealueen.
Aktori: Konferenssin järjestelijä.
Edellytykset: Tietokanta luotu.
Kuvaus: Järjestelijä lisää sovellukseen aihealueet yksitellen. Lisäyksen yhteydessä tallennetaan vain aihealueen nimi. Jokaisen lisäyksen jälkeen sovellus muokkaa tietokantaa siten, että se vastaa kyseisen konferenssin aihealueita. Jälkeenpäin järjestelijällä on mahdollisuus poistaa, lisätä tai uudelleen nimetä tekemiään aihealueita. Muutokset päivittyvät tietokantaan. Aihealueiden lisäykset, muutokset ja poistot generoidaan automaattisesti WWW-lomakkeeseen, jonka avulla hoidetaan tiedonkeräys.
Poikkeus1: Mikäli järjestelijä luo uuden aihealueen, mutta ei anna sille mitään nimeä, huomautetaan tästä.
Poikkeus2: Mikäli järjestelijä yrittää lisätä jo olemassa olevan aihealueen, ilmoitetaan, että aihealue on jo olemassa.
Poikkeus3: Mikäli järjestelijä yrittää poistaa aihealueen johon on jo tallennettu tietoja, estetään se kunnes järjestelijä on siirtänyt kaiken tiedon toisiin aihealueisiin.
Poikkeus4: Jos järjestelijä muokkaa aihealueen nimeä ja aihealueeseen on jo tallennettu tietoja, huomautetaan järjestelijää tästä ja kysytään tehdäänkö muutokset kaikkiin tietoihin.
Yhteenveto: Konferenssin järjestelijä lisää/muokkaa/poistaa sessioiden tyyppejä.
Aktori: Konferenssin järjestelijä.
Edellytykset: Tietokanta luotu.
Kuvaus: Järjestelijä luo yksitellen sovellukseen sessioiden tyypit. Luonnin yhteydessä kustakin sessiotyypistä tallennetaan nimi sekä määritellään sessiotyypin hallintatapa, eli hallitaanko sitä itse (vrt. Contributed) vai onko hallinta ulkoista (vrt. Minisymposium). Luonnin jälkeen sovellus muokkaa tietokantaa siten, että se vastaa kyseisen konferenssin sessiotyyppejä. Jälkeenpäin järjestelijällä on mahdollisuus poistaa, lisätä tai muokata tekemiään sessiotyyppejä. Muutokset päivittyvät tietokantaan. Kun sessioiden tyyppejä lisätään, muokataan tai poistetaan, muutetaan automaattisesti WWW-lomaketta, jonka avulla hoidetaan tiedonkeräys.
Poikkeus1: Mikäli järjestelijä luo uuden sessiotyypin, mutta ei anna sille mitään nimeä, huomautetaan tästä.
Poikkeus2: Mikäli järjestelijä yrittää luoda samannimisen sessiotyypin kuin järjestelmään on jo tallennettu, ilmoitetaan, että kyseisen niminen tyyppi on jo olemassa.
Poikkeus3: Mikäli järjestelijä yrittää poistaa sessiotyypin johon on jo tallennettu tietoja, estetään se kunnes järjestelijä on siirtänyt kaiken tiedon toisiin sessiotyyppeihin.
Poikkeus4: Jos järjestelijä muokkaa sessiotyypin nimeä ja kyseiseen tyyppiin on jo tallennettu tietoja, huomautetaan järjestelijää tästä ja kysytään tehdäänkö muutokset kaikkiin tietoihin.
Yhteenveto: Artikkelin kirjoittaja syöttää oman artikkelin tiivistelmän sekä kirjoittajien henkilötiedot.
Aktori: Artikkelin kirjoittaja.
Edellytykset: Ainakin yksi aihealue ja sessiotyyppi on luotu.
Kuvaus: Artikkelin kirjoittaja täyttää lomakkeelle artikkelin tiedot, kuten kirjoittajien tiedot, otsikon ja avainsanat sekä antaa artikkelin tiivistelmän. Kirjoittaja voi käydä myöhemmin muuttamassa antamiaan tietoja.
Poikkeus 1: Tiedot eivät ole oikeassa muodossa. Artikkelin kirjoittaja saa huomautuksen, että tiedot eivät ole oikein ja tietoja pyydetään korjaamaan.
Yhteenveto: Järjestelijä siirtää artikkelin toiseen sessiotyyppiin/aihe-alueeseen.
Aktori: Konferenssin järjestelijä.
Edellytykset: Artikkelin tiivistelmä on tallennettu tietokantaan.
Kuvaus: Konferenssin järjestelijä siirtää väärään sessiotyyppiin/aihe-alueeseen lisätyn artikkelin toiseen sessiotyyppiin/aihe-alueeseen.
Yhteenveto: Artikkelin kirjoittaja syöttää oman artikkelin kokonaisuudessaan oikeassa muodossa.
Aktori: Artikkelin kirjoittaja.
Edellytykset: Kirjoittajan artikkeli pitää olla hyväksytty esitettäväksi konferenssissa järjestelijän toimesta. Kirjoittaja on saanut konferenssisovelluksen toimittaman salasanan suojatuille sivuille.
Kuvaus: Artikkelin kirjoittaja pääsee salasanalla sivuille, josta hän pystyy tallentamaan koko artikkelin oikeassa muodossa.
Poikkeus 1: Salasana väärin. Artikkelin kirjoittaja saa huomautuksen, että salasana ei ole oikein ja pääsy sivuille evätään.
Poikkeus 2: Artikkeli ei täytä vaadittavia ehtoja koosta tai muodosta. Artikkelin kirjoittaja saa huomautuksen, että artikkeli ei ole oikeassa muodossa tai se on liian suuri ja tallentaminen evätään.
Yhteenveto: Konferenssin järjestelijä luo/muokkaa konferenssin aikataulun.
Aktori: Konferenssin järjestelijä.
Edellytykset: Artikkelit jaettu sessioihin.
Kuvaus: Järjestelijä syöttää sovellukselle konferenssin aikataulun. Aikataulua syötettäessä järjestelijä ilmoittaa ensin päivän ja sen jälkeen ajan milloin sessiot pidetään. Tämän jälkeen määritellään mitkä sessiot järjestetään kyseiseen aikaan. Tämän pohjalta sovellus tietää mitkä artikkelit esitetään milloinkin, sillä artikkelien tietoihin on tallennettu sessio missä ne esitetään. Lopuksi aikataulu tallennetaan tietokantaan, josta sitä voidaan myöhemmin muuttaa.
Poikkeus1: Mikäli järjestelijä yrittää syöttää samaa sessiota kahteen eri aikaan, sovellus ilmoittaa, että kyseinen sessio on jo määritelty pidettäväksi toiseen aikaan ja kertoo mikä tämä aika on.
Poikkeus2: Mikäli jollekin sessiolle ei määritellä pitoaikaa, ilmoittaa sovellus listan niistä sessioista, joille ei ole määritelty pitoaikaa.
Yhteenveto: Konferenssin järjestelijä luo/muokkaa ulkoasua.
Aktori: Konferenssin järjestelijä.
Kuvaus: Konferenssin järjestelijä luo proceedings-julkaisun ulkoasun.
Yhteenveto: Konferenssin järjestelijä voi esikatsella luomaansa ulkoasua.
Aktori: Konferenssin järjestelijä.
Edellytykset: Ulkoasu luotu.
Kuvaus: Järjestelijä valitsee ulkoasun esikatselun, minkä jälkeen hänelle näytetään miltä kokoomajulkaisu näyttää sen hetkisillä ulkoasuasetuksilla.
Yhteenveto: Konferenssin järjestelijä luo levyjaon.
Aktori: Konferenssin järjestelijä.
Edellytykset: Sessiotyypit ja aihealueet määritelty sekä levyille tuleva tieto kerätty.
Kuvaus: Kun kaikki CD-ROM-levyille tuleva tieto on kerätty, voi järjestelijä antaa sovellukselle tiedot siitä mille levyille mitkäkin artikkelit tulee sijoittaa. Lisäksi järjestelijä antaa tiedon siitä mille levylle eri selaus mahdollisuudet sijoitetaan vai sijoitetaanko ne jokaiselle levylle.
Poikkeus1: Mikäli tietyille artikkeleille ei ole määritelty levyä, kysytään järjestelijältä halutaanko kyseiset artikkelit todella jättää pois levyiltä.
Yhteenveto: Konferenssin järjestelijä luo levyille tulevan hakemistorakenteen ja HTML-sivut.
Aktori: Konferenssin järjestelijä.
Edellytykset: Tietokantaan on tallennettu lopulliset aihealueet ja valmiit artikkelit sekä järjestetty artikkelit sessioihin. Mikäli levyille sisällytetään aikataulu ja ulkoasu, pitää niiden olla määritelty. Lisäksi levyjako on pitänyt tehdä.
Kuvaus: Järjestelijä antaa komennon levyjen hakemistorakenteen luomiseksi. Samalla voidaan määritellä hakemisto johon levyjen hakemistorakenne luodaan. Tämän jälkeen sovellus luo levyrakenteet ja HTML-sivut sekä tallentaa ne tarvittavien tiedostojen kanssa omiin hakemistoihinsa.
Poikkeus 1: Tarvittavia tietoja ei löydy. Järjestelijä saa huomautuksen, että tarvittavia tietoja ei löydy sekä erittelyn tarvittavista tiedoista.
Käyttötapauskaaviossa ja kuvauksissa on kuvattu eri käyttötapauksia. Näistä osa toteutetaan projektin yhteydessä ja osa jätetään jatkokehitykseen. Projektin yhteydessä toteutetaan seuraavat konferenssin järjestelijän käyttötapaukset:
· 3. Lisää/muokkaa/poista aihealue
· 4. Lisää/muokkaa/poista sessioiden tyyppi
· 9. Luo/muokkaa ulkoasu
· 10. Esikatsele ulkoasua
· 11. Luo levyjako
· 12. Luo hakemistorakenne ja HTML-sivut
Lisäksi ryhmä toteuttaa kohdan 8, aikataulun luomisen ja muokkaamisen, mikäli siihen jää aikaa projektin yhteydessä. Artikkelin kirjoittajan käyttötapaukset kohdat 5 ja 7, jotka liittyvät tiedonkeräykseen, jätetään jatkokehitykselle sekä järjestelijän käyttötapaus 6 siirrä artikkeli. Myös kohta 2, lisää/muokkaa järjestelijä, jätetään jatkokehitykseen. Kohta 1, luo tietokanta, jätetään ylläpidon tehtäväksi.
Tämä dokumentti määrittelee Coma-projektin tekemien sovellusten vaatimukset. Vaatimusmäärittelyssä on kuvattuna hakemistorakenteesta tiedot tietokantaan kääntävän skriptin, käyttöliittymäsovelluksen, kokoomajulkaisun generoivan sovelluksen ja tietokannan vaatimukset. Projektiryhmän toteutettavat sovellukset toteutetaan ensisijaisesti tässä dokumentissa määriteltyjen vaatimusten mukaan. Projektiryhmä vastaa siitä, että kaikki vaatimusmäärittelyssä vaaditut ominaisuudet sisältyvät ryhmän tekemiin sovelluksiin ennen kuin projekti päätetään.