Dokumentti	Verkkomaksut - projekti - Määrittelyt
Versio / Päiväys	0.80 92 / 273.45.2012
Päivitykset	15.3.2012: Luotu dokumenttipohja 27 3.45.2012: Ensimmäisen version muokkausta (keskeneräinen) Kommenttikierroksella!

1. Johdanto

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

...

Rooli	Henkilö
Laskutusjärjestelmän toimittajan asiantuntija	Anu Stenbacka, Aditro
Rajapinnat ja palveluväylä	Lauri Viitanen !!! 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

...

Kehitettä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:

...

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 Jaon perusteena on seuraavat periaatteet:

...

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 kerrosSovellusalustakerros:
- 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 kerrosSovelluslogiikkakerros:
- Sovellusalustan toiminnallisuuksien lisäksi tarvitaan käyttöliittymän toiminnallisuuksia varten sovelluslogiikkoja ja -luokkia.
Käyttöliittymä kerrosKä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 noudattamiseenstandardien mukaisesti.

Metropoliassa ja myös OPI-projektissa palveluväylä toteutukset 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.

...

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 Asiointipalvelusivuston on tarkoitustoimia tarkoitus toimia 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 Asiointipalvelun tekniset ratkaisut tullaan suunnittelemaan siten, että uusien palveluiden lisääminen tulee olemaan mahdollista tulevaisuudessa.

...

Yleiskuvaus

Asiointipalvelun etusivu on palvelun käytön aloituspiste. Sivulla näytetään asiontipalvelussa asiointipalvelussa kaikille avoimet palvelut sekä annetaan mahdollisuus kirjautua palvelun käyttöön. Lisäksi etusivulla voidaan näyttää käyttöä helpottavia toimintoja, kuten pikalinkkejä usein käytettäviin toimintoihin.
Palveluun kirjautuneelle käyttäjälle ja kirjautumattomalle selailijalle voidaan näyttää erilainen sisältö. Kirjautuneelle käyttäjälle voidaan näyttää suoritettavien toimeksiantojen listaus.

...

	Käsittelysäännöt
K1	Vahvasti tunnistamaton käyttäjä: vain osa oikeuksista.
K2	Vahvasti tunnistautuneella henkilöllä on olemassa voimassa oleva metropolia tunnus: ohjataan tunnuksen käyttöön.
K3	Vahvasti tunnistautuneella henkilöllä on olemassa ei voimassa oleva metropolia tunnus: yhdistellään tietolähteistä henkilön tietoja !!! Missä järjestyksesä !!!, mutta Metropolia tunnusta ei voi käyttää kirjautumiseen.
K4	Tunnistettassa Tunnistettaessa henkilö vahvasti, käyttäjä havaitaan olevan jo järjestelmässä: aktivoidaan vanha tunnus uudelleen käyttöön, mikäli tunnus on suljettu. Joka tapauksessa pyydetään käyttäjää vaihtamaan salasanansa, koska se on ilmeisesti unohtunut (ei metropolia tunnuksia). Metropolia tunnukset omaava ohjataan käyttämään ko. tunnuksia.

...

	Käyttötapauksen kuvaus	Viittaus
1.	Käyttäjä kirjautuu asiointijärjestelmään ja valitsee omien tietojen muokkaus -toiminnon.
2.	Käyttäjä tekee muokkaukset ja tallentaa ne.	T1
3.	Asiointisovellus lähettää muutokset palveluväylään, joka käsittelyn jälkeen tallentaa muutokset tai hylkää ne.	Määrittelyn kohta Palveluväylä toiminto: Asiakkaan muokkaus, T2 tai T3
4.	Palveluväylän palaute lähetetään asiointisovellukselle, joka näyttää palautteen käyttäjälle.	T4

...

	Poikkeukset
P1	Muokkauksen tiedot ei täytä vähimmäisvaatimuksia: muokkaus hylätään.
P2	Muokkauksen tiedot ei täytä muotovaaitimuksiamuotovaatimuksia: muokkaus hylätään

	Muut vaatimukset
V1	Pakolliset kentät määritellään tietokanta määrittelyissä.

...

Esitiedot/Ehdot

Käyttäjällä on voimassa oleva Metropolia tunnus, asionti-tunnus asiointitunnus tai käyttäjä käyttää kirjautuessaan Tupas-tunnuksia.

	Käyttötapauksen kuvaus	Viittaus
1.	Käyttäjä käynnistää kirjautumisen linkin takaa.
2.	Käyttäjä valitsee kirjautumis tavankirjautumistavan: sähköpostiosoite, metropolia-tunnus tai kirjautuminen pankkitunnuksilla.	T1 TAI T2 TAI T3
3.	Palveluväylä käsittelee käyttäjän kirjautumisen käyttäjän antamien syöteiden perusteella syötteiden perusteella.	T4 TAI T5
4.	Asiointisovellus käsittelee käyttäjän kirjautumisesta saadun vasteen ja näyttää tuloksen käyttäjälle. Onnistuneen kirjautumisen jälkeen käyttäjä on kirjautunut järjestelmään käyttäjätietojen sallimalla käyttäjätasolla.

...

	Poikkeukset
P1	Käyttäjää ei tunnisteta millään tunnistautumismenetelmällä: epäonnistunut kirjautuminen.
P2	Käyttäjä käyttää vahvaa tunnistautumista, mutta hänelle ei löydy käyttäjäprofiilia: käyttäjä siirretään automaattisesti rekisteröitymisprosessiin. ??? Tarvitseeko sen jälkeen tunnistautua uudelleen ???

	Muut vaatimukset
V1

	Käsittelysäännöt
K1

...

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kirjautumaton käyttäjä	Voi käyttää vain kaikille avoimia toimintoja. Toiminnot näytetään toimintolistalla.	Listalla näytetään seuraavat toiminnot: Harkinnanvarainen lisäaika - käsittelymaksu Opinto-oikeuden palauttaminen - käsittelymaksu
Kirjautunut käyttäjä - Normaalikäyttäjä	Voi käyttää vain kaikille avoimia toimintoja. Toiminnot näytetään toimintolistalla.	Listalla näytetään seuraavat toiminnot: Harkinnanvarainen lisäaika - käsittelymaksu Opinto-oikeuden palauttaminen - käsittelymaksu Avoimet toimeksiannot	Tarvittaessa
Kirjautunut käyttäjä - Metropolian opiskelija, voimassa oleva opiskeluoikeus	Rajoitetut oikeudet. Avoimien toimintojen lisäksi oikeudet-kentän toiminnot.	Kaikille avoimien lisäksi näytetään seuraavat toiminnot: Huom! Listalta suodatetaan pois Opinto-oikeuden palauttaminen.	Tarvittaessa
Kirjautunut käyttäjä - Metropolian opiskelija, ei voimassa olevaa opiskeluoikeutta	Rajoitetut oikeudet. Avoimien toimintojen lisäksi oikeudet-kentän toiminnot.	Kaikille avoimien lisäksi näytetään seuraavat toiminnot: Huom! Listalta suodatetaan pois Harkinnanvarainen lisäaika.	Tarvittaessa
Kirjautunut käyttäjä - Metropolian työntekijä	Rajoitetut oikeudet. Vain avoimet toiminnot.		Tarvittaessa
Kirjautunut käyttäjä - opintotoimisto käyttäjä	Rajoitetut oikeudet. Avoimien toimintojen lisäksi oikeudet-kentän toiminnot.	Kaikille avoimien lisäksi näytetään seuraavat toiminnot: Käsittelymaksujen listaus - Harkinnanvarainen lisäaika Käsittelymaksujen listaus - Opinto-oikeuden palauttaminen	Tarvittaessa
Kirjautunut käyttäjä - hakutoimisto käyttäjä	Rajoitetut oikeudet. Avoimien toimintojen lisäksi oikeudet-kentän toiminnot.	Kaikille avoimien lisäksi näytetään seuraavat toiminnot: Erikoistumisopintojen opintomaksun lisääminen Erikoistumisopintojen opintomaksun ylläpito Opintomaksujen listaus - Erikoistumisopintojen opintomaksut	Tarvittaessa
Kirjautunut käyttäjä - taloushallinto	Rajoitetut oikeudet. Avoimien toimintojen lisäksi oikeudet-kentän toiminnot.	Kaikille avoimien lisäksi näytetään seuraavat toiminnot: Käsittelymaksujen seuranta Opintomaksujen seuranta Maksettujen tapahtumien siirto IntimePlussaan	Tarvittaessa
Kirjautunut käyttäjä - pääkäyttäjä	Pääkäyttäjällä on kaikki oikeudet	Kaikki toiminnot	Tarvittaessa
Kirjautunut käyttäjä - ylläpito	Ylläpito käyttäjällä on käytössä avoimien toimintojen lisäksi vain ylläpitotoiminnot.	Kaikille avoimien lisäksi näytetään seuraavat toiminnot: Lokin katselu Järjestelmän siirto ylläpitotilaan.	Tarvittaessa

...

	Käyttötapauksen kuvaus	Viittaus
1.	Käyttäjä selaa asiointipalveluun. Palvelun etusivulla näytetään lista kaikille avoimista toiminnoista.	T1
2.	Käyttäjä kirjautuu omalla käyttäjätunnuksellaan järjestelmään. Käyttäjälle näytetään lista hänen käyttäjäprofiilin mukaisista toiminnoista.	T1

	Tulokset
T1	Käyttäjälle suodatattu käyttäjäprofiilin mukainen toimintolista.

	Poikkeukset
P1	Käyttäjä yrittää käyttää toimintoa, johon hänellä ei ole oikeutta: järjestelmän tulee sulkea hänet toiminnosta ulos.

...

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kaikki asiontikäyttäjät asiointikäyttäjät		Oikeus suorittaa käsittelymaksu	Tarvittaessa

...

	Käyttötapauksen kuvaus	Viittaus
1.	Käyttäjä aloittaa käsittelymaksun maksamisen joko kirjautuneen tai kirjautumattomana.
2.		Käyttäjältä kysytään tarvittavat tiedot käsittelymaksun suorittamiseksi.	T1
3.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

Kun käsittelymaksu on valmis suoritettavaksi, käyttäjältä kysytään hänen haluamansa maksutapa.	T2
4.	Käyttäjä palautuu hyväksytyn tai hylätyn maksutapahtuman jälkeen asiointipalveluun ja hänelle näytetään maksamisen lopputulos.	T3

	Tulokset
T1	Maksukelpoinen käsittelymaksu
T2	Maksamisen ohjattu toiminto, kts. vastaava kohta määrittelyn käyttötapauksista.
T3	Palveluväylän palauttama maksutapahtuman lopputulos.

	Poikkeukset
P1	Maksaminen epäonnistuu: tietokantaan jää kesken jäänyt tapahtuma, mutta ao. toimeksiantotapahtumaa ei voi suorittaa loppuun.
P3
	Muut vaatimukset
V1
V2
V3

Käsittelysäännöt	Muut vaatimukset
V1 K1	K2

	Käsittelysäännöt
K3 K1

	Avoimet Asiat
A1
A2
A3
Mitä tietoja tarvitaan/kysytään käsittelymaksun suorittamiseksi?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Ohjattu toiminto: Harkinnanvarainen lisäaika - käsittelymaksun suoritus

...

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

Kaikki asiointikäyttäjät		Oikeus suorittaa käsittelymaksu	Tarvittaessa

Esitiedot/Ehdot

Ei ennakkoehtoja

	Käyttötapauksen kuvaus	Viittaus
1.	Käyttäjä aloittaa käsittelymaksun suorittamisen joko kirjautuneena tai kirjautumattomana.
2.		Käyttäjältä kysytään tarvittavat tiedot käsittelymaksun suorittamiseksi.	T1
3.	Kun käsittelymaksu on valmis suoritettavaksi, käyttäjältä kysytään hänen haluamansa maksutapa.	T2
4.	Käyttäjä palautuu hyväksytyn tai hylätyn maksutapahtuman jälkeen asiointipalveluun ja hänelle näytetään maksamisen lopputulos.	T3

		Tulokset
