YHTEISTESTAUKSEN PALVELUKUVAUS

Kanta-palvelut 1 (34) Kanta-palvelut YHTEISTESTAUKSEN PALVELUKUVAUS Sähköisen reseptin ja Potilastiedon arkiston yhteistestaus

Kanta-palvelut Yhteistestauksen palvelukuvaus 2 (34) Dokumentin muutoshistoria Versio Pvm Tekijä/hyväksyjä Kuvaus 1.0 27.3.2015 Kanta-palvelut Ensimmäinen julkaistu versio 1.1 Kanta-palvelut Sähköisen reseptin yhteistestauksen aloitusajankohtien päivämäärät poistettu. Tieto löytyy nyt kanta.fi Testaus sivulta. Validaattoritestit lisätty. Täsmennetty arkiston yhteistestauksen ilmoittautumismenettelyä. Korvattu käyttötapauksia esittelevä luku viittauksella alkuperäiseen määrittelyyn. Esitelty lyhyesti testitapauksia.

Kanta-palvelut Yhteistestauksen palvelukuvaus 3 (34) Sisältö 1 Johdanto... 6 1.1 Määritelmät... 7 2 Kanta-asiakastestiympäristö... 8 2.1 Testipalvelut... 9 2.1.1 Kanta-validointipalvelu... 9 2.1.2 Kanta-asiakastestipalvelu... 9 2.1.3 Omakanta-testipalvelu... 9 2.2 Kanta-asiakastestipalveluun liittyminen... 9 2.3 Kanta-asiakastestipalvelun palveluaika, päivitykset ja huoltokatkot... 10 2.4 Testiaineiston luonti... 10 3 Yhteistestauksen osapuolten vastuut... 11 3.1 Järjestelmätoimittajan vastuu... 11 3.2 Järjestelmätoimittajan asiakasorganisaation vastuu... 12 3.3 Kelan vastuu... 12 3.4 Muiden osapuolten vastuut... 12 4 Sähköisen reseptin yhteistestaus... 14 4.1 Tavoite ja rajaukset... 15 4.2 Testausaikataulu... 15 4.3 Aloittamisen edellytykset ja testauksen vaiheet... 16 4.3.1 Järjestelmätoimittajan testaus omassa testiympäristössään... 16 4.3.2 Liittyminen Kanta-asiakastestipalveluun ja itsenäinen testaus... 16 4.3.3 Ilmoittautuminen yhteistestaukseen... 17 4.3.4 Validaattori- ja interaktiotestit... 18 4.3.5 Hyväksyminen yhteistestaukseen... 18

Kanta-palvelut Yhteistestauksen palvelukuvaus 4 (34) 4.3.6 Järjestelmätoimittajien ristiintestaus... 19 4.3.7 Asiakasorganisaatioiden ristiintestaus... 19 4.4 Hyväksymiskriteerit ja raportointi... 20 4.5 Sähköisen reseptin toiminnallisuudet ja käyttötapaukset... 20 4.5.1 Potilastietojärjestelmä... 20 4.5.2 Apteekkijärjestelmä... 21 4.6 Kelan tuki... 21 5 Potilastiedon arkiston yhteistestaus... 23 5.1 Suunnittelu ja toteuttaminen... 24 5.2 Yhteistestauksen aikataulu... 24 5.3 Tarkistuspalaverit... 25 5.4 Potilastiedon arkiston yhteistestauksen vaiheet... 26 5.4.1 Testaus ennen yhteistestauksen alkua... 26 5.4.2 Järjestelmätoimittajan ja Kelan välinen tekninen järjestelmätestaus... 26 5.4.3 Järjestelmätoimittajan asiakasorganisaation ja Kelan välinen testaus... 27 5.4.4 Ristiintestaus... 28 5.5 Testitapaukset... 29 5.6 Hyväksymiskriteerit... 29 5.6.1 Yhteistestauksen aloitus- ja lopetus/hyväksymiskriteerit... 30 5.6.2 Testauksen keskeyttäminen ja jatkaminen... 30 5.6.3 Testauksen lopettaminen ja hylkäämiskriteerit... 31 6 Havaintojen ja muutosten hallinta... 31 6.1 Havaintojen ja virheiden luokittelu yhteistestausjaksolla... 31 6.2 Virheiden korjaus... 31 7 Virhetilanteiden käsittely... 32

Kanta-palvelut Yhteistestauksen palvelukuvaus 5 (34) 8 Järjestelmätoimittajan ja sen asiakasorganisaation sitoumus... 34 8.1 Sähköisen reseptin testilääkemääräykset... 34 8.2 Potilastiedon arkiston vertailutestipotilaat... 34

Kanta-palvelut Yhteistestauksen palvelukuvaus 6 (34) 1 Johdanto Yhteistestaus on Kanta-palveluiden toiminnallisuuksien suunnitelmallista testausta Kanta-asiakastestipalvelun ja potilastieto- tai apteekkijärjestelmien välillä yhteentoimivuuden todentamiseksi. Yhteistestaus on osa A-luokan tietojärjestelmän sertifiointia ja Kela laatii hyväksytysti suoritetusta yhteistestauksesta lausunnon. Ennen yhteistestauksen aloittamista järjestelmätoimittajan on toimitettava Kelalle selvitys toiminnallisten vaatimusten toteutumisesta. THL (Terveyden ja hyvinvoinnin laitos) antaa ohjeistuksen selvityksen sisällöstä ja laatimisesta. Tämä dokumentti on tarkoitettu yhteistestaukseen osallistuville tietojärjestelmien toimittajille, terveydenhuollon organisaatioille ja apteekeille. Terveydenhuollon organisaatiot ja apteekit ovat mukana ensisijaisesti järjestelmätoimittajien asiakastestaajina. Dokumentin määrittämät yhteistestauksen menettelyt koskevat sekä ensimmäistä kertaa yhteistestaukseen osallistuvia järjestelmiä että jatkokehitystä, jolla laajennetaan tai muutetaan jo kertaalleen yhteistestauksen läpäisseen ja tuotantoon viedyn järjestelmän toiminnallisuutta. Muutokset toteutetaan jatkossa kansallisen muutoksenhallintaprosessin mukaan. Seuraavat testauksen osa-alueet eivät kuulu Kelan koordinoimaan yhteistestaukseen: yhteistestauksen esikriteerinä oleva järjestelmätoimittajan toiminnallisten vaatimusten testaus, Kelan sisäinen testaus Kanta-palveluille, Kanta-palveluihin liitettävän tietojärjestelmän version hyväksymistestaus ja käytettävyystestaus, jotka järjestelmätoimittaja organisoi itsenäisesti ja yhteistestauksen aikataulusta riippumattomasti, suorituskykytestaus Kanta-palveluille ja liitettäville tietojärjestelmille sekä tuotannon aikaisiin kiirekorjauksiin ja muuhun ylläpitoon liittyvä testaus. Luvussa 4 käsitellään tarkemmin sähköisen reseptin yhteistestauksen käytäntöjä ja luvussa 5 käsitellään vastaavasti Potilastiedon arkiston ja tiedonhallintapalvelun yhteistestausta. Yhteistestaukseen liittyvät kysymykset ja tiedustelut voi lähettää sähköpostilla osoitteeseen yhteistestaus@kanta.fi, viestin otsikossa ilmaistaan koskeeko asia sähköisen reseptin vai Potilastiedon arkiston yhteistestausta.

