Määrittelyt

Dokumentti	Verkkomaksut - projekti - Määrittelyt
Versio / Päiväys	0.70 / 23.4.2012
Päivitykset	15.3.2012: Luotu dokumenttipohja 23.4.2012: Ensimmäisen versio muokkausta (keskeneräinen)

1. Johdanto

Verkkomaksut Metropoliassa projekti on perustettu syksyllä 2011 kehittämään erilaisten maksujen keräämisen tietojärjestelmä Metropoliaan. Näitä maksuja ovat esimerkiksi:

Opiskelijan harkinnanvaraisen yliajan hakemisen käsittelymaksun kerääminen
Opiskelijan harkinnanvaraisen opiskeluoikeuden palauttamisen käsittelymaksun kerääminen
Erikoistumisopintojen opiskelijamaksun kerääminen
Avoimen ammattikorkeakoulun opintojaksomaksujen kerääminen

Jokaisessa edellä mainitussa maksun keräämisessä on taustalla paperipohjainen prosessi, johon liittyy olennaisesti Metropolian taloushallinnon prosessinomistajan toimeksiannosta tapahtuva maksujen laskutus. Tämä laskutusprosessi on aikaa vievä ja lopputuloksiltaan ei tyydyttävä ko. työprosessiin käytettävään työaikaan verrattuna.

1.1 Projektin tavoite ja aikataulu

Projektille on annettu seuraava keskeinen tavoite:

(Projektin) Tavoitteena on luoda tietojärjestelmä, jolla tarjotaan, käsitellään ja hallitaan verkkomaksutapahtumat. Lisäksi järjestelmän tulee olla mahdollisimman yksinkertainen, helppokäyttöinen ja turvallinen loppukäyttäjälle.

Jotta projektin tavoitteet olisi täytettävissä, vaaditaan projektiryhmältä prosessiasiantuntemusta käytössä olevista nykyisistä prosesseista, teknistä tietämystä käytössä olevista tietojärjestelmistä sekä tuntemusta www-palveluiden rakentamisesta. Koska kyseessä on laajaan käyttöön suunnattu www-ohjelmisto, tulee projektiryhmässä olla myös käytettävyysasiantuntemusta.

Projekti tulee toteuttaa siten, että otetaan huomioon Metropoliassa käytössä oleva tietojärjestelmä arkkitehtuuri ja kehitettävien tai käyttöönotettavien tietojärjestelmien suunnitteluperiaatteet.

Projektin tulee myös ottaa huomioon kansallisesti käynnissä oleva kansallinen korkeakoulujen maksupalvelu hanke eli Raketti-hankkeen OPI-Maksut projekti.

Projektille on projektin asetanta vaiheessa asetettu aikataulu, jonka mukaan yhtä toimintaprosessia tukevan prototyyppijärjestelmän tulisi olla valmiina toukokuussa 2012. Järjestelmän tuotantokäyttöä tavoitellaan syksyllä 2012. Järjestelmän käyttöönotto voi tapahtua asteittain. Projektin aikataulua tarkistetaan tarvittaessa.

1.2 Projektitoimijat

Projektin projektipäällikkönä toimii Kaija Vuorela Metropolian Taloushallinto palveluista.

Projektitoimijat on jaettu seuraaviin ryhmiin:

Projektin toimintaa ohjaa ohjausryhmä, johon kuuluvat seuraavat jäsenet:

Rooli	Henkilö
Puheenjohtaja, tilaajan edustaja	Jorma Uusitalo
Projektipäällikkö	Kaija Vuorela
Ohjausryhmän jäsen	Kaj Kuusisto
Ohjausryhmän jäsen	Tuomas Orama
Ohjausryhmän jäsen	Taru Ruotsalainen
Ohjausryhmän jäsen	Matti Saloranta
Ohjausryhmän jäsen	Hannele Ehrsten
Ohjausryhmän jäsen	Sirkku Mäntyniemi

Projektin kehitystyötä tekee projektiryhmä, johon kuuluvat seuraavat jäsenet:

Rooli	Henkilö
Projektipäällikkö	Kaija Vuorela
Tekninen koordinaattori	Tero Hakkarainen
Projektiryhmän jäsen, talous	Pirkko Laitinen
Projektiryhmän jäsen, talous	Svetlana Muljar
Opintotoimisto	Arja Päivinen
Klusterin edustaja	Maarit Vallinkoski
Klusterin edustaja	Päivi Inkilä
Loppukäyttäjä / Opiskelijajäsen	!!! Nimi kateissa !!!

Lisäksi projektin käyttöön on asetettu seuraavat asiantuntijat:

Rooli	Henkilö
Laskutusjärjestelmän toimittajan asiantuntija	Anu Stenbacka, Aditro
Rajapinnat	!!! Puuttuva resurssi !!!
Ohjelmointi	Simo Tiainen
Palvelimet	Ronnie Lupari
Käytettävyys	Tea Dickman
Webmaster	Pekka Perälampi

Projekti joutuu tilaamaan konsultointia talousautomaatioiden sekä ko. toimintoja varten tarvittavien rajapintojen rakentamista varten Metropolian taloushallinnon tietojärjestelmien toimittajalta (Aditro Oy). Lisäksi projekti voi tilata myös muilta toimijoita tarvittavaa konsultointia.

1.2 Kehittävät tietojärjestelmät sekä niiden tietoliittymät muihin tietojärjestelmiin

Projektin tehtävänä on luoda määrittelyt sekä mahdolliset toteutukset seuraaviin tietojärjestelmiin:

Asionti-järjestelmä: asiointi.metropolia.fi
Palveluväylään liitettävät maksatustoiminnallisuudet: ?.metropolia.fi
Sähköisen asioinnin ja maksutapahtumien käsittelyn tietokanta

Lisäksi kehittävistä tietojärjestelmistä rakennetaan rajapinnat ainakin seuraaviin tietojärjestelmiin:

Aditron Intime Plus taloushallinnon tietojärjestelmä: talousautomaatiorajapinnat
Metropolian Amme-identiteetin hallintajärjestelmä: henkilötietojen välitysrajapinnat

Lisäksi rajapinnat voidaan rakentaa seuraaviin tietojärjestelmiin:

Metropolian tuleva Peppi-tietojärjestelmä: avoimen ammattikorkeakoulun opintototeutustietojen välitysrajapinnat
Logica WinhaPro: opiskelijatietojen välitysrajapinnat

1.3 Kehitettävien tietojärjestelmien käyttökohteet sekä ominaisuudet

Kehittävissä tietojärjestelmissä on suunniteltu soveltuvan seuraaviin käyttökohteisiin tai niiden on suunniteltu sisältävän seuraavat ominaisuudet:

henkilöiden tunnistaminen sähköisesti käyttäen ensimmäisessä vaiheessa pankkien tarjoamaa Tupas-tunnistautumista
henkilöiden tunnistaminen sähköisesti käyttäen matkapuhelin operaattoreiden tarjoamaa mobiilitunnistautumista
maksujen käsittely pankkien verkkomaksu menetelmillä
luottokorttimaksujen käsittely
edellä mainittujen tunnistus ja maksutoimintojen toteuttaminen julkishallinnon Vetuma-palvelun kautta. Toiminnallisuudet liitetään tietojärjestelmien käytettäväksi palveluväylän kautta.
suppeat palveluprosesseja tukevat työnkulkujen tilojen hallinnat
tietojärjestelmien toimintojen seuranta loki- ja raportointitoiminnoilla
tuettavien prosessien palvelutapausten eri käyttötapauksien palvelukäyttöliittymät

Tuettavat prosessit ovat:

Harkinnanvarainen lisäajan haun käsittelymaksun kerääminen
Harkinnanvarainen opiskeluoikeuden palauttamisen käsittelymaksun kerääminen
Erikoistumisopintojen opiskelijamaksun kerääminen

Projektia on suunniteltu jatkettavan siten, että toisessa vaiheessa toteutetaan seuraavien prosessien tuki:

Avoimen ammattikorkeakoulun opintojaksomaksujen kerääminen sekä ilmoittautumisten hallinta

1.4 Määrittelyssä ja suunnittelussa sovellettavat periaatteet

Määrittelyssä ja suunnittelussa sovelletaan seuraavia periaatteita:

I) Kehitettävien maksu- ja tunnistuspalvelutoimintojen tulee olla käytettävissä useammasta kuin yhdestä Metropolian tietojärjestelmästä.

Maksu- ja tunnistustoiminnot on määritelty sijoitettavaksi palveluväylään (ServiceMix-tuote), jolloin ko. toiminnallisuudet on käytettävissä niin asiointia varten kehitettävästä sovelluksesta kuin myös mahdollisesti muista sovelluksista. Toimintoja varten luodaan webservices-rajapinta, joita vasten toimintoja voidaan kutsua. Toimintojen käsittely, seuranta ja erityisesti talousautomaatio tapahtuu palveluväylässä tai palveluväylään liitetyissä sovelluksissa.

II) Kehitettävien asiointipalveluiden toimintojen tulee olla linkitettävissä muihin tietojärjestelmiin.

Asiointipalveluita varten kehitetään asiointipalvelusivusto, johon siis sijoitetaan asiointipalveluiden käyttöliittymät. Ko. käyttöliittymät tulee olla kutsuttavissa muista Metropolian sovelluksista käyttämällä url-kutsuja. Esimerkiksi opiskelijan harkinnanvaraisen yliaikahaun käyttöliittymän voisi kutsua linkillä asiointi.metropolia.fi\palvelut\harkinnanvarainen_yliaika{opiskelijanumero}. Linkki voi sijoittaa esimerkiksi sähköpostiin mukaan ja sitä käytettäessä loppukäyttäjälle avautuu näkymä riippuen hänen käyttötapauksestaan.

III) Kehitettävien asiointipalveluiden tulee olla loppukäyttäjien käytettävissä lähes aina. Erikseen määriteltävinä kriittisinä aikoina tulee pyrkiä keskeytyksettömään palvelun saavutettavuuteen.

Sähköisten asiointipalveluiden tulee lähtökohtaisesti olla käytettävissä lähes aina, joka tarkoittaa vuorokauden ajasta riippumatta, vuoden ympäri. Lisäksi mikäli jokin asiointipalvelun kautta jaettavan palvelun luonteeseen kuuluu esimerkiksi hakuaikajaksot, tulee ko. ajanjaksoina pyrkiä erityisesti keskeytymättömään palveluun. Keskeytymätön palvelu tulee tarvittaessa turvata palvelun teknisen ympäristön ratkaisuilla kuten palvelin kapasiteetin lisäyksellä.

IV) Kehitettävien asiointipalveluiden käytettävyys tulee suunnitella loppukäyttäjä näkökulmasta. Esteettömyys tulisi ottaa käyttöliittymien suunnittelussa huomioon vähimmäistasolla.

Palvelun asiointikäyttöliittymien suunnittelu tulee tehdä käytettävyysasiantuntijan kanssa. Lisäksi esteettömyys tulee turvata vähintään sillä tasolla, että värisokeus otetaan huomioon. Lisäksi, mikäli niin edellytetään, tulee esteettömyys suunnitella julkishallinnon tietojärjestelmä vaatimustasolla. Muutenkin suunnittelussa tulee noudattaa JHS-suosituksen JHS 129 (Julkishallinnon verkkopalvelun suunnittelun ja toteuttamisen periaatteet) asettamia vaatimuksia.

V) Toteutettavien tietojärjestelmien tietoturvavaatimukset ovat korkeat. Lisäksi tietoturva tulee testata.

Tässä määrittelydokumentissa käsiteltävien toteutettavien tietojärjestelmien keskeisenä toimintona on käsitellä sekä henkilö- että taloustietoja. Tämän vuoksi järjestelmiä suunniteltaessa tulee miettiä parhaiten käyttökohteeseen sopivat tietojen suojaus menetelmät, joilla tietojen käyttö on turvallista, mutta samalla kuitenkin käytettävää kohdan IV periaatteen mukaisesti.

Edellä mainittujen sisäisesti määrittelytyötä ohjaavien periaatteiden lisäksi määrittelytyötä on ohjannut Metropolian osallistumien korkeakoulujen väliseen OPI-Maksut projektiin. Projektin tavoitteena on luoda korkeakouluille yhteinen maksujen käsittelyjärjestelmä. Metropolian Verkkomaksut-projekti on osa tätä työtä ja yhtenä ajatuksena on käyttää Metropolian projektia pilottina palveluväylään kytkettävien maksu toiminnallisuuksien rakentamiseksi. Tätä tavoitetta tukee erityisesti kohdassa I asetetut määrittelyperiaatteet.

2. Tuettavat prosessit

lyhyt selitys prosessien tukemisesta
viittaus siihen, että myös muita prosesseja voidaan tukea

2.1 Harkinnanvarainen lisäajan haun käsittelymaksun kerääminen

Tuubin henkilökunnalle suunnatulla sivulla tästä aiheesta todetaan seuraavaa:

Kun tutkintoon johtavan koulutuksen opiskelijan opiskeluoikeusaika (enintään normiaika + 1 lukuvuosi) on päättymässä, opiskelija voi hakea Metropolialta harkinnanvaraista lisäaikaa. Opintotoimisto tiedottaa normi + 1 -ajan viimeisellä lukukaudella olevia opiskelijoita opiskeluajan päättymisestä.

...

Lisäaikaa hakeva opiskelija täyttää harkinnanvaraisen lisäajan hakemuslomakkeen, josta selviää suunnitelma puuttuvien opintojen suorittamisesta sekä perustellut syyt opintojen viivästymiselle. Hakemus toimitetaan opintotoimistoon keväällä 15.5. ja syksyllä 15.11. mennessä.

Lähde: https://tuubi.metropolia.fi/portal/fi/group/tuubi/henkilokunnalle/opintoasiat/opiskeluoikeus/harkinnanvarainen-lisaaika

Tämä prosessin käsittelymaksua koskeva osa on tarkoitus sähköistää tässä projektissa.

2.1.1 Nykyinen toimintaprosessi