T1	Maksukelpoinen käsittelymaksu.
T2	Maksamisen ohjattu toiminto, kts. vastaava kohta määrittelyn käyttötapauksista.
T3	Palveluväylän palauttama maksutapahtuman lopputulos.

	Poikkeukset
P1		Maksaminen epäonnistuu: tietokantaan jää kesken jäänyt tapahtuma, mutta ao. toimeksiantotapahtumaa ei voi suorittaa loppuun.


P2
P3
	Muut vaatimukset
V1		V2


V3
	Käsittelysäännöt
K1
K2

K3		Avoimet Asiat
A1
A2
A3	Mitä tietoja tarvitaan/kysytään käsittelymaksun suorittamiseksi?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Käyttöliittymä näkymä: Avoimet toimeksiannot

Yleiskuvaus
Käyttäjälle näytetään hänelle avoimet toimeksiannot. Ko. näkymä voidaan näyttää missä tahansa näkymässä.

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

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

Kirjautunut käyttäjä		Vain omat toimeksiannot

Esitiedot/Ehdot

Käyttäjä on kirjautunut järjestelmään.

		Käyttötapauksen kuvaus	Viittaus
1.		Käyttäjä kirjautuu asiointipalveluun käyttäjätunnuksellaan.	T1
2.	Käyttäjälle näytetään hänen avoimet toimeksiantonsa, jolloin hän voi suorittaa toimeksiannon loppuun.
3.		Käyttäjä valitsee toimeksiannon suoritettavaksi, jolloin näytetään ko. toimeksiannon käsittelynäkymä.	T2

	Tulokset
T1	Kirjautunut käyttäjä
T2	Toimeksiannon suorittaminen.

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1		V2		V3

	Käsittelysäännöt
K1	Käyttäjän tulee olla kirjautunut järjestelmään.
K2		Käyttäjälle näytetään vain hänelle kohdistetut toimeksiannot. K3

		Avoimet Asiat
A1
A2
A3

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Avoin toimeksianto: Erikoistumisopintojen opintomaksun suorittaminen

Yleiskuvaus
Erikoistumisopintojen suorittamisesta peritään opiskelijalta opintomaksu, joka tulee suorittaa ilmoittautumisen yhteydessä.

Laatija	Tero Hakkarainen
Päiväys	30.4.2012
Prosessi	Tämän määrittelyn kohta 2.3.3

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

Kirjautunut käyttäjä - Opintomaksu toimeksianto asetettu		Oikeus maksaa	Tarvittaessa

Esitiedot/Ehdot

Käyttäjän tulee olla kirjautunut käyttäjä.
Käyttäjälle tulee olla asetettuna opintomaksun toimeksianto.

		Käyttötapauksen kuvaus	Viittaus
1.		Käyttäjä kirjautuu asiointipalveluun käyttäjätunnuksellaan.	T1
2.		Käyttäjä näkee opintomaksun avoimen toimeksiannon ja valitsee maksun suoritettavaksi.	T2
3.		Käyttäjän valittua opintomaksu suoritettavaksi, käyttäjältä kysytään hänen haluamansa maksutapa.	T3
4.	Käyttäjä palautuu hyväksytyn tai hylätyn maksutapahtuman jälkeen asiointipalveluun ja hänelle näytetään maksamisen lopputulos.	T4

	Tulokset
T1	Kirjautunut käyttäjä
T2	Toimeksiannon suoritus käynnistetty.
T3	Maksamisen ohjattu toiminto, kts. vastaava kohta määrittelyn käyttötapauksista.
T4	Palveluväylän palauttama maksutapahtuman lopputulos.

	Poikkeukset
P1	Käyttäjä ei ole kirjautunut: ei mahdollista suorittaa maksua.
P2		P3	Maksaminen epäonnistuu: tietokantaan jää kesken jäänyt tapahtuma, mutta ao. toimeksiantotapahtumaa ei voi suorittaa loppuun. !!! Miten ratkotaan tämä tilanne? !!!

	Muut vaatimukset
V1		V2		V3

		Käsittelysäännöt
K1
K2
Käyttäjä haluaa laskun opintomaksusta: käyttäjä ilmoittaa tästä erillisessä prosessissa.	K3

	Avoimet Asiat
A1
A2
A3
Mitä jos maksuprosessi jää jumiin?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Ohjattu toiminto: maksaminen verkkomaksulla

Yleiskuvaus
Käyttäjä suorittaa maksun verkkomaksulla.

Laatija	Tero Hakkarainen
Päiväys	30.4.2012
Prosessi	Verkkomaksut - Asiointipalvelu - Maksutoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kaikki käyttäjät - Maksettava maksu		Vain ko. maksu - Maksaminen	Tarvittaesssa

Esitiedot/Ehdot

	Viittaus
1.	Käyttäjä valitsee toimeksiannon maksun suorittamisen maksutavan valinnasta maksutavaksi jonkin tietyn pankin verkkomaksun.	T1
2.	Maksutapatuman hallinta siirretään valitun pankin verkkomaksun maksu käyttöliittymiin. Käyttäjä suorittaa maksun.	T2 TAI T3
3.	Maksun suorittamisen jälkeen käyttäjä palautetaan takaisin asiointijärjestelmään, jolloin hänelle näytetään palaute suoritetusta maksusta.	T4

	Tulokset
T1	Valittu verkkomaksu maksutavaksi.
T2

	Poikkeukset
P1
P2
P3

Onnistunut maksaminen verkkomaksulla.
T3	Epäonnistunut maksaminen verkkomaksulla.
T4	Käyttäjälle näytettävissä oleva palaute maksutapahtumasta.

	Poikkeukset
P1	Epäonnistunut maksutapahtuma: käyttäjälle näytetään selväkielinen virheilmoitus tilanteesta. Tilapäisen häiriön vuoksi epäonnistunut maksu tarjotaan uudelleen suoritettavaksi. Epäselvissä tilanteissa tilanne keskeytetään ja tilanteesta ilmoitetaan pääkäyttäjille.

		Muut vaatimukset
V1		V2


V3
	Käsittelysäännöt
