Attribuutti-kyselypalvelu



Samankaltaiset tiedostot
Attribuutti-kyselypalvelu

Vakuutusyhtiöiden testausinfo

TESTIRAPORTTI - VYM JA KANTA Virtuaaliyhteisöjen muodostaminen Versio 1.0

KanTa-palvelut. Web-reseptisovellukset. versio 1.0

TESTIRAPORTTI - JÄRJESTELMÄ, PORTAL Virtuaaliyhteisöjen muodostaminen Versio 1.0

Kyselyjälleenmyyjien, Poliisin ja Tullin testausinfo

TESTIRAPORTTI - JÄRJESTELMÄ, ADMIN Virtuaaliyhteisöjen muodostaminen Versio 1.0

Convergence of messaging

Visma Software Oy

TEKNINEN MÄÄRITTELY. Matkahuollon osoitekorttihaun rajapinta. Ismo Koskinen

Määrittelydokumentti NJC2. Helsinki Ohjelmistotuotantoprojekti HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

TESTIRAPORTTI - XMLREADER LUOKKA Virtuaaliyhteisöjen muodostaminen Versio 1.0

HYVÄKSYMISTESTAUS- RAPORTTI - HAKEUTUJAN PALVELUT JA TODENNETUN OSAAMISEN REKISTERI

KanTa-palvelut. Sähköisen lääkemääräyksen testauspalvelun suunnitelma. versio 1.0

Aineistosiirron testauksen aloituksen ohje Trafin sopimuskumppaneille

Terveydenhuollon todistusten välitys Kelaan -palvelu

Visma Nova Webservice Versio 1.1 /

T Testiraportti - integraatiotestaus

Projektisuunnitelma Viulu

Toimintaympäristön kuvaus. LTC-Otso Myyjän työkalu (POC)

Ohjelmiston testaussuunnitelma

T Testiraportti - järjestelmätestaus

Ohjelmiston toteutussuunnitelma

T Testiraportti TR-3. ETL-työkalu

INTRASTATIN SANOMA-ASIAKKAIDEN TESTAUSOHJE

Testaussuunnitelma. Pizzeria - Pitseria HAAGA-HELIA ammattikorkeakoulu Tietojenkäsittelyn koulutusohjelma. WebPizza

Omakannan Omatietovaranto palvelun asiakastestaus

Testaussuunnitelma. Koskelo. Helsinki Ohjelmistotuotantoprojekti. HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

Teknillinen korkeakoulu T Tietojenkäsittelyopin ohjelmatyö. Testausraportti Smartmeeting opponointi

T Tietojenkäsittelyopin ohjelmatyö. Testisarja Ray tracing. Tietokonegrafiikka-algoritmien visualisointi. Testisarja Ray tracing

TESTIRAPORTTI - XMLREADER-LUOKKA Virtuaaliyhteisöjen muodostaminen Versio 1.0 (luonnos 2)

Lohtu-projekti. Testaussuunnitelma

Tulorekisterin sidosryhmätestaus

Varmennepalvelu Rajapintakuvaus Kansallisen tulorekisterin perustamishanke

Vakuutusalan ja AKE:n ATJ-työryhmän kokous 1/2005 ( )

Testaussuunnitelma. PUSU-ryhmä. Helsinki Ohjelmistotuotantoprojekti. HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

OP Tunnistuksen välityspalvelu

IT2015 EKT ERITYISEHTOJA OHJELMISTOJEN TOIMITUKSISTA KETTERIEN MENETELMIEN PROJEKTEILLA LUONNOS

Esityksen sisältö Määrittelyjen mukaisuudesta varmistuminen - PlugIT-leima

Hyväksymistestauksen tarkistuslista järjestelmän hankkijalle

TIE Ohjelmistojen testaus 2015 Harjoitustyö Vaiheet 1 ja 2. Antti Jääskeläinen Matti Vuori

Käyttäjien tunnistaminen ja käyttöoikeuksien hallinta hajautetussa ympäristössä

Project-TOP QUALITY GATE

Good Minton QA Raportti Iteraatio 1 Sulkapalloliiton Kilpailujärjestelmä

VTJkysely-palvelu. Sovelluskyselyiden rajapintakuvaus

T Testiraportti - integraatiotestaus

Auditointi. Teemupekka Virtanen

KanTa-palvelut. Sähköisen lääkemääräyksen yhteistestauksen suunnitelma. versio 1.2

Kuopio Testausraportti Kalenterimoduulin integraatio

Tik Tietojenkäsittelyopin ohjelmatyö Tietotekniikan osasto Teknillinen korkeakoulu. LiKe Liiketoiminnan kehityksen tukiprojekti

CT60A4150 OHJELMISTOTESTAUKSEN PERUSTEET. Jussi Kasurinen Kevät 2016