Vaiheen nro	Mitä tapahtuu?	Kuka tekee?	Millä tavalla?	Mikä on lopputulos?
1.	Opiskelijalle ilmoitetaan, että hän voi hakea harkinnanvaraista lisäaikaa	Winha / Opintotoimisto	Automaattisesti, kun opiskelijalla on tullut täyteen normiaika + 1 vuosi. Sähköpostitus tapahtuu kaksi kertaa vuodessa huhtikuussa ja lokakuussa.	1) Opiskelijaa on tiedotettu oikeudesta lisäaikaan. 2) Opiskelijaa saa sähköpostissa ohjeet kuinka hakea. 3) Sähköpostin liitteenä on hakulomake.
2.	Opiskelija toimittaa hakemuksen paperilla opintotoimistoon.	Opiskelija	Täytetty ja allekirjoitettu hakulomake.	Täytetty hakulomake.
3.	Hakemus vastaanotetaan ja diarioidaan.	Opintotoimisto	Diariointi tallennetaan opintotoimiston rekistereihin ja diariointi tieto täytetään hakulomakkeeseen.	Diarioitu hakulomake.
4.	Opiskelijan tiedot tallennetaan Excel-lomakkeeseen laskutusta varten.	Opintotoimisto	Excel-taulukkoon tiedot.	Laskutustiedot Excel-taulukkoon. Laskutusprosessi alkaa kohdasta a)
5.	Hakemukseen liitetään opintosuoritusote.	Opintotoimisto	Tulostetaan Winhasta	Opintosuoritusotteella täydennetty hakemus.
6.	Päätetään harkinnanvaraisesta lisäajasta.	Koulutusohjelma	Omassa menettelyssään, jota ei ole tässä kuvattu.	1) Hakemus hylätty 2) Hakemus hyväksytty
7.	Tiedot päätöksestä tallennetaan Winhaan.	Opintotoimisto	Winha.	Päivitetyt tiedot opiskelijan opinto-oikeudesta.
8.	Päätöksen postitus.	Opintotoimisto	Tulostettu päätösasiakirja.	Opiskelijalle postitettu päätös.
a)	Laskutus: Tiedot opiskelijoista toimitetaan Excel-taulukkona taloushallintoon kaksi kertaa viikossa.	Opintotoimisto	Excel-taulukko.	Laskutuskehoite
b)	Laskutus: Opiskelijoilta laskutetaan hakemuksen käsittelymaksu Metropolian normaalissa laskutusprosessissa.	Taloushallinto / Laskuttaja	Intime Plus	1) Lasku käsittelymaksusta opiskelijalle 2) Seurantatieto reskontraan ja kirjanpitoon Huom! Opintotoimisto ei saa seurantatietoa opiskelijoiden suorittamista tai suorittamatta jättämistä käsittelymaksuista!

Tässä prosessikuvauksessa ei käsitellä mahdollista hylätyn hakemuksen valitusprosessia.

2.1.2 Prosessinomistajan toivoma sähköisen prosessin tavoitetila

Prosessin omistaja on kartoituspalavereissa toivonut, että koko prosessi pyörisi sähköisesti, eli niin että hakemus ja sen käsittely tapahtuu sähköisesti ja myös päätöksen kirjaaminen tapahtuu sähköisen työnkulun kautta. Opiskelijan opintojen seurantatiedot olisi hyvä koostaa sähköisesti, samoin kuin hakemuksen liitteiden käsittely.

Maksujen käsittely tulee tapahtua järjestelmässä ja maksuista tulee saada käyttöön seurantatietoa.

2.1.3 Prosessinomistajan vähimmäisvaatimukset

Opiskelijan tekemästä hakemuksesta johtuva käsittelymaksun käsittely tulee tapahtua sähköisesti ja maksun suorittamisesta tulee tulla opintotoimiston käsittelijälle tieto. Tämän jälkeen opintotoimisto alkaa käsitellä varsinaista hakemusta tarvittavien liitetietojen koostamisella.

2.1.4 Järjestelmällä tuettava sähköinen prosessi ja prosessiin liittyvät käyttötapaukset

Vaiheen nro	Mitä tapahtuu?	Kuka tekee?	Millä tavalla?	Mikä on lopputulos?
1.	Opiskelijalle ilmoitus mahdollisuudesta hakea harkinnanvaraista lisäaikaa	Winha / Opintotoimisto	Automaattisesti, kun opiskelijalla on tullut täyteen "normi +1" opiskeluaikaa. Sähköposti lähetetään kaksi kertaa vuodessa huhtikuussa ja lokakuussa.	1) Opiskelija saa tiedon oikeudesta hakea lisäaikaa. 2) Tiedote sähköpostissa on haun toimintaohjeet. 3) Hakulomake (sähköpostin liite). 4) Linkki asiointipalvelun lisäajan haun käsittelymaksun maksamisen käynnistykseen. (asiointi.metropolia.fi/maksut/harkinnanvarainen_lisaaika)
2.	Opiskelija maksaa verkossa maksun.	Opiskelija	Verkkomaksun suoritus asiointipalvelussa.	1) Suoritettu käsittelymaksu. 2) Suorittamaton käsittelymaksu, jolloin prosessi ei jatku.
3.	Opiskelija täyttää hakulomakkeen ja toimittaa sen postilla tai sähköpostilla opintotoimistoon.	Opiskelija	Posti / Sähköposti	Täytetty hakulomake.
4.	Opintotoimisto vastaanottaa täytetyn hakulomakkeen.	Opintotoimisto	Täytetty ja allekirjoitettu hakulomake	Vastaanotettu hakulomake.
5.	Opintotoimisto diarisoi hakemuksen.	Opintotoimisto	Diariointi menettely	Diarisoitu hakulomake.
6.	Opintotoimisto tarkista asiointipalvelusta, että opiskelija on suorittanut käsittelymaksun.	Opintotoimisto	Sähköisesti asiointipalvelussa	1) Todettu, että käsittelymaksu on maksettu, jolloin erikseen hallittava päätösprosessi käynnistyy. 2) Todettu, että käsittelymaksua ei ole maksettu, jolloin prosessi keskeytyy, kunnes käsittelymaksu on maksettu. Siirtymä takaisin tämän askeleen alkuun.

!!! Selvitettävät kysymykset !!!

millä tavoin ja kuka seuraa käsittelymaksujen saapumisia kun on kerran todettu, että käsittelymaksua ei ole maksettu (eli voiko prosessi jäädä "jumiin")

2.2 Opiskeluoikeuden palauttamisen käsittelymaksun kerääminen

Opiskeluoikeuden palauttamisesta kerrotaan tuubissa seuraavalla sivulla: https://tuubi.metropolia.fi/portal/fi/group/tuubi/henkilokunnalle/opintoasiat/opiskeluoikeus/opiskeluoikeuden-palautus. Ko. sivulla mainitaan mm. kahdesta syystä palautettavasta opiskeluoikeudesta:

A) Opiskelija, jolla on lain sallimaa opiskeluoikeusaikaa jäljellä ja joka ilmoittautumisen laiminlyönnin/eroamisen takia on menettänyt opiskeluoikeuden edellisen lukukauden lopussa, voi hakea kirjallisesti hakemuksella opiskeluoikeuden palauttamista opintotoimistosta. Hakemuksen käsittelystä peritään asetuksen mukainen 35 euron maksu. Hakuasiainvastaava tekee opiskeluoikeuspäätöksen opintoasiainvastaavan esittelyn perusteella.

B) Opiskelija, jolla on lain sallimaa opiskeluoikeusaikaa jäljellä ja joka ilmoittautumisen laiminlyönnin/eroamisen takia on menettänyt opiskeluoikeuden ennen edellistä lukukautta, voi hakea opiskeluoikeuden palautusta opiskeluoikeuden palautuslomakkeella. Koulutusvastaava tai koulutuspäällikkö antaa hakemukseen lausunnon, esittelijänä toimii opintoasiainvastaava ja päätöksen opiskeluoikeuden palauttamisesta tekee hakuasiainvastaava. Hakemuksen käsittelystä peritään asetuksen mukainen 35 euron maksu.

Näiden kahden käsittelyprosessin mukaiset käsittelymaksun suorittamiset on tarkoitus sähköistää tässä prosessissa.

2.2.1 Nykyinen toimintaprosessi

Vaiheen nro	Mitä tapahtuu?	Kuka tekee?	Millä tavalla?	Mikä on lopputulos?
1.	Opiskelija ottaa yhteyttä opintotoimistoon huomattuaan, että opinto-oikeus ei ole enää voimassa.	Opiskelija	Sähköposti tai henkilökohtainen kontakti	1) Tieto, että opiskeluoikeuden voi palauttaa, jos... 2a) opiskelija oli läsnä edellisellä lukukaudella. 2b) opiskelija oli pitempään pois.
2.	Opiskelijalle annetaan ohjeet anomusta varten.	Opintosihteeri / Opintotoimisto	Sähköpostilla tai postitse	Opiskelijalla on saanut anomuspaperit ja muut ohjeet.
3.	Opiskelija täyttää anomuksen ja laatii suunnitelman opintojen loppuun suoritusta varten.	Opiskelija	Allekirjoitetulla paperilomakkeella	Opintotoimisto saa anomuksen.
4.	Anomus numeroidaan diaariin	Opintotoimisto	Käsin	Yksilöity anomus.
5.	Tarkistetaan, että oliko opiskelija läsnä edellisellä lukukaudella.	Opintotoimisto	Winha	1) Opiskelija oli läsnä edellisellä lukukaudella. Prosessi siirtyy kohtaan 6a. 2) Opiskelija ei ollut läsnä edellisellä lukukaudella. Prosessi siirtyy kohtaan 6b.
6a.	Opintotoimisto tekee päätöksen opinto-oikeuden palauttamisesta.	Opintotoimisto	Winha	Opiskelija kirjattu läsnäolevaksi.
6b.	Opintosihteeri lähettää anomuksen koulutusohjelmalle lausuntoa varten.	Opintosihteeri	Sisäposti	Koulutuspäällikkö saa anomuksen.
7b.	Koulutuspäällikkö tekee lausunnon päätöstä varten.	Koulutuspäällikkö	Paperiasiakirja	Anomuksen liitteenä oleva anomus.
8b.	Koulutuspäällikkö lähettää anomuksen liitteineen opintotoimiston vastaavalle.	Koulutuspäällikkö	Sisäposti	Puollettu tai ei puollettu anomus.
9b.	Opintotoimiston vastaava tekee päätöksen.	Opintotoimiston vastaava	Paperiasiakirja	1) Hyväksytty anomus TAI 2) Hylätty anomus
10b.	Opintosihteeri merkitsee tiedon päätöksestä Winhaan.	Opintosihteeri	Winha	1) Opinto-oikeus voimassa TAI 2) Opinto-oikeus ei ole voimassa.
11b.	Opintosihteeri lähettää päätöksen anomuksesta opiskelijalle.	Opintosihteeri	Posti	Opiskelija saa tiedon päätöksestä.

2.2.2 Prosessinomistajan toivoma sähköisen prosessin tavoitetila

Prosessinomistajan toiveena on, että vain opinto-oikeuden palautukseen liittyvä maksujenkäsittely sähköistetään.

2.2.3 Järjestelmällä tuettava sähköinen prosessi ja prosessiin liittyvät käyttötapaukset

Vaiheen nro	Mitä tapahtuu?	Kuka tekee?	Millä tavalla?	Mikä on lopputulos?
1.	Opiskelija ei opinto-oikeutta. Opiskelija ottaa yhteyden opintotoimistoon.	Opiskelija	Sähköposti tai henkilökohtainen kontakti	1) Tieto, että opiskeluoikeuden voi palauttaa, jos... 2a) opiskelija oli läsnä edellisellä lukukaudella, kuten esim. opiskelija ei ole ilmoittautunut. 2b) opiskelija on ollut pitempään pois.
2.	Opiskelijalle annetaan ohjeet anomusta varten sekä ohjeet opiskeluoikeuden palauttamisen käsittelymaksun maksamista varten.	Opintosihteeri / Opintotoimisto	Sähköpostilla tai postitse	1) Opiskelijalla on saanut anomuspaperit ja muut ohjeet. 2) Linkki asiointipalvelun opiskeluoikeuden palauttamisen käsittelymaksun maksamisen käynnistykseen. (asiointi.metropolia.fi/maksut/opiskeluoikeuden_palautus)
3.	Opiskelija täyttää anomuksen ja laatii tarvittessa suunnitelman opintojen loppuun suoritusta varten.	Opiskelija	Allekirjoitetulla paperilomakkeella	Täytetty ja allekirjoitettu anomus.
4.	Opiskelija maksaa verkossa maksun.	Opiskelija	Verkkomaksun suoritus asiointipalvelussa.	1) Suoritettu käsittelymaksu. 2) Suorittamaton käsittelymaksu, jolloin prosessi ei jatku.
5.	Opiskelija toimittaa anomuksen opintotoimistoon.	Opiskelija	Sähköisesti / Henkilökohtaisesti	Opintotoimisto saa anomuksen. Jatkoehto: Käsittelyprosessi ei käynnisty ennen kuin käsittelymaksu on maksettu.
6.	Anomus numeroidaan diaariin	Opintotoimisto	Käsin	Yksilöity anomus.
7.	Opintosihteeri tarkastaa, että onko opiskelija suorittanut käsittelymaksun.	Opintosihteeri	Asiointijärjestelmän seuranta käyttöliittymä.	Käsittelykelpoinen anomus.
8.	Tarkistetaan, että oliko opiskelija läsnä edellisellä lukukaudella.	Opintotoimisto	Winha	1) Opiskelija oli läsnä edellisellä lukukaudella. Prosessi siirtyy kohtaan 9a. 2) Opiskelija ei ollut läsnä edellisellä lukukaudella. Prosessi siirtyy kohtaan 9b. Asiointijärjestelmä ei käsittele tätä osaa prosessista.
9a.	Opintotoimisto tekee päätöksen opinto-oikeuden palauttamisesta.	Opintotoimisto	Winha	Opiskelija kirjattu läsnä olevaksi.
9b.	Opintosihteeri lähettää anomuksen koulutusohjelmalle lausuntoa varten.	Opintosihteeri	Sisäposti	Koulutuspäällikkö saa anomuksen.
10b.	Koulutuspäällikkö tekee lausunnon päätöstä varten.	Koulutuspäällikkö	Paperiasiakirja	Anomuksen liitteenä oleva anomus.
11b.	Koulutuspäällikkö lähettää anomuksen liitteineen opintotoimiston vastaavalle.	Koulutuspäällikkö	Sisäposti	Puollettu tai ei puollettu anomus.
12b.	Opintotoimiston vastaava tekee päätöksen.	Opintotoimiston vastaava	Paperiasiakirja	1) Hyväksytty anomus TAI 2) Hylätty anomus
13b.	Opintosihteeri merkitsee tiedon päätöksestä Winhaan.	Opintosihteeri	Winha	1) Opinto-oikeus voimassa TAI 2) Opinto-oikeus ei ole voimassa.
14b.	Opintosihteeri lähettää päätöksen anomuksesta opiskelijalle.	Opintosihteeri	Posti	Opiskelija saa tiedon päätöksestä.