Kanta-palvelut Yhteistestauksen palvelukuvaus 7 (34) 1.1 Määritelmät Asiakasorganisaatio: Terveydenhuollon organisaatio tai apteekki, joka osallistuu tietojärjestelmän yhteistestaukseen asiakastestaajana. Järjestelmätoimittaja valitsee yhteistestaukseen osallistuvan asiakasorganisaation asiakaskunnastaan. Kanta-palvelut: Terveydenhuollon valtakunnalliset tietojärjestelmäpalvelut, joihin kuuluvat sähköinen resepti-, Potilastiedon arkisto- ja Omakanta - palvelut. 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. 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ä. 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. Yhteistestaus: Kelan asiakastestiympäristön ja yhden tai useamman järjestelmätoimittajan tai terveydenhuollon palveluntuottajan testausympäristön välinen Kanta-palvelujen yhteentoimivuuden testaus, jossa käytetään vakioituja, kansallisia testitapauksia ja raportointimenettelyitä.

Kanta-palvelut Yhteistestauksen palvelukuvaus 8 (34) 2 Kanta-asiakastestiympäristö Yhteistestauksen testausympäristö muodostuu Kanta-asiakastestipalvelusta ja siihen liittyneiden osapuolten omista testausympäristöistä. Kantaasiakastestiympäristössä on käytettävissä tuotantoa vastaavat sähköisen reseptin ja Potilastiedon arkiston toiminnallisuudet sekä myös Omakanta testauskäyttöä varten. Testauksessa käytetään Väestörekisterikeskuksen testivarmenteita ja Kanta-asiakastestiympäristön omaa koodistopalvelua, joka on Kelan ylläpitämä ja erillään Terveyden ja hyvinvoinnin laitoksen (THL) tuotantokoodistopalvelusta. Kuva 1. Kanta-palveluiden asiakastestiympäristö

Kanta-palvelut Yhteistestauksen palvelukuvaus 9 (34) 2.1 Testipalvelut Kela tuottaa seuraavat palvelut potilastieto- ja apteekkijärjestelmien tuotekehitysvaiheessa ja yhteistestauksissa käytettäviksi. 2.1.1 Kanta-validointipalvelu Kela tarjoaa selainkäyttöisen testiasiakirjojen validointipalvelun. Palvelu on maksuton ja vapaasti käytettävissä jo ennen Kanta-asiakastestiympäristöön liittymistä kanta.fi-sivuston kautta. Palvelu sisältää HL7 CDA R2 -muotoisten asiakirjojen validointisäännöt. Palvelu on ensisijaisesti tarkoitettu järjestelmätoimittajien tuotekehityksen aikaisen testauksen tueksi. 2.1.2 Kanta-asiakastestipalvelu Kanta-asiakastestipalveluun liittyneillä järjestelmätoimittajilla ja näiden asiakastestaajaorganisaatioilla on mahdollisuus testata järjestelmiensä toiminnallisuuksia tuotannon kaltaista reseptikeskusta, Potilastiedon arkistoa ja tiedonhallintapalvelua vasten sekä ennen tietojärjestelmän sertifiointia että myöhemmässä tuotekehitysvaiheessa. 2.1.3 Omakanta-testipalvelu Kanta-asiakastestipalvelussa on Omakanta-testipalvelu, jossa on Kantapalveluiden testausta ajatellen käytettävissä informointi-, suostumus- ja kieltosekä terveystietotoiminnallisuudet siten, että palvelun sisältö on Kantaasiakastestiympäristössä olevan Potilastiedon arkiston ja sähköisen reseptin versioiden mukainen. Omakanta-testipalvelu on muuten käyttöliittymältään tuotantoa vastaava selainsovellus, mutta tietoja haetaan suoraan testipotilaan henkilötunnuksella ilman vahvan tunnistautumisen vaatimusta. 2.2 Kanta-asiakastestipalveluun liittyminen Kanta-asiakastestipalvelun liittymisohje sekä liittymislomakkeet löytyvät kanta.fi-sivuston Testaus-osiosta. Liittymislomakkeet lähetetään sähköpostitse osoitteeseen liittyminen@kanta.fi. Kanta-asiakastestiympäristöön liitytään vain testiympäristöstä, tuotantoympäristöstä ei voi liittyä. Järjestelmätoimittajan vastuulla on asiakkaansa liittymisen tukeminen Kanta-asiakastestipalveluun.

Kanta-palvelut Yhteistestauksen palvelukuvaus 10 (34) Liittymisvaatimukset on tarkemmin kuvattu kanta.fi-sivuston Testaus-osiossa dokumentissa Kanta-asiakastestipalvelun liittymisohje. 2.3 Kanta-asiakastestipalvelun palveluaika, päivitykset ja huoltokatkot Kanta-asiakastestiympäristö on käytettävissä pääsääntöisesti maanantaista perjantaihin klo 8.00 16.00. Palvelu on käytettävissä muinakin aikoina, mutta varsinaisen palveluajan ulkopuolella ympäristössä voi olla päivitys- ja huoltokatkoja. Asiakastestiympäristön huoltoikkuna on kuukauden ensimmäinen torstai. Tällöin palvelussa voi olla katkoksia klo 8.00 16.00 välisenä aikana. Asiakastestiympäristöön liittyvät ohjelmistopäivitykset tehdään tarpeen mukaan. Liittyneitä organisaatioita tiedotetaan palvelukatkoista, jotka kohdistuvat edellä ilmoitettuun palveluaikaan ja mahdollisuuksien mukaan myös muista Kantaasiakastestipalvelun katkoista. Päivityksistä ja huoltokatkoista ilmoitetaan vähintään kaksi vuorokautta ennen suunniteltua käyttökatkoa. 2.4 Testiaineiston luonti Kela toimittaa testitapaukset ja testihenkilötunnukset, joita on käytettävä yhteistestauksessa. Testitapaukset ovat kansallisia ja siten yhteisiä kaikille. Testitapaukset on dokumentoitu ja ne ovat kaikkien käytettävissä samassa muodossa versioituna. Sovitun yhteistestauksen ulkopuolella järjestelmätoimittajat ja näiden asiakasorganisaatiot voivat käyttää Kanta-asiakastestiympäristöä omatoimiseen testaukseen. Järjestelmätoimittaja tai asiakasorganisaatio voi siis luoda itse testiaineistoa tarpeen mukaan. Kela toimittaa tätä varten erilliset testihenkilötunnukset ja niitä saa pyydettäessä myös lisää. Yhteistestaukseen tarkoitettuja testihenkilötunnuksia ei käytetä omatoimiseen lisätestaukseen.