Testaus- ja sertifiointisuunnitelma

<<PALVELUN NIMI>> Palvelukuvaus versio x.x

Kanta Liittymisohje Kanta-asiakastestipalveluun

TEKNINEN MÄÄRITTELY. Matkahuollon toimipistehaun rajapinta. Ismo Koskinen

Tapahtuipa Testaajalle...

UCOT-Sovellusprojekti. Testausraportti

Testaus- ja sertifiointisuunnitelma

OnniSMS Rajapintakuvaus v1.1

KArkisto2-hanke - kokemuksia earkiston pilotoinnista Kuopiossa ja InterSystemsin Ensemblestä KanTa-liityntäpisteenä

Kansallinen palveluväylä

Liittyminen Kanta-palveluihin Valmistelukokous. Kela, Kanta-palvelut,

Toiminta häiriötilanteissa. 3/2013 v. 1.3

PALVELUKUVAUS järjestelmän nimi versio x.x

Automaattinen regressiotestaus ilman testitapauksia. Pekka Aho, VTT Matias Suarez, F-Secure

Ohje ja testitapaus. 1 Käyttöönottokoe. 1.1 Kanta-arkistonhoitaja ja Arkistonhoitajan käyttöliittymä. 1.2 Käyttöönottokokeessa esiintyvät ongelmat


Suomi.fi Viestit -palvelun käyttöönotto. Viranomaisen ohje palveluun liittymiseksi

xxx avoimen rajapinnan hallintasuunnitelma (VALMIS 1.4)

L models. Testisuunnitelma. Ryhmä Rajoitteiset

Onnistunut Vaatimuspohjainen Testaus

Teknillinen korkeakoulu T Tietojenkäsittelyopin ohjelmatyö. Testitapaukset - Koordinaattieditori

EMCS-järjestelmän sanomarajapinnan toiminnallinen kuvaus asiakkaille Meeri Nieminen

Testaussuunnitelma. Ohjelmistotuotantoprojekti Nero. Helsinki Ohjelmistotuotantoprojekti HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

Varmennepalvelu Rajapintakuvaus Tulorekisteriyksikkö

Facta Osoiterekisterin ja KRYSP-Osoitteet rajapinnan käyttöönotto

Palveluväylä tuotantoon! Marraskuun KaPA-päivä Kehittämispäällikkö Pauli Kartano / VM Hankepäällikkö Eero Konttaniemi / VRK

Ohjelmistotuotteen hallinnasta

Liite 1: KualiKSB skenaariot ja PoC tulokset. 1. Palvelun kehittäjän näkökulma. KualiKSB. Sivu 1. Tilanne Vaatimus Ongelma jos vaatimus ei toteudu

SALAKIRJOITUKSEN VAIKUTUS SUORITUSKYKYYN UBUNTU käyttöjärjestelmässä -projekti

Kansallisen palveluväylän tekniset ratkaisut Eero Konttaniemi Petteri Kivimäki

Tiedonsiirto- ja rajapintastandardit

Uutisjärjestelmä. Vaatimusmäärittely. Web-palvelujen kehittäminen. Versio 1.3

tulli.fi versio 0.3, Sanoma-asioinnin testauspalvelun käyttöohje

Testauksen hallintaa teekkareille (ja muille kiinnostuneille) Arto Stenberg

Testaussuunnitelma PULSU. Syksy 2008 Ohjelmistotuotantoprojekti. HELSINGIN YLIOPISTO Tietojenkäsittelytieteen laitos

Paikkatiedot palveluväylässä kehityksen tilanne Väylän varrelta - Kansallisen palveluväylän kehitystilanne -seminaari

Testaussuunnitelma Versio Päiväys Tekijä Kuvaus

Tekninen suunnitelma - StatbeatMOBILE

Verkkopalkan palvelukuvaus

Tekninen suunnitelma - StatbeatMOBILE

11. PALAVERIN PÖYTÄKIRJA. Jyväskylän Yliopisto Tietotekniikan laitos CONCEPT-projekti Paikka ja aika

Testauspalvelu laadunvarmistajana Arekin monitoimittajaympäristössä. Satu Koskinen Teknologiajohtaja, Arek Oy

JReleaser Yksikkötestaus ja JUnit. Mikko Mäkelä

Julkinen sanomarajapinta ja

Testausraportti. Oppimistavoitteiden hallintajärjestelmä harri

COTOOL dokumentaatio Testausdokumentit

TAMPEREEN TEKNILLINEN YLIOPISTO

Kontrollipolkujen määrä

Transkriptio:

Attribuutti-kyselypalvelu Liittymien testausohje sivu 1/18