!!! Selvitettävät kysymykset !!!

millä tavoin ja kuka seuraa käsittelymaksujen saapumisia kun on kerran todettu, että käsittelymaksua ei ole maksettu (eli voiko prosessi jäädä "jumiin")

2.3 Erikoistumisopintojen opiskelijamaksun kerääminen

Metropolian koulutusohjelmat tarjoavat opiskelijoille mahdollisuuden parantaa ammattitaitoansa erilaisilla erikoistumisopintojen koulutuskokonaisuuksilla. Ko. kokonaisuuksista tiedotetaan Metropolian verkkosivuilla ja niihin ilmoittauminen tapahtuu erillisillä kirjallisilla hakuprosesseilla. Erikoistumisopinnoista peritään opintomaksu, joka tällä hetkellä laskutetaan Metropolian normaalin laskutusprosessin kautta.

2.3.1 Nykyinen toimintaprosessi

Vaiheen nro	Mitä tapahtuu?	Kuka tekee?	Millä tavalla?	Mikä on lopputulos?
1.	Opiskelija hakee erikoistumisopintoihin.	Opiskelija	Paperilomake liitteineen	Hakemus erikoistumisopintoihin.
2.	Hakutoimisto tekee valinnan hyväksymisestä.	Hakutoimisto	Erillinen prosessi	1) Hyväksytty hakemus. 2) Hyväksytty hakemus, varasijalla. 3) Hylätty hakemus.
3.	Valitulle opiskelijalle ilmoitetaan päätös hausta.	Hakutoimisto	Kirjallisesti	1) Ilmoitus hyväksynnästä. 2) Ilmoitus varasijalle pääsystä. 3) Ilmoitus hylkäyksestä.
4a.	Opiskelija ilmoittaa opiskelupaikan vastaanotosta.	Opiskelija	Kirjallisesti	Opiskelupaikan vastaanotto ilmoitus.
5a.	Hakutoimisto kirjaa opiskelijan läsnäolevaksi.	Hakutoimisto	Winha	Opiskelupaikka varattu.
6a.	Hakutoimisto tekee opiskelumaksun laskutuspyynnön.	Hakutoimisto	Sähköposti	Laskuttaja saa laskutuspyynnön.
7a.	Laskuttaja laskuttaa opiskelumaksun.	Laskuttaja / Taloushallinto	Intime Plus	1) Paperilasku 2) e-lasku 3) Laskutus tehty.
8a.	Opiskelija maksaa laskun	Opiskelija	Laskun maksu pankkitilille	Maksu suoritettu.
4b.	Opiskelija ei ota opiskelupaikkaa vastaan. Opiskelija voi jättää tämän ilmoituksen tekemättä Metropolialle.	Opiskelija / Ei kukaan	Kirjallisesti / Ei mitenkään	Opiskelijan laskutusprosessi ei käynnisty.
5b.	Hakutoimisto ilmoittaa varalla olijoille vapaasta opiskelupaikasta.	Hakutoimisto	Sähköpostilla tai kirjallisesti	Tieto vapaasta opiskelupaikasta varalla olijoille.
6b.	Varalla oleva opiskelija ilmoittaa ottavansa opiskelupaikan vastaan.	Opiskelija	Sähköpostilla	Opiskelupaikan vastaanotto ilmoitus. Prosessi siirtyy kohtaan 5a.

2.3.2 Prosessinomistajan toivoma sähköisen prosessin tavoitetila

Prosessinomistajan toiveena on, että vain erikoistumisopintoihin liittyvien opintomaksujen käsittely sähköistetään.

2.3.3 Järjestelmällä tuettava sähköinen prosessi ja prosessiin liittyvät käyttötapaukset

Vaiheen nro	Mitä tapahtuu?	Kuka tekee?	Millä tavalla?	Mikä on lopputulos?
1.	Opiskelija hakee erikoistumisopintoihin.	Opiskelija	Paperilomake liitteineen.	Hakemus erikoistumisopintoihin.
2.	Hakutoimisto tekee valinnan hyväksymisestä.	Hakutoimisto	Erillinen prosessi	1) Valitun opiskelijan kohdalla: Maksamaton erikoistumisopintojen opintomaksu 2) Valittu, varasijalla. 3) Ei valittu
3.	Hakutoimisto tallentaa asiointijärjestelmään tiedon opiskelijan opintomaksusta.	Hakutoimisto	Asiointipalvelun käyttöliittymä: Hakutoimiston toiminnot - Erikoistumisopintojen opintomaksu toimeksiannon lisäys.	Opiskelijan opintomaksu toimeksianto.
4.	Valitulle opiskelijalle ilmoitetaan päätös hausta.	Hakutoimisto	Sähköpostilla ja kirjallisesti	1) Ilmoitus valinnasta. Sisältää ohjeen opintomaksun suorittamisesta asiointijärjestelmän kautta. 2) Ilmoitus valinnasta varasijalle. 3) Ilmoitus ei valinnasta. Siirtymä prosessissa kohtaan 5a, 5b tai 5c riippuen opiskelijan valinnoista.
5a.	Opiskelija maksaa opintomaksun verkkomaksulla.	Opiskelija	Asiointipalvelun käyttöliittymä: Kirjautuneen käyttäjän toimeksiannot - Asiointipalvelun erikoistumisopintojen opintomaksun suoritus - Maksu suoritetaan verkkomaksulla.	1) Maksu suoritettu ja seurattavissa. 2) Tieto maksusta hakutoimiston seuranta käyttöliittymään. 3) Opiskelija on ilmoittautunut.
6a.	Hakutoimisto kirjaa opiskelijan läsnä olevaksi.	Hakutoimisto	Winha	Opiskelupaikka vastaanotettu ja opiskelija kirjattu läsnä olevaksi.
5b.	Opiskelija pyytää opintomaksusta laskun kolmannelle osapuolelle.	Opiskelija	Hakutoimistolta Sähköposti / Suora yhteydenotto / Kirjallisesti	1) Opiskelu paikka varattu. 2) Opiskelumaksun laskutustarve.
6b.	Hakutoimisto sulkee asiointijärjestelmän toimeksiannon.	Hakutoimisto	Asiointipalvelun käyttöliittymä: Hakutoimiston toiminnot - Erikoistumisopintojen opintomaksu toimeksiannon ylläpito.	Suljettu opintomaksu toimeksianto.
7b.	Hakutoimisto tekee laskutuspyynnön.	Hakutoimisto	Sähköpostilla	Laskuttaja saa laskutuspyynnön.
8b.	Laskuttaja laskuttaa opiskelumaksun.	Laskuttaja / Taloushallinto	Intime Plus	1) Paperilasku TAI 2) e-lasku 3) Laskutus tehty.
9b.	Lasku maksetaan	Kolmas osapuoli	Laskun maksu pankkitilille.	1) Maksu suoritettu. 2) Seuranta tieto talousraportoinnissa.
5c.	Opiskelija ei maksa TAI Kolmas osapuoli ei maksa	Ei kukaan!	1) Toimeksianto menee vanhaksi Asiointijärjestelmässä TAI 2) Laskutettu opintomaksu lasku erääntyy	1) Vanhentunut toimeksianto 2) ... joista tieto näkymään hakutoimiston käyttöliittymässä: Vanhentuneet toimeksiannot
6c.	Hakutoimisto tiedottaa varalla olijoille vapaasta opiskelupaikasta.	Hakutoimisto	Sähköpostilla tai kirjallisesti.	Tieto vapaasta paikasta varalla olijoille.
7c.	Joku varalla ollut henkilö ilmoittautuu, nopein ilmoittautuminen valitaan.	Opiskelija ehdokas.	Sähköisesti tai puhelimitse.	Hyväksytty hakemus. Prosessi siirtyy kohtaan 3.

Selvitettävät asiat:

pitäisikö lähettää avoimista maksuista muistutus?

3. Järjestelmäarkkitehtuuri

Kuten jo edellä tässä määrittelydokumentissa on mainittu, järjestelmä on suunniteltu toteutettavaksi siten, että toiminnot jaetaan palveluväylän ja erillisen asiointisovelluksen kesken. Jako perusteena on seuraavat periaatteet:

toiminnon yleisyys ja/tai monikäyttöisyys: palveluväylä
toiminnon pitää olla saatavissa monesta eri ohjelmistosta: palveluväylä
toiminto on loppukäyttäjän käyttöliittymä: asiointipalveluohjelmisto

Järjestelmään toteutettavien ohjelmistotoiminnallisuuksien sijoittaminen eri ohjelman osiin on kuvattu seuraavassa kaaviokuvassa:

Ohjelmistokokonaisuuden käyttöliittymät ja niihin liittyvät käyttöliittymien toiminnallisuuslogiikat on sijoitettu PHP-ohjelmistoon, joka voidaan käsittää koostuvan seuraavista kokonaisuukista:

Sovellusalusta kerros:
- Asiointisovelluksen käyttöliittymät on suunniteltu toteutettavaksi PHP-ohjelmointikielellä. Lisäksi sovellusalustassa on tarkoitus käyttää Codeigniter PHP-sovelluskehystä, jonka toiminnallisuutta laajennetaan Metropolia kohtaisilla laajennoksilla.
Sovelluslogiikka kerros:
- Sovellusalustan toiminnallisuuksien lisäksi tarvitaan käyttöliittymän toiminnallisuuksia varten sovelluslogiikkoja ja -luokkia.
Käyttöliittymä kerros:
- Varsinaiset käyttöliittymät tarvitsevat PHP:llä toteutettavien palvelintoimintojen tueksi myös asiakaspuolella ajettavia selaintoiminnallisuuksia. Nämä toteutetaan jQuery- ja jQueryUI-javascript-kirjastoilla, joiden käytöllä voidan turvata myös selainyhteensopivuus modernien internet-selaimien kanssa. Käyttöliittymien luomisessa käytetään myös HTML-kieltä, jonka käytössä kannattaa myös pyrkiä standardien noudattamiseen.

Metropoliassa ja myös OPI-projektissa palveluväylä toteutukset on valittu toteutettaviksi Apache ServiceMixillä. Tämän vuoksi ohjelmistokokonaisuuden palveluväylään suunnitellut toiminnallisuudet toteutettaneen sekä Java-kielellä että Camel-toiminnallisuuksina. Maksu- ja tunnistustoiminnallisuuksien lisäksi on suunniteltu, että talousautomaatioon tarvittavat ohjelmistotoiminnallisuudet sijoitetaan palveluväylään.

Ohjelmistokokonaisuudessa käytettävien rajapintojen kautta tapahtuva tiedonsiirto tehdään XML-tiedostoilla. Poikkeuksena tästä on talousautomaation tarvitsemat siirtotiedostot, jotka tehdään määrämittaisina ASCII-tiedostoina.

Ohjelmistokokonaisuudessa käytettävät tiedot tallennetaan MySQL-tietokantaan. Palveluväyläarkkitehtuuri periaatteiden mukaisesti tietokannan tietojen käsittely tapahtuu palveluväylän kautta.

4. Tietojärjestelmä määrittelyt

Kuten edellä on jo eritelty, tekninen toteutus on jaettu kahteen osaa: asiointisovellukseen ja palveluväylään sijoitettuihin järjestelmäpalvelu toiminnallisuuksiin. Seuraavassa käydään läpi toimintojen tarkemmat määrittelyt.

4.1 Asiointipalvelu

Asiointipalvelu sivuston on tarkoitustoimia loppukäyttäjille suunnattujen palveluiden koostosivustona. Sen tarkoituksena on tukea Metropolian intranet-palveluita ja internet-sivustoja tarjoamalla käyttöliittymät loppukäyttäjille suunnattuihin palveluihin.

Asiontipalvelun tekniset ratkaisut tullaan suunnittelemaan siten, että uusien palveluiden lisääminen tulee olemaan mahdollista tulevaisuudessa.

4.1.1 Toiminnallisuudet, käyttötapaukset ja käyttöliittymäprotot

Seuraavassa käydään läpi asiointijärjestelmään suunnitellut toiminnallisuudet, toiminnallisuuksiin liittyvät käyttötapaukset ja mahdolliset käyttöliittymäprotot.

4.1.1.2 Kaikille käyttäjille suunnatut toiminnallisuudet

	Käyttötapauksen nimi
	Asiointipalvelun etusivu

Yleiskuvaus
Asiointipalvelun etusivu on palvelun käytön aloituspiste. Sivulla näytetään asiontipalvelussa kaikille avoimet palvelut sekä annetaan mahdollisuus kirjautua palvelun käyttöön. Palveluun kirjautuneelle käyttäjälle ja kirjautumattomalle selailijalle voidaan näyttää erilainen sisältö.

Laatija	Tero Hakkarainen
Päiväys	23.4.2012
Prosessi	Verkkomaksut - Asiointipalvelu - Asiointitoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointi - Käyttäjä	Asiointipalvelun kirjautumaton käyttäjä	Luku, avoimet palvelut
Asiointi - CAS-kirjautunut käyttäjä	Asiointipalvelun kirjautunut käyttäjä	Luku, kirjautumista vaativat palvelut

Esitiedot/Ehdot

Ei ennakkoehtoja

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointikäyttäjä syöttää selaimeensa asiointipalvelun osoitteen ja avaa sivuston. Sivuston etusivu näytetään	T1

	Tulokset
T1	Asiointipalvelun etusivu

	Poikkeukset