Kanta-palvelut Yhteistestauksen palvelukuvaus 11 (34) 3 Yhteistestauksen osapuolten vastuut Tässä luvussa kuvataan yhteistestaukseen liittyviä vastuita eri osapuolten näkökulmasta. 3.1 Järjestelmätoimittajan vastuu Järjestelmätoimittaja vastaa omassa testauksessaan potilastieto- tai apteekkijärjestelmänsä teknisestä ja sovelluslogiikan toimivuudesta. Potilastieto- tai apteekkijärjestelmän on toteutettava kanta.fi-sivustolla julkaistujen määrittelyiden mukaiset sähköisen reseptin tai Potilastiedon arkiston ja tiedonhallintapalvelun toiminnallisuudet. Potilastieto- tai apteekkijärjestelmän on tuotettava valideja CDA R2 -asiakirjoja ja muodostettava niistä määritysten mukaisia HL7-sanomia. Järjestelmätoimittaja voi käyttää jo tuotekehityksen aikana asiakirjojen validoinnissa apuna Kanta-validointipalvelua. Järjestelmätoimittaja tekee Kelalle hakemuksen Kantaasiakastestiympäristöön liittymiseksi ja hankkii sen käyttöä varten tarvittavat testivarmenteet Väestörekisterikeskukselta (VRK). Järjestelmätoimittaja vastaa tietojärjestelmänsä paikallisesta käytettävyydestä ja suorituskyvystä asiakkaan käytössä. Järjestelmätoimittajan on tiedotettava Kelaa ja asiakasorganisaatiota kaikista Kanta-palveluihin vaikuttavista virheistä, niiden korjaamisesta ja vaaditusta regressiotestaustarpeesta. Järjestelmätoimittaja suunnittelee ja toteuttaa omassa kehitysympäristössään tarvittavan testauksen. Yhteistestauksen uusintamenettelyt järjestelmätoimittaja sopii Kelan kanssa. Järjestelmätoimittajan on sitouduttava sovittuun yhteistestauksen aikatauluun ja tuettava asiakasorganisaationsa testaamista. Järjestelmätoimittaja etsii asiakaskunnastaan yhteistestaukseen osallistuvan organisaation huomioiden seuraavat tekijät: asiakasorganisaatiolla on testausympäristö, jossa mahdollisimman laaja sisällön ja toiminnallisuuden testaus onnistuu, asiakasorganisaatio on halukas osallistumaan testaukseen ja sillä on mahdollisuus resursoida henkilöstöä testauksen valmisteluun ja testaukseen sovittuna aikana sekä asiakasorganisaation tietojärjestelmäarkkitehtuurista on toimitettu Kelalle kuvaus yhteistestauksen kannalta oleellisilta osin (esimerkiksi kokonais- ja erillisjärjestelmän integraation toteutustapa, jos kummankin järjestelmän tuottamien asiakirjojen arkistointia testataan).

Kanta-palvelut Yhteistestauksen palvelukuvaus 12 (34) Järjestelmätoimittajalla on velvollisuus osallistua uusien liittyjien sertifioinnin tai muutosten takia järjestettäviin yhteistestauksiin ristiintestausosapuolena sen jälkeen, kun oma potilastietojärjestelmä on sertifioitu. 3.2 Järjestelmätoimittajan asiakasorganisaation vastuu Yhteistestaukseen osallistuva järjestelmätoimittajan asiakasorganisaatio tekee oman testausympäristönsä osalta liittymishakemuksen Kantaasiakastestiympäristöön ja hankkii Väestörekisterikeskukselta (VRK) testauksessa tarvittavat testivarmennekortit sekä testipalvelin- ja testijärjestelmäallekirjoitusvarmenteet. Asiakasorganisaatio vastaa, että käytössä oleva apteekki- tai potilastietojärjestelmä ja mahdolliset erillisjärjestelmät täyttävät liittymisen tekniset ja toiminnalliset vaatimukset käyttäen tukena jä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. Asiakasorganisaatio velvoitetaan osallistumaan uusiin yhteistestauksiin ristiintestausosapuolena myös sen jälkeen, kun sen käyttämä järjestelmä on sertifioitu. 3.3 Kelan vastuu Kela ylläpitää Kanta-asiakastestiympäristöä ja sen lisäpalveluita sekä antaa testipotilaiden 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 yhdessä järjestelmätoimittajan kanssa 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 Kanta-palveluiden näkökulmasta ja antaa lausunnon yhteistestauksesta tietojärjestelmän sertifiointia varten. 3.4 Muiden osapuolten vastuut Valvira, rooli- ja attribuuttitietopalvelun ylläpitäjä VRK, varmennepalvelun ylläpitäjä THL, olennaiset vaatimukset

Kanta-palvelut Yhteistestauksen palvelukuvaus 13 (34) Valvira vastaa rooli- ja attribuuttitietopalvelusta ja VRK varmennepalveluista. THL vastaa sähköisen reseptin ja Potilastiedon arkiston sekä tiedonhallintapalvelun olennaisista vaatimuksista ja laatii toiminnalliset määrittelyt.

Kanta-palvelut Yhteistestauksen palvelukuvaus 14 (34) 4 Sähköisen reseptin yhteistestaus Sähköisen reseptin yhteistestaus on tietojärjestelmien tuottamien sanomien yhteentoimivuuden testausta. Potilastieto- ja apteekkijärjestelmien yhteistestauksen tavoitteena on todeta, että tietojärjestelmät pystyvät tuottamaan sähköisen reseptin määritysten mukaisia sanomia ja että nämä sanomat ovat tulkittavissa kaikissa yhteistestaukseen osallistuvissa järjestelmissä teknisesti ja sisällöltään samanlaisina. Kuva 2. Sähköisen reseptin sanomarakenne. Yhteistestauksessa testataan sanoman eri kerroksia. Sanoman siirto- ja kontrollikehyksen tiedot, jotka lokittuvat Kanta-palvelun lokeille, testataan interaktiotestauksessa. Sähköisen reseptin CDA ja sen otsikkotiedot käydään läpi esimerkkisanomien tarkastuksessa. Yhteistestauksessa testataan sähköisen reseptin CDA:ta ja sen otsikkotietoja, kun yhteistestaukseen osallistuvat tietojärjestelmät lukevat toistensa muodostamia sanomia.

Kanta-palvelut Yhteistestauksen palvelukuvaus 15 (34) Sähköisen reseptin yhteistestausta koskevat kysymykset ja tiedustelut voi lähettää sähköpostilla osoitteeseen yhteistestaus@kanta.fi, viestin otsikossa ilmaistaan, että asia koskee sähköisen reseptin yhteistestausta. 4.1 Tavoite ja rajaukset Potilastieto- ja apteekkijärjestelmien yhteistestauksen tavoitteena on todeta, että eri tietojärjestelmistä lähetettävät sähköiseen reseptiin liittyvät sanomat ovat kaikissa yhteistestaukseen osallistuvissa järjestelmissä tulkittavissa teknisesti ja sisällöltään samanlaisina. Eri järjestelmien toiminnallisuudet tulee olla toteutettu niin, että sähköisen reseptin kirjoittamis- ja toimittamisprosessi toimii saumattomasti, riittävän tehokkaasti ja potilasturvallisuutta vaarantamatta. Yhteistestauksessa ei testata potilastieto- tai apteekkijärjestelmän sisäisiä toiminnallisuuksia. Yhteistestausta ei suunnitella potilastieto- ja apteekkijärjestelmien käyttöliittymien testauksen näkökulmasta. Yhteistestauksen lisäksi järjestelmätoimittajan tulee omissa testeissään todeta, että sähköisen reseptin vaatimusmäärittelyn mukaiset vaatimukset täyttyvät tietojärjestelmässä. 4.2 Testausaikataulu Yhteistestauksen läpiviemiseen on varattava aikaa vähintään kolme kuukautta ennen suunniteltua yhteistestausjaksoa. Mahdolliset laajat lainmuutokset tai muut suuret muutoshallinnat voivat vaikuttaa aloittamisaikaan ja yhteistestaukseen kuluvaan aikaan.