K1		Käyttäjä voi suorittaa vain yhden tietyn maksun kerrallaan, mutta maksutapahtuma/toimeksianto voi sisältää useamman rivin (maksu koostetaan useammasta kuin yhdestä rivistä. K2


K3
	Avoimet Asiat
A1
A2
A3
Miten toimitaan poikkeustapauksissa? (keskeytynyt maksutapahtuma, virheellinen palaute jne.

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Ohjattu toiminto: maksaminen luottokortilla

Yleiskuvaus
Käyttäjä suorittaa maksun luottokortilla.

Laatija	Tero Hakkarainen
Päiväys	30.4.2012
Prosessi	Verkkomaksut - Asiointipalvelu - Maksutoiminnot

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

Kaikki käyttäjät - Maksettava maksu		Vain ko. maksu - Maksaminen	Tarvittaessa

Esitiedot/Ehdot

	Viittaus
1.	Käyttäjä valitse toimeksiannon maksun suorittamisen maksutavan valinnasta maksutavaksi luottokorttimaksun. Samalla valitaan luottokortti tyyppi.	T1
2.	Maksutapahtuman hallinta siirretään valitun luottokorttimaksu tyypin käyttöliittymään. Käyttäjä suorittaa maksun.	T2 TAI T3
3.	Maksun suorittamisen jälkeen käyttäjä palautetaan takaisin asiointijärjestelmään, jolloin hänelle näytetään palaute suoritetusta maksusta.	T4

	Tulokset
T1	Valittu luottokortti maksutavaksi. Valittu tietty luottokorttityyppi.
T2	Onnistunut maksaminen luottokortilla.
	Poikkeukset
T3	Epäonnistunut maksaminen luottokortilla.
T4	Käyttäjälle näytettävissä oleva palaute maksutapahtumasta. P1

P2

	Poikkeukset		P3
P1	Epäonnistunut maksutapahtuma: käyttäjälle näytetään selväkielinen virheilmoitus tilanteesta. Tilapäisen häiriön vuoksi epäonnistunut maksu tarjotaan uudelleen suoritettavaksi. Epäselvissä tilanteissa tilanne keskeytetään ja tilanteesta ilmoitetaan pääkäyttäjille.

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3 Käyttäjä voi suorittaa vain yhden tietyn maksun kerrallaan, mutta maksutapahtuma/toimeksianto voi sisältää useamman rivin (maksu koostetaan useammasta kuin yhdestä rivistä.

		Avoimet Asiat
A1	Miten toimitaan poikkeustapauksissa? (keskeytynyt maksutapahtuma, virheellinen palaute jne.

Käyttötiheys		A2
A3

Käyttötiheys Muuta

Muuta

...

		Käyttötapauksen nimi
	Ohjattu Hakutoimiston toiminto: Erikoistumisopintojen opintomaksun lisääminen

Yleiskuvaus
Erikoistumisopintojen hakuvalintojen jälkeen valittujen opiskelijoiden tulee suorittaa opintomaksu. Tällä käyttöliittymällä lisätään opiskelijalle kohdistettu opintomaksu toimeksianto.

Laatija	Tero Hakkarainen
Päiväys	30.4.2012
Prosessi	Tämän määrittelyn kohta 2.3.3

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kirjautunut käyttäjä - Hakutoimisto		Toimeksiannon lisäys	Tarvittaessa
Kirjautunut käyttäjä - Pääkäyttäjä		Toimeksiannon lisäys	Tarvittaessa

Esitiedot/Ehdot

Käyttäjän tulee olla kirjautunut järjestelmään tarvittavilla käyttöoikeuksilla.

	Käyttötapauksen kuvaus	Viittaus
1.		Hakutoimiston työntekijä kirjautuu asiointijärjestelmään omilla tunnuksillaan.	T1
2.	Työntekijä valitsee toimintolistalta toiminnon "Erikoistumisopintojen opintomaksun lisääminen".
3.		Työntekijä syöttää tarvittavat tiedot maksun kohdistamiseksi opiskelijalle ja tallentaa toimeksiannon.	T2

	Tulokset
T1	Kirjautunut käyttäjä
T2	Avoin toimeksianto: Erikoistumisopintojen opintomaksu.

	Poikkeukset
P1		P2


P3
	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1		K2


K3
	Avoimet Asiat
A1
A2
Mitkä ovat tarvittavat tietokentät opintomaksun perustamiseksi?	A3

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Hakutoimiston toiminto: Erikoistumisopintojen opintomaksujen ylläpito

Yleiskuvaus
Hakutoimiston työntekijät voivat käydä ylläpitämässä opiskelijoille lisättyjä opintomaksu toimeksiantoja esimerkiksi sellaisissa tapauksissa, joissa opiskelija pyytää opintomaksusta laskun.

Laatija	Tero Hakkarainen
Päiväys	30.40.2012
Prosessi	Tämän määrittelyn kohta 2.3.3

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kirjautunut käyttäjä - Hakutoimisto		Toimeksiannon muokkaus	Tarvittaessa
Kirjautunut käyttäjä - Pääkäyttäjä		Toimeksiannon muokkaus	Tarvittaessa

Esitiedot/Ehdot

Käyttäjän tulee olla kirjautunut järjestelmään tarvittavilla käyttöoikeuksilla.
Toimeksiantoon tulee suorittaa jokin ylläpitotoimenpide.

	Käyttötapauksen kuvaus	Viittaus
1.		Hakutoimiston työntekijä kirjautuu asiointijärjestelmään omilla tunnuksillaan.	T1
2.		Työntekijä valitsee toimintolistalta toiminnon "Erikoistumisopintojen opintomaksun ylläpito".	T2
3.	Työntekijä valitsee listalta opintomaksutoimeksiannon, jonka muokkaamiseksi hänellä on oikeudet. Avautuu toimeksiannon muokkaus ikkuna.
4.	Työntekijä syöttää tarvittavat tiedot maksun kohdistamiseksi opiskelijalle ja tallentaa toimeksiannon.	T3

	Tulokset
T1	Kirjautunut käyttäjä
T2	Lista muokattavaista erikoistumisopintojen opintomaksutoimeksiannoista.
T3	Päivitetty toimeksianto.

	Poikkeukset
P1		P2		P3

		Muut vaatimukset
V1
V2

V3			Käsittelysäännöt
K1
K2
K3
Toimeksianto on suoritettu: ei näytetä muokattavien listalla.

	Avoimet Asiat
A1
A2
A3
Mitkä ovat tarvittavat tietokentät opintomaksun perustamiseksi?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Hakutoimiston toiminto: Opintomaksujen listaus - Erikoistumisopintojen opintomaksut

Yleiskuvaus
Hakutoimiston työntekijällä on mahdollisuus saada listattua Erikoisopintojen opintomaksu toimeksiannot.

Laatija	Tero Hakkarainen
Päiväys	30.4.2012
Prosessi	Tämän määrittelyn kohta 2.3.3

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kirjautunut käyttäjä - Hakutoimisto		Listaus	Tarvittaessa
Kirjautunut käyttäjä - Pääkäyttäjä		Listaus	Tarvittaessa

Esitiedot/Ehdot

Käyttäjän tulee olla kirjautunut järjestelmään tarvittavilla käyttöoikeuksilla.

	Viittaus
1.	Hakutoimiston työntekijä kirjautuu asiointijärjestelmään omilla tunnuksillaan.	T1
2.	Työntekijä valitsee toimintolistalta toiminnon "Erikoistumisopintojen opintomaksujen listaus".	T2
3.	Työntekijä asettaa valitsemansa suodatustekijät listalle. Näytetään suodatettu lista.	T3

	Tulokset
T1	Kirjautunut käyttäjä.
T2	Suodatustavan ja -tietojen valinta.
T3	Käyttäjän valinnoilla suodatettu listaus.

	Poikkeukset
P1		P2


P3
	Muut vaatimukset
V1	V2


V3
	Käsittelysäännöt
K1		K2


K3
	Avoimet Asiat
A1	Mitkä tiedot voivat olla suodatustekijöitä?

Käyttötiheys

A2 Muuta

A3

...

Käyttötiheys

	Käyttötapauksen nimi

Muuta

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ää Metropolian kertakirjautumispalvelua, joka on rakennettu CAS-palveluksi.

4.1.3 Raportit ja listaukset

Asiontipalvelun käyttöliittymien kautta tarjotaan raportteja tai listauksia käyttäjien käyttöön. Raporttien tiedot haetaan palveluväylän kautta tietokannasta ja raporttien tulostamisen yhteydessä pitää pystyä suodattaa ja järjestää raporttia tai listausta ao. tietojoukon pääasiallisten suodatus- tai järjestelytapojen perusteella.

Loppukäyttäjä eli asiakas (opiskelija, erikoistumisopintohin ilmoittautuva, jne.)
- toimeksiannon listaus
prosessitoimija, opintotoimisto
- yhden toimeksiannon listaus
- avointen toimeksiantojen listaus
- vastaanotetut maksut raportti
prosessitoimija, hakutoimisto
- yhden toimeksiannon listaus
- avointen toimeksiantojen 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

Järjestelmään perustetaan seuraavat käyttöoikeusprofiilit:

loppukäyttäjä
loppukäyttäjä, Metropolian opiskelija
prosessitoimija, opintotoimisto
prosessitoimija, hakutoimisto
pääkäyttäjä
ylläpito

Kirjautumattomalla käyttäjällä on rajoitetut toiminnot. Jotkin toiminnot on rakennettu siten, että varsinaista henkilön tunnistautumista ei tarvita, vaan toiminnon seurauksena suoritettu maksutapahtuma on riittävä. Tällöin käyttäjän tulee itse huolehtia siitä, että antaa tarvittavat tiedot toiminnon seurauksen kohdistamiseen.

4.1.6 Tekniset vaatimukset

Asiontipalvelun tekniset vaatimukset ovat seuraavat:

php-palvelin !!! Mikä versio !!! !!! Mitkä konffivaatimukset !!!
- modrewrite tuki
ssl-salaus. Tuotantopalvelimessa ssl-sertifikaatit pitää vastata kolmannen osapuolen turvavaatimuksia, mikäli ko. vaatimuksia on asetettu esim. Vetuma-palveluntarjoajan toimesta.
!!! mitä muuta? !!!

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

...

Opintotoimiston toiminto: Käsittelymaksujen listaus - Harkinnanvarainen lisäaika

Yleiskuvaus
Opintotoimiston työntekijällä on mahdollisuus saada listattua Harkinnanvaraisen lisäajan käsittelymaksu listaus.

Laatija	Tero Hakkarainen
Päiväys	30.4.2012
Prosessi

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kirjautunut käyttäjä - Opintotoimisto		Listaus	Tarvittaessa
Kirjautunut käyttäjä - Pääkäyttäjä		Listaus	Tarvittaessa

Esitiedot/Ehdot

Käyttäjän tulee olla kirjautunut järjestelmään tarvittavilla käyttöoikeuksilla.

	Käyttötapauksen kuvaus	Viittaus
1.	Opintotoimiston työntekijä kirjautuu asiointijärjestelmään omilla tunnuksillaan.	T1
2.	Työntekijä valitsee toimintolistalta toiminnon "Käsittelymaksujen listaus - Harkinnanvarainen lisäaika".	T2
3.	Työntekijä asettaa valitsemansa suodatustekijät listalle. Näytetään suodatettu lista.	T3

	Tulokset
T1	Kirjautunut käyttäjä
T2	Suodatustavan ja -tietojen valinta.
T3	Käyttäjän valinnoilla suodatettu listaus.

	Poikkeukset
P1

	Muut vaatimukset
V1

	Käsittelysäännöt
K1

	Avoimet Asiat
A1	Mitkä tiedot voivat olla suodatustekijöitä?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Palveluväylä Opintotoimiston toiminto: Käyttäjän rekisteröityminen Käsittelymaksujen listaus - Opinto-oikeuden palauttaminen

Yleiskuvaus
Opintotoimiston työntekijällä on mahdollisuus saada listattua Opinto-oikeuden palauttamisen käsittelymaksu listaus
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 30.4.2012
Prosessi Verkkomaksuprojekti - Asiointi - Käyttäjätoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Kirjautunut käyttäjä - Opintotoimisto		Listaus	Tarvittaessa
Kirjautunut käyttäjä - Pääkäyttäjä		Listaus	Tarvittaessa	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 Käyttäjän 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.
kirjautunut järjestelmään tarvittavilla käyttöoikeuksilla.

	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
Opintotoimiston työntekijä kirjautuu asiointijärjestelmään omilla tunnuksillaan.	T1
2.	Työntekijä valitsee toimintolistalta toiminnon "Käsittelymaksujen listaus - Harkinnanvarainen lisäaika".	T2
3.	Työntekijä asettaa valitsemansa suodatustekijät listalle. Näytetään suodatettu lista.	T3

	Tulokset
T1	Kirjautunut käyttäjä
T2	Suodatustavan ja -tietojen valinta.
T3	Käyttäjän valinnoilla suodatettu listaus.
	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 Mitkä tiedot voivat olla suodatustekijöitä?

Käyttötiheys

Muuta

...

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

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat muokata käyttäjätietoja palveluväylän asiointisovellusten käyttäjärekisteriin Taloushallinnon työntekijöille on käytettävissä käyttöliittymä, jonka avulla he pystyvät seuraamaan asiointijärjestelmän kautta tuotettuja maksuja.

Laatija	Tero Hakkarainen
Päiväys	18 2.45.2012
Prosessi	Verkkomaksuprojekti Verkkomaksut - Asiointi Asionti - Käyttäjätoiminnot Talousautomaatio

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
Taloushallinnon työntekjiä		Luku	Tarvittaessa
Pääkäyttäjä		Luku	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella Käyttäjän 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.
kirjautunut asiointijärjestelmään.

	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
Taloushallinnon käyttäjä kirjautuu asiointijärjestelmään omilla tunnuksillaan.	T1
2.	Työntekijä valitsee toimintolistalta toiminnon "Maksujen seuranta".	T2
3.	Työntekijä voi selailla maksuja suoraan käyttöliittymästä. Työntekijä voi myös asettaa suodatuksen näkymälle.	T3

	Tulokset
T1	Tietokantaan päivitetty Kirjautunut käyttäjä .
T2 Palaute: Käyttäjän tiedot	Suodattamaton seurantanäkymä.
T3 Palautettu virheilmoitus: Hylätty käyttäjä	Käyttäjän välinnoilla suodatettu näkymä.

	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äsittelysäännöt
K1

	Avoimet Asiat
A1	Mitkä tiedot voivat olla suodatustekijöitä?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Palveluväylä Taloushallinnon toiminto: Asiakkaan lisääminen Maksettujen tapahtumien siirto IntimePlussaan

Yleiskuvaus
Maksutapahtumilla suoritetut maksutapahtumat siirretään talousautomaatiolla talousjärjestelmään käsiteltyinä tapahtumina. Toiminto voidaan ajaa käsin koe- ja lopullisena ajona. Lisäksi toiminto voidaan toteuttaa myös ajastettuna ajona, jolloin toiminto tapahtuu ajastettuna palveluväylä toimintona
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 30.4.2012
Prosessi	Verkkomaksuprojekti Verkkomaksut - Maksaminen Talousautomaatio - Asiakastoiminnot Siirto talousjärjestelmään

Käyttäjärooli	Oikeudet	Käyttötiheys
Käyttäjä - Taloushallinto	Siirto - Koeajo	Tarvittessa
Käyttäjä - Taloushallinto	Siirto - Lopullinen ajo	Tarvittassa
Käyttäjä - Ajastettu toiminto	Siirto - Lopullinen ajo	Ajastettuna, kerran vuorokaudessa. (Palveluväylä ajaa ajon!)	Asiointisovellus - Asiakkaat	Oikeus lisätä uusi asiakas	Uuden asiakkaan lisäys	Aina kun asiakas lisätään

Esitiedot/Ehdot

Asiointisovelluksella Käyttäjän tulee olla käyttöoikeus palveluväylän toimintoonkirjautunut järjestelmään tarvittavilla käyttöoikeuksilla.
Palveluväylään toimitetut asiakkaan tiedot Siirrettävien toimeksiantojen tulee olla tietosisällöltään vähimmäistasollatilassa "maksettu".

	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
Taloushallinnon käyttäjä kirjautuu asiointijärjestelmään omilla tunnuksillaan	T1
2.	Työntekijä valitsee toimintolistalta toiminnon "Maksettujen tapahtumien siirto IntimePlussaan"	T2
3.	Työntekijä asettaa valitsemansa ajotyyppi valinnan ajolle: lopullinen- tai koeajo. Järjestelmä antaa ajetun ajon tuloksen siirtotiedostona	5.	Palveluväylä palauttaa asiointisovellukselle tiedon asiakkaan hylkäyksestä ja välittää selväkielisen syyn asiakkaan hylkäykseen.	T3

	Tulokset
T1 Tietokantaan	Kirjautunut käyttäjä tallennettu asiakas.
T2 Palaute	Ajotyypin valinta : Asiakkaan tiedot
T3	Siirtotiedosto 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. Siirrettävien tapahtumien pitää olla "Maksettu"-tilassa.

	Avoimet Asiat
A1	Pitäisikö käyttäjä ja asiakas käsitellä saman käyttöliittymän läpiajoa voida suodattaa joillain hakutekijöillä?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Palveluväylä toiminto: Asiakkaan muokkaus	Ylläpitotoiminto: Lokien katselu

Yleiskuvaus
Asiointijärjestelmän pääkäyttäjillä ja ylläpitäjillä on käytössään käyttöliittymä, jolla pystyy tarkastelemaan järjestelmän lokeja
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 1.45.2012
Prosessi	Verkkomaksuprojekti Verkkomaksut - Maksaminen Asiointi - Asiakastoiminnot Ylläpito

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

Esitiedot/Ehdot

Asiointisovelluksella Toiminnon käyttäjän tulee olla käytöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut asiakkaan päivitystiedot tulee olla tietosisällöltään vähimmäistasollakirjautunut asiointijärjestelmään.

	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

Pääkäyttäjä kirjautuu asiontijärjestelmään omilla tunnuksillaan.	T1
2.	Käyttäjä valitsee toimintolistalta toiminnon "Lokien katselu"	T2
3.	Käyttäjälle näytetään näkymä lokitapahtumiin. Näkymää voi suodattaa eri hakutekijöillä.	T3

	Tulokset
T1	Kirjautunut käyttäjä
T2	Suodattamaton lokinäkymä.
T3	Käyttäjän valinnoilla suodatettu näkymä.

	Poikkeukset
P1

	Muut vaatimukset
V1	Suodatustekijä: ilmoitustyyppi
V2	Suodatustekijä: päivämäärä
V3	Suodatustekijä: käyttäjä

	Käsittelysäännöt
K1

	Avoimet Asiat
A1	Mitkä muut tiedot voivat olla suodatustekijöitä?
A2	Näytetäänkö lokissa kaikkien asiointijärjestelmän lokitallennukset vai vain ao. asiointisovelluksen?

Käyttötiheys

Muuta

...

	Käyttötapauksen nimi
	Ylläpitotoiminto: Järjestelmän ylläpitotilan hallinta

Yleiskuvaus
Asiointijärjestelmä voidaan siirtää ylläpitotilaan, jolloin mm. mitkään maksutoiminnallisuudet eivät toimi. Loppukäyttäjille näytetään tiedote järjestelmän tilanteesta sekä aika-arvio ylläpitotilanteen kestosta.

Laatija	Tero Hakkarainen
Päiväys	30.4.2012
Prosessi	Verkkomaksu - Asiointi - Pääkäyttäjän toiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Pääkäyttäjä		Tilan vaihtaminen	Tarvittaessa
Ylläpito		Tilan vaihtaminen	Tarvittaessa

Esitiedot/Ehdot

Käyttäjän tulee olla kirjautunut järjestelmään tarvittavilla käyttöoikeuksilla.

	Käyttötapauksen kuvaus	Viittaus
1.	Pääkäyttäjä tai ylläpitäjä kirjautuu järjestelmään omilla tunnuksillaan.	T1
2.	Käyttäjä valitse toimintolistalta toiminnon "Ylläpitotilan hallinta"
3.	Käyttäjä tekee tarvittavan ylläpitotoimenpiteen.	T2 TAI T3

	Tulokset
T1	Kirjautunut käyttäjä
T2	Järjestelmän ylläpito tilaan
T3	Järjestelmän normaali käyttötilaan

	Poikkeukset
P1

	Muut vaatimukset
V1

	Käsittelysäännöt
K1

	Avoimet Asiat
A1

Käyttötiheys

Muuta

...

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ää Metropolian kertakirjautumispalvelua, joka on rakennettu CAS-palveluksi.

4.1.3 Raportit ja listaukset

Asiontipalvelun käyttöliittymien kautta tarjotaan raportteja tai listauksia käyttäjien käyttöön. Raporttien tiedot haetaan palveluväylän kautta tietokannasta ja raporttien tulostamisen yhteydessä pitää pystyä suodattaa ja järjestää raporttia tai listausta ao. tietojoukon pääasiallisten suodatus- tai järjestelytapojen perusteella.

Loppukäyttäjä eli asiakas (opiskelija, erikoistumisopintohin ilmoittautuva, jne.)
- toimeksiannon listaus
prosessitoimija, opintotoimisto
- yhden toimeksiannon listaus
- avointen toimeksiantojen listaus
- vastaanotetut maksut raportti
prosessitoimija, hakutoimisto
- yhden toimeksiannon listaus
- avointen toimeksiantojen 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

Järjestelmään perustetaan seuraavat käyttöoikeusprofiilit:

loppukäyttäjä
loppukäyttäjä, Metropolian opiskelija
prosessitoimija, opintotoimisto
prosessitoimija, hakutoimisto
pääkäyttäjä
ylläpito

Kirjautumattomalla käyttäjällä on rajoitetut toiminnot. Jotkin toiminnot on rakennettu siten, että varsinaista henkilön tunnistautumista ei tarvita, vaan toiminnon seurauksena suoritettu maksutapahtuma on riittävä. Tällöin käyttäjän tulee itse huolehtia siitä, että antaa tarvittavat tiedot toiminnon seurauksen kohdistamiseen.

4.1.6 Tekniset vaatimukset

Asiontipalvelun tekniset vaatimukset ovat seuraavat:

php-palvelin !!! Mikä versio !!! !!! Mitkä konffivaatimukset !!!
- modrewrite tuki
ssl-salaus. Tuotantopalvelimessa ssl-sertifikaatit pitää vastata kolmannen osapuolen turvavaatimuksia, mikäli ko. vaatimuksia on asetettu esim. Vetuma-palveluntarjoajan toimesta.
!!! mitä muuta? !!!

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

...

Muuta

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

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 hallitaperustaa käyttäjän palveluväylän asiointisovellusten käyttäjärekisteriin.

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

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Asiakas Käyttäjät	Oikeus lukea omat tiedot.	Luku, omat tiedot	Tarvittaessa
Asiointisovellus - Prosessikäyttäjä	Oikeus lukea sallittujen asiakkaiden tietoja	Luku, sallitut tiedot	Tarvittaessa
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.
Asiointisovelluksen tulee palvelupyynnössä välittää suodatustiedot, muuten palautettava listaus suodatetaan !!! millä periaatteella? !!!
Pyydettäessä yhden asiakkaan tietoja palautetaan asiointisovellukselle asiakkaasta kaikki tiedot Palveluväylään toimitetut käyttäjän tiedot tulee olla tietosisälöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Palvelusovellus Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston käyttäjästä palveluväylään.	Määrittely 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 4 5
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksenperustaa 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 asiakassovellukselle kyselyn asiointisovellukselle tiedon käyttäjän hylkäyksestä ja väittää välittää selväkielisen syyn kyselyn käyttäjän hylkäykseen.	T3 T2

	Tulokset
T1	Asiakkaiden listaus: xml-tiedosto	Tietokantaan tallennettu käyttäjä.
T2	Palaute: Käyttäjän tiedot
T3 T2	Palautettu virheilmoitus: hylätty kysely 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: Asiakas - Asiakkaiden listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.
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 Voisiko	listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto Vaaditaanko jokaiselta rekisteröityneeltä käyttäjältä vahva tunnistautumien?

Käyttötiheys

Muuta

...

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

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

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

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

Esitiedot/Ehdot

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

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen päivittävän xml-tiedoston tuotteesta 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 päivittää hyväksytyn pyynnön perusteella uuden tuotteenkäyttäjän tiedot.	T1
4.	Tuotteen lisäyksestä Tietojen päivityksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja tuotteen käyttäjän tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon tuotteen päivityksen hylkäyksestä ja välittää selväkielisen syyn tuotteen päivityksen hylkäykseen.	T3

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

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö Käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen xml-tiedosto: käyttö 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	Tuote Käyttäjien tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukanatietueessa myös päivityksen jälkeen.
V2	XML-tiedostokuvaus: Tuote Käyttäjä - Lisääminen Muokkaus

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

	Avoimet Asiat
A1

Käyttötiheys

Muuta

...

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

Yleiskuvaus
Palveluväylään sallitut asiakassovellukset voivat muokata tuotetietoja palveluväylän tuoterekisteriinasiointisovellukset voivat perustaa käyttäjään liitettävän asiakkaan palveluväylän asiointisovellusten asiakasrekisteriin.

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

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Tuotteet Asiakkaat	Oikeus muokata tuotteen tietoja.	Tuotteen tietojen päivitys	lisätä uusi asiakas	Uuden asiakkaan lisäys	Aina kun asiakas lisätään Tarvittessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylään toimitetut tuotteen päivitystiedot 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-päivitystiedoston tuotteesta 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ä päivittään perustaa hyväksytyn pyynnön perusteella tuotteen tiedotuuden asiakkaan.	T1
4.	Tuotteen päivityksestä Asiakkaan lisäyksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja tuotteen asiakkaan tiedot näytetään asiointisovellusta käyttävälle käyttäjälleasiakkaalle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon päivityksen asiakkaan hylkäyksestä ja välittää selväkielisen syyn päivityksen asiakkaan hylkäykseen.	T3

	Tulokset
T1	Tietokantaan päivitetty tuote tallennettu asiakas.
T2	Palaute: Päivitetyt Asiakkaan tiedot
T3	Palautettu virheilmoitus: hylätty päivitys 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	Tuotteen tietoja ei ole Asiakkaasta puuttuu tietue Käyttäjä taulusta: käyttö keskeytetään, tilanne kirjataan seuratalokiin seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

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

	Käsittelysäännöt
K1	Epätäydelliset tiedot, tiedot liian vajaat, eli tuote asiakas tietokantataulun pakolliset tiedot puuttuu. Tuote Käyttäjä hylätään epäkelpona.
K2	Tuotetta ei Asiakas taulussa: Päivitys hylätään epätäydellisenä 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: Tuotteiden listaus Asiakkaan muokkaus

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 hallitaasiakassovellukset voivat muokata käyttäjään liitettyjä asiakastietoja palveluväylän asiakasrekisteriin.

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

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Asiakas, Prosessi käyttäjä Asiakkaat	Oikeus lukea osa tuotetiedoista Luku, osa tiedoista muokata asiakkaan tietoja	Asiakkaan tietojen päivitys	Tarvittaessa	Asiointisovellus - Pääkäyttäjä	Oikeus lukea kaikki tuotetiedot	Luku, kaikki tiedot
			Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus käytö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 Palveluväylään toimitetut asiakkaan päivitystiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus	Viittaus
1.	Palvelusovellus Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedostonpäivitystiedoston asiakkaasta palveluväylään.	Määrittely 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 4 5
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksenpä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 kyselyn tiedon päivityksen hylkäyksestä ja väittää välittää selväkielisen syyn kyselyn päivityksen hylkäykseen.	T3 T2

	Tulokset
T1	Tuotteiden listaus: xml-tiedosto	Tietokantaan päivitetty asiakas.
T2	Palaute: Päivitetyt tiedot
T3 T2	Palautettu virheilmoitus: hylätty kysely 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 xml	-tiedostokuvaus: Tuote - Tuotteiden listauksen kysely Asiakas tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.	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 Voisiko listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto	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: Poimintakorin lisäys Asiakkaan sulkeminen

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat perustaa palveluväylän tietokantaan käyttäjään liitettävän tuotteiden ja opintojaksototeutusten poimintakorinsulkea asiakkaalta maksutoimintojen käytön. Tieto sulusta tallennetaan asiointisovellusten asiakasrekisteriin.

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

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

sulkea Asiakas	Asiakkaan sulkeminen	Tarvittaessa

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 Asiakkaan tiedot tulee löytyä Asiakas taulusta.

	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.

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

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.
	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
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: Poimintakorin muokkaus Asiakkaiden listaus

Yleiskuvaus

Paveluväylään sallitut asiointisovellukset muokata palveluväylän tietokantaan käyttäjään liitetyn tuotteiden ja opintojaksototeutusten poimintakoria 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	20 19.4.2012
Prosessi	Verkkomaksuprojekti - Asiointi Maksaminen - Poimintakoritoiminnot 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		3.

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

	Poikkeukset
P1		P2


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

	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
Voisiko listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto?

Käyttötiheys

Muuta

...

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

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

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

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä Pääkäyttäjät	Oikeus listata oman poimintakorin sisältö	Luku, oma tiedot	Tarvittaessa	Hallintasovellus - Pääkäyttäjä	Oikeus listata kaikkien poimintakorien sisältö.	Luku, kaikki tiedot	lisätä uusi tuote	Uuden tuotteen lisäys	Aina kun tuote lisätään. Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulle 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 poimintakorin tietoja palautetaan asiointisovellukselle poimintakorista kaikki tiedot, siis myös poimintakorin sisältämät poiminnat.
Palveluväylään toimitetut tuotteen tiedot tulee olla tietosisällöltään vähimmäistasolla.

	Käyttötapauksen kuvaus
1.	Palvelusovellus Asiointisovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-tiedoston tuotteesta palveluväylään.	Määrittely 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 4 5
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksenperustaa 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 kyselyn tiedon tuotteen hylkäyksestä ja väittää välittää selväkielisen syyn kyselyn tuotteen hylkäykseen.	T3 T2

	Tulokset
T1	Poimintakorien listaus: xml-tiedosto	Tietokantaan tallennettu tuote.
T2	Palaute: Tuotteen tiedot
T3 T2	Palautettu virheilmoitus: hylätty kysely 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: Poimintakori - Poimintakorien listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

	Käsittelysäännöt
K1

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	Voisiko listauksien kyselyjä varten olla yhtenäinen kuvaustiedosto?

Käyttötiheys

Muuta

...

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

Yleiskuvaus
Palveluväylään lisätyt asiointisovellukset voivat lisätä käyttäjän palveluväylässä olevaan tuotteiden ja opintototeutusten poimintakoriin poiminnansallitut asiakassovellukset voivat muokata tuotetietoja palveluväylän tuoterekisteriin.

Laatija	Tero Hakkarainen
Päiväys	20 19.4.2012
Prosessi	Verkkomaksaminen Verkkomaksuprojekti - Asiointi Maksaminen - Poimintakoritoiminnot Tuotetoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä Tuotteet	Oikeus lisätä uusi poiminta	Uuden poiminnan lisäys	Aina kun poiminta lisätään poimintakoriin.				muokata tuotteen tietoja.	Tuotteen tietojen päivitys	Tarvittessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Palveluväylän poimintakoriin lisätyn poiminnan tiedot 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-tiedoston poiminnasta 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ä lisää päivittään hyväksytyn pyynnön perusteella uuden poiminnan poimintakoriintuotteen tiedot.	T1
4.	Poiminnan lisäyksestä Tuotteen päivityksestä lähetetään palaute asiointisovellukselle (xml-tiedosto) ja poiminnan tuotteen tiedot näytetään asiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon tuotteen päivityksen hylkäyksestä ja välittää selväkielisen syyn tuotteen päivityksen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan tallennettu poiminta päivitetty tuote
T2	Palaute: poiminnan Päivitetyt tiedot
T3	Palautettu virheilmoitus: hylätty poiminta 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	Poimintakoria Tuotteen tietoja ei löydyole: käyttö keskeytetään, tilanne kirjataan seurantalokiin seuratalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

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

	Käsittelysäännöt
K1 Jos	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ä 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 Tuotteiden listaus

Yleiskuvaus

Palveluväylään lisätyt asiointisovellukset voivat muokata käyttäjän palveluväylässä olevaan tuotteiden ja opintototeutusten poimintakoriin poiminnansallitut 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	20 19.24.2012
Prosessi	Verkkomaksuprojekti - Asiointi Maksamien - Poimintakoritoiminnot Tuotetoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Käyttäjä Asiakas, Prosessi käyttäjä	Oikeus muokata omien poimintojen tietoja. lukea osa tuotetiedoista	Luku, osa tiedoista Kaikki, omat tiedot	Tarvittaessa
Hallintasovellus Asiointisovellus - Pääkäyttäjä	Oikeus muokata kaikkie poimintojen tietoja. lukea kaikki tuotetiedot	Luku, kaikki 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. 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.	Asiointisovellus Palvelusovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-päivitystiedoston poiminnan palveluväylääntiedoston.	Määrittelyn 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 5 4
3.	Palveluväylä päivittää hyväksytyn pyynnön perusteella poiminnan tiedotpalauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksen.	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 kyselyn hylkäyksestä ja välittää väittää selväkielisen syyn päivityksen kyselyn hylkäykseen.	T2 T3

	Tulokset
T1 Tietokantaan päivitetty poimita	Tuotteiden listaus: xml-tiedosto
T2	Palaute: päivitetyt tiedot	T3	Palautettu virheilmoitus: hylätty päivitys kysely

	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

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

	Käsittelysäännöt
K1
	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 yksinkertaistaalistauksien kyselyjä varten olla yhtenäinen kuvaustiedosto?

Käyttötiheys

Muuta

...

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

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat pyytää listattavaksi yhden poimintakorin poiminnat tai vain yhden tietyn poimintarivin tiedotperustaa 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 lukea omien poimintojen tiedot	Luku, omat tiedot	Tarvittaessa	Asiointisovellus - Pääkäyttäjä	Oikeus lukea kaikkien poimintojen tiedot	Luku, kaikki tiedot	lisätä uusi poimintakori	Uuden poimintakorin lisäys	Aina kun poimintakori
			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 Palveluväylään toimitetut poimintatiedot tulee olla tietosisällöltään vähimmäistasolla.

	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
P2
P3

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

	Käsittelysäännöt
K1
K2
K3

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

...

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

...

4.2.1.2 Toiminnallisuudet ja käyttötapaukset: maksupalvelutoiminnot

...

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

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 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	13 20.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot Asiointi - Poimintakoritoiminnot

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		Käyttötapauksen kuvaus
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

	Tulokset
T1
T2

	Poikkeukset
P1
P2
P3

	Muut vaatimukset
V1
V2
V3

	Käsittelysäännöt
K1
K2
K3
	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	Onko tämäkin turha, jos poimintojen muokkaus tehdään poimintatapahtumien kautta?
A2
A3

Käyttötiheys

Muuta

...

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

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat kysyä palveluväylältä täydelliset tiedot palveluväylään tallennetusta toimeksiannosta. listata palvelyväylään tallennetun käyttäjään liitetyn tuotteiden ja opintojaksojen poimintakorin.

Laatija	Tero Hakkarainen
Päiväys	16 20.4.2012
Prosessi	Verkkomaksuprojekti - Talous Asiointi - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot Poimintakoritoiminnot

Käyttäjärooli Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu Käyttäjä	Oikeus lukea asisointisovelluksen itsensä lisäämät toimeksiantoja listata oman poimintakorin sisältö	Luku, Omat oma tiedot	Tarvittaessa
Palveluväylä Hallintasovellus - Hallintasovellus Pääkäyttäjä	Oikeus lukea kaikkien asiointisovelluksen lisäämiä toimeksiantoja listata kaikkien poimintakorien sisältö.	Luku, Kaikki kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee 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.	Asiointisovellus Palvelusovellus lähettää palveluväylän palveluväylään palvelukuvauksen mukaisen xml-tiedoston palveluväylään.	Määrittelyn 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 tiedot toimeksiannosta asiointisovellukselle xml-tiedostonaasiointisovellukselle 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	Toimeksiannon tiedot Poimintakorien listaus: 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 xml-tiedostokuvaus: Toimeksianto - Toimeksiannon tiedot Poimintakori - Poimintakorien listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

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

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

Käyttötiheys

Muuta

...

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

Yleiskuvaus
Palveluväylään sallitut lisätyt asiointisovellukset voivat muokata toimeksiannon tietoja, joka tietojen täydellisyydestä riippuen voidaan siirtää käsiteltäväksi verkkomaksutoiminnolla tai muilla palveluväylässä olevilla toiminnoillalisätä käyttäjän palveluväylässä olevaan tuotteiden ja opintototeutusten poimintakoriin poiminnan.

Laatija	Tero Hakkarainen
Päiväys	16 20.34.2012
Prosessi	Verkkomaksuprojekti Verkkomaksaminen - Talous - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot Asiointi - Poimintakoritoiminnot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu Käyttäjä	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	lisätä uusi poiminta	Uuden poiminnan lisäys	Aina kun poiminta lisätään poimintakoriin.
			Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee tietää toimeksiannon tunniste 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 joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 5.
3.	Palveluväylä muokkaa lisää hyväksytyn pyynnön perusteella toimeksiannonuuden poiminnan poimintakoriin.	T1
4.	Toimeksiannon Poiminnan lisäyksestä lähetetään palaute asiakassovellukselle asiointisovellukselle (xml-tiedosto) ja toimeksiannon maksutapahtumaan vaikuttavat poiminnan tiedot näytetään käyttäjälle, joka päättää jatkaako prosessia maksuunasiointisovellusta käyttävälle käyttäjälle.	T2
5.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon muokkauksen tuotteen hylkäyksestä ja välittää selväkielisen syyn hylkäyksentuotteen hylkäykseen.	T3

	Tulokset
T1	Tietokantaan muokattu toimeksianto tallennettu poiminta
T2	Käyttötapaus Palaute: Toimeksiannon maksusuoritus poiminnan tiedot
T3	Palautettu virheilmoitus: Hylätty muokkaus 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 Asiontisovellus yrittää muokata siten, että vähimmäistietomääritykset eivät täyty: Muokkaus hylätään	Poimintakoria ei löydy: käyttö keskeytetään, tilanne kirjataan seurantalokiin ja asiointisovellukseen palautetaan selväkielinen virheilmoitus.

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

	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.
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: Toimeksiannon tilakysely Poiminnan muokkaus

Yleiskuvaus
Palveluväylään sallitut lisätyt asiointisovellukset voivat kysyä palveluväylältä yhden toimeksiannon tilan. Käyttöliittymälle voidaan tällöin palauttaa aktiivisesti tieto yhden tietyn toimeksiannon tilasta. muokata käyttäjän palveluväylässä olevaan tuotteiden ja opintototeutusten poimintakoriin poiminnan.

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

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu Käyttäjä	Oikeus lukea asiointisovelluksen itsensä lisäämien toimeksiantojen tilatietoja muokata omien poimintojen tietoja.	Kaikki Luku, omat tiedot	Tarvittaessa
Palveluväylä Hallintasovellus - Hallintasovellus Pääkäyttäjä	Oikeus lukea kaikkien asiointisovellusten lisäämien toimeksiantojen tilatietojamuokata kaikkie poimintojen tietoja.	Luku Kaikki, kaikki kaikkien tiedot	Tarvittaessa

Esitiedot/Ehdot

Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee tietää toimeksiannon tunniste 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-kuvauksen mukaisen tilakyselyn päivitystiedoston poiminnan palveluväylään.	Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee tilakyselyn palvelupyynnön ja hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 4 5
3.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon tilasta xml-tiedostona.	T1	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 4.	Palveluväylä palauttaa asiakassovellukselle kyselyn asiointisovellukselle tiedon päivityksen hylkäyksestä ja väittää välittää selväkielisen syyn kyselyn päivityksen hylkäykseen.	T3 T2

	Tulokset
T1	Toimeksiannon tila: xml-tiedosto	Tietokantaan päivitetty poimita
T2	Palaute: päivitetyt tiedot
T3 T2	Palautettu virheilmoitus: hylätty kysely päivitys

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen kyselyxml-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 tiedostokuvaus: Toimeksianto - Toimeksiannon tila

	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ä Virheellinen xml-kysely: kysely hylätään.

	Avoimet Asiat
A1	Voisiko poimintojen hallintaa jotenkin yksinkertaistaa?

Käyttötiheys

Muuta

...

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

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 toimeksiannoistapyytää listattavaksi yhden poimintakorin poiminnat tai vain yhden tietyn poimintarivin tiedot.

Laatija	Tero Hakkarainen
Päiväys	16 20.4.2012
Prosessi	Verkkomaksuprojekti - Talous Asiointi - Maksutoimeksiannot OPI-Maksut - Maksutoimeksiannot Poimintakoritoiminnot

Käyttäjärooli	Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Asiointisovellus - Verkkomaksu Käyttäjä	Oikeus päivittää asiointisovelluksen itsensä lisäämien toimeksantojen tilatietoja. lukea omien poimintojen tiedot	Luku Päivitys, omat tiedot	Tarvittaessa
Palveluväylä Asiointisovellus - Hallintasovellus Pääkäyttäjä	Oikeus päivittää kaikkien asiointisovellusten lisäämien toimeksiantojen tilatietoja. lukea kaikkien poimintojen tiedot	Luku 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 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.	Asiointisovellus Palvelusovellus lähettää palveluväylään palvelukuvauksen mukaisen xml-kuvauksen mukaisen tilakyselyn palveluväylääntiedoston.	Määrittelyn Määrittely kohta 4.2.2
2.	Palveluväylä käsittelee päivityspyynnön palvelupyynnön ja joko 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-tiedostonaasetettujen suodatusten mukaisen listauksen.	T1
4.	Palveluväylä palauttaa asiakassovellukselle päivityspyynnön asiointisovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn päivityspyynnön kyselyn hylkäykseen.	T2

	Tulokset
T1	Toimeksiannon tila Poimintojen listaus: xml-tiedosto
T2	Palautettu virheilmoitus: hylätty päivityspyyntö 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 tilan päivitys Poiminta - Poimintojen listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.

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

	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

...

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

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat käynnistää maksusuorituksen toimeksiannosta, joka on tiedoiltaan tarpeeksi täydellinen maksusuoritusta vartenlisä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	16 13.34.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	lisätä verkkomaksu toimeksianto	Uuden toimeksiannon lisäys	Aina kuin toimeksianto perustetaan. 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 Toimeksianto xml tulee olla tietosisällöltään vähimmäistasoinen.

	Käyttötapauksen kuvaus	Viittaus
1.	Asiointisovellus lähettää palveluväylään palveluväylän palvelukuvauksen mukaisen xml-tiedoston palveluväylään.	Määrittely Määrittelyn kohta 4.2.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 5
3.	Palveluväylä palauttaa asiointisovellukselle verkkomaksun suorittamisen käyttöliittymät Vetuma-palvelustaperustaa hyväksytyn pyynnön perusteella toimeksiannon.	Tulos 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
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 7.	Palveluväylä palauttaa asiointisovellukselle tiedon toimeksiannon maksamisen hylkäyksestä ja välittää väittää selväkielisen syyn hylkäyksentoimeksiannon hylkäykseen.	T3 T5

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

	Poikkeukset
P1	Käyttöoikeudeton sovellus: käyttö estetään ja tilanne kirjataan seurantalokiin.
P2	Palvelukuvauksen vastainen kyselyxml-tiedosto: 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 asiointiovellukseen palautetaan selväkielinen virheilmoitus.

	Muut vaatimukset
V1	Toimeksiantojen tietokantataulun pakolliset tiedot tulee olla aina xml-siirron mukana.
V2	XML-tiedostokuvaus: Toimeksianto - Toimeksiannon maksusuoritus 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.	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 Toimeksiannon tiedot
	Palveluväylä toiminto: Toimeksiantojen listaus Toimeksiannon tiedot

Yleiskuvaus
Palveluväylään sallitut asiointisovellukset voivat pyytää kysyä 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. 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 asiointisovelluksen asisointisovelluksen itsensä lisäämiä lisäämät toimeksiantoja .	Luku, omat Omat tiedot	Tarvittaessa
Palveluväylä - Hallintasovellus	Oikeus lukea kaikkien asiointisovellusten asiointisovelluksen lisäämiä toimeksiantoja .	Luku, kaikki 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 Asiointisovellus lähettää palveluväylään palveluväylän palvelukuvauksen mukaisen xml-tiedoston palveluväylään.	Määrittely 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 4
3.	Palveluväylä palauttaa asiointisovellukselle asetettujen suodatusten mukaisen listauksentiedot toimeksiannosta asiointisovellukselle xml-tiedostona.	T1
4.	Palveluväylä palauttaa asiakassovellukselle asiointisovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	T2

	Tulokset
T1	Toimeksiantojen listaus 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 XML-tiedostokuvaus: Toimeksianto - Toimeksiantojen listauksen kysely
V2	Listauksen kyselyssä tulee olla mukana tarvittavat listauksen suodatusrajaukset.
Toimeksiannon tiedot

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

	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. Toimeksiannon muokkaus

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 asiointisovelluksessamuokata 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	17 16.3.2012
Prosessi	Verkkomaksuprojekti - Käyttäjä Talous - Vahva tunnistaminen Maksutoimeksiannot OPI-Maksut - Vahva tunnistaminen Maksutoimeksiannot

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

Esitiedot/Ehdot

Asiointisovelluksella tulee

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 tunnistuksen käynnistyskutsunpalvelukuvauksen mukaisen xml-tiedoston.	Määrittely Määrittelyn kohta 4.2.2
2.	Palveluväylä käsittelee käynnistyspyynnön palvelupyynnön ja joko hyväksyy tai hylkää pyynnön.	Hyväksytty: kohta 3 / Hylätty: kohta 7. 5
3.	Palveluväylä palauttaa asiointisovellukselle TUPAS-tunnistamisen suorittamisen käyttöliittymät Vetuma-palvelun kauttamuokkaa hyväksytyn pyynnön perusteella toimeksiannon.	T1
4. Loppukäyttäjä käyttää TUPAS-tunnistamisen käyttöliittymiä vahvan tunnistautumisen suorittamiseen	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älle palautuu tieto tehdystä tunnistuksesta.	T3	6.	Palveluväylä palauttaa tiedon tunnistusta henkilöstä asiointisovellukselle .	T4	7.	Palveluväylä palauttaa tiedon virheellisestä tunnistustapahtumasta asiointisovellukselle.	tiedon toimeksiannon muokkauksen hylkäyksestä ja välittää selväkielisen syyn hylkäyksen.	T3 T5

	Tulokset
T1 Vetuma-palvelun kautta haetut TUPAS-tunnistautumisen käyttöliittymät.	Tietokantaan muokattu toimeksianto
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
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 käynnistysxml-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: Henkilö Toimeksianto - Henkilön vahva tunnistaminen 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

...

4.2.1.4 Toiminnallisuudet ja käyttötapaukset: talousautomaation toiminnot

...

	Käyttötapauksen nimi
	Palveluväylä toiminto: Talousautomaation siirtotiedoston muodostus 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. 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 16.4.2012
Prosessi	Verkkomaksuprojekti - Talous - Talousautomaatio Maksutoimeksiannot OPI-Maksut - Talousautomaatio Maksutoimeksiannot

Käyttäjärooli	Kuvaus	Oikeudet	Käyttötiheys
Palveluväylä Asiointisovellus - Hallintasovellus	Oikeus käynnistää siirtotiedoston muodostus koeajona siten, että siirtotiedosto muodostetaan siirtokelpoisesta aineistosta, mutta siirrettyjä toimeksiantoja ei kirjata tietokantaan siirretyiksi.	Verkkomaksu	Oikeus lukea asiointisovelluksen itsensä lisäämien toimeksiantojen tilatietoja	Luku, omat tiedot 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
lukea kaikkien asiointisovellusten lisäämien toimeksiantojen tilatietoja.	Luku, kaikki tiedot	Tarvittaessa

Esitiedot/Ehdot

Siirrettävien toimeksiantojen tulee olla verkkomaksutoiminnolla suoritettuja ja maksetuiksi todettuja verkkomaksu toiminnon tilaviesteistä Asiointisovelluksella tulee olla käyttöoikeus palveluväylän toimintoon.
Asiointisovelluksen tulee tietää toimeksiannon tunniste.

	Käyttötapauksen kuvaus	Viittaus
1.	Siirtotiedoston muodostaminen käynnistetään joko koeajona tai lopullisena ajona.	Asiointisovellus lähettää xml-kuvauksen mukaisen tilakyselyn palveluväylään.	Määrittelyn kohta 4.2.2
2.	Muodostaminen käy siirtämättömät mutta siirtokelpoiset toimeksiannot läpi ja tarkastaa niiden siirtokelpoisuuden.	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	3.	Muodostaminen kirjaa siirtokelpoiset rivit valmiiksi siirtoon.	T1
4. Muodostaminen kirjaa virheellisistä tapahtumista selväkielisen merkinnän tapahtumalokiin ja merkitsee rivit virhetilaan	Palveluväylä palauttaa asiakassovellukselle kyselyn hylkäyksestä ja väittää selväkielisen syyn kyselyn hylkäykseen.	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.

	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
	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.	xml-tiedostokuvaus: Toimeksianto - Toimeksiannon tila

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

	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

Jotta palveluväylä pystyy tarjoamaan asiointisovelluksille tarvittavat palvelut, ulkoisten toiminnallisten palveluiden lisäksi tarvitaan käsiteltävien tietojen tallentamiseksi tietokanta.

Tietokanta on rakennettu siten, että on yritetty ottaa huomioon asiointitapahtumien tarpeet, käyttäjätarpeet sekä myös maksutapahtumien ja talousautomaation tarpeet. Lisäksi on yritetty ottaa huomioon joitakin tulevia tarpeita, kuten Avoimen ammattikorkeakoulun opintojakso osallistumisien myynti.

Tietokannan kehittäminen aloitettiin seuraavalla käsitekartalla. Käsitekartalla mietittiin tietoja ja niiden linkittymistä toisiinsa.

...

Tietokanta - Käsitekartta

...

Image Removed

Käsitekartan luomisen jälkeen voitiin muodostaa seuraavat tietokanta taulut:

...

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ö.

...

	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

palveluväylä toimintojen sekä talousautomaation paketointi muille sovelluksille sopivaksi !!! Määrittely kesken !!!

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

Talousautomaatio siirtotiedoston muodostus tekee ASCII-tekstitiedoston (ISO 8859-1 merkistö), jossa siirretään myyntitapahtumat Intime Plus järjestelmään määrämittaisella tiedostolla.

Tiedosto on määritelty seuraavissa tiedostokuvauksissa (Liitteenä. Ko. tiedostot sisältävät Aditron kanssa käydyissä määrittelypalavereissa tehdyt täydennykset ja korjaukset.):

Myyntitilaus-otsikko - palaverikorjaukset.pdf

Myyntitilauserän kuvaus - palaverikorjaukset.pdf

Myyntitilausrivin kuvaus - palaverikorjaukset.pdf

Tiedosto muodostuu siirtoriveistä, jotka ovat tilauskohtaisia. Rakenne menee seuraavasti:

Tilauksen ensimmäisenä tietueena on aina tilausotsikko. Seuraavina tulevat tilaukseen
kuuluvat toimituserät, joiden ensimmäisenä tietueena on toimituserätietue ja välittömästi
sen perässä ko. toimituserään kuuluvat tilausrivitietueet. Kaikkien tietueiden pituus on
oltava sama.

Käyttöönoton alkuvaiheessa siirtotiedosto muodostetaan manuaalisesti. Kun tekniikka on todettu toimivaksi, siirtotiedosto muodostetaan automaattisesti päivittäin klo 3.00 (aamuyöllä) edellisen päivän siirtokelpoisesta materiaalista.

Siirtotiedostoon tulee vain siirtokelpoinen ja sisällöltään tarkastukset läpäisevä materiaali.

4.2.5 Tietomalli ja tietokanta

Jotta palveluväylä pystyy tarjoamaan asiointisovelluksille tarvittavat palvelut, ulkoisten toiminnallisten palveluiden lisäksi tarvitaan käsiteltävien tietojen tallentamiseksi tietokanta.

Tietokanta on rakennettu siten, että on yritetty ottaa huomioon asiointitapahtumien tarpeet, käyttäjätarpeet sekä myös maksutapahtumien ja talousautomaation tarpeet. Lisäksi on yritetty ottaa huomioon joitakin tulevia tarpeita, kuten Avoimen ammattikorkeakoulun opintojakso osallistumisien myynti.

Tietokannan kehittäminen aloitettiin seuraavalla käsitekartalla. Käsitekartalla mietittiin tietoja ja niiden linkittymistä toisiinsa.

...

Tietokanta - Käsitekartta

...

Image Added

Käsitekartan luomisen jälkeen voitiin muodostaa seuraavat tietokanta taulut:

...

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.
FK	FK_UserProfiles_ProfileName	UserProfiles-tauluun tallennettu profiilinimi	varchar	20	Pakollinen	UserProfiles-taulu, ProfileName-kenttä
	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ä	Tieto tallennetaan tietokantaan salattuna kehitystiimissä määritellyllä salausmenetelmällä.
	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ä
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.
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ä.	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ä?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.Miten käsitellään Winha_TK_koodin koodisto?

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

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	AssignmentID	Toimeksiantotunnus Henkilön tunniste	int	long	Pakollinen, Uniikki, Autoincrement		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
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ä. !!!
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 toimeksianto käytössä? Voidaan käyttää toimeksiannon pakkosulkuun.
	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?

...

päivittänyt tietuetta?
	IntimeTransferStatus	Intime siirron tila	varchar	25	Pakollinen		!!! Siirron tilojen koodit? !!! Kesken, Valmis, Odottaa siirtoa, Siirretty, Ei siirretä

Tarkastettavaa:

vetuma-speksista tietuekuvauksia
siirron tilakoodit, että vastaa tarvittavia siirtotiloja

4.2.5.

...

7 AssignmentRow-taulu:

...

Toimeksiantorivi-taulu

Toimeksiannot sisältävät useamman rivin, jotta yhdellä toimeksiannolla voidaan käsitellä useampaa kuin vain yhtä tuotetta kerrallaan (esim. avoimen opintojakso toteutuksia). Tietojen tulee olla aina tosiaikaista tilannetta vastaavia siihen saakka kunnes toimeksianto siirtyy maksuvaiheeseen, jolloin rivien tilanne jäädytetään, eli rivejä ei voi enää lisätä, poistaa tai muuttaa

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	AssignmentRowID ImplementationID	Opintojaksototeutuksen Toimeksiantorivin tunnus	int varchar	long Tieto Pepistä?	Pakollinen, Uniikki, Autoincrement		Opintojakson toteutuksen tunnus. Otetaan siitä järjestelmästä, joka on toteutuksien lähdejärjestelmä.
FK	FK_ProductAssignment_ProductID AssignmentID	Toimeksiantotunnus Asiointituote tunnus	int	long	Pakollinen	Product Assignment-taulu - ProductIDAssingmentID-kenttä
FK	FK_IntimeEducationProgramProduct_EducationProgramID ProductID	Tuotetunnus Intime Koulutusohjelmatunnus	int	long	Pakollinen	IntimeEducationProgram Product-taulu - IntimeEducationProgramIDProductID-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

...

FK	FK_StudyImplementation_StudyImplementationID	Opintojaksotunnus	varchar	Tieto Pepistä?		StudyImplementation-taulu - StudyImplementation-kenttä
FK	FK_IntimeEducationProgram_IntimeEducationProgramID	Intime Koulutusohjelma	int	long		IntimeEducationProgram-taulu - IntimeEducationProgramID-kenttä
	Amount	Määrä	double	6,2	Pakollinen		Myyty määrä.
	RowPrice	Rivihinta	double	6,2 (intime määritys)	Pakollinen		Myyntihetken rivihinta.
	RowTotal	Rivi yhteensä	double	10,2	Pakollinen		RowTotal = Amount * RowPrice, Myyntihetken arvoilla laskettuna!
	IntimeProjectID	Intime projektinumero	int	short	Pakollinen		Pitäisikö tämä olla FK_IntimeProject_IntimeProjectID
	ProductName	Tuotenimi	varchar	200	Pakollinen		Myydyn tuotteen nimi. Voidaan yhdistellä eri tiedoista, sillä tuotteen nimi voi muuttua, mutta myydyn tuotteen nimi tulee tallentaa tietokantaan. Eli esim.: haetaan nimitieto ensin tuotetaulusta ja lisäksi jos on määritelty opintojaksototeutustieto, niin täydennetään tietoa myös opintojakson toteutuksen nimellä.

Avoimet kysymykset:

Intime projektitunnuksen käyttö

...

4.2.5.8 Log-taulu: Loki-taulu

...

Järjestelmä tallentaa suorituista tapahtumista tietoa lokiin. Lokiin tallennettua tietoa näytetään pää- ja ylläpitokäyttäjille Lokin katselu käyttöliittymällä.

Huom! Tämä taulu on olemassa niin asiointijärjestelmässä kuin palveluväylässä. Molemmat järjestelmät käyttävät kuitenkin omaa lokiaan. Palveluväylä tarjoaa asiointisovellukselle oman lokinsa käyttöön tietojen näyttämistä vartenMaksun 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	LogID AssignmentID	Tapahtumatunnus Toimeksiantotunnus	int	long	Pakollinen, Uniikki, Autoincrement			PK	OrderID	Tilausnumero	int	long	Pakollinen
	Time
	CreatedFromBasket	Luotu poimintakorista	int	long
	AssignmentDate	Perustettu	date		Pakollinen
	ValidTill	Voimassaoloajan päättyminen	datetime
Tapahtuma-aika	datetime		Pakollinen,		Aikaleima joka generoidaan automaattisesti kun tietue lisätään.
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
User_ID	Käyttäjätunnus	integer	long		User-taulu - ID-kenttä	Jos on tiedossa käyttäjä, jolla virhe tapahtuu, niin kirjataan tieto. Huom! Myös kirjautumatomalla käyttäjällä voi tapahtua virheitä.
	Module	Ohjelmamoduli	varchar	100	Pakollinen		Virheen havainnut ohjelmamoduli tallettaa
	ErrorLevel	Virhetaso	varchar	25	Pakollinen		Tasot: Debug, Info, Warning, Security, Fatal.
	ErrorDescription	Virhekuvaus	varchar	1000	Pakollinen

...

4.2.5.9 UserProfiles-taulu: Käyttäjäprofiilitaulu

...

Asiointipalveluiden käyttäjälle tulee asettaa asiontijärjestelmän käyttäjäprofiili, joka määritellään tähän tauluun.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	ProfileName	Käyttäjäprofiili	string	20	Uniikki, pakollinen		TotalPayable	Loppusumma	double	10,2	Pakollinen
	IsNormalUser TransactionDate	On normaalikäyttäjä Tapahtumapäivä	boolean datetime
	IsAdmissionOfficeUser TransactionReturnStatus	On hakutoimistokäyttäjä Tapahtuman paluuvaste	boolean varchar	100			!!! Tarkistetaan Vetuma-spekseistä. !!!		TransactionArchiveID	Tapahtuman arkistointitunnus	varchar	50
	!!! Tarkistetaan Vetuma-spekseistä. !!!	IsStudentServicesUser	On opintotoimistokäyttäjä		IsInUse	On käytössä	boolean		Oletus: false		Onko toimeksianto käytössä? Voidaan käyttää toimeksiannon pakkosulkuun.
	IsFinancialUser LastUpdate	On taloushallintokäyttäjä Viimeisin päivitys	boolean 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ä

Tarkastettavaa:

vetuma-speksista tietuekuvauksia
siirron tilakoodit, että vastaa tarvittavia siirtotiloja

...

4.2.5.7 AssignmentRow-taulu: Toimeksiantorivi-taulu

...

Toimeksiannot sisältävät useamman rivin, jotta yhdellä toimeksiannolla voidaan käsitellä useampaa kuin vain yhtä tuotetta kerrallaan (esim. avoimen opintojakso toteutuksia). Tietojen tulee olla aina tosiaikaista tilannetta vastaavia siihen saakka kunnes toimeksianto siirtyy maksuvaiheeseen, jolloin rivien tilanne jäädytetään, eli rivejä ei voi enää lisätä, poistaa tai muuttaa.

...

PK/FK

...

Kenttänimi

...

Kuvaus

...

Tyyppi

...

Pituus

...

Rajoitukset

...

Viittaukset

...

Huomautukset

...

PK

...

AssignmentRowID

...

Toimeksiantorivin tunnus

...

int

...

long

...

Pakollinen, Uniikki, Autoincrement

...

FK

...

FK_Assignment_AssignmentID

...

Toimeksiantotunnus

...

int

...

long

...

Pakollinen

...

Assignment-taulu - AssingmentID-kenttä

...

FK

...

FK_Product_ProductID

...

Tuotetunnus

...

int

...

long

...

Pakollinen

...

Product-taulu - ProductID-kenttä

...

FK

...

FK_StudyImplementation_StudyImplementationID

...

Opintojaksotunnus

...

varchar

...

Tieto Pepistä?

...

StudyImplementation-taulu - StudyImplementation-kenttä

...

FK

...

FK_IntimeEducationProgram_IntimeEducationProgramID

...

Intime Koulutusohjelma

...

int

...

long

...

IntimeEducationProgram-taulu - IntimeEducationProgramID-kenttä

...

Amount

...

Määrä

...

double

...

6,2

...

Pakollinen

...

Myyty määrä.

...

RowPrice

...

Rivihinta

...

double

...

6,2 (intime määritys)

...

Pakollinen

...

Myyntihetken rivihinta.

...

RowTotal

...

Rivi yhteensä

...

double

...

10,2

...

Pakollinen

...

RowTotal = Amount * RowPrice, Myyntihetken arvoilla laskettuna!

...

IntimeProjectID

...

Intime projektinumero

...

int

...

short

...

Pakollinen

...

Pitäisikö tämä olla FK_IntimeProject_IntimeProjectID

...

ProductName

...

Tuotenimi

...

varchar

...

200

...

Pakollinen

...

Myydyn tuotteen nimi. Voidaan yhdistellä eri tiedoista, sillä tuotteen nimi voi muuttua, mutta myydyn tuotteen nimi tulee tallentaa tietokantaan. Eli esim.: haetaan nimitieto ensin tuotetaulusta ja lisäksi jos on määritelty opintojaksototeutustieto, niin täydennetään tietoa myös opintojakson toteutuksen nimellä.

IsAdminUser	On pääkäyttäjä	boolean
	IsSysAdminUser	On ylläpitokäyttäjä	boolean
	IsInUse	On käytössä	boolean		Oletus: false		Onko profiili 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?

...

4.2.5. Basket-taulu: Poimintakori-taulu

...

Poimintakoriin kerätään käyttäjän tekemät poiminnat ennen maksutapahtumaa. Kun käyttäjä on valmis siirtymään varsnaiseen ostostapahtumaan, siirretään tiedot toimeksiantoon käsiteltäväksi. Poimintakori voi sisältää usemman kuin yhden rivin.

Joissakin asiontitapauksissa ei ole pakko käyttää poimintakoria, kuten käsittelymaksun suorittamisessa.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	BasketID	Korintunnus	int	long	Pakollinen, Uniikki, Autoincrement
	SessionID	Istunnontunnus	varchar	100	Pakollinen		Käyttäjän käynnistämän www-palvelin istunnon yksilöllinen tunniste.
FK	FK_Person_PersonID	Henkilön ID	int			Person-taulu - PersonID-kenttä
	Expires	Korin vanhenemis hetki	datetime		Pakollinen		Ajan hetki, jonka jälkeen koria ei voi enää käyttää.
	LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Ajan hetki, jolloin tietuetta on viimeksi päivitetty.

...

4.2.5. BasketRow-taulu: Poimintakoririvi-taulu

...

Poimintakorin rivit tallennetaan tähän tauluun.

Avoimet kysymykset:

Intime projektitunnuksen käyttö

...

4.2.5.8 Basket-taulu: Poimintakori-taulu

...

Poimintakoriin kerätään käyttäjän tekemät poiminnat ennen maksutapahtumaa. Kun käyttäjä on valmis siirtymään varsnaiseen ostostapahtumaan, siirretään tiedot toimeksiantoon käsiteltäväksi. Poimintakori voi sisältää usemman kuin yhden rivin.

Joissakin asiontitapauksissa ei ole pakko käyttää poimintakoria, kuten käsittelymaksun suorittamisessa.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	RowID BasketID	Rivi tunniste Korintunnus	int	long	Pakollinen , Uniikki, Autoincrement
FK	FK_Basket_BasketID	Korin tunniste	int	long	Pakollinen	Basket-taulu - BasketID-kenttä			SessionID	Istunnontunnus	varchar	100	Pakollinen	Käyttäjän käynnistämän www-palvelin istunnon yksilöllinen tunniste.
FK	FK_PersonProduct_PersonID ProductID	Poimitun tuotteen tunniste Henkilön ID	int	long	Pakollinen	Person Product-taulu - PersonIDProductID-kenttä
	Expires	Korin vanhenemis hetki	datetime		Pakollinen		Ajan hetki, jonka jälkeen koria ei voi enää käyttää.
FK	FK_StudyImplementation_StudyImplementationID	Poimitun opintojaksototeutuksen tunniste	int	long		StudyImplementation-taulu - StudyImplementationID-kenttä
	Amount	Poimittu määrä	double	6,2		LastUpdate	Viimeisin päivitys	datetime		Pakollinen		Ajan hetki, jolloin tietuetta on viimeksi päivitetty.

4.2.5.

...

10 IntimeProduct-taulu:

...

IntimePlus-

...

järjestelmästä replikoidut tuotteet

IntimePlus järjestelmästä replikoitua tietoaPoimintakorin rivit tallennetaan tähän tauluun.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	IntimeProductID RowID	Intimen tuotenumero Rivi tunniste	Tarkistetaan int	Tarkistetaan long	Uniikki, Pakollinen	IntimePlus - järjestelmä, tuotenumero	Tieto replikoidaan Intimestä!

FK	FK_Basket_BasketID	Korin tunniste	int	long	Pakollinen	Basket-taulu - BasketID-kenttä
FK	FK_Product_ProductID	Poimitun tuotteen tunniste	int	long	Pakollinen	Product-taulu - ProductID-kenttä
FK	FK_StudyImplementation_StudyImplementationID	Poimitun opintojaksototeutuksen tunniste	int	long		StudyImplementation-taulu - StudyImplementationID-kenttä
	Amount	Poimittu määrä	double	6,2	Pakollinen
ProductName	Intime tuotenimi	varchar	Tarkistetaan	Pakollinen	IntimePlus - järjestelmä, tuotenimi	Tieto replikoidaan Intimestä!
	SalePrice	Intime myyntihinta	double	6,2	Pakollinen	IntimePlus - järjestelmä, tuotehinta	Tieto replikoidaan Intimestä!
	SaleUnit	Intime myyntiyksikkö	varchar	10	Pakollinen	IntimePlus - järjestelmä, tuotteen myyntiyksikkö	Tieto replikoidaan Intimestä!
	IsInUse	On käytössä	boolean		Oletus: false		Onko tuote käytössä?

Avoimet kysymykset:

intimeplussan tietotyypit ja tietuepituudet

4.2.5.

...

11 IntimeProject-taulu: IntimePlus-järjestelmästä replikoidut

...

projektit

IntimePlus järjestelmästä replikoitua tietoa.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	IntimeProjectID IntimeProductID	Intime projektinumero Intimen tuotenumero	Tarkistetaan	Tarkistetaan	Uniikki, Pakollinen	IntimePlus - järjestelmä, tuotenumero	Tieto replikoidaan Intimestä!
	ProjectName ProductName	Intime tuotenimi projektinimi	varchar	100 Tarkistetaan	Pakollinen	IntimePlus - järjestelmä, tuotenimi	Tieto replikoidaan Intimestä!
	IsInUse	On käytössä	boolean		Oletus: false		Onko projekti käytössä?

Avoimet kysymykset:

intimeplussan tietotyypit ja tietuepituudet

...

4.2.5.12 IntimeEducationProgram-taulu: IntimePlus-järjestelmästä replikoidut koulutusohjelmat

...

IntimePlus järjestelmästä replikoitua tietoa.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	IntimeEducationProgramID	Intime koulutusohjelma	Tarkistetaan	Tarkistetaan	SalePrice	Intime myyntihinta	double	6,2	Pakollinen	IntimePlus - järjestelmä, tuotehinta	Tieto replikoidaan Intimestä!
	EducationProgramName SaleUnit	Intime myyntiyksikkö koulutusohjelman nimi	varchar	10 100	Pakollinen	IntimePlus - järjestelmä, tuotteen myyntiyksikkö	Tieto replikoidaan Intimestä!
	IsInUse	On käytössä	boolean		Oletus: false		Onko tuote koulutusohjelma käytössä?

Avoimet kysymykset:

intimeplussan tietotyypit ja tietuepituudet

4.2.5.

...

13 Vetuma-asetukset

Huom! Vaikka tämä taulu on kuvattu tietokantatauluna, niin tieto tallennetaan todennäköisesti xml-tiedostona.

Järjestelmissä ei ole käyttöliittymää näiden tietojen muokkaukseen!

	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Huomautukset
Root	VetumaProfiles	VetumaProfiilit
Taso +	Profile	Profiili taso	taso			Profiilit
+	ProfileName	Profiili nimi	string		Uniikki, Pakollinen
+	RCVID	Salaisuuden tunnus	string	5 - 15		Vetuma: Kutsun suojauksessa käytetyn jaetun salaisuuden tunnus
+	APPID	Asiointisovelluksen tunnus	string	5 - 15		Vetuma: VETUMA-palvelua kutsuvan asiontisovelluksen tunnus
+	APPNAME	Sovelluksen nimi	string	40		Vetuma: Kutsuvan sovelluksen nimi käyttöliittymää varten
Taso ++	Apconf	Apconf-taso	taso			Asiakaskonfiguraatiot
++	ConfId	Apconf-tunnus	string			Asiakaskonfiguraatiolle määritelty tunnus palveluväylää varten.
++	+AP	Konfiguraatiotunnus	string	5 - 15		Vetuma: Kutsun palvelemisessa käytettävän VETUMA-asiakaskonfiguraation tunnus.

...

4.2.5.14 Asiointikanavat

...

Huom! Vaikka tämä taulu on kuvattu tietokantatauluna, niin tieto tallennetaan todennäköisesti xml-tiedostona.

Järjestelmissä ei ole käyttöliittymää näiden tietojen muokkaukseen!

IntimePlus järjestelmästä replikoitua tietoa.

PK/FK	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	IntimeProjectID	Intime projektinumero	Tarkistetaan	Tarkistetaan	Uniikki, Pakollinen	IntimePlus - järjestelmä,	Tieto replikoidaan Intimestä!
	ProjectName	Intime projektinimi	varchar	100	Pakollinen	IntimePlus - järjestelmä,	Tieto replikoidaan Intimestä!
	IsInUse	On käytössä	boolean		Oletus: false		Onko projekti käytössä?

Avoimet kysymykset:

intimeplussan tietotyypit ja tietuepituudet

...

4.2.5.12 IntimeEducationProgram-taulu: IntimePlus-järjestelmästä replikoidut koulutusohjelmat

...

IntimePlus järjestelmästä replikoitua tietoa.

...

	Kenttänimi	Kuvaus	Tyyppi	Pituus	Rajoitukset	Viittaukset	Huomautukset
PK	IntimeEducationProgramID	Intime koulutusohjelma	Tarkistetaan	Tarkistetaan	Pakollinen	IntimePlus - järjestelmä,	Tieto replikoidaan Intimestä!
	EducationProgramName	Intime koulutusohjelman nimi	varchar	100	Pakollinen	IntimePlus - järjestelmä,	Tieto replikoidaan Intimestä!
	IsInUse	On käytössä	boolean		Oletus: false		Onko koulutusohjelma käytössä?

Avoimet kysymykset:

intimeplussan tietotyypit ja tietuepituudet

...

Puuttuvat taulut:

...


Root	EServiceChannel	Asiointikanavat
Taso +	Channel	Kanava taso	taso
+	ChannelName	Kanavan nimi	string		Uniikki, Pakollinen
+	ChannelAppId	Kanavan liikennöintitunnus	string	32		Metropolia määritysten mukainen sovellustunnus.
Taso ++	ChannelRights	Kanavan oikeudet	taso
++	SOAApp	Palveluväylä sovellus	string		Pakollinen
++	Right	Käyttöoikeus	string		Pakollinen	Määritelty käyttöoikeus palveluväyläsovellukseen.

...

4.2.5.15 Järjestelmäparametrit

...

Asiointipalvelun järjestelmäparametrit tallennetaan CodeIgniterin määritystiedostoihin. Muunneltavat parametrit määritellän kehitysvaiheessa.

Palveluväylän järjestelmäparametrit tallennetaan beans-parametreina. Muunneltavat parametrit määritellään kehitysvaiheessa.

...

Tietokanta - taulut

...

Tietokannan eri taulujen väliset relaatiot on kuvattu seuraavassa kaaviossa:

...

Tietokanta - taulut

...

Puuttuvat kentät:

Määriteltävää:

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

Muuta:

StudyImplementation.FK_IntimeEducationProgram_IntimeEducationProgramID ei pitäisi viitanta Product-tauluun.
Miksi StudyImplementation.StudyUnitDescription ei asu Product-taulussa? Senhän ei pitäisi muuttua toteutusten välillä?
Assignment.CreatedFromBasket?

4.2.6 Tekniset vaatimukset

...

Järjestelmän palveluväyläosion palveluväylä toteutukseksi on valittu Apache ServiceMix. Tuotteesta valitaan käyttöönotettavaksi käyttöönottohetkellä kehitystyössä vakaaksi todettu versio. Versio voi olla myös jonkin muun toimittajan jakeluun perustuva ServiceMix versio. ServiceMixistä voidaan kehitystyössä käyttää tarpeelliseksi katsottuja tekniikoita.
Palveluväylä rajapinnat toteutetaan xml-rajapinnoilla, joita voi käyttää myös restful-tekniikoilla (Apache CXF). Joissakin käyttöliittymä kysymyksissä kannattanee tutkia myös JSON-rajapintojen käyttöä.
Palveluväylän takana olevat tietokannat toteutetaan MySQL-tietokantoina.
Teknisiä määrittelyjä voidaan tarkentaa, mikäli kehitystyössä kohdataan tarkentamista vaativia kohtia.
...

4.2.7 OPI-Maksut projektin vaatimuksien huomioon ottaminen

...

OPI-maksut projektin vaatimukset on pyritty ottamaan huomioon, kun järjestelmän teknistä rakennetta on suunniteltu. Toiminnot ja rajapinnat on pyritty yleistämään ja yksinkertaistamaan, kuitenkin luopumatta järjestelmälle ennen määrittelyä asetetuista tavoitteista.

Suurimpana ongelmana yleisen toteutuksen kehittämisessä tulee olemaan eri korkeakoulujen talouden ohjaus menetelmät ja prosessit, talousjärjestelmä sekä talousautomaation toteutus. Todennäköisesti näiden kohdalla toteutuksia on lähes yhtä monta kuin korkeakouluja. Tämän vuoksi talousautomaation toteutus tullee vaatimaan työtä myös jatkossa.

5. Toteutussuunnitelma

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

...

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

6.4

...

Käyttöönottovaiheen 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.

...

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.

...

Syöttöpohjat

...

Tyhjäpohja: Prosessikuvaus

...

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?

Maksamisen ohjattu toiminto, kts. vastaava kohta määrittelyn käyttötapauksista.

Child pages

Page History

Versions Compared

Old Version 144

New Version Current

Key

1. Johdanto

1.2

Kehitettävät tietojärjestelmät sekä niiden tietoliittymät muihin tietojärjestelmiin

4.1 Asiointipalvelu

4.1.2 Rajapinnat

4.1.3 Raportit ja listaukset

4.1.5 Käyttöoikeudet

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.1.2 Rajapinnat

4.1.3 Raportit ja listaukset

4.1.5 Käyttöoikeudet

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.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

Tietokanta - Käsitekartta

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

4.2.5.2 Person-taulu: Henkilötiedot

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

Tietokanta - Käsitekartta

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

4.2.5.4 Product-taulu: Tuote tiedot

4.2.5.

7 AssignmentRow-taulu:

Toimeksiantorivi-taulu

4.2.5.6 Assignment-taulu: Toimeksianto-taulu

4.2.5.8 Log-taulu: Loki-taulu

4.2.5.9 UserProfiles-taulu: Käyttäjäprofiilitaulu

4.2.5.7 AssignmentRow-taulu: Toimeksiantorivi-taulu

4.2.5. Basket-taulu: Poimintakori-taulu

4.2.5. BasketRow-taulu: Poimintakoririvi-taulu

4.2.5.8 Basket-taulu: Poimintakori-taulu

4.2.5.

10 IntimeProduct-taulu:

IntimePlus-

järjestelmästä replikoidut tuotteet

4.2.5.

11 IntimeProject-taulu: IntimePlus-järjestelmästä replikoidut

projektit

4.2.5.12 IntimeEducationProgram-taulu: IntimePlus-järjestelmästä replikoidut koulutusohjelmat

4.2.5.

13 Vetuma-asetukset

4.2.5.14 Asiointikanavat

4.2.5.12 IntimeEducationProgram-taulu: IntimePlus-järjestelmästä replikoidut koulutusohjelmat

4.2.5.15 Järjestelmäparametrit

Tietokanta - taulut

Tietokanta - taulut

Puuttuvat kentät:

Muuta:

4.2.6 Tekniset vaatimukset

4.2.7 OPI-Maksut projektin vaatimuksien huomioon ottaminen