Sisällysluettelo 1 Tausta ja lähtötilanne... 3 1.1 Dokumentin tarkoitus ja kohde... 3 1.2 Jiran käyttö testauksen hallinnassa... 3 1.3 Testausympäristön looginen kuvaus... 4 1.4 Integraatiotestaus ja kuormitustestaus (kaikki kolme liittymää)... 4 1.5 Testauksessa huomioitavaa... 5 1.6 Kyselypalvelun testausta koskeva prosessi... 7 2 Testitapaukset attribuutti-rajoitustietosanomalle... 7 3 Ensimmäisen vaiheen toimenpiteet... 9 3.1 Yleistä ja tavoitteet... 9 3.2 Testauksen työsuunnitelma... 10 3.2.1 Connectivity-testaus (yhteystestaus)... 10 3.2.2 Web service -palveluiden testaus, palveluosoitteet... 10 4 Yhteistestauksen tavoitteet, malli ja raportointi... 13 4.1 Tavoitteet... 13 4.2 Testauksen toteutusmalli... 13 4.3 Testauksen päättämisen kriteerit... 13 4.4 Virheet ja raportointi... 13 5 Testauksen aloittamisen esimerkit... 15 5.1 A1 attribuutti-rajoitustietosanoma... 15 5.2 A2 ammattioikeuden rajoituslista... 17 5.3 A3 ammattioikeuden lista... 17 6 Viitteet... 17 7 Liitteet... 17 8 Muutoshistoria... 18 sivu 2/18

Liittymien testausohje 1 Tausta ja lähtötilanne 1.1 Dokumentin tarkoitus ja kohde Liittymien testausohje -dokumentissa kerrotaan Sosiaali- ja terveysalan lupa- ja valvontaviraston (Valvira) attribuuttikyselypalvelun kehittämishankkeen testauksen ohjeistus ja tavoitteet iteraatioittain (liittymittäin). Dokumentti on tarkoitettu testaajien apuvälineeksi ja testauksen rungoksi testauksen eri vaiheisiin. Testaajilla oletetaan olevan tietämystä Web service -palveluiden testaamisesta. Kyselypalvelun rajapinnassa käytetään ensimmäisen attribuutti-rajoitustietokyselyn osalta Web service SOAP versio 1.1 standardia ja kahden muun listakyselyn osalta standardia xml:ää https-protokollalla. Dokumentti kuvaa: 1. A1 Attribuutti-Rajoitustietosanoman kyselyvastaustoiminnon testauksen (WS/SOAP) 2. A2 Ammattioikeuden rajoituslistan tuottamisen ja noudon testauksen (HTTPS/XML) 3. A3 Ammattioikeuslistan tuottamisen ja noudon testauksen (HTTPS/XML) Kela on linjannut KanTo-hankkeessa testauksesta, jonka mukaan kyselypalvelun testausta tehdään (viite 1). Kelalla on prosessi KanTapalveluihin liittymiseksi (viite 2), jonka mukaiset toimenpiteet oletetaan suoritetuiksi ennen testausta. 1.2 Jiran käyttö testauksen hallinnassa Valviran toimittaja käyttää testauksen hallinnassa Jira-nimistä selainpohjaista välinettä. Valviran palvelulle on perustettu testauksen työtila Jira-välineeseen. Työtila ei toistaiseksi ole julkinen. Niille toimijoille, jotka käyttävät muuta hallintavälinettä, kohdan voi jättää huomiotta. Yksikkötestauksessa ja Valvira - Kela testauksessa kirjataan asiat Jiraan seuraavan ohjeen mukaan: - Se, että testitapaus on suoritettu onnistuneesti tai on löytynyt bugeja hoidetaan Jiran tilojen avulla (käytössä olevat oletustilat ovat:open, INPROGRESS, REOPENED, CLOSED). - Testitapaus testauksessa -> tilaksi INPROGRESS sivu 3/18

- Jos BUGI löytyy -> kirjataan Jiraan ja testitapauksen tilaksi -> REOPENED - Kun BUGI on korjattu -> tilaksi INPROGRESS - Kun testitapaus on testattu loppuun asti onnistuneesti, -> tilaksi CLOSED - COMMENT-kohtaan tulee tarkempaa tietoa testauksesta - Jirasta saa raportit CLOSED-tilan perusteella liittymittäin, testitapauksittain, josta näkee, että ne on testattu. 1.3 Testausympäristön looginen kuvaus Kuvassa 1 esitetään kyselypalvelun looginen ympäristö. Kuva 1: Kyselypalvelun looginen kuva 1.4 Integraatiotestaus ja kuormitustestaus (kaikki kolme liittymää) Tässä kuormitus- ja suorituskykytestauksen kohteena on kyselypalvelun ympäristö ja tavoitteena kyseisessä ympäristössä saatujen sivu 4/18

