Vaatimusluettelo versio 0.17 Toiminnalliset ja ei-toiminnalliset vaatimukset Tunnus (ID) Vaatimus Vaatimuksen Yleiset vaatimukset 1 Koodistopalvelujärjestelmä on selainkäyttöinen 2 Käyttöliittymän tulee toimia kaikilla yleisimmillä internet-selaimilla JHS Koodistopalvelu esittäjä ja Jyri- Pekka Tähtinen Jyri-Pekka Tähtinen Päivämäärä Tärkeys 18.5.2011, 12.8.2011 Perustelu 1 Järjestelmä on julkinen ja pitäisi olla helposti saatavilla 12.8.2011 1 Eri organisaatioissa käytetään eri internet-selaimia 3 Koodistopalvelun teknisen toteutuksen tulee perustua avoimiin ja laajasti käytettyihin internet-standardeihin. Toimittajakohtaisia teknisiä ratkaisuja ei sallita palvelun keskeisissä rajapinnoissa ja käyttäjälle näkyvissä toiminnallisuuksissa. Jyri-Pekka Tähtinen 12.8.2011 1 Toimittajariippumattomuus kilpailuttamisen mahdollistamiseksi Koodistojen ja koodien tallentaminen ja muokkaaminen 4 Järjestelmä tukee uuden koodiston lisäämistä 5 Järjestelmä tukee uuden koodin lisäämistä valittuun koodistoon 6 Järjestelmä tukee koodistokohtaisia metatietoja (ks. erillinen välilehti) 7 Vakiometatietojen lisäksi käyttäjän on voitava lisätä uusia metatietoja koodistokohtaisesti. Lisättävän metatiedon nimi ja tietotyyppi ovat vapaasti valittavissa. Metatieto voi liittyä koodistoon tai sen sisältämiin koodeihin. 18.5.2011 1 Järjestelmän perustoiminnallisuus 18.5.2011 1 Koodistojen muuttuvuus 18.5.2011 1 Järjestelmän perustoiminnallisuus Työryhmä 23.5.2011 2 Koodistojen monipuolisuus Page 1 of 10
8 Käyttäjän on voitava lisätä tiedonlähde mihin tahansa koodistokohtaiseen metatietoon. Tiedonlähde voi perustua koodistoon ja sitä voi tarkentaa tekstillä 9 Käyttäjän on voitava muokata koodistokohtaisia metatietoja, mikäli hänellä on tähän riittävät oikeudet 10 Koodistokohtaisten metatietojen versiohistoria tallentuu ja on selattavissa käyttöliittymän avulla 11 Järjestelmä tukee koodikohtaisia metatietoja (ks. erillinen välilehti) 12 Käyttäjän on voitava lisätä tiedonlähde mihin tahansa koodikohtaiseen metatietoon. Tiedonlähde voi perustua koodistoon ja sitä voi tarkentaa tekstillä 13 Käyttäjän on voitava muokata koodikohtaisia metatietoja, mikäli hänellä on tähän riittävät oikeudet 14 Koodikohtaisten metatietojen versiohistoria tallentuu ja on selattavissa käyttöliittymän avulla 15 Järjestelmä mahdollistaa uuden koodiston muodostamisen olemassa olevasta koodistosta 16 Järjestelmä tukee linkitystä emo- ja tytärkoodistojen välille. Jos emokoodisto päivitetään, järjestelmä ehdottaa automaattisen tytärkoodiston päivityksen. Hallintaprosessien tuki 17 Järjestelmä mahdollistaa palautekierrosten järjestämisen valituista koodistoista tai niiden versioista Työryhmä 23.5.2011 2 Tiedon alkuperän seuranta, mm. tekijänoikeuksien takia 18.5.2011 1 Koodistojen muuttuvuus 18.5.2011 1 Koodistojen muuttuvuus, koodistojen kehityksen seuranta 18.5.2011 1 Järjestelmän perustoiminnallisuus Työryhmä 23.5.2011 2 Tiedon alkuperän seuranta, mm. tekijänoikeuksien takia 18.5.2011 1 Koodistojen muuttuvuus 18.5.2011 1 Koodistojen muuttuvuus, koodistojen kehityksen seuranta Työryhmä 23.5.2011 3 Koodistojen erikoisversioiden muodostamisen tuki Työryhmä 23.5.2011 3 Koodistojen välisten riippuvuuksien tuki 20.5.2011 2 Suosituksessa määriteltyjen hallintaprosessien tuki Page 2 of 10
18 Järjestelmä tukee suosituksessa määriteltyä koodistojenhallintaprosessia mahdollistamalla siirtymiset koodistojen ja koodien tilojen välillä prosessissa määritellyllä tavalla 18.5.2011 1 Suosituksessa määriteltyjen hallintaprosessien tuki 19 Järjestelmä tukee käyttäjien rekisteröintiä Työryhmä 23.5.2011 1 Koodistojen käytön seuranta ja käyttäjien informointi koodistojen muutoksista 20 Järjestelmässä on tuki useille eri käyttäjärooleille, joiden vastuut ja oikeudet on määritelty välilehdellä "Käyttäjäroolit" 21 Käyttäjille annettavat oikeudet voidaan määritellä koodistokohtaisesti Palvelut koodistojen hyödyntäjille 22 Järjestelmässä on rajapinnat koodistojen hakemiseen 23 Rajapintojen kautta koodistot saa kaikissa tuetuissa muodoissa. Tuetut muodot ovat: JHS XML -mukainen skeema, Genericode, XML Schema enumeration, RDF, Excel (CSV) 24 Koodistojen käyttäjät voivat ilmoittaa koodiston käytöstä, tieto tallentuu järjestelmään 25 Järjestelmässä on hakutoiminto, joka kattaa kaikki koodistot ja koodit. Hakutoiminto tuottaa luettelon haun osumista. 18.5.2011 1 Suosituksessa määriteltyjen hallintaprosessien tuki 18.5.2011 1 Suosituksen mukaiset koodistojen hallintaprosessit 18.5.2011 1 Koodistopalvelun hyödyntäminen muissa järjestelmissä 18.5.2011 2 Koodistopalvelun hyödyntäminen muissa järjestelmissä 18.5.2011 2 Koodistoja käyttävien sidosryhmien tiedottaminen 18.5.2011 1 Koodistojen määrä ja monipuolisuus 26 Haun tulos esitetään tiettyjen metatietojen koosteena (esim. koodiarvo, koodinimi, omistaja, jne.) 27 Järjestelmä tukee koodistokohtaisten postituslistojen, RSS-syötteiden tms. hallintaa tiedottamista varten 18.5.2011 1 Hakutulosten informatiivisuus 18.5.2011 2 Koodistoja käyttävien sidosryhmien tiedottaminen Page 3 of 10
28 Järjestelmässä on koodistokohtainen kommentointijärjestelmä 29 Järjestelmä raportoi automaattisesti muutoksista koodistoissa tiedossa oleville käyttäjille 30 Järjestelmä muodostaa raportit koodistojen käytöstä ja käyttäjistä Käytettävyys 31 Käyttöliittymän toimintojen tulee olla käytettävissä ilman, että käyttäjältä edellytetään selaimen lisäosien, liitännäisten tms. lataamista 32 Koodien ja koodistojen käsittelyn pitää olla sujuvaa sähköisten asiointipalvelujen käyttöön tottuneelle käyttäjälle ilman käyttöohjeiden lukemista 33 Käyttöliittymän tulee tarjota toimintokohtainen käyttöohje (context sensitive help) Miika Alonen / Tikesos Jyri-Pekka Tähtinen ja Jyri- Pekka Tähtinen Jyri-Pekka Tähtinen 18.5.2011 2 Yhteisöllisyys sekä koodistojen laadun parantaminen 20.5.2011 2 Koodistoja käyttävien sidosryhmien tiedottaminen 18.5.2011 3 Koodistoja käyttävien sidosryhmien tiedottaminen 12.8.2011 1 Liitännäisten yms. asentaminen on julkisen hallinnon organisaatioissa usein kiellettyä 18.5.2011, 12.8.2011 1 Käytettävyys 12.8.2011 3 Käytettävyys 34 Käyttöliittymän on mahdollistettava monikielinen toteutus. Käyttöliittymä on toteutettava suomen, ruotsin ja englannin kielellä. 35 Järjestelmä esittää koodisto- ja koodiluettelot niin, että ne voidaan lajitella metatietokohtaisesti. 36 Käyttäjän on voitava helposti selvittää koodin sijainti hierarkkisessa koodistossa. Kapasiteetti 37 Järjestelmän kapasiteetti riittää siihen, että 100 käyttäjää voi selata koodistoja samanaikaisesti käyttöliittymän avulla. Jyri-Pekka Tähtinen 12.8.2011 1 Kielilaki, kansainväliset sidosryhmät Työryhmä 23.5.2011 2 Käytettävyys 11.8.2011 2 Hierarkkisten koodistojen tuki, käytettävyys Työryhmä 23.5.2011 2 Kapasiteetin riittävyys Page 4 of 10
38 Koodistoja haettaessa teknisen rajapinnan kautta, nopeudella 100 kyselyä minuutissa, 95 %:ssa kyselyitä järjestelmän vasteaika on alle 3 sekuntia. Työryhmä 23.5.2011 2 Kapasiteetin riittävyys Versiohistoria Versio Pvm ja tekijä Muutokset 0.1 18.5.2011 KH Ensimmäinen versio 0.11 20.5.2011 KH ja MA Vaatimus "Järjestelmä tukee olemassa olevan koodiston poistamista" poistettu. Koodistot dea Vaatimus "Järjestelmä mahdollistaa palautekierrosten järjestämisen valituista koodistoista tai Vaatimuis "Järjestelmä raportoi automaattisesti muutoksista koodistoissa tiedossa oleville käy Vaatimusten järjestys muutettu 0.12 23.5.2011 Työryhmä Uusien vaatimusten ja metatietojen tunnistaminen 0.13 9.8.2011 KH Työryhmässä tunnistettujen vaatimusten ja metatietojen integrointi taulukkoon 0.14 12.8.2011 KH ja JT Nettipohjaisuutta ja käytettävyyttä koskevien vaatimusten tarkentaminen 0.15 14.8.2011 KH Vaatimusten järjestys muutettu ja vaatimukset ryhmitelty Perustelut ja prioriteetit lisätty 0.16 24.8.2011 JPT Tarkistettu ja muokattu suositusluonnosta vasten 0.17 29.8.2011 JPT Viimeistelty Page 5 of 10
Toimittajan kommentit Page 6 of 10
Page 7 of 10
Page 8 of 10
Page 9 of 10
aktivoidaan voimassaoloaikojen avulla. niiden versioista" lisätty yttäjille" lisätty Page 10 of 10