4. Testa i testmiljön

Bild: Testa i testmiljön

Visa större bilden

I det här avsnittet ges anvisningar om testning av tjänstens funktion i testmiljön. Detta avsnitt är avsedd för personer som ansvarar för organisationens tekniska anslutning till Informationsleden. Testningen utförs antingen av den som erbjuder de tekniska lösningarna eller av din egen organisation, beroende på om du har lagt ut anslutningsserverlösningen eller inte. Samma anvisningar fungerar också i produktionsmiljön.

Testa Informationsledens verksamhet i testmiljön innan du övergår till produktionsmiljön. Genom en noggrann testning säkerställer du att du har utfört alla faser i ibruktagningsprocessen på rätt sätt och att Informationsledens förbindelser fungerar utan problem. När testningen är klar och du har korrigerat eventuella fel under testningen kan du övergå till produktionsmiljön. Anvisningar för hur man ansluter sig till produktionsmiljön finns i följande skede.

Testa först anslutningsserverns förbindelse till Informationsleden och därefter meddelandekedjornas och meddelandeförmedlingens funktion.

1. Testa förbindelsen till Informationsleden med hjälp av testtjänsterna. För testning av SOAP-meddelandenas funktion finns enkla getRandom- och helloService-tjänster i Informationsleden. Testningen av REST-tjänsterna lyckas med öppna gränssnittstjänster i subsystemet för öppna data.
2. Testa att meddelandekedjan fungerar. Du kan testa meddelandekedjans funktion själv med två anslutningsservrar som har anslutits till testmiljön samt tillsammans med tjänstelevrantören.
3. Testa meddelandeförmedlingen med hjälp av metatjänster. Du kan anropa metatjänster av Informationsledens centralserver för att testa meddelandeförmedlingens funktion och anslutningsserverns funktionsduglighet.
4. Korrigera de eventuella fel som testningen visar innan du övergår till produktionsmiljön.

1. Testa förbindelsen till Informationsleden

Informationsleden har också några enkla test tjänster som kan användas för att kontrollera att SOAP- och REST-meddelanden fungerar i den egna anslutningsservern. Samma test tjänster fungerar både i utvecklings-, test- och produktionsmiljön.

Testning av SOAP-tjänster

Använd följande testtjänster för att testa SOAP-tjänster:

• getRandom: Returnerar ett slumpmässigt heltal 0–100 utan anropsparametrar. Se instruktionsvideon om testning av förbindelsen med tjänsten getRandom (YouTube video på finska, texting på svenska)Öppnas i ett nytt fönster..
• helloService: Innehåller en name-anropsparameter och returnerar som svar en hälsning till det angivna namnet.

Testet kan göras med RESTClient-gränssnitt eller Curl-kommandoradprogram.

Beskrivningar av SOAP-test tjänsternaÖppnas i ett nytt fönster. finns i API-katalogen.

Testning av REST-tjänster

Använd följande RestTest testtjänster för att testa REST-tjänster:

• Get rest-test/random: Returnerar ett slumpmässigt heltal 0–100 utan anropsparametrar.
• GET rest-test/hello: Innehåller en name-anropsparameter och returnerar som svar en hälsning till det angivna namnet.

Testet kan göras med RESTClient-gränssnitt eller Curl-kommandoradprogram.

Beskrivningar av REST-test tjänsternaÖppnas i ett nytt fönster. finns i API-katalogen.

2. Testa meddelandekedjans funktion

Testa också hela meddelandekedjans funktion så att du kan försäkra dig om att meddelandena går i båda riktningarna mellan den server som producerar tjänsten och den server som utnyttjar tjänsten utan problem. Du kan testa meddelandekedjans funktion på två olika sätt:

1. Testa meddelandekedjans funktion själv med två anslutningsservrar som har anslutits till testmiljön

• I det här fallet kan båda anslutningsservrarna vara din organisations anslutningsservrar.

2. Testa meddelandekedjans funktion med tjänsteleverantören

• Testiningen i det här fallet beror på tjänsteleverantörens villkor, så kom överens om testningen med tjänsteleverantören.
• I det här fallet är den andra anslutningsservern din organisations (anslutningsserver som utnyttjar tjänsten) och den andra anslutningsservern tjänsteleverantörens (anslutningsserver som erbjuder tjänsten).
• Tjänsteleverantören kan i allmänhet berätta när förbindelserna fungerar utan problem.

3. Testa meddelandeförmedlingen med hjälp av metatjänster

I alla anslutningsservrar finns några så kallade metatjänster inbyggda som du kan använda till exempel för att testa att anslutningsservern fungerar. Vem som helst kan anropa på Metatjänster, eftersom de inte beviljas separat tillstånd. Användningen av Metatjänster har dokumenterats i X-Road dokumentation (på engelska)Öppnas i ett nytt fönster.. I Serviceadministrationens stödartikel Metatjänster hittar du mer information om metatjänsterna och hur du anropar på dem.

Följande metatjänster finns på anslutningsservrarna:

• listClients: förteckning över organisationer som anslutits till Informationsleden (member) och organisationernas subsystem.
• listCentralServices: förteckning över centraltjänster som tillhandahålls av centralserverns anslutningsserver (central services).
• allowedMethods: förteckning över sådana tjänster som en viss organisation tillhandahåller och avsändaren av enkäten har användarrätt till.
• getWsdl: tjänsternas WSDL-gränssnittsbeskrivningar
• listMethods: förteckning över tjänster tillhandahållen av viss organisation. Normal X-Road SOAP-protokollrequest, anropet förmedlas till organisationens anslutningsserver. Lämpar sig väl för testning av kommunikationsförmedlingens funktion.

Alla anslutningsservrar har kontakt med centralserverns anslutningsserver. Du kan alltså anropa till exempel centralanslutningsserverns metatjänster när du vill testa om datakommunikationsförbindelserna fungerar. Belasta dock inte centralservrarna i onödan. Detta lämpar sig alltså inte för kontinuerlig automatisk övervakning, utan det måste skötas separat. Se anvisningarna för övervakning i avsnittet om underhåll.

4. Korrigera de eventuella fel som testningen visar

Anteckna de fel som observerats under testningen och korrigera dem före övergången till produktionsmiljön. När allt fungerar utan problem kan du övergå till produktionsmiljön.

Man ansluter sig till produktionsmiljön på samma sätt som till testmiljön. Läs mer om övergången till produktion i följande skede.

Fortsätt till nästa skede