4. Testaa testiympäristössä

Kuva: Testaa testiympäristössä -vaihe

Näytä kuva suurempana

Tässä osiossa ohjeistetaan palvelun toiminnan testaus testiympäristössä. Osio on tarkoitettu henkilöille, jotka ovat vastuussa organisaation teknisestä liittämisestä Palveluväylään. Testaamisen suorittaa joko teknisten ratkaisujen tarjoaja tai oma organisaatiosi, riippuen siitä onko organisaatioisi ulkoistanut liityntäpalvelinratkaisun vai ei. Samat ohjeet toimivat myös tuotantoympäristössä.

Testaa Palveluväylän toimintaa testiympäristössä ennen kuin siirryt tuotantoympäristöön. Huolellisella testaamisella varmistat, että olet tehnyt kaikki käyttöönottoprosessin vaiheet oikein ja että Palveluväylän yhteydet toimivat ongelmitta. Kun testaus on valmis ja olet korjannut sen aikana mahdollisesti tapahtuneet virheet, aloita siirtyminen tuotantoympäristöön. Ohjeet tuotantoympäristöön liittymisestä löydät seuraavasta osiosta.

Testaa ensin liityntäpalvelimesi yhteys Palveluväylään ja sitten viestiketjujen sekä viestinvälityksen toimivuus.

1. Testaa yhteys Palveluväylään testipalvelujen avulla. SOAP-viestien toiminnan testausta varten Palveluväylältä löytyy yksinkertaiset getRandom- ja helloService-palvelut. REST-palvelujen testaaminen onnistuu avoindata-alijärjestelmän avoimilla rajapintapalveluilla.
2. Testaa viestiketjun toimivuus. Voit testata viestiketjun toimivuutta itsenäisesti kahdella testiympäristöön liitetyllä liityntäpalvelimella sekä yhdessä palveluntarjoajan kanssa.
3. Testaa viestinvälitystä metapalvelujen avulla. Voit kutsua Palveluväylän keskuspalvelimen metapalveluja testataksesi viestinvälityksen toiminnan ja liityntäpalvelimen toimintakunnon.
4. Korjaa kaikki mahdolliset virheet, joita esiintyi testaamisen aikana ennen kuin siirryt tuotantoympäristöön.

1. Testaa yhteys Palveluväylään

Palveluväylässä on myös muutamia yksinkertaisia testipalveluita, joiden avulla voit testata oman liityntäpalvelimesi SOAP- ja REST-viestien toimintaa. Samat testipalvelut toimivat sekä kehitys-, testi- että tuotantoympäristössä.

SOAP-palveluiden testaaminen

Käytä SOAP-palveluiden testaamiseen seuraavia testipalveluja:

• getRandom: Palauttaa satunnaisen kokonaisluvun 0–100, ei sisällä kutsuparametreja. Katso ohjevideo yhteyden testaamisesta getRandom-palvelulla (Youtube)Avautuu uuteen ikkunaan..
• helloService: Sisältää name-kutsuparametrin ja palauttaa vastauksena parametrin arvona annetulle nimelle kohdistetun tervehdyksen.

Testauksessa voi käyttää RESTClient-liitännäistä tai Curl-komentoriviohjelmaa.

SOAP-testipalveluiden rajapintakuvauksetAvautuu uuteen ikkunaan. löydät Liityntäkatalogista.

REST-palveluiden testaaminen

Käytä REST-palveluiden testaamiseen seuraavia rest-test testipalvelun rajapintoja:

• GET rest-test/random: Palauttaa satunnaisen kokonaisluvun 0–100, ei sisällä kutsuparametreja.
• GET rest-test/hello: Palauttaa vastauksena tervehdyksen, joka on kohdistettu “name” -query-parametrissa annetulle nimelle.

Testauksessa voi käyttää RESTClient-liitännäistä tai Curl-komentoriviohjelmaa.

REST-testipalveluiden rajapintakuvauksetAvautuu uuteen ikkunaan. löydät Liityntäkatalogista.

2. Testaa viestiketjun toimivuus

Testaa myös koko viestiketjun toimivuus, jotta voit varmistua siitä, että viestit kulkevat palvelua tarjoavan ja palvelua hyödyntävän palvelimen välillä kumpaankin suuntaan ongelmitta. Voit testata viestiketjun toimivuutta kahdella eri tavalla:

1. Testaa viestiketjun toimivuus itse kahdella testiympäristöön liitetyllä liityntäpalvelimella

• Tässä tapauksessa molemmat liityntäpalvelimet voivat olla oman organisaatiosi liityntäpalvelimia

2. Testaa viestiketjun toimivuus palveluntarjoajan kanssa

• Testaus tässä tapauksessa riippuu palveluntarjoajan ehdoista, joten sovi testauksesta erikseen palveluntarjoajan kanssa.
• Tässä tapauksessa toinen liityntäpalvelin on organisaatiosi oma (palvelua hyödyntävä liityntäpalvelin) ja toinen palveluntarjoajan omistama liityntäpalvelin (palvelua tarjoava liityntäpalvelin).
• Palveluntarjoaja osaa yleensä kertoa, kun yhteydet toimivat ongelmitta.

3. Testaa viestinvälitystä metapalvelujen avulla

Kaikissa liityntäpalvelimissa on sisäänrakennettuna muutamia niin sanottuja metapalveluja, joita voit käyttää esimerkiksi liityntäpalvelimen toimintakunnon testaamiseen. Metapalveluita voi kutsua kuka tahansa, sillä niitä ei luviteta erikseen.

Lisätietoja metapalvelujen käytöstä on kerrottu X-Roadin dokumentaatiossa (englanniksi)Avautuu uuteen ikkunaan..

Lue lisää metapalveluista ja niiden kutsumisesta.

Liityntäpalvelimilta löytyvät seuraavat metapalvelut:

• listClients: listaus Palveluväylään liitetyistä organisaatioista (member) ja organisaatioiden alijärjestelmistä (subsystem)
• listCentralServices: listaus keskuspalvelimen liityntäpalvelimen tarjoamista keskuspalveluista (central services)
• allowedMethods: listaus sellaisista tietyn organisaation tarjoamista palveluista, joihin kyselyn lähettäjällä on käyttöoikeus
• getWsdl: palvelujen WSDL-rajapintakuvaukset
• listMethods: listaus tietyn organisaation tarjoamista palveluista. Normaali X-Road SOAP-protokollakutsu, joka välitetään organisaation liityntäpalvelimelle. Sopii hyvin viestinvälityksen toimivuuden testaamiseen.

Kaikilla liityntäpalvelimilla on yhteys keskuspalvelimen liityntäpalvelimeen. Voit siis kutsua esimerkiksi keskusliityntäpalvelimen metapalveluja, kun haluat testata, toimivatko tietoliikenneyhteydet. Älä kuitenkaan kuormita keskuspalvelimia turhaan. Tämä ei siis sovellu jatkuvaan automaattiseen valvontaan, vaan se pitää hoitaa erikseen. Katso ohjeet valvontaan Tekninen ylläpito -osiosta.

4. Korjaa mahdolliset testauksessa havaitut virheet

Kirjaa testauksen aikana havaitut virheet ylös ja korjaa ne ennen tuotantoympäristöön siirtymistä. Kun kaikki toimii ongelmitta, voit siirtyä tuotantoympäristöön.

Tuotantoympäristöön liitytään samalla tavalla kuin testiympäristöön. Lue lisää tuotantoympäristöön siirtymisestä seuraavasta vaiheesta.

Siirry seuraavaan vaiheeseen