mittaustulosten analysoiminen. Kukin sovellustoimittaja (sidosryhmä) vastaa oman ympäristönsä sisäisistä testauksista. Valviran kyselypalvelun toimittaja on käyttänyt Jmeter-nimistä ohjelmaa suorituskyvyn testaamiseen. Jmeteristä on saatavilla julkisesti dokumentaatio ja ladattava versio omaan käyttöön. Jotta kuormitustestauksen testitulokset ovat pitäviä, tulee testiympäristön olla identtinen (ohjelmistokonfiguraatiot, verkkokonfiguraatiot jne.) tuotannon kanssa, muuten tulokset ovat vain suuntaa antavia. Tässä kuormitustestissä saadaan vastaus, miten nopeasti ensimmäinen komponentti vastaa Jmeterille. Jmeter asennetaan esimerkiksi Windowspalvelimelle tai sitä voidaan ajaa etäyhteydellä testausympäristössä. Valviran kyselypalvelun toimittaja on käyttänyt kyselyn simuloimiseen salaamattomassa sisäisessä yhteydessä Altovan XMLSpy -nimistä välinettä, jolloin on voitu varmistua, että kysely ja vastaus ovat valideja. Ulkoisissa SSL-salatuissa yhteyksissä kyselyn simuloimiseen voidaan käyttää esimerkiksi Jmeter-välinettä. Varsinaiseen testaukseen tulee käyttää oikeaa sovellusta, jossa Web service / https -client sijaitsee. Integraatiotestissä ajetaan kaikki testitapaukset läpi kerran, kuormitustestissä ajetaan oikeamuotoista ja yhtä virheellistä sanomaa loopissa tietyn aikaa ja seurataan kuormaa ja suorituskykyä. Palveluiden kuormituksesta tai erityisestä suorituskykytestauksesta on sovittava etukäteen ottamalla yhteyttä Valviran kyselypalvelun toimittajaan. Lokitus otetaan mukaan testiin. Lokitukseen saadaan tieto, milloin sanoma lähtee kyselypalvelusta eteenpäin eli lokituksen avulla saadaan kartoitettua lähtevät paluusanomat sidosryhmälle. Lokituksesta saadaan myös tilastotietoa. Kaikista lokituksen erityistarpeista sovitaan ennen testauksen käynnistämistä. Tieto on osittain tuotannon kaltaista. Hylätyt sanomamallit ovat itse tuotettua aineistoa. 1.5 Testauksessa huomioitavaa Suunnittelu, kohteet ja aineisto - Luettelo ja kuvaus mitä testataan ja miten testataan, saadaan Jirasta - Suunnitellaan testijaksot (vaiheet), jotka ovat tietyssä järjestyksessä suoritettavia testitapausten settejä - Oikeamuotoinen testaussanoma, joka lähetetään, sovittava sidosryhmäkohtaisesti - Testauksessa suoritettavat testiskenaariot suunniteltava sidosryhmien edustajien kanssa (testitapausten alustava luettelo valmiina) sivu 5/18