P1	Ei kirjautunut käyttäjä: näytetään vain asiointipalvelu kaikille avoin sisältö
P2	Kirjautunut käyttäjä: näytetään kaikki ko. käyttäjän käyttäjäprofiiliin kuuluva sisältö.

	Muut vaatimukset
V1	Sivulla käytetään aina SSL-salausta

	Käsittelysäännöt
K1

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi

Yleiskuvaus

Laatija
Päiväys
Prosessi

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys

Esitiedot/Ehdot

	Käyttötapauksen kuvaus	Viittaus
1.
2.
3.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3

	Avoimet Asiat
A1
A2
A3

Käyttötiheys

Muuta

	Käyttötapauksen nimi

Yleiskuvaus

Laatija
Päiväys
Prosessi

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys

Esitiedot/Ehdot

	Käyttötapauksen kuvaus	Viittaus
1.
2.
3.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3

	Avoimet Asiat
A1
A2
A3

Käyttötiheys

Muuta

	Käyttötapauksen nimi

Yleiskuvaus

Laatija
Päiväys
Prosessi

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys

Esitiedot/Ehdot

	Käyttötapauksen kuvaus	Viittaus
1.
2.
3.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3

	Avoimet Asiat
A1
A2
A3

Käyttötiheys

Muuta

Kaikki käyttäjät
- etusivu
- rekisteröityminen
- omien tietojen päivitys
- kirjautuminen
- käyttäjän toimeksiantolistaus (toimintolistaus)
- velho: maksaminen verkkomaksulla
- velho: maksaminen luottokortilla
- velho: erikoistusopintojen opintomaksun suorittaminen
- avoimen opintojakson lisääminen poimintakoriin
- avoimen opintojaksojen poimintakori
- avoimen ilmoittautuminen poimintakorin perusteella
käyttäjä: metropolian opiskelija, voimassa oleva opiskeluoikeus
- velho: harkinnanvaraisen yliajan hakeminen
käyttäjä: metropolian opiskelija, päättynyt opiskeluoikeus
- velho: harkinnanvarainen opiskeluoikeuden palauttaminen
prosessitoimijat, opintotoimisto
prosessitoimijat, hakutoimisto
prosessitoimijat, avoin amk

4.1.2 Rajapinnat

Toimintojen tekninen käyttö tapahtuu palveluväylän rajapintojen kautta. Nämä rajapinnat käsitellään määrittelydokumentin kohdassa 4.2.2.

Lisäksi käyttäjien kirjautumisessa voidaan käyttää Metropolia SSO-palvelua, joka on rakennettu CAS-palveluksi.

4.1.3 Raportit ja listaukset

Raporttien tiedot haetaan palveluväylän kautta tietokannasta!

loppukäyttäjä
- toimeksiannon listaus
prosessitoimija, opintotoimisto
- yhden toimeksiannon listaus
- avointen toimeksiantojen listaus
- vastaanotetut maksut raportti
prosessitoimija, hakutoimisto
- yhden toimeksiannon listaus
- avointen toimeksiantojen listaus
- vastaanotetut maksut raportti
prosessitoimija, avoin amk
- avoimen amk opintojaksototeutusten listaus
- yhden opintojaksototeutuksen ilmoittautumisten listaus
- vastaanotetut maksut raportti
pääkäyttäjä
- käyttäjälistaus
- henkilölistaus
- tuotelistaus
- toimeksiantolistaus
- maksuyhteenveto raportti
ylläpito
- lokin listaus

4.1.5 Käyttöoikeudet ja työnkulut

käyttäjäprofiilit
- loppukäyttäjä
- loppukäyttäjä, metropolian opiskelija
- prosessitoimija, opintotoimisto
- prosessitoimija, hakutoimisto
- pääkäyttäjä
- ylläpito

käyttöoikeudet toiminnallisuuksiin

4.1.6 Tekniset vaatimukset

4.2 Palveluväylä

Metropolian Verkkomaksu projektissa on valittu toimintojen toteuttamiseksi malli, jossa palvelukeskeinen arkkitehtuuri on keskeinen osa teknistä ratkaisua. Tämä tarkoittaa sitä, että toteutettavien palveluiden käyttöliittymät ja ohjelmistologiikat on hajautettu järjestelmään: asiointisovellukseen ja palveluväylään. Tämä tuo mukanaan sen edun, että teknisten ratkaisujen muuttuessa joko käyttölittymä tai ohjelmistopalvelu puolella, niin järjestelmät ovat joustavammin muunnettavissa uuteen toimintaympäristöön.

Metropolian palveluväylä periaatteita on kirjattu omaan dokumenttiinsa: !!! Viite: Tomin dokumentti !!!

4.2.1 Toiminnallisuudet ja käyttötapaukset

Palveluväylään on suunniteltu seuraavat toiminnallisuudet

4.2.1.1 Toiminnallisuudet ja käyttötapaukset: asiointipalvelutoiminnot

	Käyttötapauksen nimi
	Palveluväylä toiminto: Käyttäjän rekisteröityminen

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat perustaa käyttäjän palveluväylän asiointisovellusten käyttäjärekisteriin.

Laatija	Tero Hakkarainen
Päiväys	18.4.2012
Prosessi	Verkkomaksuprojekti - Asiointi - Käyttäjätoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjät	Oikeus lisätä uusi käyttäjä	Uuden käyttäjän lisäys	Aina kun käyttäjä lisätään.

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut käyttäjän tiedot tulee olla tietosisälöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston käyttäjästä palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä perustaa hyväksytyn pyynnön perusteella uuden käyttäjän.	T1
4.	Käyttäjän lisäyksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja käyttäjän tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon käyttäjän hylkäyksestä ja välittää selväkielisen syyn käyttäjän hylkäykseen.	T3

	Tulokset
T1	Tietokantaan tallennettu käyttäjä.
T2	Palaute: Käyttäjän tiedot
T3	Palautettu virheilmoitus: Hylätty käyttäjä

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Käyttäjien tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	XML-tiedostokuvaus: Käyttäjä - Lisääminen

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli käyttäjien tietokantataulun pakolliset tiedot puuttuu. Käyttäjä hylätään epäkelpona.

	Avoimet Asiat
A1	Vaaditaanko jokaiselta rekisteröityneeltä käyttäjältä vahva tunnistautumien?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Käyttäjän muokkaus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat muokata käyttäjätietoja palveluväylän asiointisovellusten käyttäjärekisteriin.

Laatija	Tero Hakkarainen
Päiväys	18.4.2012
Prosessi	Verkkomaksuprojekti - Asiointi - Käyttäjätoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjät	Oikeus päivittää käyttäjäntietoja	Käyttäjätietojen päivitys	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut käyttäjäntiedot tulee olla tietosisällöltään vähimmäistasolla.
Päivitettävän käyttäjäntiedot tulee löytyä tietokannasta.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen päivitys xml-tiedoston käyttäjästä palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5.
3.	Palveluväylä päivittää hyväksytyn pyynnön perusteella käyttäjän tiedot.	T1
4.	Tietojen päivityksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja käyttäjän tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon päivityksen hylkäyksestä ja välittää selväkielisen syyn päivityksen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan päivitetty käyttäjä.
T2	Palaute: Käyttäjän tiedot
T3	Palautettu virheilmoitus: Hylätty käyttäjä

	Poikkeukset
P1	Käyttöoikeudeton sovellus: Käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: Käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Päivitettävää käyttäjää ei löydy: Käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Käyttäjien tietokantataulun pakolliset tiedot tulee olla aina tietueessa myös päivityksen jälkeen.
V2	XML-tiedostokuvaus: Käyttäjä - Muokkaus

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli käyttäjien tietokantataulun pakolliset tiedot puuttuu. Käyttäjä hylätään epäkelpona.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Asiakkaan lisääminen

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat perustaa käyttäjään liitettävän asiakkaan palveluväylän asiointisovellusten asiakasrekisteriin.

Laatija	Tero Hakkarainen
Päiväys	18.4.2012
Prosessi	Verkkomaksuprojekti - Maksaminen - Asiakastoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Asiakkaat	Oikeus lisätä uusi asiakas	Uuden asiakkaan lisäys	Aina kun asiakas lisätään

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut asiakkaan tiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston asiakkaasta palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä perustaa hyväksytyn pyynnön perusteella uuden asiakkaan.	T1
4.	Asiakkaan lisäyksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja asiakkaan tiedot näytetään asiointisovellusta käyttävälle asiakkaalle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon asiakkaan hylkäyksestä ja välittää selväkielisen syyn asiakkaan hylkäykseen.	T3

	Tulokset
T1	Tietokantaan tallennettu asiakas.
T2	Palaute: Asiakkaan tiedot
T3	Palautettu virheilmoitus: Hylätty asiakas

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Asiakkaasta puuttuu tietue Käyttäjä taulusta: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Asiakas tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	Asiakasta vastaava tietue tulee olla tallennettuna Käyttäjä tauluun.
V3	XML-tiedostokuvaus: Käyttäjä - Lisääminen

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli asiakas tietokantataulun pakolliset tiedot puuttuu. Käyttäjä hylätään epäkelpona.
K2	Asiakasta vastaava tietue puuttuu Käyttäjä taulusta. Asiakas hylätään epäkelpona.

	Avoimet Asiat
A1	Pitäisikö käyttäjä ja asiakas käsitellä saman käyttöliittymän läpi?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Asiakkaan muokkaus

Yleiskuvaus
Palveluväylään sallitut asiakassovellukset voivat muokata käyttäjään liitettyjä asiakastietoja palveluväylän asiakasrekisteriin.

Laatija	Tero Hakkarainen
Päiväys	19.4.2012
Prosessi	Verkkomaksuprojekti - Maksaminen - Asiakastoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Asiakkaat	Oikeus muokata asiakkaan tietoja	Asiakkaan tietojen päivitys	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käytöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut asiakkaan päivitystiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-päivitystiedoston asiakkaasta palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä päivittään hyväksytyn pyynnön perusteella asiakkaan tiedot.	T1
4.	Asiakkaan päivityksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja asiakkaan tiedot näytetään asiointisovellusta käyttävälle asiakkaalle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon päivityksen hylkäyksestä ja välittää selväkielisen syyn päivityksen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan päivitetty asiakas.
T2	Palaute: Päivitetyt tiedot
T3	Palautettu virheilmitus: hylätty päivitys

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Asiakkaan tietoja ei ole: käyttö keskeytetään, tilanne kirjataan seuratalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P4	Asiakkaasta puuttuu tietue Käyttäjä taulusta: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Asiakas tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	Asiakas tulee olla tallennettuna Asiakas tauluun.
V3	Asiakasta vastaava tietue tulee olla tallennettuna Käyttäjä tauluun.
V4	XML-tiedostokuvaus: Asiakas - Muokkaus

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli asiakas tietokantataulun pakolliset tiedot puuttuu. Käyttäjä hylätään epäkelpona.
K2	Asiakasta ei Asiakas taulussa: Päivitys hylätään epätäydellisenä.
K3	Asiakasta vastaava tietue puuttuu Käyttäjä taulusta. Asiakas hylätään epäkelpona.

	Avoimet Asiat
A1	Pitäisikö käyttäjä ja asiakas käsitellä saman käyttöliittymän läpi?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Asiakkaan sulkeminen

Yleiskuvaus
Palveluväylään saliitut asiointisovellukset voivat sulkea asiakkaalta maksutoimintojen käytön. Tieto sulusta tallennetaan asiointisovellusten asiakasrekisteriin.

Laatija	Tero Hakkarainen
Päiväys	19.4.2012
Prosessi	Verkkomaksuprojekti - Maksaminen - Asiakastoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Prosessitoimijat	Oikeus sulkea Asiakas	Asiakkaan sulkeminen	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiakkaan tiedot tulee löytyä Asiakas taulusta.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen pyynnön asiakkaan sulkemisesta palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä sulkee hyväksytyn pyynnön perustella asiakkaan.	T1
4.	Asiakkaan sulkemisesta lähetetään palaute asiointisovellukselle (xml-tiedosto) ja tehty toimenpide näytetään asiontisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon pyynnön hylkäyksestä ja välittää selväkielisen syyn pyynnön hylkäykseen.	T3

	Tulokset
T1	Tietokantaan suljettu asiakas.
T2	Palaute: Hyväksytty pyyntö
T3	Palaute: Hylätty pyyntö

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Asiakkaasta puuttuu tietue Käyttäjä taulusta: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Asiakasta vastaava tietue tulee olla tallennettuna Käyttäjä tauluun.
V2	XML-tiedostokuvaus: Asiakas - Sulkeminen

	Käsittelysäännöt
K1	Asiakasta ei Asiakas taulussa: Päivitys hylätään.

	Avoimet Asiat
A1	Pitäisikö käyttäjä ja asiakas käsitellä saman käyttöliittymän läpi?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Asiakkaiden listaus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat pyytää palveluväylältä listauksen palveluväylään tallennetuista asiakkaista. Listausta voidaan suodattaa eri hakutekijöillä, jotta tietojen näyttämistä asiointisovelluksen käyttöliittymissä voidaan hallita.

Laatija	Tero Hakkarainen
Päiväys	19.4.2012
Prosessi	Verkkomaksuprojekti - Maksaminen - Asiakastoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Asiakas	Oikeus lukea omat tiedot.	Luku, omat tiedot	Tarvittaessa
Asiointisovellus - Prosessikäyttäjä	Oikeus lukea sallittujen asiakkaiden tietoja	Luku, sallitut tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee palvelupyynnössä välittää suodatustiedot, muuten palautettava listaus suodatetaan !!! millä periaatteella? !!!
Pyydettäessä yhden asiakkaan tietoja palautetaan asiointisovellukselle asiakkaasta kaikki tiedot.

	Käyttötapauksen kuvaus	Viittaus
1.	Palvelusovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston.	Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksen.	T1
4.	Palveluväylä palauttaa asiakassovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Asiakkaiden listaus: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty kysely

	Poikkeukset
P1

	Muut vaatimukset
V1	xml-tiedostokuvaus: Asiakas - Asiakkaiden listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

	Käsittelysäännöt
K1

	Avoimet Asiat
A1	Voisiko listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Tuotteen lisääminen

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat perustaa tuotteen palveluväylän tuoterekisteriin.