Kanta-palvelut Yhteistestauksen palvelukuvaus 16 (34) Kuva 3. Sähköisen reseptin yhteistestauksen aikataulumalli. Järjestelmätoimittajien ristiintestauksessa esiin tulevien virheiden korjaamista varten testaus voidaan keskeyttää kahdeksi viikoksi kuitenkin niin, että testauksen kokonaisaikataulu pysyy suunnitellussa 4 6 viikossa. Kelalla on oikeus keskeyttää tietojärjestelmän yhteistestaus, mikäli 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. Tarkistuspisteet pidetään erikseen sovittavan aikataulun mukaisesti. Jokaisessa testausvaiheessa pidetään vähintään yksi tarkistuspiste. Järjestelmätoimittaja sitoutuu yhteistestauksen aikatauluun suunnitelman mukaisesti (vähintään 10 viikkoa). Järjestelmätoimittajan tulee varata tarvittavat resurssit testaukseen ja virheiden korjaukseen. 4.3 Aloittamisen edellytykset ja testauksen vaiheet 4.3.1 Järjestelmätoimittajan testaus omassa testiympäristössään Järjestelmätoimittaja testaa oman tietojärjestelmänsä sähköisen reseptin toiminnallisuuksia itsenäisesti ennen liittymistä Kanta-asiakastestipalveluun. Kanta-validointipalvelua voi käyttää jo tässä vaiheessa asiakirjojen validointiin. 4.3.2 Liittyminen Kanta-asiakastestipalveluun ja itsenäinen testaus Järjestelmätoimittaja liittyy Kanta-asiakastestipalveluun. Ohjeet liittymisestä löytyvät kanta.fi-sivustolta. Edellytykset:

Kanta-palvelut Yhteistestauksen palvelukuvaus 17 (34) Järjestelmätoimittaja on kehittänyt potilastieto- tai apteekkijärjestelmän, joka toteuttaa sähköisen reseptin keskeiset käyttötapaukset: reseptien kirjoittaminen, hakutoiminnot ja toimitukset sekä niihin liittyvät korjaukset ja mitätöinnit. Järjestelmätoimittaja on tehnyt kirjallisen selvityksen siitä, että järjestelmä on mahdollista liittää Kanta-palveluun kunkin kansallisesti kuvatun liittymismallivaihtoehdon avulla (Kanta.fi: liittymismallit Kantapalveluihin) 1. Järjestelmätoimittaja testaa itsenäisesti Kanta-asiakastestiympäristössä kaikki määritellyt sähköisen reseptin toiminnallisuudet käyttäen lääkerekisteriä, jossa on kansallisen lääketietokannan tietojen kanssa yhtäpitävät tiedot ja jota on tarkoitus käyttää tuotannossa. Potilastietojärjestelmätoimittaja 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 järjestelmätoimittajan käyttöön (esim. lääketoimituksia ja uusimispyyntöjä). Testimateriaalin toimitusaika on noin kaksi viikkoa. Järjestelmätoimittaja arvioi, milloin se on valmis yhteistestauksen aloittamiseen. 4.3.3 Ilmoittautuminen yhteistestaukseen Ilmoittautuminen yhteistestaukseen on tehtävä sähköpostitse osoitteeseen yhteistestaus@kanta.fi kolme kuukautta ennen suunniteltua yhteistestauksen aloittamista. Kela tiedottaa yhteistestaukseen ilmoittautuneista järjestelmistä kanta.fi-sivuston Testaus-osiossa. Ilmoittautumisen yhteydessä Kelalle toimitetaan testausraportti, josta selviää, että tietojärjestelmän kaikki määritellyt sähköisen reseptin toiminnallisuudet on testattu asiakastestiympäristössä (ks. luku 4.5 Sähköisen reseptin toiminnallisuudet ja käyttötapaukset) käyttäen lääkerekisteriä, jossa on kansallisen lääketietokannan tietojen kanssa yhtäpitävät tiedot ja jota on 1 Järjestelmän tulee noudattaa kansallisten vaatimusten mukaisia avoimia rajapintoja ja standardeja. Jä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 Kanta-liittymismallien muuttuessa.

Kanta-palvelut Yhteistestauksen palvelukuvaus 18 (34) tarkoitus käyttää tuotannossa. Tietojärjestelmän käyttäjähallinta sekä Valviran rooli- ja attribuuttitietojen käyttö tulee olla toteutettu Kelan vaatimusmäärittelyn mukaisesti. Suoritetusta testauksesta tulee toimittaa Kelalle testausraportti yhteistestaukseen ilmoittautumisen yhteydessä. Testausraportissa tulee ilmoittaa käytettävä lääkerekisteri sekä miten lääkerekisterin jakelu käyttäjätahoille hoidetaan. Yhteistestaukseen ilmoittautumisen jälkeen Kela toimittaa järjestelmätoimittajalle tiedot siitä, mitkä validaattori- ja interaktiotestit järjestelmätoimittajan tulee suorittaa Kanta-asiakastestiympäristöön. Validaattori- ja interaktiotestit tulee olla tehtynä kahden viikon sisällä yhteistestaukseen ilmoittautumisesta. Kelan ja järjestelmätoimittajan kesken pidetään kokous yhteistestauksen periaatteista ja toteutuksesta. Järjestelmätoimittaja sitoutuu yhteistestauksen aikatauluun suunnitelman mukaisesti (vähintään 10 viikkoa). Tarvittavat resurssit on varattu testaukseen ja virheiden korjaukseen. 4.3.4 Validaattori- ja interaktiotestit Kela toimittaa järjestelmätoimittajalle testitapaukset validattori- ja interaktiotestien suorittamiseksi. Validaattori- ja interaktiotestit tulee suorittaa kahden viikon sisällä yhteistestaukseen ilmoittautumisesta. Testitapaukset suoritetaan yhdessä Kelan kanssa. Validaattori- ja interaktiotesteissä muodostuneet -asiakirjat on tuotettava integroidusta tietojärjestelmästä. Tietojärjestelmässä tulee olla käytössä lääkerekisteri, jossa on kansallisen lääketietokannan tietojen kanssa yhtäpitävät tiedot ja jota on tarkoitus käyttää tuotannossa. Asiakirjoissa tulee välittää tuotantoa vastaavat tiedot toimenpiteen suorittavasta ammattihenkilöstä (Valviran rooli- ja attribuuttitietopalvelun tiedot). Asiakirjoista tarkastetaan, että tietojärjestelmä tuottaa oikean muotoisia asiakirjoja oikealla tietosisällöllä. Interaktiotesteissä testataan, että kaikki tietojärjestelmän eri interaktiot toimivat ja niistä kirjautuu oikeat lokimerkinnät Kanta-palvelujen lokeille (mm. hakusanomien kyselyn syy ja suostumustiedot). 4.3.5 Hyväksyminen yhteistestaukseen Kela arvioi yhteistestaukseen ilmoittautumisen yhteydessä toimitetun testausraportin sekä validattori- ja interaktiotestauksen testitulosten perusteella onko tietojärjestelmällä valmiudet yhteistestauksen aloittamiseen. Yhteistestauksen aloittamisen edellytyksenä on myös, että Kela on