- Kuvataan testien suorittamisessa tarvittava aineisto (osa asiakkaan tekemiä, osa toimittajan tekemiä) Testausympäristöt - Tarkistetaan testausympäristön toimivuus ja oikeudet etukäteen - Tilataan / varmistetaan, että sidosryhmien testausympäristöt ovat käytettävissä sovittuna aikana - Tilataan tarvittavat oikeudet välittömästi, jos aiempi tilaus todetaan vialliseksi - Tarkistetaan toimivuus etukäteen ennen varsinaisen testauksen suorittamista - Sovitaan tapa missä ja miten todetaan vastaussanoman oikeellisuus (puhelimella, sähköpostilla vai miten) - Tehdään yhteenveto testauksen valmistelusta, dokumentoidaan koska ja kuinka kauan ympäristö on käytettävissä (mm. yhteiskäyttöiset ympäristöt) jne. Varsinainen testaus - Tarkistetaan testaukseen toimitettu ohjelmisto (käynnistyykö oikea versio, jne (tarkistuslista käydään läpi) - Tarkistetaan ovatko testitapaukset ja testijaksot valmiit - Suoritetaan testijaksot sidosryhmäkohtaisesti (Jirasta luettelo, johon havainnot kirjataan ja viedään Jiraan toimittajan toimesta) - Testien suorituksen aikana tehdyt havainnot ja viat dokumentoidaan määritetyn prosessin mukaan: raportointi sähköpostilla (esim. yhteistestaussuunnitelman mukainen Excel-tiedosto ja/tai Jiraan) - Tarkistetaan hyväksymiskriteerien ja/tai keskeytyskriteerien täyttyminen Lopetus - Raportoidaan läpäisikö ohjelmisto testit hyväksytysti vai hylättiinkö se (pöytäkirja testaustilaisuudesta) - Tehdään yhteenveto dokumentoiduista havainnoista ja vioista sekä niiden mahdollisista vaikutuksista projektiin - Testauksen kulun raportti (dokumentti mahdollisista poikkeamista suunnitelmista sekä yhteenveto testien suorittamisesssa esiintyneistä ongelmista) - Testimateriaalin säilöntä (viimeistellään ja talletetaan tarvittavat materiaalit kuten automaatioskriptit, testiaineistot, testien tulokset testien toistamista tai myöhempää analysointia varten) sivu 6/18

1.6 Kyselypalvelun testausta koskeva prosessi Kuva 1: Palvelun testausprosessi Prosessi nojaa Kelan toimittamaan yhteistestaussuunnitelmaan. Määrittely- ja suunnitteludokumentteja ovat toimitetut sanomakuvaukset, WSDL-kuvaukset ja esimerkkisanomat. Testaussuunnitelmalla tarkoitetaan yhteistestaussuunnitelmaa (tai sisäisesti toimittajan omaa suunnitelmaa). 2 Testitapaukset attribuutti-rajoitustietosanomalle Toimittajat voivat käyttää listattuja testitapauksia testeissään. Testitapaukset luodaan xml-skeemojen pohjalta. Testitapaukset siirretään testauksen hallintavälineeseen. Testitapauksia tehdään hallintavälineeseen alkuvaiheessa vain yksi per käyttötapaus eli luodaan tilanne, joka kertoo, miten prosessi menee, jos kaikki menee hyvin. Myöhemmässä vaiheessa huomioidaan virheelliset sanomat ja muut poikkeukset tekemällä lisää testitapauksia. Virheraportoinnissa noudatetaan viitteen 1 toimintamallia. Eli ensimmäisessä vaiheessa testitapauksia on kolme kappaletta, yksi attribuutti-rajoituskyselyä varten, toinen rajoitustietojen noutoa varten ja kolmas ammattioikeuksien noutoa varten. Testitapausten oikeellisuus ja vasteajat todennetaan lokitusjärjestelmällä ja siitä saatavilla yhteenvetoraporteilla, joiden toimivuus varmistetaan lokituksen testitapauksilla, jotka ovat Jirassa. sivu 7/18

Testitapaukset on lueteltu alla olevassa taulukossa. Tapaus Kuvaus Odotettu lopputulos TC-TA1 TC-TA2 TC-TA3 TC-TA4 TC-TA5 TC-TA6 TC-TA7 TC-TA8 sivu 8/18 (00398706184) - henkilötunnuksella Virheetön rajoitustietolistan nouto Virheetön ammattioikeuslistan nouto (10098704835) Virheetön ammattioikeuskysely (70398700685) (00698701695) (10098703696) (03298701677) - henkilöllä ammattioikeuksia (1), tutkintoa(1), ei rajoituksia Asiakassovellus on noutanut skeeman mukaisen rajoitustietotiedoston Valviran Asiakassovellus on noutanut skeeman mukaisen ammattioikeustiedoston Valviran - henkilöllä ammattioikeuksia (1), ei tutkintoa, ei rajoituksia - henkilöllä ammattioikeuksia (1,lupatoimia), tutkinto (1) - henkilöllä ammattioikeuksia (1), tutkintotieto (1) -henkilöllä ammattioikeuksia (1), tutkintotietoja (2) - henkilöllä ammattioikeuksia (1), oikeudenmentys voimassa (ei loppupvm), tutkintotietoja (1)

TC-TA9 TC-TA10 TC-TA11 TC-TA12 TC-TA13 TC-TA14 (00198703761) (00198703621) (00198704330) (00198704702) (00598703288) (00198704025) - henkilöllä ammattioikeuksia (1), vanha oikeudenmenetys (loppupvm on, menetys tulee takautuvasti), rajoitus(1) - henkilöllä ammattioikeuksia (1), rajoitustietoja voimassa (loppupvm ei ole) tutkintotietoja (1) - henkilöllä ammattioikeuksia (1), rajoitustietoja voimassa (loppupvm on, rajoitus tulee takautuvasti ) tutkintotietoja (1) - henkilö kuollut, tietoja ei tule ( Rekisterinumeroa ei löydy! ) - henkilöllä ammattioikeuksia (1), tutkintotietoja (1) - henkilöllä ammattioikeuksia (1), rajoitus(3), tutkintotietoja (1) Testitapauksista on esimerkkisanomat liitteenä olevassa zip-tiedostossa. 3 Ensimmäisen vaiheen toimenpiteet 3.1 Yleistä ja tavoitteet Alkuvaiheen tavoitteena testauksen osalta on ollut tehdä: sivu 9/18

- Testauksen suunnittelu o Liittymien testausohjeen suunnittelu ja täydentäminen o Integraatio, - kuormitus, - ja suorituskykytestauksen vaatimusten tarkentaminen ja suunnittelu - Jiran käyttöönotto testauksen työvälineenä 1 - Liittymien testauksen työsuunnitelmat o Kertovat miten liittymät testataan - Vaiheen varsinaiset testaustoimenpiteet 3.2 Testauksen työsuunnitelma 3.2.1 Connectivity-testaus (yhteystestaus) Connectivity-testaus suoritetaan sidosryhmäympäristöstä esimerkiksi telnetkomennolla Kelan toimittamia ip-osoitteita vasten. Epäonnistuneesta testauksesta raportoidaan Kelalle yhteysavauksien ja palomuurisääntöjen tarkastamiseksi. Yhteysosoitteet ovat (t = testi) 91.202.114.18 t-attrib.valtteri.fi 91.202.114.19 t-lists.valtteri.fi 91.202.115.32 attrib.valtteri.fi 91.202.115.33 lists.valtteri.fi Yhteystesti tehdään SSL-porttiin 443. 3.2.2 Web service -palveluiden testaus, palveluosoitteet Palveluosoitteet: Testipalvelut: Ammattioikeudenrajoituslista: https://t-lists.valtteri.fi/ammattioikeusrajoituslista Ammattioikeuslista: https://t-lists.valtteri.fi/ammattioikeuslista Attribuutti-rajoitustietosanoma 1 Yhteistestaussuunnitelman mukaan voidaan käyttää Excel-taulukkoa sivu 10/18

https://t-attrib.valtteri.fi/ammattioikeus Tuotantopalvelut: Ammattioikeudenrajoituslista: https://lists.valtteri.fi/ammattioikeusrajoituslista Ammattioikeuslista: https://lists.valtteri.fi/ammattioikeuslista Attribuutti-rajoitustietosanoma https://attrib.valtteri.fi/ammattioikeus Toimintaohje testaukseen (A1) Toimittajat voivat soveltaa seuraavaa riippuen käyttämistään tuotteista ja sovelluksista: Kun sovelluskomponentti on valmis testattavaksi, ilmoitetaan sähköpostitse testausvastaaville valmiudesta aloittaa testausta. Kyselypalvelun komponentin palvelukuvaus (WSDL) ilmestyy UDDI:in viimeistään, kun palvelu on julkistettu. Tätä ennen toimitetaan alustava versio palvelukuvauksesta. https://t-attrib.valtteri.fi/ammattioikeus?wsdl https://t-attrib.valtteri.fi/ammattioikeus?schema %2FAmmattioikeus_COMMON%2FInterfaces %2FAmmattioikeusKysely https://t-attrib.valtteri.fi/ammattioikeus?schema %2FAmmattioikeus_COMMON%2FInterfaces %2FTEOCommon https://t-attrib.valtteri.fi/ammattioikeus?schema %2FAmmattioikeus_COMMON%2FInterfaces %2FAmmattioikeusVastaus (t-attrib.valtteri.fi on sijaittava luotettujen varmenteiden listassa) Joko WSDL:stä tai UDDI:sta otetaan talteen palvelun URL. sivu 11/18

Valitaan Altova XMLSpy:sta (tai vastaava Web service client, kuten SSL-testauksessa Jmeter) create new SOAP request ja annetaan siihen em. WSDL. Altova XMLSpy generoi esimerkkisanoman, jossa tietosisältö korvautuu String merkinnällä. Korvataan Altova XMLSpy:n esimerkkisanoman tieto asiakkaan tai toimittajan testiaineistolla, jolloin oletussanomasta tulee testisanoma. Valitaan Altova XMLSpy:sta send request to server. Palvelin vastaa Altova XMLSpy:lle sanomalla, joka on joko validi tai tulee virhesanoma. Sekä testisanoma, että vastaussanoma talletetaan testiaineistoksi uudelleenkäyttöä varten Jiraan (tai toimittajan omaan hallintavälineeseen). Koko tapahtuma lokittuu tietoineen lokiin. Tarkastetaan tieto lokista ja varmistetaan että kaikki lokituksen kentät on täytetty. Raportoidaan testauksesta viitteen 1 mukaan. Ammattioikeuden rajoituslistan tuottaminen ja nouto (A2) Vastauksena saatu ammattioikeudenrajoituslista sisältää luettelon niistä Terhikin rekisterinumeroista, joilla on jokin rajoitus voimassa listan luontihetkellä. Listalta voidaan tarkistaa rekisterinumeron avulla kohdistuuko henkilön ammattioikeuksiin jotain rajoituksia. Lisäksi listalla ovat niiden henkilöiden rekisterinumerot, joissa kuolinpvm > (luontiaika-90 vrk). Ammattioikeuslistan tuottaminen ja nouto (A3) Vastauksena saatu ammattioikeuslista sisältää luettelon Terhikin lääkäreistä ja hammaslääkäreistä (rekisterinumeroista), joilla ammattioikeus on voimassa ja jotka ovat elossa. Listat luodaan kerran vuorokaudessa. Noudon jälkeen molemmat osapuolet toteavat, onko listan sisältö validi ja raportoivat mahdollisista virheistä. Kutsun tekeminen tapauksissa A2-A3 sivu 12/18

Testataan kuten kohdassa A1, mutta client-toiminnallisuuden tulee toteuttaa http-kutsu Kelan ympäristöön ilman SOAP-kehystä. Kutsu tehdään toimitettavan url:n perusteella (liite 3). https://t-lists.valtteri.fi/ammattioikeuslista https://t-lists.valtteri.fi/ammattioikeusrajoituslista (t-lists.valtteri.fi on sijaittava luotettujen varmenteiden listassa) Autentikointi ja salaus Autentikointiin ja salaukseen käytetään SSL-varmenteita, jotka Valvira on varmentanut ja allekirjoittanut kullekin sidosryhmälle. Tavoitteena on Kelan SSL-purun onnistumisen varmistaminen. 4 Yhteistestauksen tavoitteet, malli ja raportointi 4.1 Tavoitteet Testauksen osalta tavoitteena on: - Testauksesta tiedottaminen ja testausajankohdista sopiminen - Testauksen hallinnasta sopiminen sidosryhmän kanssa - Testauksen osoitteiden, tunnusten ja palvelukuvausten viimeisten versioiden jakaminen - Varsinaisen testauksen suorittaminen sidosryhmän kanssa - Testauksesta raportoiminen ja korjausten tekeminen havaintojen perusteella 4.2 Testauksen toteutusmalli Toteutus tapahtuu siten, että testataan oikeilla sovelluksilla päästä päähän. Kukin organisaatio valmistautuu testaukseen järjestelmällä aikaa, välineet ja asiantuntijat paikalle valvomaan testauksen kulkua. Testauksen kulussa noudatetaan viitteen 1 mallia. 4.3 Testauksen päättämisen kriteerit Kyselypalvelun testauksen osalta kriteerejä ovat: - Tietoliikenneyhteydet kaikkien kolmen liitynnän osalta toimii (A1-A3) - Listat on saatu noudettua onnistuneesti https-protokollalla (A2-A3) - Attribuuttikysely-rajoitussanoma on saatu vastauksena kyselyyn (A1) - Sanomien sisältö vastaa tieto- ja skeemakuvauksissa esitettyä sisältöä 4.4 Virheet ja raportointi Virheiden, häiriöiden ja selvennystä vaativien tilanteiden hallinnassa noudatetaan viitteen 1 yhteistestaussuunnitelmaa ja siinä kerrottua menettelyä. sivu 13/18

Valviran palvelua koskevat ilmoitukset pyydetään kohdentamaan osoitteeseen varmennepalvelut@valvira.fi. Tietoliikenneyhteyksiin liittyvät asiat pyydetään kohdentamaan osoitteeseen tekninentuki@kanta.fi. sivu 14/18

5 Testauksen aloittamisen esimerkit 5.1 A1 attribuutti-rajoitustietosanoma Kyselysanoman alku HTTP-protokollan tasolla ennen salausta POST /AmmattiOikeus HTTP/1.0 Host: t-attrib.valtteri.fi:443 Content-Type: text/xml; charset=utf-8 Content-Length: 1598 SOAPAction: "https://t-attrib.valtteri.fi/amha/psammattioikeus" Kyselysanoma salaamattomana <SOAP-ENV:Envelope xmlns:soap- ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap- ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:m0="http://www.valvira.fi/amha/services/xsd/v1/types/common"> <SOAP-ENV:Body> <m:ammattioikeuskysely xmlns:m="http://www.valvira.fi/amha/services/xsd/v1/messages/ammatt ioikeuskysely"> <m:header> <m0:organisaatio>tieto</m0:organisaatio> <m0:jarjestelma>jmeter</m0:jarjestelma> <m0:lisatunniste>xxx.xxx.xxx.xxx</m0:lisatunniste> <m0:sanomatyyppi>string</m0:sanomatyyppi> <m0:sanomaversio>1.0</m0:sanomaversio> <m0:sanomatunnus>string</m0:sanomatunnus> <m0:sanomavastiketunnus>string</m0:sanomavastiketunnus> <m0:kyselyaika>2001-12-17t09:30:47.0z</m0:kyselyaika> </m:header> <m:request> <m:rekisterinumero>10098704835</m:rekisterinumero> </m:request> </m:ammattioikeuskysely> sivu 15/18

</SOAP-ENV:Body> </SOAP-ENV:Envelope> Vastaussanoma salaamattoma <?xml version="1.0" encoding="iso-8859-1"?> - <soapenv:envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> - <soapenv:body> - <amm:ammattioikeusvastaus xmlns:com="http://www.valvira.fi/amha/services/xsd/v1/types/common" xmlns:amm="http://www.valvira.fi/amha/services/xsd/v1/messages/ammattioikeu svastaus"> - <amm:header> <com:organisaatio>1.2.246.10.999999</com:organisaatio> <com:jarjestelma>jmeter</com:jarjestelma> <com:lisatunniste>win_xp</com:lisatunniste> <com:sanomatyyppi>valvira_terva</com:sanomatyyppi> <com:sanomaversio>1.0</com:sanomaversio> <com:sanomatunnus>tca9</com:sanomatunnus> <com:sanomavastiketunnus>1234</com:sanomavastiketunnus> <com:kyselyaika>2010-09-30t12:11:41z</com:kyselyaika> </amm:header> - <amm:response> <amm:vastausaika>2010-09-30t12:11:41z</amm:vastausaika> <amm:vastausstatus>1</amm:vastausstatus> - <amm:henkilotiedot> <amm:rekisterinumero>00198703761</amm:rekisterinumero> <amm:henkilotunnus>160355-xxxx</amm:henkilotunnus> <amm:sukunimi>testi</amm:sukunimi> <amm:etunimi>per Olof</amm:etunimi> </amm:henkilotiedot> - <amm:ammattioikeudet> <amm:ammattioikeuskoodi>001</amm:ammattioikeuskoodi> <amm:svnumero>999999</amm:svnumero> <amm:oikeudenalkupvm>1980-10-14t21:00:00z</amm:oikeudenalkupvm> - <amm:menetystiedot> <amm:oikeudenmenetysalkupvm>2003-12- 02T21:00:00Z</amm:oikeudenmenetysalkupvm> <amm:oikeudenmenetysloppupvm>2008-12- 03T20:59:59Z</amm:oikeudenmenetysloppupvm> </amm:menetystiedot> - <amm:rajoitustiedot> - <amm:rajoitusperuste> <amm:code>10</amm:code> <amm:codesystem>1.2.246.537.6.147.2008</amm:codesystem> </amm:rajoitusperuste> <amm:rajoitustieto>kielletään toistaiseksi määräämästä apteekeista pääasiassa keskushermostoon vaikuttavia lääkeaineita eli PKVlääkkeitä.</amm:rajoitustieto> <amm:rajoitusalkupvm>2002-03-12t21:00:00z</amm:rajoitusalkupvm> sivu 16/18

- <amm:laakeryhma> <amm:code>p</amm:code> <amm:codesystem>1.2.246.537.5.40118.2006</amm:codesystem> </amm:laakeryhma> </amm:rajoitustiedot> </amm:ammattioikeudet> </amm:response> </amm:ammattioikeusvastaus> </soapenv:body> </soapenv:envelope> 5.2 A2 ammattioikeuden rajoituslista Ei parametreja 5.3 A3 ammattioikeuden lista GET https://t-lists.valtteri.fi/ammattioikeusrajoituslista Ei parametreja GET https://t-lists.valtteri.fi/ammattioikeuslista 6 Viitteet 7 Liitteet Viite 1: Yhteistestaussuunnitelma, Kela, Luonnos, 20.1.2009 Viite 2: KanTa-palveluihin liittyminen, Kela, 20.1.2009 Liite 1: Valvira-Attribuutti-kyselypalvelu, tietosisältö Liite 2: Valvira- Attribuutti-kyselypalvelu, rajapintakuvaus Liite 3: Sanomakuvaukset WSDL- ja XSD-kuvaukset sekä esimerkkisanomat Sanomakuvaukset; WSDL-, XSD-kuvaukset sekä esimerkkisanomat ovat tiedostossa Valvira_attrib_schema.2009.09.30.zip sivu 17/18

8 Muutoshistoria Versio Päiväys Tekijä Tarkastaja Hyväksyjä Muutoshistoria V1.3 7.10.2010 Lisätty tarkemmat palveluosoitteet V1.3 7.10.2010 Esimerkkisanomat, liitteet, yhtenäistetty versionumero Liittyy ohjelmaversioon 1.3 V0.93 4.2.2009 Marko Karjunen V0.92 28.1.2009 Marko Karjunen V0.91 27.1.2009 Marko Karjunen V0.9 20.1.2009 Marko Karjunen V0.4 8.1.2009 Marko Karjunen V0.3 15.12.2008 Marko Karjunen V0.1 13.10.2008 Marko Karjunen Esimerkkisanomat, liitteet Valvira, Kela kommenttien muutokset Korjauksia Päivitetty vastaamaan yhteistestaussuunnitelmaa Muutoksia nimeämisiin Täydennetty ohjetta Liittymien testausohje (alustava, täydentyy suunnittelun edetessä) sivu 18/18