Anvä ndärhändledning test Revisionshistorik Version Författare Kommentar 0.1 Eva Biberg Första version 0.2 Oscar Möller Ändringar efter genomläsning 0.3 Oscar Möller Flyttar översiktsbilder från LAT-hund Sida: 1 (16)
1 Introduktion Det här dokumentet är en vägledning hur tester kan genomföras för ett anslutningsprojekt, från varje led för sig till test av hela kedjan. 1.1 Referenser Referens R1 Dokument NKRR Användarhandbok https://service.projectplace.com/pp/pp.cgi/r1248223488 Sida: 2 (16)
2 Anslutning 2.1 Avtal Två övergripande avtal reglerar hantering av de personuppgifter som överförs från vårdgivarens system till kvalitetsregistret; Personuppgiftbiträdesavtal ska finnas skrivet mellan aktuellt kvalitetsregisters centrala personuppgiftsansvarig, CPUA, och driftsansvarig för NKRR vilket är registercentrum VGR, RC-VGR. Inera agerar underbiträde till RC-VGR avseende behandling av berörda personuppgifter på nationell tjänsteplattform. Varje vårdgivare skall därför ha ingått ett så kallat Modellavtal med Inera avseende just Ineras hantering av personuppgifter. 2.2 Beställning Projekt hittar vägledning på Ineras webb om Anslutning till tjänsteplattform. Vid behov kan hjälp och vägledning fås av en anslutningskoordinator hos Inera. För vårdgivare gäller att följande dokument ska skickas in och godkännas av Inera; [1] Förstudie allmänt om vårdgivarens användning av nationell tjänsteplattform [2] Blankett C avseende varje tjänstedomän som vårdgivaren producerar på nationell tjänsteplattform [3] Blankett D avseende samverkan mellan vårdgivare och NKRR [4] Blankett B avseende anrop till Inera Engagemangsindex [5] Blankett D avseende samverkan mellan vårdgivare och Inera Engagemangsindex Sida: 3 (16)
För aktuellt kvalitetsregister gäller att följande dokument skall skickas in och godkännas av Inera; [6] Förstudie allmänt om kvalitetsregistrets användning av nationell tjänsteplattform [7] Blankett B avseende anrop till NKRR GetFormData [8] Blankett D avseende samverkan mellan kvalitetsregistret och NKRR Sida: 4 (16)
3 Tester Nedanstående bild visar att tester kan göras i flera led 1. Enhetstester Innebär att skapa testdata och testa formulär. Ansvar för dessa tester ligger hos kvalitetsregistret och dess stödorganisation. 2. Integrationstest kvalitetsregister NKRR Test att kommunikation mellan kvalitetsregister och NKRR fungerar. Ansvar för dessa tester ligger hos kvalitetsregistret och dess stödorganisation med stöd av NKRR förvaltning. 3. Integrationstest NKRR vårdgivare Test att kommunikation mellan NKRR och vårdgivare fungerar. Vårdgivaren har ansvar för dessa tester med stöd av NKRR förvaltning. 3.1) Hämta all data 3.2) Använd aktuellt formulär 4. End-to-end tester Test av hela kedjan. Sida: 5 (16)
3.1 Enhetstester Enhetstester i NKRR bygger på att man utifrån de regler som har skapats för ett givet formulär lägger till testdata som reglerna kan testas mot. Testdata lagras på en testvårdgivare som är specifik för varje kvalitetsregister. Under fliken testdata kan man se HSA-id för den testvårdgivare som är kopplad till registret. Ansvar för dessa tester ligger hos kvalitetsregistret och dess stödorganisation. 3.1.1 Förberedelser För att kunna genomföra enhetstester behöver man skapa testdata. Detta innebär att lägga till testpatienter, skapa testdata, se bilder nedan samt NKRR Användarhandbok [R1]. Detta kan läggas till av samtliga användare som har skrivrättigheter till registret. Sida: 6 (16)
3.1.2 Genomför tester Tester kan sedan genomföras på två olika sätt, antingen via testresultat fliken i formulärhanteringen eller via Visa vyn. Detta kan utföras av användare som har läs- eller skrivrättighet till registret. 3.1.2.1 Enhetstester via förväntade resultat och testresultat fliken På fliken förväntade resultat kan man lägga till förväntade resultat för en given patient och careencounterstartdate Därefter kan testerna genomföras genom att köra testerna på Testresultatfliken vilket ger en rapport med resultatet i form av en jämförelse av förväntade svar och faktiska svar givet ett visst careencounterstartdate och det testdata som är lagrat för patienten. Sida: 7 (16)
Sida: 8 (16)
3.1.2.2 Enhetstester via Visa vyn Tester kan även genomföras genom att ange en testpatient, datum och ett formulär i Visa vyn samt välja testvårdgivaren för registret. Resultat kan då kontrolleras manuellt Sida: 9 (16)
3.2 Integrationstest kvalitetsregister - NKRR Test för att säkerställa att kommunikation mellan kvalitetsregister och NKRR fungerar genom att anropa GetFormData med den testvårdgivare som är kopplad till registret i NKRR och som innehåller testdata skapad för enhetstester. Vidare kan testet även användas för att kontrollera att förifyllnanden av formuläret fungerar. Under fliken testdata kan man se HSA-id för den testvårdgivare som är kopplad till registret. Ansvar för dessa tester ligger hos kvalitetsregistret och dess stödorganisation med stöd av NKRR förvaltning. 3.2.1 Förberedelser För att kunna genomföra testet behöver man skapa testdata. Detta innebär att lägga till testpatienter skapa testdata samt förväntade resultat (se bilder nedan samt NKRR Användarhandbok [R1]). Detta kan läggas till av samtliga användare som har skrivrättigheter till registret. Om enhetstester har skapats sedan tidigare kan de testdata som skapats för dessa återanvändas för integrationstester. Sida: 10 (16)
För att kunna genomföra tester av förifyllnad behöver kvalitetsregister ha implementerat stöd för förifyllnad som lagt in rätt konfiguration av endpoints och anropsparametrar. 3.2.2 Genomför tester Tester sker från registret. Testet genomförs med fördel genom att anropa GetFormData via tjänstplattformen, men det kräver att det finns en godkänd anslutning. Testet kan även göras genom att anropa motsvarande endpoint hos registercentrum VGR direkt. Endpoint via NTJP: https://qa.esb.ntjp.se:443/vp/followup/qualityregistry/nkrr/getformdata/getformdataservice/1/ri vtabp21 Endpoint direktanrop: https://qankrr.registercentrum.se/getformdata/getformdataservice/1/rivtabp21 Parametrar i anropet ska anges enligt nedan. Logisk adress HSA-id för NKRR-testvårdgivare. Anges under fliken testdata för aktuellt register. Om anrop sker via NTJP behöver HSA-id finnas i godkänd D-blankett. Observera att kvalitetsregistret använder olika logiska adresser beroende på om testdata ska hämtas från NKRR eller hos vårdgivare FormulärId (formid) Testpatient (subjectofcareid) Externt Id för aktuellt formulär (se bild nedan) NKRR-testpatienter för aktuellt formulär som skapats via administrationsgränssnittet. Anges under fliken testpatienter för aktuellt formulär. FormulärId hämtas genom att redigera det aktuella formuläret och klicka på Redigera formulärnamn. Externt Id motsvarar det id som ska anges som Formulärid i anropet. För ett genomföra tester av förifyllnad sker istället anropet från kvalitetsregistret formulärapplikation och kontroll görs att de förväntade resultatet förifylls i aktuellt formulär. Sida: 11 (16)
3.3 Integrationstest NKRR vårdgivare Test för att säkerställa att kommunikation mellan NKRR och vårdgivare fungerar genom att anropa aktuella JoL-tjänster. Vårdgivaren har ansvar för dessa tester med stöd av NKRR förvaltning. 3.3.1 Förberedelser För att kunna genomföra testet behöver det finnas en testpatient med testdata hos vårdgivaren. Vidare behöver vårdgivaren vara upplagd i NKRR. Konfigurering av vårdgivare görs av NKRRs förvaltning. 3.3.2 Genomför tester Tester genomförs genom att ange en testpatient, datum och ett formulär i Visa vyn samt den vårdgivare för vilken testdata ska hämtas. Test för att hämta all data kan göras av användare som har läsrättigheter till registret Producenttest. Test med aktuellt formulär kan göras av användare som har läsrättigheter till aktuellt register. 3.3.2.1 Integrationstest som hämtar all data Ange en testpatient som finns hos vårdgivare och ett formulär i registret Producenttest i Visa vyn samt den vårdgivare där data ska hämtas. HSA-id för den vårdgivare som anges används som en filterparameter i JoL-tjänsteanropet samt logisk adress hämtas från vårdgivarens konfiguration i NKRR. I de fall man vill söka ut exempelvis observationer för ett visst datum anges detta datum. I annat fall kan man låta dagens datum stå kvar. Sida: 12 (16)
Resultatet visas samt information om vilka adresser som har anropats och med vilken logisk adress. 3.3.2.2 Integrationstest med aktuellt formulär Ange en testpatient som har testdata kopplad till sig hos vårdgivaren. Ange därefter även datum och aktuellt formulär i Visa vyn samt den vårdgivare där data ska hämtas. HSA-id för den vårdgivare som anges används som en anropsparameter i JoL-tjänsteanropet och logisk adress hämtas från vårdgivarens konfiguration i NKRR. Sida: 13 (16)
Resultatet visas samt information om vilka adresser som har anropats och med vilken logisk adress. Sida: 14 (16)
3.4 End-to-end tester Test av hela kedjan från Kvalitetsregister via NKRR till vårdgivare 3.4.1 Förberedelser För att kunna genomföra testet behöver det finnas en testpatient med testdata hos vårdgivaren. Vidare behöver vårdgivaren vara upplagd i NKRR med kopplingar till aktuella JoL-tjänster samt logisk adress som ska anges i JoL-tjänsteanropet. Konfigurering av vårdgivare görs av NKRRs förvaltning. 3.4.2 Genomför tester Tester sker från registret. Testet görs med fördel genom att anropa GetFormData via tjänstplattformen men det kräver att det finns en godkänd anslutning. Testet kan även göras genom att anropa GetFormData direkt. Endpoint via NTJP: https://qa.esb.ntjp.se:443/vp/followup/qualityregistry/nkrr/getformdata/getformdataservice/1/ri vtabp21 Endpoint direktanrop: https://qankrr.registercentrum.se/getformdata/getformdataservice/1/rivtabp21 Parametrar i GetFormData-anropet ska anges enligt nedan. Den logisk adress som registret anger i GetFormData-anropet anges som en filterparameter i JoL-tjänsteanropet till vårdgivaren. Logisk adress HSA-id för aktuell vårdgivare. Om anrop sker via NTJP behöver HSA-id finnas i godkänd D-blankett. Observera att kvalitetsregistret använder olika logiska adresser beroende på om testdata ska hämtas från NKRR eller hos vårdgivare FormulärId (formid) Testpatient (subjectofcareid) Externt Id för aktuellt formulär (se beskrivning nedan) Testpatient som finns hos vårdgivare. Sida: 15 (16)
FormulärId hämtas genom att redigera det aktuella formuläret och klicka på Redigera formulärnamn. Externt Id motsvarar det id som ska anges som Formulärid i anropet. Testet kan även genomföras för att kontrollera korrekt förifyllnad av formuläret hos kvalitetsregister och då triggas istället anropet från själva registerapplikationen istället för GetFormData. Sida: 16 (16)