Kanta-palvelut Yhteistestauksen palvelukuvaus 19 (34) hyväksynyt toimittajan selvityksen tuesta kansallisesti määritellyille liittymismalleille. Mikäli tietojärjestelmää ei ensimmäisen testauskierroksen perusteella voida hyväksyä yhteistestaukseen, voidaan järjestelmätoimittajalle antaa korjausaikaa. Interaktiotestit 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. Tällöin järjestelmätoimittajille jää riittävästi aikaa korjausten toteuttamiseen. 4.3.6 Järjestelmätoimittajien ristiintestaus Jä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 jä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. Jä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 järjestelmän testaustuloksia, järjestelmätoimittajien ristiintestaus on tehtävä uudestaan aikaisintaan seuraavan testausjakson aikana. Tällöin jä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. 4.3.7 Asiakasorganisaatioiden ristiintestaus Järjestelmätoimittajien asiakastestaajina toimivat terveydenhuollon organisaatiot ja apteekit (asiakasorganisaatiot) suorittavat ristiintestauksen Kelan toimittamien testiketjujen ja esimerkkilääkemääräysten mukaisesti. Jos

Kanta-palvelut Yhteistestauksen palvelukuvaus 20 (34) testattava jä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 järjestelmätoimittajan yhtä asiakasorganisaatiota. Kela järjestää asiakastestaajakumppanin asiakasorganisaatioiden ristiintestaukseen. Aloittamisen edellytykset: Kelan, järjestelmätoimittajan ja asiakasorganisaation kokous yhteistestauksen pelisäännöistä on pidetty. Asiakasorganisaatio on perehdytetty tuotteeseen ja tietojärjestelmän testiin luovutus asiakkaalle on tehty (järjestelmätoimittajan vastuulla). Asiakasorganisaatio liittymishakemus Kanta-asiakastestipalveluun on lähetetty Kelalle, liittymishakemus tehdään mielellään jo samoihin aikoihin, kun järjestelmätoimittaja itse tekee liittymishakemuksen. Tietojärjestelmä on suorittanut järjestelmätoimittajien ristiintestauksen hyväksytysti. Asiakasorganisaatio sitoutuu yhteistestauksen ristiintestauksen aikatauluun suunnitelman mukaan (4 viikkoa). Jos osapuolet eivät hyväksy tietojärjestelmän testaustuloksia, asiakasorganisaatioiden ristiintestaus on tehtävä uudestaan aikaisintaan seuraavan testausjakson aikana. Tällöin järjestelmätoimittajille jää riittävästi aikaa korjausten toteuttamiseen. 4.4 Hyväksymiskriteerit ja raportointi Kaikki määritellyt toiminnallisuudet pitää testata ja todeta yhteistestausjaksoon osallistuvissa tietojärjestelmissä yhteentoimiviksi testauksen aikana. Havaitut virheet pitää olla korjattu tai erikseen on päätetty korjausaikataulu aukioleville virheille. Kela laatii yhteistestauskokonaisuuden päätteeksi lausunnon hyväksytysti suoritetusta yhteistestauksesta järjestelmän sertifiointia varten. Asiakasorganisaatio laatii lausunnon liitteeksi testausraportin suorittamastaan yhteistestauksesta. 4.5 Sähköisen reseptin toiminnallisuudet ja käyttötapaukset 4.5.1 Potilastietojärjestelmä Tarkastele lääkemääräyksiä, lääketoimituksia ja uusimispyyntöjä

Kanta-palvelut Yhteistestauksen palvelukuvaus 21 (34) Kirjoita lääkemääräys Lähetä allekirjoitetut lääkemääräykset ja lääkemääräysten korjaukset Mitätöi lääkemääräys Korjaa lääkemääräystä Alikäyttötapaus Hae tietoja reseptikeskuksesta Alikäyttötapaus Poista reseptikeskuksesta haetut tiedot potilaskertomus-järjestelmästä Poista lääkemääräyksen lukitus Tulosta potilasohje Tulosta yhteenveto sähköisistä lääkemääräyksistä Käsittele uusimispyynnöt Hylkää tai palauta uusimispyyntö Ohjaa uusimispyynnöt käsittelyyn Tee uusimispyyntö Sulkulistat, attribuuttipalvelu 4.5.2 Apteekkijärjestelmä Alikäyttötapaus Hae tietoja reseptikeskuksesta Alikäyttötapaus Poista reseptikeskuksesta haetut tiedot apteekin tietojärjestelmästä Valitse toimitettavat lääkemääräykset Tee lääketoimitus Lähetä allekirjoitetut lääketoimitukset Lähetä allekirjoitettu lääketoimituksen mitätöinti Tulosta yhteenveto sähköisistä lääkemääräyksistä Mitätöi lääketoimitus Korjaa lääketoimitusta Päivitä lääkemääräyksen tilatietoja (lukitus, varaus, annosjakelu ja näiden purkusanomat sekä toimitusvarauksen purku) Lähetä uusimispyyntö Tarkasta lähetettyjen uusimispyyntöjen tilat Korjaa lääkemääräystä Mitätöi lääkemääräys Lähetä allekirjoitettu lääkemääräyksen korjaus Lähetä allekirjoitettu lääkemääräyksen mitätöinti Sulkulistat, attribuuttipalvelu 4.6 Kelan tuki Kelalla on testilaboratoriossaan tarvittavat tietojärjestelmät, joiden avulla voidaan simuloida tietojärjestelmien toiminnallisuuksia ja selvittää virhe- ja

Kanta-palvelut Yhteistestauksen palvelukuvaus 22 (34) 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. Kelan asiakastestiympäristössä on käytössä myös allekirjoitusvalidaattori, jonka avulla voidaan tarkastaa sähköisen allekirjoituksen oikeellisuutta sekä toimittajaloki, josta järjestelmätoimittajat näkevät virheilmoitukset tarkemmalla tasolla. Yhteistestauksessa käytetty testimateriaali on Kelan käytössä yhteistestauksen jälkeen. Kela toimittaa tarvittaessa yhteistestauksen testimateriaalia muiden järjestelmien testauskäyttöön. Kela ei ota kantaa tietojärjestelmien käyttöliittymiin eikä tue järjestelmätoimittajaa substanssiasioissa. Järjestelmätoimittajalla pitää olla yhteistestauksen aikana käytettävissään omaa tai asiakkaansa asiantuntijatukea farmasiaa ja lääkehoitoa koskevissa asioissa.

