Vaatimusluettelo rajapinnoille ja liittymille Ulkoiset ajapinnat ja liittymät (SPECS-189) -palvelukortti Muutoshistoria Versio Päiväys Muokkaaja Kommentti 0.51 Edellinen draft 0.60 20.2.2013 Arto Puikkonen 0.70 22.2.2013 Juha Tretjakov 0.71 27.2.2013 Arto Puikkonen 0.72 14.3.2013 Mikko Ahonen Muunnettu taulukko ohjelmallisesti luettavaan muotoon Päivitetty prioriteettisaraketta julkaisurytmin mukaan: 1 = "punainen lanka" (maaliskuun 2013 julkaisu); 2 = minimitila 2. asteelle syksyllä; 3 = tavoitetila 2. asteelle syksyllä; 4 = minimitila lokakuun julkaisuun; 5 = myöhempien julkaisujen tavoitetila ID muutettu muotoon UJL (Aiemmin L) ja nimestä poistettu "Toiminnalliset vaatimukset" Lisätty tila Avoin kaikille vaatimuksille Palvelun tulee täyttää omalta osaltaan myös ei-toiminnalliset vaatimukset. ID Vaatimus Vaatimuksen esittäjä Päivämäärä Tila Julkaisu Tärkeys Perustelu Toimittajan kommentit T=Yleinen teknin vaatimus =ajapintakoh vaatimus V_UJL_10 siirtää oppijan verkkopalvelusta koulutustarjontatietoja muihin järjestelmiin (esim. opintohallinnon järjestelmät). Koulutustarjonnan käyttötapaukset 1b\B4 20.8.2012 Avoin 2 pitää jakaa osiin V_UJL_11 Koulutuksen järjestäjien virkailijoiden täytyy voida siirtää oppijoiden tutkinto- ja opintosuoritustietoja oppijan Valmistautuminen hakuun, TO 20.8.2012 Avoin 1 pitää jakaa osiin. Virta? V_UJL_12 V_UJL_13 V_UJL_14 siirtää tutkinto- ja opintosuoritustietoja muihin järjestelmiin (esim. KELA, TEM, jne) Koulutuksen järjestäjän virkailijan täytyy voida siirtää oppijan opinto-oikeus, opintojen vastaanotto ja läsnäolotiedot sekä voimassa olevat tutkintoon johtavat opinto-oikeudet oppijan Opetushallituksen virkalijan täytyy voida siirtää oppijan opinto-oikeus, opintojen vastaanotto ja läsnäolotiedot sekä voimassa olevat tutkintoon johtavat opinto-oikeudet muihin kolmannen osapuolen järjestelmiin (KELA, TEM) Kela-käyttötapaukset 20.8.2012 Avoin 4 pitää jakaa osiin. 2-tiimi vastaa tarjonnan siirtämisestä. Tutkinnot? Yleinen vaatimus 6.9.2012 Avoin 1 Yleinen vaatimus 6.9.2012 Avoin 4 V_UJL_15 Koulutuksen järjestäjän virkailijan täytyy voida siirtää sijoittelupalvelun tarvitsemat tiedot (esim. koepisteet ja lisänäytöt) oppijan Valintojen toteuttaminen - ylätason proosa 20.8.2012 Avoin 2
V_UJL_16 Syöttötietojen virhekäsittely tulee toteuttaa mahdollisimman yksityiskohtaisesti. Virheviestin tulee kertoa selkokielisesti missä kohtaa virhe on 20.8.2012 Avoin 2 Vähemmän teknisten ihmisten on ymmärrettävä viestin sisältö. V_UJL_17 V_UJL_18 Virheellisissä tiedonsiirroissa täytyy voida eristää virheellinen tieto ja pystyä käsittelemään virheettömät tietueet. Virheen sijainnista tultava virheilmoitus Virkalijan täytyy voida valita onko tiedonsiirto täydentävää vai korvaavaa 20.8.2012 Avoin 2 20.8.2012 Avoin 1 V_UJL_19 Organisaatiotiedot täytyy voida siirtää Yritystietojärjestelmästä (YTJ) Oppijan Organisaatiotietojen siirto 20.8.2012 Valmis 2 Valmis 11.4.2013 muuten, mutta ei ajastettua massasiirtoa. Organisaatiota luotaessa voi hakea YTJ:stä. V_UJL_20 siirtää organisaatiotiedot oppijan verkkopalvelusta johonkin muuhun järjestelmään (Salama, Aipal jne.) Organisaatiotietojen siirto 20.8.2012 Avoin 2 Aika monesta järjestelmästä sammutettava virta jos näitä ei saada siirrettyä.vrt. Koulutan sidokset. V_UJL_21 V_UJL_22 siirtää oppijoiden henkilötiedot Väestörekisterikeskuksen (VK) järjestelmästä oppijan siirtää oppijoiden henkilötietoja johonkin muuhun järjestelmään (Kela, jne) Henkilötietojen siirrot 20.8.2012 Avoin 1 Henkilötietojen siirrot 20.8.2012 Avoin 2 V_UJL_23 Oppijan verkkopalvelun käyttäjien tunnistetiedot täytyy pystyä lukemaan tunnistepalveluista (HAKA, Vetuma, Virtu ja Katso) Käyttäjähallinnon määrittely 20.8.2012 Avoin 1 V_UJL_24 Koodistopalvelun käyttäjän täytyy voida ladata koodistoja omaan järjestelmäänsä rajapinnan avulla tai siirtotiedostona Koodistopalvelu: lataa koodisto (download, selain), 20.8..2012 Avoin 2 HUOM! käyttötapauksen mukaan manuualisiirrot ja automaattisiirrot hoituvat samalla rajapinnalla. V_UJL_25 Koodistopalvelun käyttäjän täytyy voida tuoda koodisto omasta järjestelmästään koodistopalveluun rajapinnan avulla tai siirtotiedostona Koodistopalvelu: tuo koodisto ulkoisesta lähteestä (upload selain) 20.8..2012 Avoin 2 V_UJL_26 Koulutuksen järjestäjien järjestämis - ja koulutusluvat täytyy pystyä lukemaan järjestämislupajärjestelmistä 20.8..2012 Avoin 2 Kouten korvaajasta haettava ammatillisen koulutuksen koulutusluvat V_UJL_27 siirtää pitkäaikaissäilytettävät tiedot Arkistolaitoksen VAPA-palveluun. 20.8..2012 Avoin 4 Tarkennettava V_UJL_28 Koulutuksen järjestäjän virkailijan täytyy pystyä siirtämään valintaesitys omaan tietojärjestelmään 20.8.2012 Avoin 2 Tarkistettava V_UJL_29 Koulutuksen järjestäjän täytyy pystyä siirtämään tiedot valintapäätöksestä oppijan Valintatulosten raportointi 20.8.2012 Avoin 3 V_UJL_30 siirtää valintapäätökset KELA:n tietojärjestelmään 20.8.2012 Avoin 2 V_UJL_31 Yleissivistävän ja ammatillisen koulutuksen Opetussuunnitelmien ja tutkintojen perusteet eops 6.9.2012 Avoin 3
V_UJL_32 muodostaa ja lähettää e-kirjeitä aspara esiselvitys 20.8.2012 Avoin 3 V_UJL_33 ammatinkuvaustietoja oppijan Tarjonnan kuvailevat tiedot 20.8.2012 Poistettu 4?? Mihinköhän tämä viittaa? Päätetty ettei tehdä. V_UJL_34 siirtää VIPUNEN- palveluun tilastointiaineistoa 20.8.2012 Avoin 4 Eikös tämä ole automaattitoiminto ja käytännössä prioriteettiä 1. Mitä aineistua? V_UJL_35 siirtää Operatiivisia raporteja ulkopuoliseen järjestelmään 20.8.2012 Avoin 3 V_UJL_36 oppijan muuta yleistä koulutustiedotusta Tarjonnan kuvailevat tiedot 20.8.2012 Avoin 5 V_UJL_37 Virkailijan pitää voida tallentaa laskentaan tai valintaan liittyvä pistetieto tiedonsiirtona Valintojen käyttötapaukset a2) Tallenna pisteet tiedonsiirron avulla määrämuotoisesta tiedostosta esim. YTL-tiedonsiirrot, csv.) 23.8.2012 Avoin 2 V_UJL_38 Koulutustarjontaa siirrettäessä koodiston pitää olla sekä lähettäjällä että vastaanottajalla samat. Siirretyssä tiedossa tulee olla koodin UI. Koulutustarjonnan käyttötapaukset B4 ja B5 23.8.2012 Avoin 1 Pitäisikö koodin UI:in lisätä myös koodiston versio? T V_UJL_39 Virkailijan pitää voida siirtää tietoja yksittäisinä ja/tai massasiirtoina. esim. Valintojen käyttötapaukset a2) Tallenna pisteet tiedonsiirron avulla määrämuotoisesta tiedostosta esim. YTL-tiedonsiirrot, csv.) 23.8.2012 Avoin 2 T V_UJL_40 Siirtotiedostojen on oltava sovitun skeeman mukaisia. esim. Valintojen käyttötapaukset a2) 23.8.2012 Avoin 1 T V_UJL_41 Siirtotiedostoja täytyy voida tuoda/viedä järjestelmään ajastetusti. OPH:n järjestelmä ei tarjoa ajastuspalveluita. 24.8.2012 Avoin 3 T V_UJL_42 Tiedonsiirroissa ja kaiken sähköisen tiedon tallentamisessa täytyy huomioida Sähke2 pakolliset metatiedot niiden tietojen osalta, jotka ovat arkistointivelvoitteen piirissä (esim. Hakemukset). Arkistointivelvoite on sillä tiedonsiirron osapuolella, joka on siirrettävän tiedon omistaja. Arkistointivaatimukset 29.8.2012 Avoin 2 T V_UJL_44 Korkeakoulun omassa järjestelmässä tehdyssä valinta-ajossa syntyneet valintajonot täytyy voida siirtää Oppijaan. Korkeakoulun täytyy voida käyttää omia Opetushallituksen tarjoamaa palveluväylää hyödyntäviä palvelukomponentteja osana haku- ja valintaprosessia 30.8.2012 Avoin 4 V_UJL_47 Kirjautuneen hakijan hakulomakkeelle täytyy hakea automaattisesti esim. pohjakoulutustiedot rekisteristä perustuen hakijan tunnistetietoihin 30.8.2012 Avoin 4 Hakijoita ei ole vielä kevään julkaisuissa. Eikä pohjakoulutustietoja. V_UJL_48 Kirjautuneen hakijan yhteystiedot täytyy hakea automaattisesti hakulomakkeelle Väestörekisterin tiedoista 30.8.2012 Avoin 4 VK-tiedonsiirto
V_UJL_52 Korkeakoulun täytyy voida käyttää omia järjestelmiään valintojen toteuttamiseen liittyvissä laskennoissa ja teknisissä ajoissa. Omista järjestelmistä saadut tulokset täytyy voida siirtää muodostuvaan järjestelmään 30.8.2012 Avoin 4 V_UJL_54 V_UJL_55 viedä hakijatiedot valitsemastaan hakijajoukosta Excel-muotoon Järjestelmästä tehtyjen hakija- ja hakemuskohtaiset hakujen tulokset täytyy voida hakea excel-taulukkomuotoon #20 #25 V_UJL_56 Virkailijan luomat tiedotustekstit täytyy voida tuoda palveluun koulutustoimijan omista järjestelmistä #31 V_UJL_58 tiedotustekstejä järjestelmästä oppilaitoksen omaan toimitustaitto-ohjelmaan. #34 V_UJL_62 V_UJL_63 Järjestelmän täytyy hakea henkilötiedot hakijarekisteristä tai VTJ:stä henkilötunnuksen perusteella, kun virkailija syöttää hakijan paperista hakemusta järjestelmään Mikäli tiedot ovat sähköisesti saatavilla TO:sta ja mikäli hakukohde sisältää tiedot siitä, että arvosanatiedot tarvitaan valintaa varten, täytyy järjestelmän hakea myös pohjakoulutustiedot ja sähköiset todistus- ja arvosanatiedot kun virkailija syöttää hakijan paperista hakemusta järjestelmään. Jos tietoja ei ole saatavilla, täytyy virkailijan syöttää hakijan hakemukseen kirjaamat arvosanat #84 #85 V_UJL_64 Järjestelmän täytyy lähettää tieto hakijalle ja alaikäisen hakijan huoltajalle (jos hakija on antanut luvan) sähköpostitse tai sähköisenä kirjeenä kun paperinen hakemus on tallentunut järjestelmään #86 smtp-rajapinta V_UJL_65 Hakemukseen tehdyistä muutoksista ja mitätöinneistä täytyy lähettää hakijalle ja alaikäisen hakijan huoltajalle (jos hakija on antanut luvan) sähköpostitse tai sähköisenä kirjeenä #95 V_UJL_70 Järjestelmään tuotavilla sähköisillä tiedostoilla täytyy olla ennalta määritetty maksimikoko ja määritettynä tuetut tiedostomuodot #111 31.8.2012 Avoin 2 V_UJL_71 määrittää vaatimukset oppilaitokseen toimitetuille liitteille ja ennakkotehtäville #112 V_UJL_73 liittää sähköisessä muodossa toimitetut liitteet hakemukseen #118 31.8.2012 Avoin 5 Ei kuulu skooppiin V_UJL_74 hakemukset liitteineen omaan opintohallinto- tai muuhun järjestelmään jatkokäsittelyä varten #120
V_UJL_75 Virkailijan tekemät henkilölistaukset täytyy voida tallentaa PDF:nä tai Excel-formaatissa virkailijan omalle tietokoneelle tai tulostaa #123 V_UJL_76 Lukion virkailijan täytyy voida hakea hakemuksen yhteydessä täytetyt ainevalintakortit ja tallentaa ne Excel-formaatissa omalle tietokoneelle tai tulostaa #127 V_UJL_77 Virkailijan täytyy lähettää valintakokeeseen tai haastatteluun tulijoille valintakoekutsun hakijan valitsemalla viestintäkanavalla (sähköposti, sähköinen kirje, paperikirje, tekstiviesti) #130 31.8.2012 Avoin 2 V_UJL_78 Varasijalta hyväksytylle täytyy lähteä viesti hyväksynnästä hakijan valitsemalla viestintäkanavalla #154 05.9.2012 Avoin 4 V_UJL_79 Korkeakoulun virkailijan täytyy toimittaa tarvittavat henkilöiden tulostiedot mukaan sijoitteluun, jos korkeakoulu ei käytä hakeutujan palveluiden valintapalvelua. Tiedot täytyy voida siirtää järjestelmään rajapintaratkaisuna, perättäistiedostoina tai tiedot voidaan tallentaa suoraan hakijoiden hakemusten tietoihin sähköiselle työpöydältd class="confluencetdle", #142 V_UJL_80 Muissa peruskoulutuksen jälkeisissä koulutuksissa koulutusorganisaation valintatulostiedot täytyy voida tuoda järjestelmään opintohallintojärjestelmistä tai Excelistä #164 liittyy käyttötapaukseen #29. Valintatulos ja valintapäätös määriteltävä. V_UJL_81 Järjestelmän viestinnässä viranomaisten päätökset täytyy voida lähettää (VIP)-asi ointitilille, mikäli hakija on valinnut sen omassa profiilissaan viestintäkanavaksi #166 V_UJL_82 OPH:n virkailijan täytyy lähettää jälkiohjauskirjeet sähköisen kirjepalvelun avulla #167 V_UJL_83 Järjestelmän ja OPH:n virkailijan täytyy voida lähettää tekstiviestejä #168 03.9.2012 Avoin 5 V_UJL_85 muodosta PDF ja Excel-muotoisia raportteja niin, että raportissa näkyy hakeneet, hyväksytyt, paikan vastaanottaneet, valintaesitys, kokeet ja lisänäytöt, joustavan valinnan kokeet ja lisätyöt, koetulosten tallennustilanne, peruutetut koulutukset, valintakoetulosten tallennustilanne, hakutoivetilasto #189 03.9.2012 Avoin 4 V_UJL_88 Sisällönhallintajärjestelmällä tuodulla sisällöllä täytyy olla määritettynä tiedon tila (onko tieto valmis julkaistavaksi), tiedon voimassaoloaika ja kuka on tehnyt päätöksen tiedon julkaisemisesta #198 03.9.2012 Avoin 2 Onko tämä rajapintavaatimus vai onko tämä mieluummin tietosisältöasiaa?
V_UJL_89 Koulutustiedon verkkopalvelusta valittujen ajankohtaistietojen täytyy siirtyä automaattisesti palvelun Facebook-sivuille #199 03.9.2012 Avoin 5 V_UJL_99 YTJ-tiedot täytyy voida päivittää tietyin väliajoin järjestelmään eräsiirtona hallinnalle, #41 03.9.2012 Avoin 2 V_UJL_100 V_UJL_102 V_UJL_106 OPH:n pääkäyttäjän täytyy voida hakea manuaalisesti tietojen päivityksiä YTJ:stä YTJ-tietojen epäonnistuneesta päivityksestä täytyy lähettää järjestelmän pääkäyttäjälle/ylläpitäjälle sähköposti Eri toimijoiden, oppilaitosten ja toimipisteiden täytyy voida päivittää omia perustietojaan ja yhteystietojaan omissa järjestelmissään ja siirtää tiedot automaattisesti päivityspalvelulla Oppijan verkkopalveluihin hallinnalle, #42 hallinnalle, #43 hallinnalle, #112 03.9.2012 Avoin 2 03.9.2012 Avoin 2 toteutetaan kuten vaatimus 6 03.9.2012 Avoin 5 Organisaatiotietojen master data tulee YTJ:stä. Miksi toimijat voisivat muokata niitä? V_UJL_107 V_UJL_109 V_UJL_110 Yhteystiedot on voitava viedä toisiin järjestelmiin rajapinnan ja/tai siirtotiedoston avulla koulutusmoduulin toteutus järjestelmästä tiedostona ulos (esim XML-tiedosto) koulutusmoduulin toteutuksesta muodostettu tiedosto omaan oppilashallintojärjestelmäänsä hallinnalle, #117 hallinnalle, #59 hallinnalle, #60 03.9.2012 Avoin 3 V_UJL_111 V_UJL_112 tuoda koulutusmoduulin toteutus järjestelmään ulkoisella tiedostolla (esim. XML-tiedosto) Virkailijan täytyy määrittää mille kaudelle toteutus tuodaan, kun virkailija tuo koulutusmoduulin toteutusta järjestelmään ulkoisella tiedostolla hallinnalle, #61 hallinnalle, #62 V_UJL_113 Järjestelmään ulkoisella tiedostolla tuodun koulutusmoduulin toteutuksen tila on oletuksena "suunnitteilla" hallinnalle, #63 V_UJL_114 siirtyä tarkastelemaan ja muokkaamaan tuotua koulutusmoduulin toteutusta tuonnin jälkeen. hallinnalle, #64 V_UJL_115 muuttaa tuodun koulutusmoduulin toteutuksen tila valmiiksi, ei julkaistuksi tai perutuksi. hallinnalle, #65 V_UJL_117 V_UJL_118 tulostaa oman koulutustoimensa tai oppilaitoksensa tarjontatiedot painetuksi oppaaksi. Tiedot täytyy voida tulostaa suoraan järjestelmästä tai siirtämällä ne ensin erilliseen toimitusjärjestelmään Tarjontatiedot täytyy voida linkittää oppilaitoksen omille sivuille hallinnalle, #101 hallinnalle, #103 03.9.2012 Avoin 5 03.9.2012 Avoin 3 Tämähän on aika helppo palvelu tarjottavaksi
V_UJL_119 V_UJL_120 Hakijan täytyy voida tulostaa lähetetty hakulomake pdf- tai html-muotoisena Hakija voi liittää hakulomakkeeseen liitteen sähköisessä muodossa hakulomakkeelle, #221 hakulomakkeelle, #219 03.9.2012 Avoin 3 Toiminnallisuusvaatimus 03.9.2012 Avoin 4 Liiteri-palvelun kysymys V_UJL_121 Liiterin kautta välitettävän liitteen muoto ja suurin sallittu koko täytyy voida määritellä (virkailijan toiminto) hakulomakkeelle, #225 - #226 03.9.2012 Avoin 4 Liiteri-palvelun kysymys V_UJL_123 liittää hakulomake sähköpostiin hakulomakkeelle, #110 03.9.2012 Avoin 3 V_UJL_124 Järjestelmästä tehtyjen hakija- ja hakemuskohtaiset hakujen tulokset täytyy voida hakea excel-taulukkomuotoon hakulomakkeelle, #25 03.9.2012 Avoin 4 V_UJL_125 V_UJL_128 V_UJL_133 V_UJL_135 V_UJL_136 OPH:n henkilöstön tulee voida kertakirjautua AD-domainiin Käyttäjä voi heikosti tunnistaa itsensä käyttäen web 2.0 palvelua (esim gmail) Vahvasti tunnistautunut käyttäjä voi tarkastella itsestään järjestelmään tuotuja viranomaistietoja Session ja identiteetin siirtäminen Oppijasta ulkopuoliseen palveluun ja päinvastoin tulee onnistua Virkailijan täytyy pystyä hakemaan yksittäisiä tietoja ja rajaamalla tietoa hakuehdoilla. käyttäjähallinnalle, #1 käyttäjähallinnalle, #10 käyttäjähallinnalle, #36 käyttäjähallinnalle, #61 03.9.2012 Poistettu 3 HAKA-federointi 03.9.2012 Poistettu 5 Määritelty muissa vaatimusluetteloissa 03.9.2012 Avoin 2 Tietojen metatiedot (lähde) täytyy olla saatavilla 03.9.2012 Poistettu 2 11.1.2013 Avoin 4 ajapinnan kautta voidaan hakea koulutuksia esimerkiksi rajaamalla se organisaation mukaan