Vaatimusluettelo rajapinnoille ja liittymille

Transkriptio

1 Vaatimusluettelo rajapinnoille ja liittymille Ulkoiset ajapinnat ja liittymät (SPECS-189) -palvelukortti Muutoshistoria Versio Päiväys Muokkaaja Kommentti 0.51 Edellinen draft Arto Puikkonen Juha Tretjakov Arto Puikkonen 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\B 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 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 Avoin 4 pitää jakaa osiin. 2-tiimi vastaa tarjonnan siirtämisestä. Tutkinnot? Yleinen vaatimus Avoin 1 Yleinen vaatimus 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 Avoin 2

2 V_UJL_16 Syöttötietojen virhekäsittely tulee toteuttaa mahdollisimman yksityiskohtaisesti. Virheviestin tulee kertoa selkokielisesti missä kohtaa virhe on 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 Avoin Avoin 1 V_UJL_19 Organisaatiotiedot täytyy voida siirtää Yritystietojärjestelmästä (YTJ) Oppijan Organisaatiotietojen siirto Valmis 2 Valmis 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 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 Avoin 1 Henkilötietojen siirrot 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 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), 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) Avoin 2 V_UJL_26 Koulutuksen järjestäjien järjestämis - ja koulutusluvat täytyy pystyä lukemaan järjestämislupajärjestelmistä Avoin 2 Kouten korvaajasta haettava ammatillisen koulutuksen koulutusluvat V_UJL_27 siirtää pitkäaikaissäilytettävät tiedot Arkistolaitoksen VAPA-palveluun Avoin 4 Tarkennettava V_UJL_28 Koulutuksen järjestäjän virkailijan täytyy pystyä siirtämään valintaesitys omaan tietojärjestelmään Avoin 2 Tarkistettava V_UJL_29 Koulutuksen järjestäjän täytyy pystyä siirtämään tiedot valintapäätöksestä oppijan Valintatulosten raportointi Avoin 3 V_UJL_30 siirtää valintapäätökset KELA:n tietojärjestelmään Avoin 2 V_UJL_31 Yleissivistävän ja ammatillisen koulutuksen Opetussuunnitelmien ja tutkintojen perusteet eops Avoin 3

3 V_UJL_32 muodostaa ja lähettää e-kirjeitä aspara esiselvitys Avoin 3 V_UJL_33 ammatinkuvaustietoja oppijan Tarjonnan kuvailevat tiedot Poistettu 4?? Mihinköhän tämä viittaa? Päätetty ettei tehdä. V_UJL_34 siirtää VIPUNEN- palveluun tilastointiaineistoa 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 Avoin 3 V_UJL_36 oppijan muuta yleistä koulutustiedotusta Tarjonnan kuvailevat tiedot 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.) 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 B 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.) Avoin 2 T V_UJL_40 Siirtotiedostojen on oltava sovitun skeeman mukaisia. esim. Valintojen käyttötapaukset a2) Avoin 1 T V_UJL_41 Siirtotiedostoja täytyy voida tuoda/viedä järjestelmään ajastetusti. OPH:n järjestelmä ei tarjoa ajastuspalveluita 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 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 Avoin 4 V_UJL_47 Kirjautuneen hakijan hakulomakkeelle täytyy hakea automaattisesti esim. pohjakoulutustiedot rekisteristä perustuen hakijan tunnistetietoihin 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 Avoin 4 VK-tiedonsiirto

4 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 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 # 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 # Avoin 5 Ei kuulu skooppiin V_UJL_74 hakemukset liitteineen omaan opintohallinto- tai muuhun järjestelmään jatkokäsittelyä varten #120

5 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) # Avoin 2 V_UJL_78 Varasijalta hyväksytylle täytyy lähteä viesti hyväksynnästä hakijan valitsemalla viestintäkanavalla # 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ä # 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 # 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 # Avoin 2 Onko tämä rajapintavaatimus vai onko tämä mieluummin tietosisältöasiaa?

6 V_UJL_89 Koulutustiedon verkkopalvelusta valittujen ajankohtaistietojen täytyy siirtyä automaattisesti palvelun Facebook-sivuille # Avoin 5 V_UJL_99 YTJ-tiedot täytyy voida päivittää tietyin väliajoin järjestelmään eräsiirtona hallinnalle, # 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, # Avoin Avoin 2 toteutetaan kuten vaatimus 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, # 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, # Avoin Avoin 3 Tämähän on aika helppo palvelu tarjottavaksi

7 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, # Avoin 3 Toiminnallisuusvaatimus 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 - # Avoin 4 Liiteri-palvelun kysymys V_UJL_123 liittää hakulomake sähköpostiin hakulomakkeelle, # Avoin 3 V_UJL_124 Järjestelmästä tehtyjen hakija- ja hakemuskohtaiset hakujen tulokset täytyy voida hakea excel-taulukkomuotoon hakulomakkeelle, # 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, # Poistettu 3 HAKA-federointi Poistettu 5 Määritelty muissa vaatimusluetteloissa Avoin 2 Tietojen metatiedot (lähde) täytyy olla saatavilla Poistettu Avoin 4 ajapinnan kautta voidaan hakea koulutuksia esimerkiksi rajaamalla se organisaation mukaan