Kanta-palvelut Yhteistestauksen palvelukuvaus 23 (34) 5 Potilastiedon arkiston yhteistestaus Tämä luku esittelee Potilastiedon arkiston yhteistestausten yleiset periaatteet, jotka koskevat niin julkisen kuin yksityisen sektorin järjestelmien testausta. Kunkin yksittäisen yhteistestauksen tarkempi sisältö ja aikataulu kuvataan omassa testaussuunnitelmassa. Yhteistestauksessa potilastietojärjestelmät testataan suunnitelmallisesti toistensa ja Potilastiedon arkiston kanssa Kanta-asiakastestipalvelussa. Yhteistestauksen tavoitteena on todeta, että eri potilastietojärjestelmistä lähetettävät sanomat ovat kaikissa yhteistestaukseen osallistuvissa järjestelmissä tulkittavissa teknisesti ja sisällöltään samanlaisina. Eri järjestelmien toiminnallisuudet tulee olla toteutettu niin, että toimintaprosessi toimii saumattomasti, riittävän tehokkaasti ja potilasturvallisuutta vaarantamatta. Kela suunnittelee yhteistestausjaksojen ajoituksen ja käytettävät testitapaukset sekä valvoo testauksen etenemistä. Potilastiedon arkistoon liitytään pääsääntöisesti terveydenhuollon kokonaisjärjestelmillä, joilla organisaatio hoitaa sekä potilaskertomusasiakirjojen tuottamisen että potilashallinnon ja toiminnanohjauksen. Organisaatioilla on lisäksi rajoitetumpaan käyttöön tarkoitettuja potilastietojärjestelmiä, esimerkiksi kuvantamisen ja laboratorion erillisjärjestelmiä, sekä erilaisia alueellisia potilastietojärjestelmiä. Yhteistestauksen ilmoittaudutaan sähköpostitse osoitteeseen yhteistestaus@kanta.fi. Ilmoittautumislomake ja lisätietoa ajankohtaisista yhteistestausjaksoista julkaistaan Kanta.fi-sivuston Testaus-osiossa. Yhteistestaukseen osallistuminen edellyttää, että potilastietojärjestelmään on rakennettu määritysten mukaiset toiminnallisuudet Potilastiedon arkistoon liittymistä varten. Yhteistestausvalmiuden osoittamiseksi järjestelmätoimittajan tulee raportoida näihin toiminnallisuuksiin liittyvän oman testauksensa tulokset Kelalle. Lisäksi järjestelmätoimittajan tulee toimittaa Kelalle selvitys toiminnallisten vaatimusten toteutumisesta. Ohjeet selvityksen sisällöstä ja laatimisesta tulevat THL:ltä. Kun osallistumisen edellytykset täyttyvät ja järjestelmätoimittaja on ilmoittautunut yhteistestaukseen, tarkennetaan testauksen sisältö, aikataulu, resurssivaatimukset ja mahdolliset rajaukset toimittajan ja Kelan yhteistyönä. Osapuolet sitoutuvat noudattamaan yhteisesti sovittua aikataulua ja suunnitelmaa. Potilastiedon arkiston yhteistestausta koskevia kysymyksiä ja tiedusteluja voi lähettää sähköpostitse osoitteeseen yhteistestaus@kanta.fi, viestin otsikossa ilmaistaan, että asia koskee Potilastiedon arkiston yhteistestausta.

Kanta-palvelut Yhteistestauksen palvelukuvaus 24 (34) 5.1 Suunnittelu ja toteuttaminen Kela suunnittelee ja koordinoi yhteistestauksen, jonka tarkoituksena on todentaa erityyppisten asiakirjojen määritysten mukainen arkistoituminen ja luovutus Potilastiedon arkistosta. Järjestelmätoimittajalla on kuitenkin aina vastuu suunnitella oman potilastietojärjestelmänsä testauskokonaisuus kulloisenkin tarpeen mukaan niin teknisten ominaisuuksien kuin käytettävyydenkin osalta. Kela toimittaa yhteistestauksen ohjeistuksen ja kansallisesti määritellyt testitapaukset, joita on käytettävä yhteistestauksessa. Kantaasiakastestiympäristöön arkistoidaan asiakirjoja vain Kelan toimittamille testihenkilötunnuksille. Kela myöntää testihenkilötunnuksia yhteistestausten lisäksi myös omatoimiseen testaukseen. Yhteistestauksessa käytettyjä testihenkilötunnuksia ei saa käyttää muuhun testaukseen. 5.2 Yhteistestauksen aikataulu Järjestelmätoimittajien ja näiden asiakasorganisaatioiden on oltava valmiina kuhunkin vaiheeseen erillisten kriteerien mukaisesti. Kullekin vaiheelle määritellään kesto, jossa testaus on kyettävä suorittamaan. Kokonaisuudessaan laaja yhteistestaus kestää noin 5-6 kuukautta. Tarvittaessa vuosittain voidaan käynnistää useita yhteistestausjaksoja, jotka voivat asettua ajallisesti limittäin. Yhteistestausjaksojen aikataulut julkaistaan kanta.fi-sivuston Testaus-osiossa. Seuraavassa kaaviossa esitetään laajan yhteistestauksen perusvaiheistusmallin mukainen aikataulutus. Ensimmäiseen, järjestelmätoimittajan ja Kelan kahdenväliseen testaukseen varataan eniten aikaa, koska siihen sisältyy sekä arkistointi- että luovutustestiketjujen suoritus. Siinä varaudutaan myös 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ä on syytä aloittaa vasta, kun järjestelmätoimittajan ja Kelan välinen testaus on hyväksytty ja asiakasorganisaation testiympäristöön voidaan toimittaa mahdolliset korjaukset sisältävä potilastietojärjestelmän versio. Myös jälkimmäiset testausvaiheet on optimaalista suorittaa peräkkäin.

Kanta-palvelut Yhteistestauksen palvelukuvaus 25 (34) Potilastiedon arkiston laaja yhteistestaus Vaihe Toimittajan omatoiminen testaus Aika kuukausina 1 2 3 4 5 6 Liittyminen Kantaasiakastestiympäristöön Aloituskokous Kelan kanssa Toimittajan ja Kelan kahdenvälinen testaus Asiakasorganisaation ja Kelan kahdenvälinen testaus Asiakasorganisaatioiden ristiintestaus Kelan lausunto Kuva 4. Potilastiedon arkiston laajan yhteistestauksen ohjeellinen aikataulumalli vaiheen 1 tietosisällön testaukselle. Jos kyseessä on suppeampi testaus, sovelletaan aikataulua vastaavasti. Kaiken kaikkiaan Potilastiedon arkiston yhteistestauksesta voidaan antaa vain ohjeellinen aikataulumalli, koska testausjakson kokonaiskesto riippuu monesta tekijästä, muun muassa järjestelmän alkuvalmiudesta, testauksen osapuolten resursseista sekä havaittujen virheiden määrästä ja uudelleentestaustarpeesta sekä testattavasta tietosisällöstä. Perusmallista poikkeavissa tilanteissa testauksen sisältö ja kesto vaatii yksilöllisempää suunnittelua. Näitä poikkeustilanteita ovat esimerkiksi: erillisjärjestelmän tuottamien asiakirjojen arkistoinnin ja luovutusten testaus huomioiden palvelutapahtuman muodostuminen erillisjärjestelmän ulkopuolella, arkiston toiminnallisuuksia vain osittain käyttävien järjestelmien testaus, esimerkiksi pelkkiä asiakirjojen hakuja tekevät järjestelmät sekä tietosisällön tai toiminnallisuuden muutosten ja täydennysten testaus. 5.3 Tarkistuspalaverit Testauksen etenemistä käydään läpi tilannepalavereissa, joissa testien tulokset käydään läpi yhteistyössä testausvaiheeseen osallistuvien toimijoiden kesken. Tarkistuspisteiden avulla seurataan testauksen edistymistä ja aikataulussa pysymistä sekä arvioidaan seuraavaan testausjaksoon siirtymistä. Kela arvioi testien onnistumisen ja läpäisyn Potilastiedon arkiston/tiedonhallintapalvelun osalta, mutta testien tulee olla onnistuneita myös järjestelmätoimittajan oman tietojärjestelmän vaatimusten mukaan.

