Potilastiedon arkiston; Resepti-palvelun; Sosiaalihuollon asiakastiedon arkiston ja Kuva-aineistojen arkiston yhteistestaus 20.9.2018 Kanta-palvelut
2 Muutoshistoria Versio Muutos Tekijä PVM 1.0 Ensimmäinen julkaistu versio Kanta-palvelut 27.3.2015 1.1 Sähköisen Reseptin yhteistestauksen aloitusajankohtien päivämäärät pois-tettu. Tieto löytyy nyt kanta.fi Testaus sivulta. Validaattoritestit lisätty. Kanta-palvelut 16.11.2015 Täsmennetty arkiston yhteistestauksen ilmoittautumismenettelyä. Korvattu käyttötapauksia esittelevä luku viittauksella alkuperäiseen määrittelyyn. Esitelty lyhyesti testitapauksia. 1.2 Lisätty Sosiaalihuollon asiakastiedon arkiston osuudet. Yhdistetty yhteistestaus-osiot koskemaan yleisluontoisesti kaikkia palveluita. Kanta-palvelut 31.5.2017 Muutettu: Sähköinen resepti = Resepti 1.3 Tarkennettu yhteistestaukseen ilmoittautumisen ohjetta. Kanta-palvelut 20.9.2018 Tarkennettu yhteistestauksen testitapausten luonnetta ja rajallisuutta suhteessa muuhun tarvittavaan testaukseen. Lisätty tuotannonkuvaympäristön ja Kuvaaineistojen arkiston osuudet sekä EU:n tietosuojaasetuksen vaikutukset Kanta-testipalveluihin.
3 Sisällysluettelo 1. Johdanto... 5 1.1 Määritelmät... 6 1.2 Dokumentaatio... 8 2 Kanta-palvelujen testiympäristöt... 8 2.1 Testipalvelut... 9 2.1.1 Validointipalvelu... 9 2.1.2 Asiakastestipalvelu... 10 2.1.3 Asiakastestiympäristö... 10 2.1.4 Tuotannonkuvaympäristö... 10 2.1.5 Omakanta-testipalvelu... 11 2.2 Asiakastestipalveluun liittyminen... 11 2.3 Asiakastestipalvelun palveluaika, päivitykset ja huoltokatkot... 11 2.4 Testiaineiston luonti... 12 2.5 Testihenkilötunnukset ja tunnistetiedot... 12 3 Yhteistestauksen osapuolten vastuut... 13 3.1 Tietojärjestelmätoimittajan vastuu... 13 3.2 Tietojärjestelmätoimittajan asiakasorganisaation vastuu... 14 3.3 Kelan vastuu... 15 3.4 Muiden osapuolten vastuut... 16 4 Yhteistestaus... 16 4.1 Tavoite ja rajaukset... 17 4.2 Testausaikataulu... 17 4.3 Aloittamisen edellytykset... 19 4.3.1 Tietojärjestelmätoimittajan testaus omassa testiympäristössään... 19 4.3.2 Liittyminen Kanta-asiakastestipalveluun ja omatoiminen testaus... 19 4.3.3 Erillisjärjestelmien integraatiot... 20
4 4.3.4 Ilmoittautuminen yhteistestaukseen... 21 4.3.5 Hyväksyminen yhteistestaukseen... 21 4.4 Yhteistestauksen vaiheet... 22 4.4.1 Tietojärjestelmätoimittajan ja Kelan välinen testaus... 22 4.4.2 Tietojärjestelmätoimittajan asiakasorganisaation ja Kelan välinen testaus... 23 4.4.3 Ristiintestaus... 24 4.4.4 Tarkistuspalaverit... 27 4.5 Hyväksymiskriteerit ja raportointi... 27 4.5.1 Yhteistestauksen aloitus- ja hyväksymiskriteerit... 28 4.5.2 Testauksen keskeyttäminen ja jatkaminen... 29 4.5.3 Testauksen keskeyttäminen ja hylkäämiskriteerit... 29 4.6 Virheiden korjaus... 29 4.7 Kelan tuki... 30 5 Virhetilanteiden käsittely... 30 6 Tietojärjestelmätoimittajan ja sen asiakasorganisaation sitoutuminen... 32 6.1 Resepti-palvelun testilääkemääräykset... 32 6.2 Potilastiedon arkiston vertailutestipotilaat... 32
5 1. Johdanto Yhteistestaus on Kanta-palvelujen toiminnallisuuksien suunnitelmallista testausta Kanta-asiakastestipalvelun ja Kantaan liitettävien tietojärjestelmien välillä niiden yhteentoimivuuden todentamiseksi. Yhteistestaus on osa A-luokan tietojärjestelmän sertifiointia, ja Kela laatii hyväksytysti suoritetusta yhteistestauksesta lausunnon. Ennen yhteistestauksen aloittamista tietojärjestelmätoimittajan on toimitettava Kelalle selvitys toiminnallisten vaatimusten toteutumisesta erillisellä järjestelmälomakkeella. Terveyden ja hyvinvoinnin laitos (jatkossa THL) antaa ohjeistuksen järjestelmälomakkeen täyttämisestä. Tämä dokumentti on tarkoitettu yhteistestaukseen osallistuville tietojärjestelmien toimittajille, terveyden- ja sosiaalihuollon organisaatioille sekä apteekeille. Sosiaali- ja terveydenhuollon organisaatiot ja apteekit ovat mukana ensisijaisesti tietojärjestelmätoimittajien asiakastestaajina. Dokumentin määrittämät yhteistestauksen menettelyt koskevat sekä ensimmäistä kertaa yhteistestaukseen osallistuvia tietojärjestelmiä että jatkokehitystä, jolla laajennetaan tai muutetaan jo kertaalleen yhteistestauksen läpäisseen ja tuotantoon viedyn tietojärjestelmän toiminnallisuutta. Muutokset toteutetaan kansallisen muutoksenhallintaprosessin mukaan. Seuraavat testauksen osa-alueet eivät kuulu Kelan koordinoimaan yhteistestaukseen: yhteistestauksen esikriteerinä oleva tietojärjestelmätoimittajan toiminnallisten vaatimusten testaus, Kanta-palveluihin liitettävän tietojärjestelmän version hyväksymistestaus ja käytettävyystestaus. Nämä järjestelmätoimittaja organisoi itsenäisesti ja yhteistestauksen aikataulusta riippumattomasti, suorituskykytestaus Kanta-palveluille ja niihin liitettäville tietojärjestelmille tuotannon aikaisiin kiirekorjauksiin ja muuhun ylläpitoon liittyvä testaus sertifiointiin liittyvä tietoturvatestaus Luvussa 4 käsitellään tarkemmin yhteistestausta ja sen käytäntöjä.
6 1.1 Määritelmät Yhteistestaukseen liittyvät kysymykset ja tiedustelut voi lähettää sähköpostilla osoitteeseen yhteistestaus@kanta.fi. Kirjoita viestin otsikkoon, mitä palvelua asia koskee: Resepti-palvelu, Potilastiedon arkisto, Sosiaalihuollon asiakastiedon arkisto vai Kuva-aineistojen arkisto. Asiakasorganisaatio Sosiaali- tai terveydenhuollon organisaatio tai apteekki, joka osallistuu tietojärjestelmän yhteistestaukseen asiakastestaajana. Tietojärjestelmän toimittaja valitsee yhteistestaukseen osallistuvan asiakasorganisaation asiakaskunnastaan. Asiakastestiympäristö Tekninen asiakastestiympäristö.liittyminen asiakastestiympäristöön tarkoittaa teknistä liittymistä liittyjän omasta testiympäristöstä. Asiakastestiympäristössä on tuotantoympäristöstä seuraava kehitysversio. Kanta-asiakastestipalvelu Sisältää kaksi testiympäristöä, asiakastestiympäristön ja tuotannonkuvaympäristön. Sisältää tukipalvelut asiakkaan itsenäisesti tekemän testauksen aikana. Kun asiakas liittyy asiakastestipalveluun, hänelle avataan yhteydet testiympäristöön ja annetaan ympäristössä käytettäviä testihenkilötunnuksia. Kanta-palvelut Terveydenhuollon valtakunnalliset tietojärjestelmäpalvelut, joihin kuuluvat Resepti-palvelu, Potilastiedon arkisto- ja Omakanta -palvelut. Kanta-palveluihin kuuluu myös Lääketietokanta, Kelain, Omatietovaranto (PHR), Sosiaalihuollon asiakastiedon arkisto ja Kuva-aineistojen arkisto. Kanta-palveluista säädetään sähköisestä lääkemääräyksestä annetussa laissa (61/2007) ja sosiaali- ja terveydenhuollon asiakastietojen sähköisestä käsittelystä annetussa laissa (159/2007) myöhempine muutoksineen. Kanta-palveluihin liitettävä tietojärjestelmä Kanta-palveluihin liitettävät tietojärjestelmät ovat potilastietojärjestelmiä, sosiaalihuollon asiakastietojärjestelmiä, apteekkijärjestelmiä tai kuvantamisen tietojärjestelmiä.
7 Kanta-testipalvelu Kokonaisuus, joka sisältää Asiakastestipalvelun, Validointipalvelun, Kantapalvelujen koordinoiman yhteistestauksen sekä tuen asiakkaan itsenäisesti tekemän testauksen aikana. Ristiintestaus Yhteistestausvaihe, jossa kahden tai useamman tietojärjestelmän testausympäristöstä testataan, että tietojärjestelmien tuottamat sanomat ovat tulkittavissa teknisesti ja sisällöltään samanlaisina kaikissa testaukseen osallistuvissa tietojärjestelmissä. Tietojärjestelmätoimittajan asiakasorganisaation ja Kelan välinen testaus Yhteistestausvaihe, jossa testataan palveluiden toiminnallisuuksia ja tietosisältöä laajemmin tietojärjestelmätoimittajan asiakasorganisaation testiympäristössä tuotantokäyttöä vastaavalla tavalla. Testauksen tavoitteena on todentaa tietojärjestelmän ja Kanta-palvelujen välinen toimivuus asiakasorganisaation käytössä. Tietojärjestelmätoimittajan ja Kelan välinen testaus Yhteistestausvaihe, jonka tavoitteena on testata Kanta-palveluihin liitettävän tietojärjestelmän ja Kanta-palveluiden välistä toiminallisuutta erilaisten testitapausten avulla. Tuotannonkuvaympäristö Tekninen tuotannonkuvaympäristö.liittyminen tuotannonkuvaympäristöön tarkoittaa teknistä liittymistä liittyjän omasta testiympäristöstä. Tuotannonkuvaympäristössä on tuotantoympäristöä vastaava kehitysversio. Tuotannonkuvaympäristö on tarkoitettu ensisijaisesti omatoimiseen testaukseen. Validointipalvelu Omatoimiseen testaamiseen tarkoitettu selainpohjainen työkalu, jonka tarkoituksena on tarkistaa HL7 CDA R2 -asiakirjojen tietorakenteita. Validointipalvelu on vapaasti käytössä ja sen käyttö on maksutonta. Yhteentoimivuus Tietojärjestelmien tekninen ja tietosisällöllinen toimivuus muiden tietojärjestelmien kanssa yhteen silloin, kun järjestelmät käyttävät samoja tietoja. Yhteistestauksessa todennetaan, että tietojärjestelmä on yhteentoimiva Kanta-palvelujen ja siihen liitettyjen muiden tietojärjestelmien kanssa.
8 1.2 Dokumentaatio Yhteistestaus Kelan asiakastestiympäristön ja yhden tai useamman tietojärjestelmätoimittajan tai palveluntuottajan välinen Kanta-palvelujen yhteentoimivuuden testaus, jossa käytetään vakioituja, kansallisia testitapauksia ja raportointimenettelyitä. 2 Kanta-palvelujen testiympäristöt Yhteistestauksen työskentelykielenä on suomi, joten kaikki testimateriaali ja ohjeistukset ovat tarjolla vain suomeksi. Kanta-palvelut ei vastaa yhteistestauksen testimateriaalin kääntämisestä muille kielille eikä siitä mahdollisesti aiheutuvista kuluista. Asiakastestipalvelu muodostuu asiakastestiympäristöstä ja tuotannonkuvaympäristöstä. Asiakastestiympäristössä on käytettävissä Reseptin, Potilastiedon arkiston, Sosiaalihuollon asiakastiedon arkiston, Kuvaaineistojen arkiston ja Omakannan toiminnallisuudet. Kuvassa 1 on esitetty, mistä Kanta-palvelujen asiakastestiympäristö muodostuu.
9 Kuva 1 Kanta-palvelujen asiakastestiympäristö Testauksessa käytetään Väestörekisterikeskuksen testivarmenteita ja Kantapalvelujen testiympäristöjen omaa koodistopalvelua. Se on Kelan ylläpitämä ja eri kuin Terveyden ja hyvinvoinnin laitoksen (THL) tuotantokoodistopalvelu. 2.1 Testipalvelut Tuotannonkuvaympäristössä on käytettävissä tuotannon versiota vastaavia toiminnallisuuksia sekä Omakanta testauskäyttöä varten. 2.1.1 Validointipalvelu Kela tarjoaa seuraavia palveluja Kantaan liitettävien tietojärjestelmien tuotekehityksessä ja yhteistestauksissa käytettäviksi. Selainkäyttöinen testiasiakirjojen validointipalvelu on maksuton ja vapaasti käytettävissä jo ennen Kanta-palvelujen apiakastestiympäristöön liittymistä. Linkki Validointipalveluun löytyy kanta.fi-sivustolta järjestelmäkehittäjien sivuilta Testaus-osiosta. Palvelu sisältää HL7 CDA R2 -muotoisten asiakirjojen
10 validointisäännöt. Palvelu on ensisijaisesti tarkoitettu järjestelmätoimittajien tuotekehityksen testauksen tueksi. 2.1.2 Asiakastestipalvelu Sosiaalihuollon asiakastiedon arkisto -palvelussa on käytettävissä oma, erillinen SOAP-pohjainen validointipalvelu, jota asiakastestiympäristöön liittyneet sosiaalihuollon järjestelmätoimittajat voivat käyttää tuotekehityksen tukena. 2.1.3 Asiakastestiympäristö Asiakastestipalveluun liittyneillä tietojärjestelmätoimittajilla ja näiden asiakastestaajaorganisaatioilla on mahdollisuus testata tietojärjestelmiensä toiminnallisuuksia asiakastestiympäristössä ja / tai tuotannonkuvaympäristössä. Asiakastestipalvelussa voi tehdä testausta sekä ennen tietojärjestelmän sertifiointia että myöhemmässä tuotekehitysvaiheessa. Asiakastestipalvelu sisältää Reseptikeskus-, Sosiaalihuollon asiakastiedon arkisto-, Kuva-aineistojen arkisto-, Potilastiedon arkisto- ja tiedonhallintapalvelut. 2.1.4 Tuotannonkuvaympäristö Kanta-palvelujen asiakastestiympäristöön liittyneillä tietojärjestelmätoimittajilla ja asiakasorganisaatioilla on mahdollisuus testata tietojärjestelmiensä toiminnallisuuksia asiakastestiympäristössä. Asiakastestiympäristössä on tuotantoympäristöstä seuraava kehitysversio. Asiakastestiympäristö on tarkoitettu yhteistestaukseen tähtäävään omatoimiseen testaukseen sekä yhteistestauksen läpiviemiseen. Kanta-palvelujen tuotannonkuvaympäristöön liittyneillä tietojärjestelmätoimittajilla ja asiakasorganisaatioilla on mahdollisuus testata tietojärjestelmiensä toiminnallisuuksia tuotannonkuvaympäristössä. Siellä on tuotantoympäristöä vastaava kehitysversio. Asiakkaat voivat käyttää tuotannonkuvaympäristöä testatakseen tietojärjestelmiinsä tekemiään muutoksia samanlaisessa ympäristössä, joka on muutosten käyttöönottohetkellä tuotannossa. Tuotannonkuvaympäristö on tarkoitettu ensisijaisesti omatoimiseen testaukseen. Tuotannonkuvaympäristöä
11 voidaan Kelan päätöksestä käyttää myös osana yhteistestauksen läpivientiä, jos asiakastestipalvelun kehitysversio poikkeaa oleellisesti tuotannon versiosta. 2.1.5 Omakanta-testipalvelu Asiakasorganisaatioiden tulee perustella liittymisen tarve Kantatuotannonkuvaympäristöön ja toimittaa Kelaan testaussuunnitelma liittymishakemuksen yhteydessä. Kela arvioi perustelujen ja testaussuunnitelman perusteella hyväksytäänkö asiakasorganisaation hakemus. Asiakastestiympäristössä ja tuotannonkuvaympäristössä on Omakantatestipalvelu, jossa on käytettävissä informointi-, suostumus- ja kielto- sekä terveystietotoiminnallisuudet. Palvelun sisältö on testiympäristössä olevan Potilastiedon arkiston ja Reseptin versioiden mukainen. Omakantatestipalvelussa tietoja haetaan suoraan testipotilaan henkilötunnuksella ilman vahvan tunnistautumisen vaatimusta. 2.2 Asiakastestipalveluun liittyminen Sosiaalihuollon asiakastiedon arkistossa ja Kuva-aineistojen arkistossa Omakanta ei ole vielä käytössä. Sosiaalihuollon asiakastiedon arkistossa se tulee käyttöön vaiheessa II. Liittymisvaatimukset on tarkemmin kuvattu kanta.fi-sivustolla dokumentissa Liittymisohje Kanta-asiakastestipalveluun. Palveluun liittyvän tietojärjestelmätoimittajan tai tietojärjestelmätoimittajan asiakasorganisaation tulee itse pitää kirjaa omista testiorganisaatioistaan ja liityntäpisteistään, joita Kanta-testipalveluihin liitetään. 2.3 Asiakastestipalvelun palveluaika, päivitykset ja huoltokatkot Testiympäristöt ovat käytettävissä pääsääntöisesti maanantaista perjantaihin klo 8.00 16.00. Ne ovat käytettävissä muinakin aikoina, mutta varsinaisen palveluajan ulkopuolella ympäristössä voi olla päivitys- ja huoltokatkoja. Palvelun huoltoikkuna on kuukauden ensimmäinen torstai. Tällöin siinä voi olla katkoksia klo 8.00 16.00 välisenä aikana. Testiympäristöihin liittyvät ohjelmistopäivitykset tehdään tarpeen mukaan.
12 Liittyneitä organisaatioita tiedotetaan palvelukatkoista, jotka kohdistuvat edellä ilmoitettuun palveluaikaan ja mahdollisuuksien mukaan myös muista Kantatestipalvelujen katkoista. Päivityksistä ja huoltokatkoista ilmoitetaan sähköpostitse vähintään kaksi vuorokautta ennen suunniteltua käyttökatkoa. 2.4 Testiaineiston luonti Tiedotuksessa käytettävät yhteystiedot kerätään asiakastestipalvelun liittymishakemuksella. Mikäli yhteystietoihin tai yhteyshenkilöihin on tullut muutoksia, voi ne ilmoittaa sähköpostitse osoitteeseen yhteistestaus@kanta.fi. Kela toimittaa testitapaukset ja testihenkilötunnukset, joita asiakastestiympäristössä on käytettävä. Testitapaukset ovat kansallisia ja siten yhteisiä kaikille. Niitä voidaan tarvittaessa muokata vastaamaan paremmin testattavan järjestelmän käyttötarkoitusta, kuitenkin ottaen huomioon yhteistestauksen rajaukset. Käytettävät testitapaukset eivät mallinna resepti- tai potilastietojärjestelmään tehtäviä kirjauksia tai terveydenhuollon työnkulkuja kokonaisuudessaan. Yhteistestauksen testitapaukset säilytetään yhteistestauksen työtilassa testauksen päätyttyä. 2.5 Testihenkilötunnukset ja tunnistetiedot Sovitun yhteistestauksen ulkopuolella tietojärjestelmätoimittajat ja näiden asiakasorganisaatiot voivat käyttää asiakastestiympäristöä omatoimiseen testaukseen. Tietojärjestelmätoimittaja tai asiakasorganisaatio voi luoda itse testiaineistoa tarpeen mukaan. Kela toimittaa tätä varten erilliset testihenkilötunnukset, joita saa pyydettäessä myös lisää. Yhteisetestausten testitapausten tarkistusten selkeyttämiseksi ja nopeuttamiseksi yhteistestaukseen tarkoitettuja testihenkilötunnuksia ei saa käyttää omatoimiseen lisätestaukseen. Testiympäristöissä saa testata vain Kelan antamilla 900-sarjan henkilötunnuksilla eli henkilötunnus on esimerkiksi muotoa 010190-900P. 900- sarjan henkilötunnukset ovat tarkoitettuja testauskäyttöön ja ne täyttävät henkilötunnuksen muotovaatimukset, mutta ne eivät ole virallisia henkilötunnuksia. Kanta-testiympäristöön liittymisen yhteydessä Kela toimittaa järjestelmätoimittajille ja niiden asiakasorganisaatiolle tietyn määrän testihenkilötunnuksia. Muiden kuin 900-sarjan henkilötunnusten käyttäminen Kanta-palvelujen testiympäristöissä on ehdottomasti kielletty.
13 900-sarjan henkilötunnuksia käytetään myös silloin, kun henkilötunnustieto kirjataan potilaan henkilötunnuksen lisäksi myös muihin tietokohtiin. Tällaisia ovat esimerkiksi erillisen asiakirjan toisen henkilön henkilötunnus ja alaikäisen potilaan vanhemman henkilötunnus. Testihenkilötunnuksia voi pyytää osoitteesta yhteistestaus@kanta.fi. Henkilötunnuksen lisäksi kaikkien sellaisten tunnistetietojen käyttö Kantapalvelujen testiympäristöissä on kielletty, jotka liittyvät oikeaan henkilöön. Tällaisia tietoja ovat esimerkiksi nimi, osoite, puhelinnumero ja sähköpostiosoite. Testauksessa ei saa käyttää oikeiden ihmisten nimiä, osoitteita tai muita todellisia tunnistetietoja. Kuva-aineistojen arkistoa testattaessa tulee varmistaa, että testauksessa tallennettava kuva-aineisto on täysin anonymisoitua. Anonymisointi tarkoittaa sitä, että kuva-aineisto ei saa sisältää oikeaa henkilötietoa millään kuvaaineiston tasolla: ei kuvantamistutkimuksen metatiedoissa (manifestissa), kuvaaineistossa erillisessä layer-kerroksessa eikä pikselidatassa. Testiympäristöissä tulee käyttää ainoastaan terveydenhuollon testiammattikortteja, joihin on liitetty Valviran rekisterissä testauskäyttöön tarkoitettu 900-sarjan testihenkilötunnus. Kelan testiympäristöissä ei saa käyttää oikeita terveydenhuollon toimikortteja. Tietojärjestelmätoimittajan tulee omalta osaltaan varmistaa, että sen asiakasorganisaatiot tuntevat Kelan testauskäytännöt ja noudattavat niitä Kelan ylläpitämissä testiympäristöissä. 3 Yhteistestauksen osapuolten vastuut 3.1 Tietojärjestelmätoimittajan vastuu Tietojärjestelmätoimittaja vastaa omassa testauksessaan Kantaan liitettävän tietojärjestelmän teknisestä ja sovelluslogiikan toimivuudesta. Tietojärjestelmän on toteutettava kanta.fi-sivustolla julkaistujen määrittelyiden mukaiset toiminnallisuudet. Tietojärjestelmien on tuotettava valideja asiakirjoja ja muodostettava niistä määritysten mukaisia HL7-sanomia. Tietojärjestelmätoimittaja voi käyttää jo tuotekehityksen aikana asiakirjojen validoinnissa apuna Validointipalvelua.
14 Tietojärjestelmätoimittaja tekee Kelalle hakemuksen asiakastestiympäristöön liittymiseksi ja hankkii sen käyttöä varten tarvittavat testivarmenteet Väestörekisterikeskukselta (VRK). Tietojärjestelmätoimittaja vastaa tietojärjestelmänsä paikallisesta käytettävyydestä ja suorituskyvystä. Tietojärjestelmätoimittajan on sitouduttava sovittuun yhteistestauksen aikatauluun ja tuettava asiakasorganisaationsa testaamista. Tietojärjestelmätoimittaja etsii asiakaskunnastaan yhteistestaukseen osallistuvan asiakasorganisaation organisaation huomioiden seuraavat tekijät: asiakasorganisaatiolla on testausympäristö, jossa mahdollisimman laaja sisällön ja toiminnallisuuden testaus onnistuu asiakasorganisaatio on halukas osallistumaan Kelan kanssa tehtävään testaukseen ja sillä on mahdollisuus resursoida henkilöstöä testauksen valmisteluun ja testaukseen sovittuna aikana asiakasorganisaation tietojärjestelmäarkkitehtuurista tulee toimittaa Kelalle kuvaus yhteistestauksen kannalta oleellisilta osin. Siitä tulee ilmetä esim. integraation toteutustapa kun kokonaisjärjestelmään on integroitu erillisjärjestelmä. Tietojärjestelmätoimittajan on tiedotettava Kelaa ja asiakasorganisaatiota kaikista Kanta-palveluihin vaikuttavista virheistä ja niiden korjaamisesta. Tietojärjestelmätoimittaja suunnittelee ja toteuttaa omassa kehitysympäristössään tarvittavan testauksen ja sopii Kelan kanssa yhteistestauksen uusintamenettelyt Oman tietojärjestelmänsä sertifioinnin jälkeen tietojärjestelmätoimittajalla on lakisääteinen velvollisuus osallistua ristiintestausosapuolena uusien liittyjien sertifioinnin tai muutosten takia järjestettäviin yhteistestauksiin. 3.2 Tietojärjestelmätoimittajan asiakasorganisaation vastuu Yhteistestaukseen osallistuva tietojärjestelmätoimittajan asiakasorganisaatio tekee oman testausympäristönsä osalta liittymishakemuksen asiakastestiympäristöön ja hankkii Väestörekisterikeskukselta (VRK) testauksessa tarvittavat testivarmennekortit sekä testipalvelin- ja testijärjestelmäallekirjoitusvarmenteet. Asiakasorganisaatio vastaa, että
15 käytössä oleva Kanta-palveluihin liitettävä tietojärjestelmä sekä mahdolliset erillisjärjestelmät täyttävät liittymisen tekniset ja toiminnalliset vaatimukset käyttäen tukena tietojärjestelmätoimittajan asiantuntemusta. Asiakasorganisaatio sitoutuu sovittuun aikatauluun varaamalla testaukseen ja sen valmisteluun riittävästi resursseja ja tekemällä tietojärjestelmänsä hyväksymistestauksen aikataulun mukaisesti, jos testausympäristö vaatii laajemman versiopäivityksen ennen yhteistestausta. Asiakasorganisaatio laatii suorittamastaan yhteistestauksesta testausraportin. 3.3 Kelan vastuu Asiakasorganisaatio velvoitetaan osallistumaan uusiin yhteistestauksiin ristiintestausosapuolena myös sen jälkeen, kun sen käyttämä järjestelmä on sertifioitu. Kela ylläpitää Kanta-palvelujen testiympäristöjä ja niiden lisäpalveluita sekä antaa testihenkilöiden henkilötunnukset, testimateriaalit ja kansalliset testitapaukset testaavien osapuolten käyttöön. Kela suunnittelee yhteistestaukset ja koordinoi niiden etenemistä sekä ylläpitää testitapauksia. Kela arvioi eri testausvaiheiden tarpeellisuuden tietojärjestelmätoimittajan antamien tietojen perusteella ennen hyväksymistä yhteistestaukseen. Kela kartoittaa uusiin yhteistestauksiin osallistuville tietojärjestelmille ristiintestausparin sertifioitujen tietojärjestelmien ja niitä käyttävien asiakasorganisaatioiden joukosta, sekä sopii osapuolten kanssa ristiintestauksen aloittamisesta. Kela tarkistaa testausraportit yhteentoimivuuden näkökulmasta ja antaa lausunnon hyväksytystä yhteistestauksesta tietojärjestelmän sertifiointia varten. Kelalla on salassapitovelvollisuus luottamuksellisiin tietoihin, joita se on saanut tietoonsa tietojärjestelmästä yhteistestauksen aikana 1. Tällaista tietoa ovat esimerkiksi liikesalaisuudet, joita koskee myös tiedon hyväksikäyttökielto. Yhteistestauksen aikana Kela käsittelee tietojärjestelmien tietoja huolellisesti ja luottamuksellisesti. 1 Laki viranomaisten toiminnan julkisuudesta (621/1999)
16 3.4 Muiden osapuolten vastuut Muut osapuolet ja niiden roolit: Valvira, rooli- ja attribuuttitietopalvelun ylläpitäjä VRK, varmennepalvelun ylläpitäjä THL, tietojärjestelmää koskevien olennaisten vaatimusten määrittelijä THL vastaa Resepti-palvelun, Sosiaalihuollon asiakastiedon arkisto-, Kuva-aineistojen arkisto- ja Potilastiedon arkisto- sekä tiedonhallintapalvelun olennaisista vaatimuksista ja laatii toiminnalliset määrittelyt. Tietojärjestelmätoimittajan tulee neuvotella mahdolliset poikkeukset olennaisiin vaatimuksiin THL:n kanssa ennen yhteistestauksen aloittamista. THL:lla on oikeus antaa tarkempia säännöksiä asiakastietolaissa säädetyistä tietojärjestelmien olennaisista vaatimuksista: tietojärjestelmien luokkien määräytymisestä olennaisten vaatimusten osoittamiseksi noudatettavista menettelyistä ja annettavasta selvityksestä olennaisten vaatimusten merkittävistä poikkeamista ja niitä koskevista ilmoituksista. 4 Yhteistestaus Yhteistestaus on tietojärjestelmien tuottamien sanomien yhteentoimivuuden testausta Kanta-palveluja ja että toisia tietojärjestelmiä vasten (ristiintestaus). Testaus tapahtuu Kanta-palvelujen ja asiakkaan testiympäristöjen välillä. Jokaisella Kanta-palvelulla on oma yhteistestausjaksonsa, jonka tarkempi sisältö ja aikataulu suunnitellaan erikseen.yhteistestausta koskevat kysymykset ja tiedustelut voi lähettää sähköpostilla osoitteeseen yhteistestaus@kanta.fi. Viestin otsikossa ilmaistaan, minkä palvelun yhteistestausta asia koskee.
17 4.1 Tavoite ja rajaukset Yhteistestauksen tavoitteena on todeta, että tietojärjestelmät pystyvät tuottamaan määritysten mukaisia sanomia ja että nämä sanomat ovat tulkittavissa kaikissa yhteistestaukseen osallistuvissa järjestelmissä teknisesti ja sisällöltään samanlaisina. Tietojärjestelmätoimittajan on tullut toteuttaa eri tietojärjestelmien toiminnallisuudet niin, että toimintaprosessi on saumaton, riittävän tehokas ja asiakasturvallisuutta ei vaaranneta. 4.2 Testausaikataulu Yhteistestauksessa ei testata tietojärjestelmien sisäisiä toiminnallisuuksia eikä testausta suunnitella tietojärjestelmien käyttöliittymien testauksen näkökulmasta, vaan sen tarkoituksena on suunnitelmallisella testauksella todentaa Kanta-palvelujen, potilastieto-, asiakastieto- ja apteekkijärjestelmien välinen yhteentoimivuus. Tietojärjestelmätoimittajan tulee omissa testeissään todeta, että vaatimusmäärittelyn mukaiset vaatimukset täyttyvät tietojärjestelmässä. Kela suunnittelee Kanta-palvelukohtaisesti yhteistestausjaksojen ajoituksen ja käytettävät testitapaukset sekä seuraa testauksen etenemistä. Tietojärjestelmätoimittajien ja näiden asiakasorganisaatioiden on oltava valmiina kuhunkin vaiheeseen ilmoittautumislomakkeella kerrottujen kriteerien mukaisesti. Yhteistestausjaksot on esitelty Kanta-julkaisusuunnitelmassa. Yhteistestausjakso sisältää useamman testausvaiheen. Jokaisessa testausvaiheessa pidetään vähintään yksi tarkistuspalaveri, jossa käsitellään testauksen edistymistä, aikataulussa pysymistä ja mahdollisten uusintatestausten suorittamista. Tarkistuspalaverit pidetään erikseen sovittavan aikataulun mukaisesti. Yhteistestauksen läpiviemiseen on varattava aikaa. Tarkempaa aikataulutusta varten tietojärjestelmätoimittajan tulee esitellä Kelalle testaussuunnitelmansa, jolloin Kela voi arvioida yhteistestauksen keston sekä mahdolliset muut huomioitavat asiat. Mahdolliset laajat lainmuutokset tai muut suuret muutoshallinnat voivat vaikuttaa aloittamisaikaan ja yhteistestaukseen kuluvaan aikaan. Kuvassa 2 on esitetty yhteistestausprosessin periaatteellinen eteneminen.
18 Tarvittaessa vuoden aikana voidaan käynnistää useita yhteistestausjaksoja, jotka voivat asettua ajallisesti limittäin. Yhteistestausjaksojen aikataulut julkaistaan kanta.fi-sivustolla. Kuva 2 Yhteistestausprosessin periaatteellinen eteneminen Potilastiedon arkiston, Sosiaalihuollon asiakastiedon arkiston ja Kuvaaineistojen arkiston osalta ensimmäiseen testausvaiheeseen, joka on tietojärjestelmätoimittajan ja Kelan kahdenvälinen testaus, varataan eniten aikaa, koska siihen sisältyy laajasti perustoiminnallisuuksien testausta. Testausvaiheessa varaudutaan mahdollisiin korjauksiin ja uudelleentestaukseen. Tavoitteena on löytää ja korjata ongelmat varhaisessa vaiheessa, jotta ne eivät toistuisi seuraavissa testausvaiheissa. Testaus asiakasorganisaation ja Kelan välillä aloitetaan vasta, kun tietojärjestelmätoimittajan ja Kelan välinen testaus on hyväksytty ja asiakasorganisaation testiympäristöön voidaan toimittaa mahdolliset korjaukset sisältävä tietojärjestelmän versio. Myös jälkimmäiset testausvaiheet on optimaalista suorittaa peräkkäin. Yhteistestausprosessin kestosta ei voida antaa tarkkaa aikatauluarviota, koska testausjaksojen kokonaiskestot riippuvat monesta tekijästä. Tällaisia ovat muun muassa tietojärjestelmän alkuvalmius, testauksen osapuolten resurssit sekä havaittujen virheiden määrä ja uudelleentestaustarve sekä testattava tietosisältö. Tapauskohtainen aikatauluarvio voidaan antaa yhteistestauksen alkaessa.
19 Järjestelmätoimittaja sitoutuu yhteistestauksen aikatauluun suunnitelman mukaisesti. Järjestelmätoimittajan tulee varata tarvittavat resurssit testaukseen ja virheiden korjaukseen. Kelalla on oikeus keskeyttää tietojärjestelmän yhteistestaus, mikäli yhdessä sovitut testausaikataulut eivät pidä tai järjestelmän testaustulokset eivät ole hyväksyttäviä. Tällöin yhteistestaus on aloitettava myöhemmin uudestaan siten, että järjestelmätoimittajalle jää riittävästi aikaa korjausten toteuttamiseen. 4.3 Aloittamisen edellytykset 4.3.1 Tietojärjestelmätoimittajan testaus omassa testiympäristössään Tietojärjestelmätoimittaja testaa oman tietojärjestelmänsä toiminnallisuuksia omatoimisesti ennen liittymistä Asiakastestipalveluun. Kanta-validointipalvelua voi käyttää jo tässä vaiheessa asiakirjojen validointiin. 4.3.2 Liittyminen Kanta-asiakastestipalveluun ja omatoiminen testaus Tietojärjestelmätoimittaja liittyy asiakastestipalveluun. Ohjeet liittymisestä ja lisätietoa yhteistestausjaksoista löytyy kanta.fi-sivuston Testaus-osiossa. Liittymisen edellytykset: tietojärjestelmätoimittaja on toteuttanut Kantaan liitettävän tietojärjestelmään vaatimusten mukaiset toiminnallisuudet tietojärjestelmän tulee noudattaa kansallisten vaatimusten mukaisia avoimia rajapintoja ja standardeja. Tietojärjestelmän tulee kyetä liittymään Kanta-palveluihin itsenäisesti ja / tai toimittajariippumattoman integraatioratkaisun avulla. Integraatioratkaisu voi olla järjestetty organisaation sisäisesti tai alueellisesti. Standardien mukaisten rajapintojen suora tuki takaa yhteentoimivuuden myös Kantaliittymismallien muuttuessa. Tietojärjestelmätoimittaja testaa itsenäisesti Kanta-palvelujen asiakastestiympäristössä kaikki määritellyt toiminnallisuudet ja samalla varmistaa, että määrittelyiden mukaiset vaatimukset täyttyvät tietojärjestelmässä. Reseptinääketietokannan tietojen kanssa yhtäpitävät tiedot ja jota on tarkoitus käyttää tuotannossa.
20 Reseptejä toimittava tietojärjestelmä testaa omatoimisesti jo yhteistestauksen läpikäyneiden potilastietojärjestelmien lääkemääräysten tietojen näkymisen omassa järjestelmässään. Kela toimittaa henkilötunnukset, joille testilääkemääräystaulukon pohjalta laaditut testilääkemääräykset on laadittu. Kela voi pyynnöstä toimittaa kohtuullisen määrän testimateriaalia tietojärjestelmätoimittajan käyttöön (esim. lääketoimituksia ja uusimispyyntöjä). Testimateriaalin toimitusaika on noin kaksi viikkoa. 4.3.3 Erillisjärjestelmien integraatiot Tietojärjestelmätoimittaja arvioi, milloin se on valmis yhteistestauksen aloittamiseen. Kelan vaatimus on, että tietojärjestelmän toimittaja on huolellisesti testannut Kantaan liitettävän tietojärjestelmän jo ennen yhteistestauksen aloittamista. Laissa sosiaali- ja terveydenhuollon asiakastietojen sähköisestä käsittelystä (asiakastietolaki) säädetään yhteistestauksesta seuraavaa (19 e ): Luokkaan A kuuluvan tietojärjestelmän on oltava yhteentoimiva valtakunnallisten tietojärjestelmäpalvelujen ja siihen liitettyjen muiden tietojärjestelmien kanssa. Yhteentoimivuus on osoitettava Kansaneläkelaitoksen järjestämässä yhteistestauksessa. Yhteistestauksessa testataan se tietojärjestelmäkokonaisuus, joka tullaan ottamaan käyttöön sosiaali- tai terveydenhuollossa. Jotta Kela pystyy todentamaan laissa vaaditun yhteentoimivuuden, sertifioitavassa tietojärjestelmässä (tai tietojärjestelmäkokonaisuudessa) tulee yhteistestauksen alkaessa olla valmiina kaikki Kanta-integraatioon vaikuttavat integraatiot. Erillisjärjestelmällä tarkoitetaan sellaista tietojärjestelmää, joka muodostaa toisen järjestelmän kanssa toiminnallisen järjestelmäkokonaisuuden. Erillisjärjestelmä voi olla esimerkiksi laboratoriojärjestelmä. Kelan yhteistestauksen tulee tietää sertifioitava tietojärjestelmä tai tietojärjestelmäkokonaisuus, ja siihen mahdollisesti integroitavat erillisjärjestelmät, jotta yhteistestattava kokonaisuus voidaan ymmärtää ja jotta yhteistestauksesta saadaan kattava. Tämän vuoksi tietojärjestelmätoimittajaa pyydetään toimittamaan yhteistestauksen ilmoittautumislomakkeen yhteydessä myös loogisen tason arkkitehtuurikuvaus. Arkkitehtuurikuvauksen tarkoituksena
21 4.3.4 Ilmoittautuminen yhteistestaukseen on selventää testattava kokonaisuus. Jotta yhteentoimivuus voidaan testata, tulee erillisjärjestelmän integraation olla toteutettu yhteistestauksen alkaessa. Ilmoittautuminen yhteistestaukseen tehdään sähköpostitse osoitteeseen yhteistestaus@kanta.fi kaksi kuukautta ennen suunniteltua yhteistestauksen aloittamista. Kela tiedottaa yhteistestauksen aloittaneista tietojärjestelmistä kanta.fi-sivuston Testaus-osiossa. Ilmoittautumisen yhteydessä järjestelmätoimittaja toimittaa Kelaan 1. ilmoittautumislomakkeen, joka sisältää valmiusraportin 2. THL:n järjestelmälomakkeen 3. tietojärjestelmäkokonaisuuksia testattaessa arkkitehtuurikuvauksen. Suorittamalla valmiusraportin sisältämät testitapaukset tietojärjestelmätoimittaja todentaa, että se on valmis aloittamaan yhteistestauksen. Kun valmiusraportin testitulosten perusteella on todennettu tietojärjestelmän toteutuksen kypsyys, Kela hyväksyy tietojärjestelmän yhteistestaukseen. Eri käyttötarkoituksiin tehtyjen tietojärjestelmien vähimmäisvaatimuksia on määritelty valtakunnallisten profiilien kautta. Järjestelmälomakkeella tietojärjestelmätoimittaja selvittää Kelalle, mitä valtakunnallisia profiileja ja niiden mukaisia toiminnallisia vaatimuksia ja tietosisältöjä tietojärjestelmä toteuttaa. THL vastaa järjestelmälomakkeesta ja ohjeistaa siihen liittyvissä kysymyksissä. 4.3.5 Hyväksyminen yhteistestaukseen Ilmoittautuminen on voimassa kolme (3) kuukautta. Jos tietojärjestelmätoimittajasta riippuvasta syystä yhteistestaus ei ala kolmen (3) kuukauden kuluessa ilmoittautumisesta, se vanhenee. Tämän jälkeen tietojärjestelmätoimittajan tulee ilmoittautua uudelleen yhteistestaukseen. Kun yhteistestaukseen osallistumisen edellytykset täyttyvät ja tietojärjestelmätoimittaja on ilmoittautunut yhteistestaukseen, tarkennetaan testauksen sisältö, aikataulu ja mahdolliset rajaukset toimittajan ja Kelan yhteistyönä.
22 Kelan ja tietojärjestelmätoimittajan kesken pidetään aloituskokous yhteistestauksen periaatteista ja toteutuksesta. Järjestelmätoimittaja sitoutuu yhteistestauksen aikatauluun suunnitelman mukaisesti. Tarvittavat resurssit on varattu testaukseen ja virheiden korjaukseen. Mikäli tietojärjestelmää ei ensimmäisen testauskierroksen perusteella voida hyväksyä yhteistestaukseen, annetaan tietojärjestelmätoimittajalle korjausaikaa. Yhteistestauksen valmiusraportointi voidaan suorittaa kerran uudelleen viimeistään kuukautta ennen yhteistestausjakson alkamista. Mikäli testaustulokset eivät tällöinkään ole hyväksyttäviä, yhteistestaukseen ilmoittautuminen on tehtävä uudestaan seuraavalle yhteistestausjaksolle. Tällöin tietojärjestelmätoimittajille jää riittävästi aikaa korjausten toteuttamiseen. 4.4 Yhteistestauksen vaiheet 4.4.1 Tietojärjestelmätoimittajan ja Kelan välinen testaus Vaiheen tavoitteena on testata Kanta-palveluihin liitettävän tietojärjestelmän ja Kanta-palveluiden välistä toiminallisuutta erilaisten testitapausten avulla. Kela toimittaa suoritettavat testitapaukset. Tietojärjestelmätoimittaja testaa ja raportoi testit Kelalle, korjaa testauksessa tietojärjestelmässä havaitut virheet, sekä osoittaa korjausten toimivuuden uudelleentestauksella ja raportoinnilla. Kela tarkastaa raportoidut testit, antaa palautetta testaushavainnoista ja hyväksyy testauksen tulokset. Vaihe voidaan hyväksyä, kun kaikki testit on testattu ja raportoitu ja järjestelmätoimittaja korjaa testauksessa havaitut virheet sekä osoittaa korjausten toimivuuden uudelleentestauksella ja raportoinnilla. Mikäli korjausten ja uudelleentestausten jälkeen esiintyy vielä puutteita, puutteet dokumentoidaan ja niitä koskevat jatkotoimenpiteet käsitellään erikseen.
23 4.4.2 Tietojärjestelmätoimittajan asiakasorganisaation ja Kelan välinen testaus Vaiheen aikana testataan palveluiden toiminnallisuuksia ja tietosisältöä laajemmin tietojärjestelmätoimittajan asiakasorganisaation testiympäristössä tuotantokäyttöä vastaavalla tavalla. Testauksen tavoitteena on todentaa tietojärjestelmän ja Kanta-palvelun välinen toimivuus asiakasorganisaation käytössä. Myös ne testausvaiheet, joihin asiakasorganisaatiot tämän prosessin mukaisesti osallistuvat, liittyvät tietojärjestelmän liittymisvalmiuksien varmistamiseen. Niiden tarkoituksena ei ole testata asiakasorganisaation liittymisvalmiutta. Tämän vuoksi Kela tukee vain yhtä asiakastestausta tietojärjestelmää kohti. Testauksessa voi olla mukana yksi asiakasorganisaatio tai useamman asiakasorganisaation muodostama kokonaisuus. Asiakasorganisaatio testaa ja raportoi testit Kelalle ja tietojärjestelmätoimittajalle sekä suunnittelee ja organisoi omien testausresurssien käytön. Kela laatii yhteistestauksen testitapaukset THL:n avustuksella. Asiakasorganisaatio vastaa, että yhteistestauksen ohessa tehtävä omatoiminen testaus sisältää riittävästi tuotantokäytön kaltaisia tilanteita, ja että testaus vastaa omia käyttötarpeita. Tietojärjestelmätoimittaja osallistuu asiakasorganisaationsa testaukseen ja tukee testausta tarpeen mukaan seuraavin toimin: Varmistaa yhdessä asiakasorganisaationsa kanssa, että käytettävissä on vaatimusten mukainen testiympäristö ja toimittaa tarvittavat päivitykset. Opastaa asiakasorganisaationsa testaajia testaukseen sisältyvissä tietojärjestelmän toiminnallisuuksissa sekä täsmentää kansallisten testitapausten toteutus- ja raportointiohjeistuksen testattavaa tietojärjestelmää varten. Opastaa asiakasorganisaationsa pääkäyttäjiä testiympäristön konfiguroinnissa. Varaa riittävästi resursseja testauksen aikaiseen tukeen, kuten virhe- ja ongelmatilanteiden selvittelyyn ja tilannekatsauspalavereihin osallistumiseen.
24 Kela tarkastaa raportoidut testit, antaa palautetta tarvittavista virhekorjauksista ja hyväksyy asiakasorganisaation testauksen tulokset. Vaihe voidaan hyväksyä, kun Kaikki testit on tehty. Asiakasorganisaatio on raportoinut Kelalle suorittamansa testauksen. Asiakasorganisaatio on korjannut mahdolliset omaan testiympäristöönsä liittyvät puutteet. Tietojärjestelmätoimittaja on korjannut testauksessa havaitut sovellusvirheet sekä toimittanut korjaukset asiakasorganisaationsa käyttöön. Tarvittaessa muutoksiin liittyvä uudelleentestaus on tehty ja raportoitu. Mikäli korjausten ja uudelleentestausten jälkeen esiintyy vielä puutteita, puutteet dokumentoidaan ja niitä koskevat jatkotoimenpiteet käsitellään erikseen. 4.4.3 Ristiintestaus Tämä testausvaihe poikkeaa hieman toisistaan testattavasta palvelusta riippuen, joten alla kuvataan erikseen Resepti-palvelun ja Potilastiedon arkisto - palvelun ristiintestausvaiheet. Sosiaalihuollon asiakastiedon arkiston osalta ristiintestausta ei ole julkaisun vaiheessa I ollenkaan. Ristiintestaus Resepti-palvelussa (tietojärjestelmätoimittajat) Tietojärjestelmätoimittajat suorittavat ristiintestauksen Kelan toimittamien testiketjujen ja esimerkkilääkemääräysten mukaisesti. Jos testattava järjestelmä on potilastietojärjestelmä, Kela osallistuu testaukseen apteekkijärjestelmän toimintojen osalta. Muissa tapauksissa tämän vaiheen testaukset suoritetaan tietojärjestelmätoimittajien toimesta. Tässä vaiheessa on mukana kaksi potilastietojärjestelmää sekä kolme apteekkijärjestelmää. Kela järjestää potilastietojärjestelmäkumppanin järjestelmätoimittajien ristiintestaukseen.
25 Aloittamisen edellytyksenä on, että edelliset testausvaiheet on suoritettu hyväksytysti. Tietojärjestelmätoimittajien ristiintestausvaiheessa esiin tulevien virheiden korjaamista varten voidaan ristiintestaus keskeyttää kahdeksi viikoksi kuitenkin niin, että ristiintestauksen kokonaisaikataulu pysyy suunnitellussa 4 6 viikossa. Jos Kela ei hyväksy tietojärjestelmän testaustuloksia, tietojärjestelmätoimittajien ristiintestaus on tehtävä uudestaan aikaisintaan seuraavan testausjakson aikana. Tällöin tietojärjestelmätoimittajille jää riittävästi aikaa korjausten toteuttamiseen. Jos testausaikataulut eivät pidä, Kelalla on oikeus keskeyttää ristiintestaus. Asiakas aloittaa omatoimisen testauksen viimeistään tämän vaiheen aikana. Kela voi pyynnöstä toimittaa kohtuullisen määrän testimateriaalia asiakkaan käyttöön (esim. lääketoimituksia ja uusimispyyntöjä). Testimateriaalin toimitusaika on noin kaksi viikkoa. Ristiintestaus Resepti-palvelussa (asiakasorganisaatiot) Tietojärjestelmätoimittajien asiakastestaajina toimivat terveydenhuollon organisaatiot ja apteekit (asiakasorganisaatiot) suorittavat ristiintestauksen Kelan toimittamien testiketjujen ja esimerkkilääkemääräysten mukaisesti. Jos testattava tietojärjestelmä on potilastietojärjestelmä, Kela osallistuu testaukseen apteekkijärjestelmän toimintojen osalta. Muissa tapauksissa tämän vaiheen testaukset suoritetaan asiakasorganisaatioiden toimesta. Kela tukee yhteistestauksessa tietojärjestelmätoimittajan yhtä asiakasorganisaatiota. Kela järjestää asiakastestaajakumppanin asiakasorganisaatioiden ristiintestaukseen. Aloittamisen edellytykset: Kelan, tietojärjestelmätoimittajan ja näiden asiakasorganisaatioiden yhteinen aloituskokous on pidetty. Liittyminen asiakastestipalveluun on tehty. Tietojärjestelmä on läpäissyt järjestelmätoimittajien ristiintestauksen hyväksytysti.
26 Asiakasorganisaatio sitoutuu ristiintestauksen suunniteltuun aikatauluun sekä on varannut tarvittavat resurssit. Jos osapuolet eivät hyväksy tietojärjestelmän testaustuloksia, asiakasorganisaatioiden ristiintestaus on tehtävä uudestaan aikaisintaan seuraavan yhteistestausjakson aikana. Tällöin tietojärjestelmätoimittajille jää riittävästi aikaa korjausten toteuttamiseen. Ristiintestaus arkistoivissa palveluissa Potilastiedon arkiston, Sosiaalihuollon asiakastiedon arkiston (vaiheesta II alkaen) ja Kuva-aineistojen arkiston ristiintestaus suoritetaan tietojärjestelmätoimittajien asiakasorganisaatioiden välisenä. Ristiintestaukseen osallistuu uutta testattavaa asiakastieto- tai potilastietojärjestelmää käyttävä asiakasorganisaatio ja toista, aikaisemmin sertifioitua järjestelmää käyttävä asiakasorganisaatio. Kummankin osapuolen tietojärjestelmätoimittajat osallistuvat ristiintestaukseen tukemalla asiakasorganisaatiota testauksessa. Tietojärjestelmätoimittajan tuki on erityisen tärkeä sertifioitavan tietojärjestelmän osalta. Aloittamisen edellytykset: Kelan, tietojärjestelmätoimittajan ja näiden asiakasorganisaatioiden yhteinen aloituskokous on pidetty. Edelliset testausvaiheet on suoritettu hyväksytysti. Asiakasorganisaatio sitoutuu ristiintestauksen suunniteltuun aikatauluun sekä on varannut tarvittavat resurssit. Ristiintestauksessa käytetään asiakasorganisaatioiden omia asiakastestiympäristöön liitettyjä tuotannon kaltaisia testausympäristöjä. Näihin on toteutettu mahdolliset integraatiot erillisjärjestelmiin. Aineistona voidaan käyttää aiemmin yhteistestauksessa arkistoituja tietoja sekä ristiintestauksessa arkistoitavia uusia tietoja. Asiakasorganisaatiot testaavat ja raportoivat testien tulokset Kelalle.
27 4.4.4 Tarkistuspalaverit Testauksen etenemistä käydään läpi tarkistuspalavereissa, joissa testien tulokset käydään läpi yhteistyössä testausvaiheeseen osallistuvien toimijoiden kesken. Tarkistuspalaverien avulla seurataan testauksen edistymistä ja aikataulussa pysymistä sekä arvioidaan seuraavaan testausjaksoon siirtymistä. Kela arvioi testien onnistumisen ja läpäisyn. Tarkistuspalavereissa käydään läpi testauksessa ilmenneet virheet ja niiden jatkotoimenpiteet, sekä sovitaan tarvittavasta uudelleentestauksesta. 4.5 Hyväksymiskriteerit ja raportointi Kela ylläpitää listaa yhteistestauksessa havaituista virheistä ja tietojärjestelmätoimittaja huolehtii virhehavaintojen korjaamisesta. Tässä esitettyjä kriteereitä ja toimintaperiaatteita sovelletaan kaikissa yhteistestauksissa riippumatta siitä, onko kyseessä suuri kansallisen muutoksenhallintaprosessin mukainen versio tai pienemmän muutospaketin testaus, jossa ei viedä läpi kaikkia testausvaiheita. Testausvaiheiden päätyttyä Kela arvioi, onko tietojärjestelmän yhteistestaus suoritettu hyväksytysti. Kela laatii yhteistestauksen päätteeksi lausunnon hyväksytysti suoritetusta yhteistestauksesta tietojärjestelmän sertifiointia varten. Asiakasorganisaatio laatii lausunnon liitteeksi testausraportin suorittamastaan yhteistestauksesta. Testaushavainnot luokitellaan jatkokäsittelyä varten alla olevan taulukon mukaisesti: Havainnon luokka Selite 0 Kosmeettinen Ei haittaa toimintoja, ei merkitystä testauksen etenemiselle, ei vaadi uudelleentestausta, ei tarvitse korjata yhteistestauksen aikana. 1 Huomioitava Ei haittaa toimintoja merkittävästi, ei merkitystä testauksen etenemiselle, ei tarvitse korjata yhteistestauksen aikana, mutta tulee korjata
28 seuraavaan mahdolliseen korjausversioon. 2 Merkittävä Virheellisestä toiminnosta haittaa, ei estä testauksen jatkumista, korjaus yhteistestauksen aikana, uudelleentestattava. 3 Estävä Vakava virhe, joka estää testauksen etenemisen, vaatii välittömän korjauksen, uudelleentestattava. 4.5.1 Yhteistestauksen aloitus- ja hyväksymiskriteerit Yhteistestaus voidaan aloittaa, kun testauksen alkuvalmistelut, kuten testiympäristön konfigurointi, on valmis THL:n järjestelmälomake on täytettynä yhteistestaukseen tulevan sovellusversion tiedoilla ilmoittautumislomake ja sen sisältämä yhteistestausvalmiuden raportointi on toimitettu Kelaan ja Kela on tarkistanut ja hyväksynyt raportin testitulokset tietojärjestelmätoimittajan testaus Kanta-validointipalvelua vasten on suoritettu valmiusraportoinnin yhteydessä järjestelmäkokonaisuutta testatessa arkkitehtuurikuvaus on toimitettu Kelaan tarvittava testauksen laajuus on arvioitu Kelan ja tietojärjestelmätoimittajan kesken Kelan lupa aloittaa testaus on annettu.
29 Yhteistestaus voidaan hyväksyä, kun kaikki sovitut testausvaiheet ja testitapaukset on hyväksytysti suoritettu kaikki tunnetut havainnot on kirjattu ja käsitelty 4.5.2 Testauksen keskeyttäminen ja jatkaminen luokan 2 ja 3 havainnot on todennettu korjatuiksi sekä luokan 1 havainnot on joko todennettu korjautuneiksi tai ne on kirjattu jatkokehityksessä huomioitaviksi. Yhteistestaus voidaan keskeyttää tilapäisesti välittömien muutospaineiden takia. Kyseessä voi olla esimerkiksi testauksen jatkamisen estävä virhe tai merkittävä resurssivaje. Yhteistestausta voidaan jatkaa, kun keskeyttämisen aiheuttanut tilanne on selvitetty. Kanta-palveluihin liitettävässä tietojärjestelmässä olevan sovellusvirheen osalta myös korjausten testaus tulee olla läpäisty ja raportoitu. Tällöin Kela arvioi, mitä jo suoritettuja yhteistestauksen testejä on uusittava. Testauksen jatkamisesta sovitaan osapuolten yhteisessä tilaisuudessa ja Kela antaa lopullisen hyväksynnän jatkamiselle. 4.5.3 Testauksen keskeyttäminen ja hylkäämiskriteerit Jos useista viivästyksistä ja uudelleentestauksista huolimatta yhteistestaus ei etene, voidaan testaus keskeyttää. Keskeyttämisestä sovitaan kaikkien osapuolten yhteisessä tilaisuudessa. 4.6 Virheiden korjaus Yhteistestaus voidaan hylätä, jos testauksen aikana on löydetty vakavuusluokkien 2 3 virheitä, eikä niitä ehditä tai pystytä korjaamaan testaukseen varatussa aikataulussa. Yhteistestaukseen osallistuva tietojärjestelmätoimittaja huolehtii siitä, että tarvittavat korjaukset toteutetaan tietojärjestelmään ja korjauksen sisältävä sovellusversio testataan mahdollisimman nopeasti. Tietojärjestelmätoimittajan tekemien korjauksen yhteydessä Kela tekee arvion järjestelmätoimittajan antamien tietojen perusteella tarvittavan uudelleentestauksen laajuudesta, ja huomioi myös korjauksen mahdollisen vaikutuksen muihin jo hyväksytysti
30 testattuihin toiminnallisuuksiin. Korjausten ja uuden sovellusversion asennusten jälkeen vähintään aiemmin virheeseen päätyneet testitapaukset tulee testata uudelleen. Tarvittaessa tietyn eristettävissä olevan virhekorjauksen uudelleentestaus on mahdollista tehdä suppeammin kuin mitä testitapaukseen on kuvattu. Menettelystä on kuitenkin sovittava erikseen Kelan kanssa, koska testauksen tavoitteena on, että koko tapahtumaketju eri vaiheineen saadaan todennettua onnistuneeksi. 4.7 Kelan tuki Yhteistestauksen päättyessä luokkien 0 ja 1 havaintojen korjaustoimenpiteiden aikataulutus tai mahdolliset päätökset jättää havainnot korjaamatta käsitellään ja dokumentoidaan erikseen. Luokkien 2 ja 3 havaintojen tulee olla korjattu ja uudelleentestattu sekä korjaukset on todettu toimiviksi. Kelan testilaboratoriossa on tietojärjestelmiä, joiden avulla Kela voi simuloida tietojärjestelmien toiminnallisuuksia ja selvittää virhe- ja muita ongelmatilanteita. Kela voi tarvittaessa tilauksesta toimittaa kohtuullisen määrän testimateriaalia testilaboratorion tietojärjestelmillä. Kela osallistuu tarvittaessa sanomarakenteiden virheiden ja puutteiden selvittämiseen sekä tiedottaa havaituista puutteista. Yhteistestauksessa käytetty testimateriaali on Kelan käytössä yhteistestauksen jälkeen. Kela toimittaa tarvittaessa yhteistestauksen testimateriaalia muiden järjestelmien testauskäyttöön. 5 Virhetilanteiden käsittely Kela ei ota kantaa tietojärjestelmien käyttöliittymiin eikä tue järjestelmätoimittajaa substanssiasioissa. Tietojärjestelmätoimittajalla pitää olla yhteistestauksen aikana käytettävissään omaa tai asiakkaansa asiantuntijatukea esimerkiksi farmasiaa ja lääkehoitoa koskevissa asioissa. Tieto sellaisista virhetilanteista, jotka mahdollisesti vaikuttavat muiden testausosapuolten toimintaan, kerrotaan välittömästi sähköpostitse kyseisten ohjelmistojen kehittäjille ja Kelalle. Yhteistestausjaksoilla havaintojen käsittelyä varten järjestetään myös yhteisiä tarkistuspalavereita.
31 Kelalle osoitetut kiireelliset virheilmoitukset lähetetään osoitteeseen kantakehitys@kanta.fi. Kela koordinoi virhekäsittelyä ja tarvittaessa selvittää, onko virhe tietojärjestelmissä vai Kanta-palveluissa. Virheilmoituksissa ilmoitetaan seuraavat tiedot: otsikko: "Resepti-palvelun/Potilastiedon arkiston/sosiaalihuollon asiakastiedon arkiston/kuva-aineistojen arkiston testaus ohjelmisto asia" esim. Resepti-palvelun testaus Pegasos virhe Reseptikeskuksen palauttamissa tiedoissa virheen havaitsemisajankohta käyttötapaus, testitapaus tai potilastarina, johon virhe liittyy virheen kuvaus tietojärjestelmän mahdollisesti palauttama virheilmoitus organisaatio ja järjestelmä, missä virhe on havaittu virheen ilmoittaja liitetiedostona lähetetty SOAP-sanoma ja mahdollisesti myös httpheader (järjestelmätoimittajat). Tietojärjestelmätoimittajat huolehtivat, että korjaukset tehdään ja toimitetaan uudelleentestattaviksi mahdollisimman nopeasti. Korjausten ja uuden ohjelmistoversion asennusten jälkeen korjaaja informoi Kelaa ja virheilmoituksen tehnyttä organisaatiota korjaustoimenpiteistä uudelleentestausta varten. Jos kyseessä on kriittinen virhe, Kela tekee päätökset yhteistestauksen keskeyttämisestä yhdessä kyseisten tietojärjestelmätoimittajien kanssa. Kelalla on oikeus myös yksipuolisesti keskeyttää jonkin tietojärjestelmän yhteistestaus järjestelmässä havaittujen vakavien puutteiden vuoksi. Valviran rooli- ja attribuuttitietopalveluihin liittyvät virheilmoitukset ilmoitetaan osoitteeseen: varmennepalvelut@valvira.fi.