Laatija	Tero Hakkarainen
Päiväys	19.4.2012
Prosessi	Verkkomaksuprojekti - Maksaminen - Tuotetoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Pääkäyttäjät	Oikeus lisätä uusi tuote	Uuden tuotteen lisäys	Aina kun tuote lisätään.

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut tuotteen tiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston tuotteesta palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä perustaa hyväksytyn pyynnön perusteella uuden tuotteen.	T1
4.	Tuotteen lisäyksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja tuotteen tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon tuotteen hylkäyksestä ja välittää selväkielisen syyn tuotteen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan tallennettu tuote.
T2	Palaute: Tuotteen tiedot
T3	Palautettu virheilmoitus: Hylätty tuote

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Tuote tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	XML-tiedostokuvaus: Tuote - Lisääminen

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli tuote tietokantataulun pakolliset tiedot puuttuu. Tuote hylätään epäkelpona.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Tuotteen muokkaus

Yleiskuvaus
Palveluväylään sallitut asiakassovellukset voivat muokata tuotetietoja palveluväylän tuoterekisteriin.

Laatija	Tero Hakkarainen
Päiväys	19.4.2012
Prosessi	Verkkomaksuprojekti - Maksaminen - Tuotetoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Tuotteet	Oikeus muokata tuotteen tietoja.	Tuotteen tietojen päivitys	Tarvittessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut tuotteen päivitystiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-päivitystiedoston tuotteesta palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä päivittään hyväksytyn pyynnön perusteella tuotteen tiedot.	T1
4.	Tuotteen päivityksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja tuotteen tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon päivityksen hylkäyksestä ja välittää selväkielisen syyn päivityksen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan päivitetty tuote
T2	Palaute: Päivitetyt tiedot
T3	Palautettu virheilmoitus: hylätty päivitys

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Tuotteen tietoja ei ole: käyttö keskeytetään, tilanne kirjataan seuratalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Tuote tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	Tuote tulee olla tallennettuna Tuote tauluun.
V3	XML-tiedostokuvaus: Tuote - Muokkaus

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli tuote tietokantataulun pakolliset tiedot puuttuu. Tuote hylätään epäkelpona.
K2	Tuotetta ei Asiakas taulussa: Päivitys hylätään epätäydellisenä.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Tuotteiden listaus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat pyytää palveluväylältä listauksen palveluväylään tallennetuista tuotteista. Listausta voidaan suodattaa eri hakutekijöillä, jotta tietojen näyttämistä asiointisovelluksen käyttöliittymissä voidaan hallita.

Laatija	Tero Hakkarainen
Päiväys	19.4.2012
Prosessi	Verkkomaksuprojekti - Maksamien - Tuotetoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Asiakas, Prosessi käyttäjä	Oikeus lukea osa tuotetiedoista	Luku, osa tiedoista	Tarvittaessa
Asiointisovellus - Pääkäyttäjä	Oikeus lukea kaikki tuotetiedot	Luku, kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee palvelupyynnössä välittää suodatustiedot, muuten palautettava listaus suodatetaan !!! millä periaatteella? !!!
Pyydettäessä yhden tuotteen tietoja palautetaan asiointisovellukselle tuotteesta kaikki tiedot.

	Käyttötapauksen kuvaus	Viittaus
1.	Palvelusovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston.	Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksen.	T1
4.	Palveluväylä palauttaa asiointisovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Tuotteiden listaus: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty kysely

	Poikkeukset
P1

	Muut vaatimukset
V1	xml-tiedostokuvaus: Tuote - Tuotteiden listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

	Käsittelysäännöt
K1

	Avoimet Asiat
A1	Voisiko listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Poimintakorin lisäys

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat perustaa palveluväylän tietokantaan käyttäjään liitettävän tuotteiden ja opintojaksototeutusten poimintakorin.

Laatija	Tero Hakkarainen
Päiväys	20.4.2012
Prosessi	Verkkomaksuprojekti - Asiointi - Poimintakoritoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä	Oikeus lisätä uusi poimintakori	Uuden poimintakorin lisäys	Aina kun poimintakori

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut poimintatiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.
2.
3.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3

	Avoimet Asiat
A1	Tämä on ilmeisesti turha toiminto, sillä uusi poimintakori voidaan perustaa poiminnan lisäämisen yhteydessä, kun tehdään ensimmäinen poiminta!
A2	Vai tulisiko palveluväylän tukea useaa samanaikaista poimintakoria?
A3

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Poimintakorin muokkaus

Yleiskuvaus
Paveluväylään sallitut asiointisovellukset muokata palveluväylän tietokantaan käyttäjään liitetyn tuotteiden ja opintojaksototeutusten poimintakoria.

Laatija	Tero Hakkarainen
Päiväys	20.4.2012
Prosessi	Verkkomaksuprojekti - Asiointi - Poimintakoritoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys

Esitiedot/Ehdot

	Käyttötapauksen kuvaus	Viittaus
1.
2.
3.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3

	Avoimet Asiat
A1	Onko tämäkin turha, jos poimintojen muokkaus tehdään poimintatapahtumien kautta?
A2
A3

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Poimintakorien listaus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat listata palvelyväylään tallennetun käyttäjään liitetyn tuotteiden ja opintojaksojen poimintakorin.

Laatija	Tero Hakkarainen
Päiväys	20.4.2012
Prosessi	Verkkomaksuprojekti - Asiointi - Poimintakoritoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä	Oikeus listata oman poimintakorin sisältö	Luku, oma tiedot	Tarvittaessa
Hallintasovellus - Pääkäyttäjä	Oikeus listata kaikkien poimintakorien sisältö.	Luku, kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulle olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee palvelupyynnössä välittää suodatustiedot, muuten palautettava listaus suodatetaan !!! millä periaatteella? !!!
Pyydettäessä yhden poimintakorin tietoja palautetaan asiointisovellukselle poimintakorista kaikki tiedot, siis myös poimintakorin sisältämät poiminnat.

	Käyttötapauksen kuvaus	Viittaus
1.	Palvelusovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston.	Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksen.	T1
4.	Palveluväylä palauttaa asiointisovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Poimintakorien listaus: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty kysely

	Poikkeukset
P1

	Muut vaatimukset
V1	xml-tiedostokuvaus: Poimintakori - Poimintakorien listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

	Käsittelysäännöt
K1

	Avoimet Asiat
A1	Voisiko listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Poiminnan lisäys

Yleiskuvaus
Palveluväylään lisätyt asiointisovellukset voivat lisätä käyttäjän palveluväylässä olevaan tuotteiden ja opintototeutusten poimintakoriin poiminnan.

Laatija	Tero Hakkarainen
Päiväys	20.4.2012
Prosessi	Verkkomaksaminen - Asiointi - Poimintakoritoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä	Oikeus lisätä uusi poiminta	Uuden poiminnan lisäys	Aina kun poiminta lisätään poimintakoriin.

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylän poimintakoriin lisätyn poiminnan tiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston poiminnasta palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5.
3.	Palveluväylä lisää hyväksytyn pyynnön perusteella uuden poiminnan poimintakoriin.	T1
4.	Poiminnan lisäyksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja poiminnan tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon tuotteen hylkäyksestä ja välittää selväkielisen syyn tuotteen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan tallennettu poiminta
T2	Palaute: poiminnan tiedot
T3	Palautettu virheilmoitus: hylätty poiminta

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Poimintakoria ei löydy: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Poiminta tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	XML-tiedostokuvaus: Poiminta - Lisääminen

	Käsittelysäännöt
K1	Jos käyttäjälle ei löydy poimintakoria palveluväylästä, niin poimintakori perustetaan käyttäjälle.

	Avoimet Asiat
A1	Voidaanko poimintojen ja poimintakorien hallinta hoitaa yksinkertaisemmin?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Poiminnan muokkaus

Yleiskuvaus
Palveluväylään lisätyt asiointisovellukset voivat muokata käyttäjän palveluväylässä olevaan tuotteiden ja opintototeutusten poimintakoriin poiminnan.

Laatija	Tero Hakkarainen
Päiväys	20.2.2012
Prosessi	Verkkomaksuprojekti - Asiointi - Poimintakoritoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä	Oikeus muokata omien poimintojen tietoja.	Kaikki, omat tiedot	Tarvittaessa
Hallintasovellus - Pääkäyttäjä	Oikeus muokata kaikkie poimintojen tietoja.	Kaikki, kaikkien tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut poiminnan päivitystiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-päivitystiedoston poiminnan palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä päivittää hyväksytyn pyynnön perusteella poiminnan tiedot.	T1
4.	Poiminnan päivityksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja poiminnan tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon päivityksen hylkäyksestä ja välittää selväkielisen syyn päivityksen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan päivitetty poimita
T2	Palaute: päivitetyt tiedot
T3	Palautettu virheilmoitus: hylätty päivitys

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Poiminnan tietoja ei ole: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Poiminta tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	Poiminta tulee olla tallennettuna Poimintarivi tauluun.
V3	Poimintakori, jossa poiminta on, tulee myös olla olemassa Poimintakorit taulussa.
V4	XML-tiedostokuvaus: Poiminta - Muokkaus

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli poimintarivit tietokantataulun pakolliset tiedot puuttuu. Poiminta hylätään epäkelpona.
K2	Poimintaa ei Poimintarivit taulussa: Päivitys hylätään epätäydellisenä.

	Avoimet Asiat
A1	Voisiko poimintojen hallintaa jotenkin yksinkertaistaa?

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Poimintojen listaus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat pyytää listattavaksi yhden poimintakorin poiminnat tai vain yhden tietyn poimintarivin tiedot.

Laatija	Tero Hakkarainen
Päiväys	20.4.2012
Prosessi	Verkkomaksuprojekti - Asiointi - Poimintakoritoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä	Oikeus lukea omien poimintojen tiedot	Luku, omat tiedot	Tarvittaessa
Asiointisovellus - Pääkäyttäjä	Oikeus lukea kaikkien poimintojen tiedot	Luku, kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee palvelupyynnössä välittää suodatustiedot, muuten palautettava listaus suodatetaan !!! millä periaatteella? !!!
Pyydettäessä yhden poiminnan tietoja palautetaan asiointisovellukselle poiminnasta kaikki tiedot.

	Käyttötapauksen kuvaus	Viittaus
1.	Palvelusovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston.	Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksen.	T1
4.	Palveluväylä palauttaa asiointisovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Poimintojen listaus: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty kysely

	Poikkeukset
P1

	Muut vaatimukset
V1	xml-tiedostokuvaus: Poiminta - Poimintojen listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

	Käsittelysäännöt
K1

	Avoimet Asiat
A1	Voisiko listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto?

-

Käyttötiheys

-

Muuta

4.2.1.2 Toiminnallisuudet ja käyttötapaukset: maksupalvelutoiminnot

	Toimeksiannon lisääminen
	Palveluväylä toiminto: Toimeksiannon lisääminen

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat lisätä toimeksiannon, joka tietojen täydellisyydestä riippuen voidaan siirtää käsiteltäväksi verkkomaksutoiminnolla tai muilla palveluväylässä olevilla toiminnoilla.

Laatija	Tero Hakkarainen
Päiväys	13.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu	Oikeus lisätä verkkomaksu toimeksianto	Uuden toimeksiannon lisäys	Aina kuin toimeksianto perustetaan.

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Toimeksianto xml tulee olla tietosisällöltään vähimmäistasoinen.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylän palvelukuvauksen mukaisen xml-tiedoston palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä perustaa hyväksytyn pyynnön perusteella toimeksiannon.	Tulos T1
4.	Toimeksiannon lisäyksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja toimeksiannon maksutapahtumaan vaikuttavat tiedot näytetään käyttäjälle, joka päättää jatkaako prosessia maksuun.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon hylkäyksestä ja väittää selväkielisen syyn toimeksiannon hylkäykseen.	T3

	Tulokset
T1	Tietokantaan tallennettu toimeksianto
T2	Käyttötapaus: Toimeksiannon maksusuoritus
T3	Palautettu virheilmoitus: Hylätty toimeksianto

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointiovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Toimeksiantojen tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	XML-tiedostokuvaus: Toimeksianto - Lisääminen

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli toimeksiantojen tietokantataulun pakolliset tiedot puuttuu. Toimeksianto hylätään epäkelpona.
K2	Epätäydelliset tiedot, tiedot vajaat, mutta toimeksiantojen tietokantataulun pakolliset tiedot on välitetty. Toimeksianto tallennetaan tynkänä, mutta siirto maksatukseen estetään.
K3	Täydelliset maksutoiminallisuuden käynnistämiseen kelvolliset tiedot on tallennettu. Maksatukseen siirto on mahdollinen.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Toimeksiannon tiedot
	Palveluväylä toiminto: Toimeksiannon tiedot

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat kysyä palveluväylältä täydelliset tiedot palveluväylään tallennetusta toimeksiannosta.

Laatija	Tero Hakkarainen
Päiväys	16.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu	Oikeus lukea asisointisovelluksen itsensä lisäämät toimeksiantoja	Luku, Omat tiedot	Tarvittaessa
Palveluväylä - Hallintasovellus	Oikeus lukea kaikkien asiointisovelluksen lisäämiä toimeksiantoja	Luku, Kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylän palvelukuvauksen mukaisen xml-tiedoston palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa tiedot toimeksiannosta asiointisovellukselle xml-tiedostona.	T1
4.	Palveluväylä palauttaa asiointisovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Toimeksiannon tiedot: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty kysely

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen kysely: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	XML-tiedostokuvaus: Toimeksianto - Toimeksiannon tiedot

	Käsittelysäännöt
K1	Virheellinen xml-kysely: kysely hylätään.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Toimeksiannon muokkaus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat muokata toimeksiannon tietoja, joka tietojen täydellisyydestä riippuen voidaan siirtää käsiteltäväksi verkkomaksutoiminnolla tai muilla palveluväylässä olevilla toiminnoilla.