Kanta-palvelut Yhteistestauksen palvelukuvaus 26 (34) Tarkistuspisteissä käydään läpi testauksessa ilmenneet virheet ja niiden jatkotoimenpiteet, sekä sovitaan tarvittavasta uudelleentestauksesta. Kela ylläpitää listaa Potilastiedon arkistosta havaittavista virheistä ja vastaavasti järjestelmätoimittaja huolehtii potilastietojärjestelmän virhehavaintojen listauksesta. 5.4 Potilastiedon arkiston yhteistestauksen vaiheet Yhteistestauksen sekä sisällöllinen että aikataulullinen laajuus riippuu testattavan toiminnallisuuden ja tietosisällön määrästä. Kela määrittelee kunkin yhteistestauksen sisällön ja laajuuden. Testausvaiheet ja sisältö kuvataan tarkemmin kunkin yhteistestauksen omassa testaussuunnitelmassa. 5.4.1 Testaus ennen yhteistestauksen alkua Testauksen sisältöä ovat: sovelluskehityksen aikainen testaus järjestelmätoimittajan ympäristössä, kun potilastietojärjestelmään toteutetaan määritysten mukaiset toiminnallisuudet ja tietosisällöt Potilastiedon arkistoon liittymistä varten järjestelmän tuottamien asiakirjojen tarkistus Kanta-validointipalvelussa liittyminen Kanta-asiakastestipalveluun järjestelmätoimittajan omatoiminen testaus potilastietojärjestelmän ja Kanta-asiakastestiympäristön välillä, Omakanta-testipalvelun käyttäminen apuna ilmoittautuminen yhteistestaukseen, kun potilastietojärjestelmällä on siihen valmiudet, viimeistään 2-3 kuukautta ennen yhteistestausjakson alkua toiminnallisten vaatimusten toteutumisesta toimitetaan selvitys Kelalle ennen yhteistestauksen aloittamista raportin toimittaminen Kelalle yhteistestausvalmiuksien arviointia varten, yhteistestauksen edellytykset ja yhteistestausvalmiuden raportointipohja löytyvät kanta.fi-sivuston Testaus-osiosta. 5.4.2 Järjestelmätoimittajan ja Kelan välinen tekninen järjestelmätestaus Vaiheen tavoitteena on testata potilastietojärjestelmän ja Potilastiedon arkiston välistä toiminnallisuutta ja tietosisältöä lyhyiden testitapausten avulla sekä todentaa valmius edetä seuraavaan testausvaiheeseen. Vaiheen aikana testataan sekä arkistointi- että luovutustoiminnallisuuksia.

Kanta-palvelut Yhteistestauksen palvelukuvaus 27 (34) Järjestelmätoimittaja testaa ja raportoi testit Kelalle, korjaa testauksessa potilastietojärjestelmässä havaitut virheet, sekä osoittaa korjausten toimivuuden kohtien uudelleentestauksella ja raportoinnilla. Järjestelmätoimittaja vastaa potilastietojärjestelmänsä sisäisen toiminnallisuuden testaamisesta huomioiden asiakkaidensa erilaiset käyttötarpeet. Kela tarkastaa raportoidut testit, antaa palautetta testaushavainnoista ja hyväksyy testauksen tulokset. Vaihe voidaan hyväksyä, kun kaikki suunnitellut testit on testattu ja raportoitu ja järjestelmätoimittaja korjaa testauksessa potilastietojärjestelmässä havaitut virheet sekä osoittaa korjausten toimivuuden kohtien uudelleentestauksella ja raportoinnilla. Mikäli korjausten ja uudelleentestausten jälkeen esiintyy vielä puutteita, puutteet dokumentoidaan ja niitä koskevat jatkotoimenpiteet käsitellään erikseen. 5.4.3 Järjestelmätoimittajan asiakasorganisaation ja Kelan välinen testaus Vaiheen aikana testataan Potilastiedon arkiston toiminnallisuuksia ja tietosisältöä määriteltyjen laajempien toimintoketjujen avulla järjestelmätoimittajan asiakasorganisaation testiympäristössä tuotantokäyttöä vastaavalla tavalla. Testaus painottuu arkistointitoiminnallisuuksiin. Asiakasorganisaation testausympäristöön tulee olla toteutettuna myös arkistoitavien asiakirjojen tuottamiseen tarvittavat liittymät erillisjärjestelmiin. Testauksen tavoitteena on todentaa potilastietojärjestelmän ja Potilastiedon arkiston välinen toimivuus asiakasorganisaation käytössä. Myös ne testausvaiheet, joihin asiakasorganisaatiot tämän prosessin mukaisesti osallistuvat, liittyvät potilastietojärjestelmän (eikä asiakasorganisaation) liittymisvalmiuksien varmistamiseen, minkä vuoksi Kela tukee vain yhtä asiakastestausta potilastietojärjestelmää kohti. Testauksessa voi olla mukana yksi asiakasorganisaatio tai useamman asiakasorganisaation muodostama kokonaisuus. Asiakasorganisaatio testaa ja raportoi testit Kelalle ja järjestelmätoimittajalle sekä suunnittelee ja organisoi omien testausresurssien käytön. Asiakasorganisaatio vastaa, että testaus sisältää riittävästi tuotantokäytön kaltaisia tilanteita ja että testaus vastaa omia käyttötarpeita. Järjestelmätoimittaja osallistuu asiakasorganisaationsa testaukseen ja tukee testausta tarpeen mukaan seuraavin toimin:

Kanta-palvelut Yhteistestauksen palvelukuvaus 28 (34) varmistaa yhdessä asiakasorganisaationsa kanssa, että käytettävissä on vaatimusten mukainen testiympäristö ja toimittaa tarvittavat päivitykset, opastaa asiakasorganisaationsa testaajia testaukseen sisältyvissä potilastietojärjestelmän toiminnallisuuksissa sekä täsmentää kansallisten testitapausten toteutus- ja raportointiohjeistuksen testattavaa potilastietojärjestelmää varten, opastaa asiakasorganisaationsa pääkäyttäjiä testiympäristön konfiguroinnissa ja varaa riittävästi resursseja testauksen aikaiseen tukeen, kuten virhe- tai ongelmatilanteiden selvittelyyn ja tilannekatsauspalavereihin osallistumiseen. Kela tarkastaa raportoidut testit, antaa palautetta tarvittavista virhekorjauksista ja hyväksyy asiakasorganisaation testauksen tulokset. Vaihe voidaan hyväksyä, kun kaikki suunnitellut testit on tehty, asiakasorganisaatio on raportoinut Kelalle suorittamansa testauksen, korjannut mahdolliset omaan testiympäristöönsä liittyvät puutteet, järjestelmätoimittaja on korjannut testauksessa havaitut sovellusvirheet sekä toimittanut korjaukset asiakasorganisaationsa käyttöön ja 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. 5.4.4 Ristiintestaus Ristiintestaus suoritetaan järjestelmätoimittajien asiakasorganisaatioiden välisenä. Ristiintestaukseen osallistuu uutta testattavaa potilastietojärjestelmää käyttävä asiakasorganisaatio ja toista, aikaisemmin sertifioitua järjestelmää käyttävä asiakasorganisaatio. Kummankin osapuolen järjestelmätoimittajat osallistuvat ristiintestauksen suunnitteluun sekä tukevat asiakasorganisaatiota testauksessa. Järjestelmätoimittajan tuki on erityisen tärkeä testattavan järjestelmän osalta. Vaihe voidaan aloittaa, kun Kelan, järjestelmätoimittajien ja näiden asiakasorganisaatioiden yhteinen aloituskokous on pidetty, edelliset testausvaiheet on suoritettu hyväksytysti ja asiakasorganisaatiot ovat sitoutuneet testauksen aikatauluun sekä ovat varanneet tarvittavat resurssit.

Kanta-palvelut Yhteistestauksen palvelukuvaus 29 (34) Ristiintestauksessa käytetään asiakasorganisaatioiden omia Kantaasiakastestiympäristöön liitettyjä tuotannon kaltaisia testausympäristöjä. Näihin on mahdollisesti toteutettu integraatioita erillisjärjestelmiin. Testauksen kohteena on suostumustenhallinta, luovutustoiminnallisuus ja arkistoitujen tietojen tarkastelu. Aineistona käytetään aiemmin yhteistestauksessa arkistoituja tietoja sekä ristiintestauksessa arkistoitavia uusia tietoja. Testausvaiheen päätyttyä asiakasorganisaatiot raportoivat Kelalle tuloksista. 5.5 Testitapaukset Testitapaukset perustuvat Potilastietojärjestelmien käyttötapaukset - dokumentissa kuvattuihin arkiston hyödyntämisen käyttötapauksiin. Dokumentin uusin versio on julkaistu Kanta.fi-sivustolla (ammattilaiselle/potilastiedon arkiston määrittelyt). Testitapaukset kootaan testauskokonaisuuksiksi. Kokonaisuuksien sisältöön vaikuttavat mm. vaiheistusasetuksessa säädetyt käyttöönottojen takarajat. Yksittäisiä yhteistestauksia suunniteltaessa huomioidaan lisäksi testattavan järjestelmän käyttötarkoitus, ja käyttötarkoitukseen soveltumattomat testitapaukset voidaan perustelluista syistä jättää testaamatta. Järjestelmätoimittajan ja Kelan kahdenvälisen testauksen testitapaukset ovat lyhyitä ja tiettyyn toiminnallisuuteen rajautuvia. Jos testauskokonaisuuteen sisältyy myös asiakasorganisaation testaus, tämän vaiheen testitapauksiin sisällytetään samoja testauskokonaisuuden käyttötapauksia, mutta testitapaukset ovat pitempiä ketjuja, jotka jäljittelevät terveydenhuollon työnkulkuja. Ristiintestauksen testitapauksissa keskitytään yhteentoimivuuteen, kun testauskokonaisuuden mukaisia sisältöjä hyödynnetään eri potilastietojärjestelmillä. 5.6 Hyväksymiskriteerit Tässä luvussa esitettyjä kriteereitä ja toimintaperiaatteita sovelletaan kaikissa erilaisissa yhteistestauksissa riippumatta siitä, onko kyseessä suuri kansallisen muutoksenhallintaprosessin mukainen versio tai pienemmän muutospaketin testaus, jossa ei viedä läpi kaikkia testausvaiheita. Kaikkien testausvaiheiden päätyttyä Kela, asiakasorganisaatio ja järjestelmätoimittaja arvioivat yhdessä, onko potilastietojärjestelmän yhteistestaus suoritettu hyväksytysti. Kela laatii yhteistestauskokonaisuuden päätteeksi lausunnon hyväksytysti suoritetusta yhteistestauksesta järjestelmän sertifiointia varten. Asiakasorganisaatio laatii lausunnon liitteeksi testausraportin suorittamastaan yhteistestauksesta.

Kanta-palvelut Yhteistestauksen palvelukuvaus 30 (34) 5.6.1 Yhteistestauksen aloitus- ja lopetus/hyväksymiskriteerit Yhteistestaus voidaan aloittaa, kun järjestelmätoimittajan omasta toiminnallisten vaatimusten testauksesta on toimitettu selvitys Kelaan, yhteistestausvalmiusraportti on toimitettu Kelaan, testauksen alkuvalmistelut, kuten testiympäristön konfigurointi on valmis, järjestelmätoimittajan testaus Kanta-validointipalvelua vasten on suoritettu, testisuunnitelma on hyväksytty, tarvittava testauksen laajuus on arvioitu Kelan ja järjestelmätoimittajan kesken sekä Kelan lupa aloittaa testaus on annettu. Yhteistestaus voidaan hyväksyä, kun kaikki sovitut testivaiheet ja testit on hyväksytysti suoritettu, kaikki tunnetut ongelmat on rekisteröity ja tiedotettu, tunnetut ongelmat eivät olennaisesti haittaa tuotantokäyttöä, luokan 2 ja 3 havainnot on todennettu korjautuneiksi sekä luokan 1 havainnot on joko todennettu korjautuneiksi tai ne on kirjattu jatkokehityksessä huomioitaviksi (havaintojen luokittelu esitellään luvussa 6). 5.6.2 Testauksen keskeyttäminen ja jatkaminen Yhteistestaus voidaan keskeyttää tilapäisesti välittömien muutospaineiden takia. Kyseessä voi olla esimerkiksi testauksen jatkamisen estävä virhe tai merkittävä resurssivaje. Testauksen keskeyttäminen on keino rauhoittaa tilanne ja kohdentaa voimavarat ongelman korjaamiseen. Yhteistestausta voidaan jatkaa, kun keskeyttämisen aiheuttanut tilanne on selvitetty. Sovellusvirheen osalta myös korjausten testaus tulee olla suoritettu onnistuneesti ja raportoitu. Tällöin on ensin arvioitava mitä jo suoritettuja yhteistestauksen testejä on uusittava. Testauksen jatkamisesta sovitaan osapuolten yhteisessä tilaisuudessa ja Kela antaa lopullisen hyväksynnän jatkamiselle.

Kanta-palvelut Yhteistestauksen palvelukuvaus 31 (34) 5.6.3 Testauksen lopettaminen ja hylkäämiskriteerit Jos useista keskeytyksistä ja uudelleentestauksista johtuen yhteistestaus ei etene, voidaan testaus lopettaa. Lopettamisesta sovitaan kaikkien osapuolten yhteisessä tilaisuudessa. Yhteistestaus voidaan hylätä, jos testauksen aikana on löydetty vakavuusluokkien 2-3 virheitä, eikä niitä ehditä tai pystytä korjaamaan testaukseen varatussa aikataulussa. 6 Havaintojen ja muutosten hallinta 6.1 Havaintojen ja virheiden luokittelu yhteistestausjaksolla 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 seuraavaan mahdolliseen korjausversioon. 2 - Merkittävä Virheellisestä toiminnosta haittaa, ei estä testauksen jatkumista, korjaus yhteistestauksen aikana, uudelleentestattava. 3 - Estävä Niin vakava virhe, että estää testauksen etenemisen, vaatii välittömän korjauksen, uudelleentestattava. Taulukko 2. Yhteistestauksessa käytettävä havaintojen luokittelu. 6.2 Virheiden korjaus Yhteistestaukseen osallistuva järjestelmätoimittaja huolehtii siitä, että tarvittavat korjaukset toteutetaan potilastieto- tai apteekkijärjestelmään ja korjauksen sisältävä sovellusversio toimitetaan testaukseen mahdollisimman nopeasti. Korjauksen tekemisen yhteydessä on tehtävä arvio tarvittavan uudelleentestauksen laajuudesta huomioiden myös korjauksen mahdollinen vaikutus muihin jo hyväksytysti testattuihin toiminnallisuuksiin. Korjausten ja uuden ohjelmistoversion asennusten jälkeen yleensä vähintään aiemmin