Laatija	Tero Hakkarainen
Päiväys	16.3.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu	Oikeus muokata asiointisovelluksen itsensä lisäämiä verkkomaksutoimeksiantoja.	Päivitys, omat toimeksiannot	Tarvittaessa
Palveluväylä - Hallintasovellus	Oikeus muokata kaikkien asiointisovellusten lisäämiä verkkomaksutoimeksiantoja.	Päivitys, kaikki toimeksiannot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee tietää toimeksiannon tunniste.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5
3.	Palveluväylä muokkaa hyväksytyn pyynnön perusteella toimeksiannon.	T1
4.	Toimeksiannon lisäyksestä lähetetään palaute asiakassovellukselle (xml-tiedosto) ja toimeksiannon maksutapahtumaan vaikuttavat tiedot näytetään käyttäjälle, joka päättää jatkaako prosessia maksuun.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon muokkauksen hylkäyksestä ja välittää selväkielisen syyn hylkäyksen.	T3

	Tulokset
T1	Tietokantaan muokattu toimeksianto
T2	Käyttötapaus: Toimeksiannon maksusuoritus
T3	Palautettu virheilmoitus: Hylätty muokkaus

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Asiontisovellus yrittää muokata siten, että vähimmäistietomääritykset eivät täyty: Muokkaus hylätään.

	Muut vaatimukset
V1	Toimeksiantojen tietokantataulun pakolliset tiedot tulee olla ana xml-siirron mukana myös muokkauksissa.
V2	XML-tiedostokuvaus: Toimeksianto - Muokkaus

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli toimeksiantojen tietokantataulun pakolliset tiedot puuttuu. Muokkaus hylätään epäkelpona.
K2	Epätäydelliset tiedot, tiedot vajaat, mutta toimeksiantojen tietokantataulun pakolliset tiedot on välitetty. Toimeksiannon muokkaus tallennetaan tynkänä, mutta siirto maksatukseen estetään.
K3	Täydelliset maksutoiminallisuuden käynnistämiseen kelvolliset tiedot on tallennettu. Maksatukseen siirto on mahdollinen.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Toimeksiannon tilakysely

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat kysyä palveluväylältä yhden toimeksiannon tilan. Käyttöliittymälle voidaan tällöin palauttaa aktiivisesti tieto yhden tietyn toimeksiannon tilasta.

Laatija	Tero Hakkarainen
Päiväys	16.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu	Oikeus lukea asiointisovelluksen itsensä lisäämien toimeksiantojen tilatietoja	Luku, omat tiedot	Tarvittaessa
Palveluväylä - Hallintasovellus	Oikeus lukea kaikkien asiointisovellusten lisäämien toimeksiantojen tilatietoja.	Luku, kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee tietää toimeksiannon tunniste.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää xml-kuvauksen mukaisen tilakyselyn palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee tilakyselyn ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon tilasta xml-tiedostona.	T1
4.	Palveluväylä palauttaa asiakassovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Toimeksiannon tila: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty kysely

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen kysely: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	xml-tiedostokuvaus: Toimeksianto - Toimeksiannon tila

	Käsittelysäännöt
K1	Virheellinen xml-kysely: kysely hylätään.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Toimeksiannon tilapäivitykset

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat päivittää yhden toimeksiannon tilan. Tällöin voidaan esimerkiksi teknisen virheen vuoksi jumiin jääneet toimeksiannot vapauttaa takaisin maksettavaksi. Lisäksi käsittelemättömät toimeksiannot voidaan sulkea pois aktiivisista toimeksiannoista.

Laatija	Tero Hakkarainen
Päiväys	16.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu	Oikeus päivittää asiointisovelluksen itsensä lisäämien toimeksantojen tilatietoja.	Päivitys, omat tiedot	Tarvittaessa
Palveluväylä - Hallintasovellus	Oikeus päivittää kaikkien asiointisovellusten lisäämien toimeksiantojen tilatietoja.	Päivitys, kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiontisovelluksen tulee tietää toimeksiannon tunniste.
Asiointisovelluksen tulee tietää toimeksiannon päivitettävä tila.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää xml-kuvauksen mukaisen tilakyselyn palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee päivityspyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa asiointisovellukselle tiedon päivityspyynnön tilasta xml-tiedostona.	T1
4.	Palveluväylä palauttaa asiakassovellukselle päivityspyynnön hylkäyksestä ja väittää selväkielisen syyn päivityspyynnön hylkäykseen.	T2

	Tulokset
T1	Toimeksiannon tila: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty päivityspyyntö

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen kysely: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	xml-tiedostokuvaus: Toimeksianto - Toimeksiannon tilan päivitys

	Käsittelysäännöt
K1	Virheellinen tila: päivitys hylätään.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Toimeksiannon maksusuoritus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat käynnistää maksusuorituksen toimeksiannosta, joka on tiedoiltaan tarpeeksi täydellinen maksusuoritusta varten.

Laatija	Tero Hakkarainen
Päiväys	16.3.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu	Oikeus käynnistää verkkomaksutoiminto asiakassovelluksen itsensä lisäämälle toimeksiannolle.	Suoritus, omat toimeksiannot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee tietää toimeksiannon tunniste
Toimeksiannon tulee olla tietosisältään kelvollinen maksutoimintoon.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston.	Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 7
3.	Palveluväylä palauttaa asiointisovellukselle verkkomaksun suorittamisen käyttöliittymät Vetuma-palvelusta.	T1
4.	Loppukäyttäjä käyttää asiointisovelluksen kautta verkkomaksukäyttölittymiä maksun suorittamiseen.	T2
5.	Palveluväylälle palautuu tieto maksun suorituksen tilasta	T3
6.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon tilasta verkkomaksun suorittamisen jälkeen. Toimeksiannon päivittyneen tilan tiedot näytetään käyttäjälle asiointisovelluksessa.	T4
7.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon maksamisen hylkäyksestä ja välittää selväkielisen syyn hylkäyksen.	T5

	Tulokset
T1	Vetuma-palvelun verkkomaksukäyttöliittymä
T2	Suoritettu maksu TAI Epäonnistunut maksutapahtuma
T3	Vetuma-palvelun palauttama tieto maksun tilasta.
T4	Toimeksiannon maksun suorituksen tila: xml-tiedosto
T5	Palautettu virheilmoitus: hylätty maksusuoritus

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen kysely: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.
P3	Maksu suoritusta yritetään riittämättömillä toimeksiannon tiedoilla: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	xml-tiedostokuvaus: Toimeksianto - Toimeksiannon maksusuoritus

-

	Käsittelysäännöt
K1	Maksuun riittämättömät tiedot: maksua ei käynnistetä
K2	Toimeksianto ei ole maksuun kelvollisessa tilassa: maksua ei käynnistetä

	Avoimet Asiat
A1

Käyttötiheys

Muuta

	Käyttötapauksen nimi
	Palveluväylä toiminto: Toimeksiantojen listaus

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat pyytää palveluväylältä listan palveluväylään tallennetuista toimeksiannoista. Listausta voidaan suodattaa eri hakutekijöillä, jotta tietojen näyttämistä asiointisovelluksen käyttöliittymissä voidaan hallita.

Laatija	Tero Hakkarainen
Päiväys	16.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu	Oikeus lukea asiointisovelluksen itsensä lisäämiä toimeksiantoja.	Luku, omat tiedot	Tarvittaessa
Palveluväylä - Hallintasovellus	Oikeus lukea kaikkien asiointisovellusten lisäämiä toimeksiantoja.	Luku, kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee palvelupyynnössä välittää suodatustiedot, muuten palautettava listaus suodatetaan !!! millä periaatteella? !!!

	Käyttötapauksen kuvaus	Viittaus
1.	Palvelusovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston.	Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksen.	T1
4.	Palveluväylä palauttaa asiakassovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Toimeksiantojen listaus: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty kysely

	Poikkeukset
P1

	Muut vaatimukset
V1	xml-tiedostokuvaus: Toimeksianto - Toimeksiantojen listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

	Käsittelysäännöt
K1

	Avoimet Asiat
A1

Käyttötiheys

Muuta

4.2.1.3 Toiminnallisuudet ja käyttötapaukset: tunnistustoiminnot

	Käyttötapauksen nimi
	Palveluväylä toiminto: Henkilön tunnistaminen TUPAS-tunnistautumisella.

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat käynnistää Vetuman-kautta tarjottavan TUPAS-tunnistautumisen. TUPAS-tunnistautumisen kautta välitetty käyttäjäntunnistaminen tallennetaan palveluväylän tietokantaan ja tunnistettua henkilötietoa voidaan käyttää tämän jälkeen asiointisovelluksessa.

Laatija	Tero Hakkarainen
Päiväys	17.3.2012
Prosessi	Verkkomaksuprojekti - Käyttäjä - Vahva tunnistaminen OPI-Maksut - Vahva tunnistaminen

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Vahva tunnistaminen	Oikeus käynnistää tunnistustoiminto	Suoritus	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään tunnistuksen käynnistyskutsun.	Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee käynnistyspyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 7.
3.	Palveluväylä palauttaa asiointisovellukselle TUPAS-tunnistamisen suorittamisen käyttöliittymät Vetuma-palvelun kautta.	T1
4.	Loppukäyttäjä käyttää TUPAS-tunnistamisen käyttöliittymiä vahvan tunnistautumisen suorittamiseen.	T2
5.	Palveluväylälle palautuu tieto tehdystä tunnistuksesta.	T3
6.	Palveluväylä palauttaa tiedon tunnistusta henkilöstä asiointisovellukselle.	T4
7.	Palveluväylä palauttaa tiedon virheellisestä tunnistustapahtumasta asiointisovellukselle.	T5

	Tulokset
T1	Vetuma-palvelun kautta haetut TUPAS-tunnistautumisen käyttöliittymät.
T2	Suoritettu tunnistaminen TAI Epäonnistunut tunnistaminen
T3	Vetuma-palvelun palauttamat tiedot tunnistetusta henkilöstä.
T4	Henkilön tunnistamisen tila ja osa palautetusta tiedoista.
T5	Palautettu virheilmoitus: epäonnistunut tunnistautuminen

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen käynnistys: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	xml-tiedostokuvaus: Henkilö - Henkilön vahva tunnistaminen

	Käsittelysäännöt
K1

	Avoimet Asiat
A1

Käyttötiheys

Muuta

4.2.1.4 Toiminnallisuudet ja käyttötapaukset: talousautomaation toiminnot

	Käyttötapauksen nimi
	Palveluväylä toiminto: Talousautomaation siirtotiedoston muodostus

Yleiskuvaus
Talousautomaation tarvitsemat siirtotiedostot muodostetaan maksetuista toimeksiantoriveistä. Ajo voidaan suorittaa joko ajastetusti tai hallinta käyttöliittymän kautta. Ajo on myös mahdollista ajaa koeajona.

Laatija	Tero Hakkarainen
Päiväys	17.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Talousautomaatio OPI-Maksut - Talousautomaatio

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Palveluväylä - Hallintasovellus	Oikeus käynnistää siirtotiedoston muodostus koeajona siten, että siirtotiedosto muodostetaan siirtokelpoisesta aineistosta, mutta siirrettyjä toimeksiantoja ei kirjata tietokantaan siirretyiksi.	Tietokanta, vain luku, siirtokelpoiset toimeksiannot	Tarvittaessa
Palveluväylä - Hallintasovellus	Oikeus käynnistää siirtotiedoston muodostus siten, että siirtotiedosto muodostetaan siirtokelpoisesta aineistosta ja että siirretyt toimeksiannot kirjataan tietokantaan siirretyksi.	Tietokanta, luku ja kirjoitus, siirtokelpoiset toimeksiannot	Tarvittaessa
Palveluväylä - Ajastetut toiminnot	Oikeus käynnistää ajastetusti siirtotiedoston muodostus siten, että siirtotiedosto muodostetaan siirtokelpoisesta aineistosta ja että siirretyt toimeksiannot kirjataan tietokantaan siirretyksi.	Tietokanta, luku ja kirjoitus, siirtokelpoiset toimeksiannot	Päivittäin

Esitiedot/Ehdot

Siirrettävien toimeksiantojen tulee olla verkkomaksutoiminnolla suoritettuja ja maksetuiksi todettuja verkkomaksu toiminnon tilaviesteistä.

	Käyttötapauksen kuvaus	Viittaus
1.	Siirtotiedoston muodostaminen käynnistetään joko koeajona tai lopullisena ajona.
2.	Muodostaminen käy siirtämättömät mutta siirtokelpoiset toimeksiannot läpi ja tarkastaa niiden siirtokelpoisuuden.
3.	Muodostaminen kirjaa siirtokelpoiset rivit valmiiksi siirtoon.	T1
4.	Muodostaminen kirjaa virheellisistä tapahtumista selväkielisen merkinnän tapahtumalokiin ja merkitsee rivit virhetilaan.	T2
5.	Ajo muodostaan siirtotiedoston siirtokelpoisista riveistä.	Määrittely kohta 4.2.4
6.	Ajon suorituksesta kirjataan merkintä tapahtumalokiin.
7.	Ajosta palautetaan siirtoraportti, joka lähetetään taloushallintoon sähköpostilla.	T3

	Tulokset
T1	Siirtokelpoinen toimeksianto.
T2	Virhetilassa oleva toimeksianto.
T3	Siirtoraportti.

	Poikkeukset
P1	Puutteellisilla tiedoilla varustettu toimeksianto, jota yritetään siirtää: Toimeksianto tila vaihdetaan virhe tilaan ja tilanne kirjataan lokiin.

	Muut vaatimukset
V1	Talousjärjestelmän (Intime Plus) siirtotiedostojen kuvaukset.

	Käsittelysäännöt
K1	Toimeksiantoa ei merkitty maksetuksi: siirtoa ei käynnistetä.
K2	Maksetulla toimeksiannolla ristiriitaiset tiedot: merkitään virhetilaan.

	Avoimet Asiat
A1

Käyttötiheys

Muuta

4.2.2 Toimintojen Webservice-rajapinnan kuvaukset

eli palveluväylä toimintojen sekä talousautomaation paketointi muille sovelluksille sopivaksi

4.2.3 Maksu- ja tunnistustoiminnallisuuksien Vetuma-rajapintojen kuvaukset

Maksu- ja tunnistustoiminnallisuuksien rakentamisessa käytetään Vetuma-rajapintoja. Vetumasta käytetään seuraavia teknisiä kuvauksia liittymien rakentamiseksi:

!!! Tarvitaanko myös SAML-rajapintoja? !!!

4.2.4 Talousautomaation rajapinnan kuvaukset

siirtotiedostokuvaukset: huom! määrämittaisia ASCII-tiedostoja
muista laittaa suunnitelmiin tiedot, että mikä toiminnallisuus luo tiedon ja millaisella syklillä!

4.2.5 Tietomalli ja tietokanta

tietokantataulujen kuvaukset

4.2.5.1 User-taulu: Käyttäjätiedot

Käyttäjien tiedot tallennetaan tähän tauluun.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	ID	Käyttäjätunniste	int	long	Uniikki, pakollinen, autoincrement		Käyttäjän juokseva tunniste.
FK	FK_Person_PersonID	Person-taulun ID	int	long	Uniikki, pakollinen	Person-taulu, PersonID-kenttä	1:1 viittaus Person-tauluun. Henkilöstä muodostuu yksi identiteetti kahden taulun tietojen perusteella.
	MetropoliaID	Metropolia käyttäjätunnus	varchar	Tomilta tieto			Mikäli käyttäjällä on olemassa Metropolia tunnus, tunnus tallennetaan tähän kenttään. Kun käyttäjä tunnistetaan vahvasti, tämän tiedon vastine haetaan tunnistautumisen perusteella Ammeesta.
	EmailAddress	Sähköpostiosoite	varchar	100			Käyttäjän ilmoittama sähköpostiosoite. Voidaan käyttää myös kirjautumistunnuksena
	MetropoliaIDIsInUse	Metropolia-tunnus käytössä?	boolean		Oletus: false Lisäksi, jos Person - IsInUse kenttä on false, niin tämäkin on false.		Onko käyttäjän Metropolia tunnus kirjautumiskäytössä? Käytännössä CAS validoi käyttöoikeuden voimassaolon.
	EmailIDIsInUse	Sähköpostitunnus käytössä?	boolean		Oletus: false Lisäksi, jos Person - IsInUse kenttä on false, niin tämäkin on false.		Onko käyttäjän sähköpostiosoite käytössä kirjautumiseen?
	LastLogin	Viimeinen kirjautuminen	datetime				Milloin käyttäjä on kirjautunut viimeksi?
	LastLoginIP	Viimeisen kirjautumisen IP-osoite	varchar	15			Mistä osoitteesta käyttäjä on viimeksi kirjautunut?
	LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Milloin tietuetta on viimeksi päivitetty?
	UpdateBy	Viimeisin päivittäjä	varchar	Tomilta tieto	Pakollinen	User-taulu - ID-kenttä	Kuka käyttäjä on viimeksi päivittänyt tietuetta?

4.2.5.2 Person-taulu: Henkilötiedot

Käyttäjään liittyvän henkilön tiedot tallennetaan omaan tauluunsa. Tiedot on tallennettu 1:1 viittauksella, jolloin yhtä käyttäjätunnusta vastaa yksi henkilö.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	PersonID	Henkilötunniste	int	long	Uniikki, pakollinen, autoincrement		Henkilön juokseva tunniste.
	CustomerID	Asiakasnumero	int	short	Uniikki		Henkilölle liitetty asiakasnumero. Sama kuin IntimePlussaan siirrettävä asiakasnumero
	ID	Henkilötunnus	varchar	11	Uniikki, vain suomalaiset, vahvatunnistus	Henkilötunnuksen määritelmä
	StudentID	Opiskelijanumero	int / varchar	?		Winha	Opiskelijanumero ilmeisesti Winhasta. Tietotyyppi pitää tarkistaa!
	Surname	Sukunimi	varchar	Tomilta tieto	Pakollinen		Henkilön virallinen sukunimi. Tieto haetaan mieluiten virallisista tietolähteistä.
	Firstnames	Etunimet	varchar	Tomilta tieto	Pakollinen		Henkilön viralliset etunimet. Tieto haetaan mieluiten virallisista tietolähteistä.
	IsStrongIdentified	Vahva tunnistus suoritettu	boolean		Oletus: false		Onko käyttäjä tunnistettu vahvalla tunnistus menetelmällä?
	Winha_TK_koodi	Winha-järjestelmän TK-koodi	varchar	Pituus Winhasta!		Winha	Winhassa käytössä oleva koulutusohjelman koodi, jolla opiskelija on kohdistettu koulutusohjelmalle. Tieto haetaan Ammeesta.
	IsInUse	On käytössä	boolean		Oletus: false		Onko henkilö käytössä?
	LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Milloin tietuetta on viimeksi päivitetty?
	UpdateBy	Viimeisin päivittäjä	varchar	Tomilta tieto	Pakollinen	User-taulu - ID-kenttä	Kuka käyttäjä on viimeksi päivittänyt tietuetta?

Avoimet kysymykset: tarvitaanko kutsumanimi-kenttä?

Miten käsitellään Winha_TK_koodin koodisto?

4.2.5.3 PersonAddress-taulu: Henkilön osoitetiedot

Henkilöön liittyvien osoitteiden tiedot tallennetaan omaan tauluunsa. Henkilölle voi olla liitettynä useampi kuin yksi osoite. Osoitteet eroitellaan toisistaan rooleina, esim. kotiosoite, työosoite, opiskelupaikan osoite jne.

Henkilön kotiosoite-tiedot pyritään täydentämään vahvan tunnistautumisen yhteydessä saatavan tiedon mukaiseksi.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
FK / PK	FK_Person_PersonID	Henkilön tunniste	int	long			Henkilön tunniste Person-taulusta
PK	Address_Role	Osoitteen rooli	varchar	25		Määritelty rooliluokitus	Yllämainittu osoitteen rooliluokitus.
	PostalAddress	Postiosoite	varchar	100			Postiosoite
	PostCode	Postinumero	varchar	10			Postinumero
	Municipality	Postitoimipaikka	varchar	50			Postitoimipaikka
	Country	Maa	varchar	50			Maa
	CompanyID	Y-tunnus	varchar	15		YTJ-tietojärjestelmän y-tunnus	Rooliin liitettävä mahdollisen yrityksen y-tunnus.
	CompanyName	Yrityksen nimi	varchar	50			Rooliin liitettävän mahdollisen yrityksen virallinen nimi.
	IsBillingAddress	Onko laskutusosoite?	boolean		Oletus: false		Onko tämä ao. osoite henkilön oletuslaskutusosoite?
	LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Milloin tietuetta on viimeksi päivitetty?
	UpdateBy	Viimeisin päivittäjä	varchar	Tomilta tieto	Pakollinen	User-taulu - ID-kenttä	Kuka käyttäjä on viimeksi päivittänyt tietuetta?

Avoimet kysymykset: Hajoitetaanko AddressRole - kentän roolilista omaksi taulukseen vai vedätäänkö tieto kovakoodattuna?
Mitkä ovat tuetut roolit?

4.2.5.4 Product-taulu: Tuote tiedot

Tämä taulu sisältää verkkomaksu-järjestelmän kautta myytävät tuotteet. Tuote tietojen taakse on myös liitetty tietoja talousautomaatiota varten. Tämän vuoksi osa taulun tiedoista kytkeytyy IntimePlus-järjestelmästä replikoituhin tietoihin.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	ProductID	Tuotetunnus	int	short			Tuotteen kuvaava tunnus
	ProductName	Tuotteen nimi	varchar				Tuotteen käyttöliittymissä näytettävä nimi.
FK	FK_IntimeProduct_IntimeProductID	Intime tuotetunnus	int	long		IntimeProduct-taulu - IntimeProductID-kenttä	IntimePlus tuotetunnus taulusta IntimeProduct.
FK	FK_IntimeProject_IntimeProjectID	Intime projektitunnus	int	long		IntimeProject-taulu - IntimeProjectID-kenttä	IntimePlus projektitunnus taulusta IntimeProject.
FK	FK_IntimeEducationProgram_IntimeEducationProgramID	Intime Koulutusohjelmatunnus	int	long		IntimeEducationProgram-taulu - IntimeEducationProgramID-kenttä	IntimePlus koulutusohjelmatunnus taulusta IntimeEducationProgram
FK?	EServiceProductType	Asiointi tuotetyyppi	varchar	20	Pakollinen		Millainen asiointipalvelu tuote on kyseessä? Tällä luokitellaan tuote esim. käsittelymaksuksi.
FK?	EServiceChannel	Asiointi palvelukanava	varchar	20	Pakollinen		Missä asiointipalvelu kanavassa tuotetta voi käyttää? Eli tällä voidaan erotella palveluväylän tuote johonkin tietyyn asiointisovellukseen.
	IsInUse	On käytössä	boolean		Oletus: false		Onko tuote käytössä?
	LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Milloin tietuetta on viimeksi päivitetty?
	UpdateBy	Viimeisin päivittäjä	varchar	Tomilta tieto	Pakollinen	User-taulu - ID-kenttä	Kuka käyttäjä on viimeksi päivittänyt tietuetta?

Avoimet kysymykset: pitäiskö tuo tuote taulukenttä nimi tehdä hieman geneerisemmäksi?
pitäiskö asiointipalvelutyypit / kanavat hajoittaa omaksi taulukseen?

4.2.5.5 StudyImplementation-taulu: Opintojaksototeutus tiedot

Huom! Tätä taulua ei toteuteta tuotantoon projektin ensimmäisessä vaiheessa. Taulun tietosisältö on tällä hetkellä jatkokehityksen alla.

Taulu sisältää avoimen ammattikorkeakoulun asiointipalvelussa myytävien opintojaksototeutusten tiedot.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	ImplementationID	Opintojaksototeutuksen tunnus	varchar	Tieto Pepistä?	Pakollinen		Opintojakson toteutuksen tunnus. Otetaan siitä järjestelmästä, joka on toteutuksien lähdejärjestelmä.
FK	FK_Product_ProductID	Asiointituote tunnus	int	long	Pakollinen	Product-taulu - ProductID-kenttä
FK	FK_IntimeEducationProgram_EducationProgramID	Intime Koulutusohjelmatunnus	int	long	Pakollinen	IntimeEducationProgram-taulu - IntimeEducationProgramID-kenttä
	StudyUnitName	Opintojakson nimi	varchar		Pakollinen		Tiedot edellä mainitusta lähdejärjestelmästä.
	StudyUnitDescription	Opintojakson kuvaus	varchar		Pakollinen		Tiedot edellä mainitusta lähdejärjestelmästä.
	StudyUnitWWWInfoPage	Linkki ulkoisiin tietoihin	varchar		Pakollinen		Tiedot edellä mainitusta lähdejärjestelmästä.
	ImplementationStartTime	Toteutuksen aloitus päivämäärä	date		Pakollinen		Tiedot edellä mainitusta lähdejärjestelmästä.
	ImplementationEndTime	Toteutuksen päättymis päivämäärä	date		Pakollinen		Tiedot edellä mainitusta lähdejärjestelmästä.
	MinimumSeats	Paikkoja vähintään	int	short			Tiedot edellä mainitusta lähdejärjestelmästä.
	MaximumSeats	Paikkoja enintään	int	short			Tiedot edellä mainitusta lähdejärjestelmästä.
	FreeSeats	Paikkoja vapaana	int	short			Laskennallinen tieto, joka päivittyy tehtyjen myyntien perusteella.
	IsInUse	On käytössä	boolean		Oletus: false		Onko toteutus käytössä? Voimassa vain kun InternetPublish on voimassa, eli tietoa voidaan käyttää jonkun toteutuksen ilmoittautumisten väliaikaiseen keskeyttämiseen.
	InternetPublishStart	Internet julkaisu alkaa	datetime				Tiedot edellä mainitusta lähdejärjestelmästä.
	InternetPublishEnd	Internet julkaisu päättyy	datetime				Tiedot edellä mainitusta lähdejärjestelmästä.
	LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Milloin tietuetta on viimeksi päivitetty?
	UpdateBy	Viimeisin päivittäjä	varchar	Tomilta tieto	Pakollinen	User-taulu - ID-kenttä	Kuka käyttäjä on viimeksi päivittänyt tietuetta?

Avoimet kysymykset: Tarvitaanko joku toinen mekanismi toteutuksilla olevien vapaiden paikkojen hallintaan?
Mistä nämä tiedot tuotetaan? Verkkomaksu/Asiointi järjestelmään ei olla lisäämässä käyttöliittymiä näiden tietojen syöttämistä varten!

Tarkastettavat tiedot:

Intime avaintietojen tietotyypit.

4.2.5.6 Assignment-taulu: Toimeksianto-taulu

Maksun sisältävän asiointitapahtumien tiedot tallennetaan toimeksiantoina. Toimeksianto tiedot pitävät sisällään tarvittavat tiedot yhden asiointitapahtuman käsittelyyn. Toimeksianto voi sisältää useamman toimeksiantorivin, jotka tallennetaan omaan tauluunsa.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	AssignmentID	Toimeksiantotunnus	int	long	Pakollinen, Uniikki, Autoincrement
PK	OrderID	Tilausnumero	int	long	Pakollinen
	CreatedFromBasket	Luotu poimintakorista	int	long
	AssignmentDate	Perustettu	date		Pakollinen
	ValidTill	Voimassaoloajan päättyminen	datetime
FK	FK_Person_CustomerID	Henkilö	int	long	Pakollinen	Person-taulu - CustomerID-kenttä
	EServiceChannel	Asiontikanava	varchar	25	Pakollinen
	Hashtag	Yksilöllinen tunniste	varchar	32	Pakollinen
	State	Käsittelyn tila	varchar	25	Pakollinen
	HandlingMethod	Käsittelytapa	int	short	Pakollinen		!!! Missä määritellään käsittelytapojen koodit? !!!
	ReferenceID	Pankkiviite	varchar	50	Pakollinen		SEPA-standardin mukaan varataan tilaa, tosin aluksi tuetaan suomalaista.
	TermOfPayment	Maksuehto	int	short	Pakollinen
	TotalPayable	Loppusumma	double	10,2	Pakollinen
	TransactionDate	Tapahtumapäivä	datetime
	TransactionReturnStatus	Tapahtuman paluuvaste	varchar	100			!!! Tarkistetaan Vetuma-spekseistä. !!!
	TransactionArchiveID	Tapahtuman arkistointitunnus	varchar	50			!!! Tarkistetaan Vetuma-spekseistä. !!!
	IsInUse	On käytössä	boolean		Oletus: false		Onko henkilö käytössä?
	LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Milloin tietuetta on viimeksi päivitetty?
	UpdateBy	Viimeisin päivittäjä	varchar	Tomilta tieto	Pakollinen	User-taulu - ID-kenttä	Kuka käyttäjä on viimeksi päivittänyt tietuetta?
	IntimeTransferStatus	Intime siirron tila	varchar	25	Pakollinen		!!! Siirron tilojen koodit? !!! Kesken, Valmis, Odottaa siirtoa, Siirretty, Ei siirretä

Puuttuvat taulut:

asiontipalvelutiedot vai kanava vai mitä
ohjaustiedot
vetumatiedot

Pohja

Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset







IsInUse	On käytössä	boolean		Oletus: false		Onko henkilö käytössä?
LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Milloin tietuetta on viimeksi päivitetty?
UpdateBy	Viimeisin päivittäjä	varchar	Tomilta tieto	Pakollinen	User-taulu - ID-kenttä	Kuka käyttäjä on viimeksi päivittänyt tietuetta?

tarkat kuvaukset per taulu kenttätasolla!
tsekkaa kenttänimet vastaamaan ensisijaisesti metropolia nimiä ja sitten xdw-mallia vasten, tarvittaessa käytä aliaksia!
tietokantamallia päivitetään kun määrittelydokumentti täydentyy

Tietokannat:

käyttäjät
henkilöt / asiakas
tuotteet
intimetuotteet (replikaatti)
opintojaksototeutukset
toimeksianto
toimeksiantorivit
intimeprojektit (replikaatti)
poimintakori
poimintarivit
intimekoulutusohjelmast (replikaatti)

Tietokanta - Käsitekartta

Tietokanta - taulut

Puuttuvat kentät:

Määriteltävää:

opiskelijan lajittelutekijät hakukäyttöliittymissä: koulutusohjelma (kysytään kun opiskelija suorittaa maksua) / kustannuspaikka / projekti

4.2.6 Tekniset vaatimukset

ympäristöjen tekniset vaatimukset (edes jotain) palvelin, että toiminnallisuus näkökulmasta
"palvelimien tulee olla teknisesti suojattu... palveluita käytetään vain ssl-rajapintojen kautta"
huomautetaan, että määrittelyjä voidaan tarkentaa...

4.2.7 OPI-Maksut projektin vaatimuksien huomioon ottaminen

something, something, the dark side

5. Toteutussuunnitelma

Järjestelmän toteutus tehdään normaalien kehitysmenetelmien avulla. Kehityssykliin kuuluu siis määrittely, toteutus, testaus ja käyttöönotto.

Kehittäjille tulee tarjota tarvittavat tiedot määrittelyissä teknisen toteutuksen rakentamiseen. Metropolian ulkopuolisten teknisten rajapintojen määrittelyiden ensisijainen lähde on ao. rajapintojen tekniset dokumetaatiot.

Kehittäjien kohdatessa prosesseihin liittyviä sisällöllisiä ongelmia, tulee ongelmat ratkoa projektipäällikön avustuksella.

Toteutusvaiheessa olennaista on tarvittavien testausmenettelyjen noudattaminen. Lisäksi loppukäyttäjät tulee sitoa mukaan testaukseen mahdollisimman aikaisessa vaiheessa ennen käyttöönottoa.

6. Testaussuunnitelma

Projektin kuluessa tulee noudattaa hyväksi todettuja testausmenettelyjä. Testausmenettelyjä tulee soveltaa niin määrittelyihin kuin varsinaisiin ohjelmistototeutuksiin.

Periaatteet ovat seuraavat:

Testataan toiminnallisuudet käyttämällä toimintojen käyttäjätarinoita viitekehyksenä.
Testataan toiminnallisuudet joko käytettävyyden näkökulmasta tai rajapintojen kohdalta teknisiä rajapintakuvaksia vasten.
Testaajien tulee parhaansa mukaan yrittää löytää poikkeavia toimintatapoja, joihin ei määrittelyssä ole voitu ennakoida
Jokaisesta virhetilanteesta tulee tehdä virheraportti

Järjestelmän tietoturvallisuus tulee käydä läpi tarvittaessa penetraatiotestauksella.

Lisäksi eri vaiheissa sovelletaan seuraavia periaatteita:

6.1 Määrittelyt ja käyttöliittymäprotot

Määrittelyjen pohjalla olevien prosessien prosessikuvaukset tulee olla hyväksytettyjä ao. prosessit omistavissa Metropolian yksiköissä.

Määrittelyt tulee käydä läpi vähintään vertaistarkistuksen kautta. Tavoitteena on, että koko Metropolian kehitystiimi on käynyt läpi määrittelyt vähintään omalta osaltaan. Lisäksi eri osioiden määrittelydokumentit tulee käydä osiot toteuttavien kehittäjien kautta.

Määrittelyissä mukana olevat käyttölittymäprotot tulee olla tarkastettu Metropolian käyttöliittymä asiantuntijoilla, mikäli niitä ei ole tehty heidän toimestaan.

6.2 Kehitysvaihe: palveluväylä

Palveluväylän toimintojen ja liittymärajapintojen testaus tehdään aina teknisissä määrittelyissä olevia teknisiä kuvauksia vasten, eli rajapintojen muodostamat tiedot tulee vastata määrittelyjä. Vähin hyväksyttävä taso on täsmällinen määrittelyjen vastaavuus.

Mikäli kolmannen osapuolen rajapinnoissa pystyy käyttämään esim. xml-tiedoston validointia, tulee näitä tekniikoita käyttää.

Sovelluskehityksessä tulee käyttää mahdollisuuksien mukaan yksikkötestausta, mutta tämä ei ole vähimmäistaso, jolla testaus voidaan katsoa suoritetuksi.

6.3 Kehitysvaihe: asiointisovellus

Asiointisovelluksen testaus koostuu kahdesta osasta: ohjelmistotestaus ja käytettävyystestaus.

Ohjelmistotestauksessa sovelletaan samoja periaatteita kuin palveluväylän testauksessa.

Näiden periaatteiden lisäksi tulee asiointisovelluksen osalta tehdä myös mahdollisuuksien käytettävyystestaus. Vähimmäistasolla asiointisovelluksen käyttöliittymä tulee käydä läpi toteuttajan ja käytettävyyssuunnittelijan kanssa ja sopivalla vertaiskäyttäjä testauksella.

Lisäksi, koska asiointisovellus on selainkäyttöinen sovellus, tulee asiointisovelluksen toiminnallisuus varmistaa yleisimmillä käytössä olevilla selainohjelmistoilla Windows 7 ja Mac-alustoilla.

6.4 Käyttöottovaiheen testaukset

Käyttöönottovaiheessa tehtävien ongelmien korjaamiseksi tehtävä korjaukset voidaan viedä tuotantoon nopeammalla testaussyklillä, mutta vähimmäistason testauksesta ei saa tinkiä. Yhtään testaamatonta komponenttia ei saa viedä käyttöönottovaiheessa olevaan järjestelmään.

6.5 Ylläpitovaiheen testaukset

Samat testausperiaatteet kuin kehitys- ja ylläpitovaiheessa pätevät myös ylläpitovaiheessa. Olennaista on hallitun testausmenettelyn ylläpitämiseksi on rakentaa ylläpito vaiheen ajaksi malli, jossa on olemassa järjestelmästä seuraavat ympäristöt:

kehitysympäristö: uudet ominaisuudet ja kehittäjätestaus tapahtuvat tässä ympäristössä. Kehitysympäristöt voivat sijaita kehittäjien omilla tietokoneilla, kunhan ohjelmistokoodien hallinnassa käytetään versionhallintaympäristöä.
hyväksymistestausympäristö: ennen tuotantoon siirtoa loppukäyttäjät testaavat uudet ominaisuudet ja korjaukset tässä ympäristössä. Ympäristö vastaa mahdollisimman hyvin tietosisällöltään tuotantoympäristöä.
tuotantoympäristö: tässä ympäristössä tapahtuu tuotantokäyttö. Tuotantoympäristössä ei testata.

7. Käyttöönottosuunnitelma

Järjestelmän ensi julkaisu tuotantoon tehdään vasta, kun järjestelmän Metropolian sisäinen tilaaja on hyväksynyt järjestelmän hyväksymistestausympäristössä.

Järjestelmän käyttöönotto suoritetaan aina siten, että uudet ominaisuudet ja korjaukset hyväksytetään testauksesta vastaavilla henkilöillä ennen ominaisuuksien siirtoa tuotantojärjestelmään.

8. Ylläpitosuunnitelma

Järjestelmän ylläpidossa tulee huolehtia seuraavista asioista:

varmistukset: järjestelmän tuottamista tiedoista pitää ottaa säännöllisesti varmistukset. Tietokannoista pitää tämän vuoksi ottaa päivitykset mieluiten päivittäin (koko tietokanta).
palvelutaso: järjestelmän asiointisovelluksen käytön pitää olla lähes katkeamatonta. Järjestelmä saa olla pois käytöstä suunniteltuina käyttökatkosaikoina, jolloin käyttäjälle ilmoitetaan palvelun etusivulla käyttökatkosta (nk. huoltotila).
skaalautuvuus: kun järjestelmään lisätään avoimen ammattikorkeakoulun toiminnot, tulee käytössä olemaan selviä korkeamman käytön jaksoja. Näihin tulee varautua.
muutoksen hallinta: järjestelmään ei lisätä uusia ominaisuuksia ilman suunnitelmallista toimintaa. Järjestelmän omistajalla Metropoliassa on velvollisuus ja vastuu koordinoida järjestelmässä tapahtuvia muutoksia.

Tyhjäpohja: Prosessikuvaus

Vaiheen nro	Mitä tapahtuu?	Kuka tekee?	Millä tavalla?	Mikä on lopputulos?
1.

Tyhjäpohja: Käyttötapaus

	Käyttötapauksen nimi

Yleiskuvaus

Laatija
Päiväys
Prosessi

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys

Esitiedot/Ehdot

	Käyttötapauksen kuvaus	Viittaus
1.
2.
3.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3

	Avoimet Asiat
A1
A2
A3

Käyttötiheys

Muuta

Child pages

Määrittelyt

1. Johdanto

1.1 Projektin tavoite ja aikataulu

1.2 Projektitoimijat

1.2 Kehittävät tietojärjestelmät sekä niiden tietoliittymät muihin tietojärjestelmiin

1.3 Kehitettävien tietojärjestelmien käyttökohteet sekä ominaisuudet

1.4 Määrittelyssä ja suunnittelussa sovellettavat periaatteet

2. Tuettavat prosessit

2.1 Harkinnanvarainen lisäajan haun käsittelymaksun kerääminen

2.1.1 Nykyinen toimintaprosessi

2.1.2 Prosessinomistajan toivoma sähköisen prosessin tavoitetila

2.1.3 Prosessinomistajan vähimmäisvaatimukset

2.1.4 Järjestelmällä tuettava sähköinen prosessi ja prosessiin liittyvät käyttötapaukset

!!! Selvitettävät kysymykset !!!

2.2 Opiskeluoikeuden palauttamisen käsittelymaksun kerääminen

2.2.1 Nykyinen toimintaprosessi

2.2.2 Prosessinomistajan toivoma sähköisen prosessin tavoitetila

2.2.3 Järjestelmällä tuettava sähköinen prosessi ja prosessiin liittyvät käyttötapaukset

!!! Selvitettävät kysymykset !!!

2.3 Erikoistumisopintojen opiskelijamaksun kerääminen

2.3.1 Nykyinen toimintaprosessi

2.3.2 Prosessinomistajan toivoma sähköisen prosessin tavoitetila

2.3.3 Järjestelmällä tuettava sähköinen prosessi ja prosessiin liittyvät käyttötapaukset

Selvitettävät asiat:

3. Järjestelmäarkkitehtuuri

4. Tietojärjestelmä määrittelyt

4.1 Asiointipalvelu

4.1.1 Toiminnallisuudet, käyttötapaukset ja käyttöliittymäprotot

4.1.1.2 Kaikille käyttäjille suunnatut toiminnallisuudet

4.1.2 Rajapinnat

4.1.3 Raportit ja listaukset

4.1.5 Käyttöoikeudet ja työnkulut

4.1.6 Tekniset vaatimukset

4.2 Palveluväylä

4.2.1 Toiminnallisuudet ja käyttötapaukset

4.2.1.1 Toiminnallisuudet ja käyttötapaukset: asiointipalvelutoiminnot

4.2.1.2 Toiminnallisuudet ja käyttötapaukset: maksupalvelutoiminnot

4.2.1.3 Toiminnallisuudet ja käyttötapaukset: tunnistustoiminnot

4.2.1.4 Toiminnallisuudet ja käyttötapaukset: talousautomaation toiminnot

4.2.2 Toimintojen Webservice-rajapinnan kuvaukset

4.2.3 Maksu- ja tunnistustoiminnallisuuksien Vetuma-rajapintojen kuvaukset

4.2.4 Talousautomaation rajapinnan kuvaukset

4.2.5 Tietomalli ja tietokanta

4.2.5.1 User-taulu: Käyttäjätiedot

4.2.5.2 Person-taulu: Henkilötiedot

4.2.5.3 PersonAddress-taulu: Henkilön osoitetiedot

4.2.5.4 Product-taulu: Tuote tiedot

4.2.5.5 StudyImplementation-taulu: Opintojaksototeutus tiedot

4.2.5.6 Assignment-taulu: Toimeksianto-taulu

Tietokanta - Käsitekartta

Tietokanta - taulut

Puuttuvat kentät:

4.2.6 Tekniset vaatimukset

4.2.7 OPI-Maksut projektin vaatimuksien huomioon ottaminen

5. Toteutussuunnitelma

6. Testaussuunnitelma

6.1 Määrittelyt ja käyttöliittymäprotot

6.2 Kehitysvaihe: palveluväylä

6.3 Kehitysvaihe: asiointisovellus

6.4 Käyttöottovaiheen testaukset

6.5 Ylläpitovaiheen testaukset

7. Käyttöönottosuunnitelma

8. Ylläpitosuunnitelma