BRUKERVEILEDNING SAMSVARSTEST AV ELEKTRONISKE MELDINGER I NHN TESTSENTER DOKUMENTHISTORIKK DATO VERSJON BESKRIVELSE 13.04.2016 1.0
INNHOLD 1 Om samsvarstest i NHN... 3 2 Validere XML-filer... 4 3 Forberedelser til samsvarstest... 5 3.1 Avtale om testgjennomføring... 5 3.2 Opprette organisasjon i Samsvarstest... 5 3.3 Opprette bruker i Samsvarstest... 5 4 Gjennomføre samsvarstest... 6 4.1 Pålogging... 6 4.2 Velge type melding/test... 6 4.3 Velge kommunikasjonsdata... 7 4.4 Gjeldende kommunikasjonsdata... 8 4.5 Fylle ut skjema og laste opp vedlegg... 10 4.6 Sende testcase (melding)... 10 4.7 Motta testcase (melding)... 11 4.8 Sende inn skjema med vedlegg... 12 4.9 Kontroll og godkjenning av resultat... 12 4.10 Statusoversikter fra samsvarstest... 12 Veiledning samsvarstestveiledning samsvarstest side 2
1 OM SAMSVARSTEST I NHN Norsk Helsenett SF (NHN) skal gjennom sin test- og godkjenningsordning hjelpe systemleverandører med enhetlig bruk og korrekt implementering av standarder for elektronisk samhandling. Våre samsvarstester dekker krav til bruk av standarder ved elektronisk samhandling i Forskrift om IKT-standarder i helse- og omsorgstjenesten. Dette dokumentet beskriver hvordan man gjennomfører samsvarstest av elektroniske meldinger i Norsk Helsenetts testsenter. Ta kontakt med oss på e-post testsenter@nhn.no for å avtale gjennomføring av test. Testmateriell og testverktøy som benyttes i samsvarstesten er tilgjengelig på https://samsvar.testsenter.nhn.no/ XML-validering Vi har en web-side der man kan laste opp xml-filer for validering av meldingssyntaks i fagmelding (payload). Tjenesten er tilgjengelig for alle på internett. Resultat av valideringen presenteres kun for brukeren, og blir ikke lagret. Det forutsettes at man har kvalitetssikret xml-filene sine i valideringstjenesten før man setter i gang en samsvarstest med innsending av melding. Gjennomføring av samsvarstest (wizard) Her kreves det at organisasjonen er satt opp med autorisert bruker. I samsvarstesten skal man fylle ut et egenerklæringsskjema og sende dette inn til NHN sammen med dokumentasjon av funksjonalitet/skjermbilder. Testen innebærer også utveksling av ebxml testmeldinger mellom systemleverandørens fagsystem og NHN Testsenter. Innsendte meldinger og dokumentasjon gjennomgås av testkonsulent i NHN. Testmateriell til gjennomsyn Testmateriellet som benyttes i samsvarstestene er tilgjengelig for gjennomsyn fra en egen side som ikke krever pålogging. Man kan også se testcasene som benyttes for mottak av meldinger. Innholdet i noen av feltene vil overskrives når man kjører test. Det kan være greit å se gjennom testene på forhånd som en forberedelse til testgjennomføring. Veiledning samsvarstestveiledning samsvarstest side 3
2 VALIDERE XML-FILER NHN forutsetter at validering av fagmelding/payload skal være utført uten feil før man sender meldinger inn til samsvarstest i NHN. Valideringstjenesten er tilgjengelig på internett og kan benyttes av alle, uten at det må gjøres avtale på forhånd. Tjenesten sjekker følgende: Syntaktisk test mot XML schema Om obligatoriske elementer er med og har verdi Om ikke obligatoriske elementer som er tatt med, har verdi Kodeverdiene til de fleste mindre kodeverk, og også noen større. Der tilgang til kodeverk mangler oppgis dette. At datatyper som CV og CS er korrekt utfylt med riktige datafelt (V, DN, S, OT osv.) Avhengigheter mellom to eller flere element (f.eks. et manglende element påkrever et annet) Spesialtilpasninger av standarden (f.eks. valgfrie element som ikke skal være med) Velg xml-fil som skal lastes opp, angi meldingstype og trykk Run. Tjenesten gir umiddelbart tilbakemelding på resultatet av valideringen i samme skjermbilde. Tilbakemelding på feil oppgis med rød tekst, kommentarer kommer med blå tekst, og godkjent validering med sort tekst. Veiledning samsvarstestveiledning samsvarstest side 4
3 FORBEREDELSER TIL SAMSVARSTEST 3.1 AVTALE OM TESTGJENNOMFØRING Ta kontakt med NHN Testsenter for å gjøre avtale om gjennomføring av samsvarstest. Send mail til testsenter@nhn.no og beskriv hvilke meldinger som ønskes testet og når det kan være aktuelt å starte testen. Vi tar kontakt og avtaler en tidsplan for gjennomføringen. I det avtalte tidsrommet vil en av våre testkonsulenter bistå dere i testen og gjennomgå testresultatene. Testkonsulenten kan bistå underveis i testen pr. telefon eller chat, og gjerne også med bruk av skjermdeling (f.eks. TeamViewer eller Skype). 3.2 OPPRETTE ORGANISASJON I SAMSVARSTEST Nye kunder må opprette kommunikasjonspart og bruker i testverktøyet for samsvarstest (Wizard). Det forutsettes at man har gyldig virksomhetssertifikat (Buypass eller Commfides) for signering og kryptering av elektroniske meldinger. Samme virksomhetssertifikat kan brukes både i produksjon og test. Vi trenger følgende informasjon for å registrere organisasjonen som kommunikasjonspart: Organisasjonsnummer Organisasjonens navn E-postadressen som skal benyttes ved meldingsutveksling i samsvarstesten (tilsvarer EDI-adresse) Virksomhetssertifikat som skal benyttes for kommunikasjonsparten i testen Kontaktperson med telefonnummer og mailadresse Vi bruker Adresseregisteret i test på https://register.test.nhn.no/ som felles kilde til opplysninger om samhandlingsparter. Dersom kommunikasjonsdata som skal benyttes i samsvarstest allerede er registrert i test-ar, sender du oss riktig HER-id, så kan vi hente opplysninger og virksomhetssertifikat derfra. Ny profil og brukertilgang i test-ar opprettes av kundesenter@nhn.no, tlf 02017. Virksomhetssertifikatet for NHN Testsenter sin kommunikasjonspart i Samsvarstest kan lastes ned fra test-ar, HER-id 91393 (Norsk Helsenett SF Hovedkontor). 3.3 OPPRETTE BRUKER I SAMSVARSTEST For å gjennomføre test må man også ha en bruker for pålogging i Samsvarstest. Brukeren knyttes til organisasjonen og kommunikasjonsparten(e) som er registrert på denne organisasjonen. Slik oppretter du en bruker: 1. Gå til påloggingssiden; https://samsvar.testsenter.nhn.no/wizard/index.php 2. Klikk på "Ny bruker", fyll inn feltene og klikk på "Send". 3. Testsenteret sjekker oppgitt e-post for å vurdere tilknytning til oppgitt organisasjon før brukeren aktiveres. Testsenteret gir tilbakemelding når bruker er aktivert og kan benyttes. Veiledning samsvarstestveiledning samsvarstest side 5
4 GJENNOMFØRE SAMSVARSTEST 4.1 PÅLOGGING Gå til https://samsvar.test.nhn.no/ og velg Gjennomføring av samsvarstest (wizard). Logg inn med brukernavnet og passordet du selv valgte da du opprettet brukeren. Hvis du har glemt passordet kan du trykke på Nullstill passord. Da får du tilsendt e-post med lenke til en side der du kan opprette et nytt passord. 4.2 VELGE TYPE MELDING/TEST Etter pålogging kommer du først til en startside. Velg Ny/påbegynt erklæring. På neste side kan du starte en ny test/egenerklæring, eller du kan fortsette å jobbe med en test du har opprettet tidligere. Alle tester som er påstartet/opprettet blir liggende i en liste på denne siden. Velg først hvilken test som skal gjennomføres i nedtrekksmenyen under Meldingsrolle. Klikk deretter på Start ny. Velg Endre/fortsett for å fortsette en påstartet test. Veiledning samsvarstestveiledning samsvarstest side 6
Opprettede tester vil bli merket med (Merknad) dersom NHN har gjort endringer i testmateriellet etter at du startet testen. Du kan fortsette å jobbe i den gamle versjonen, men for å få siste versjon av testmateriellet må du opprette en ny erklæring. Ta gjerne kontakt med oss for å avklare hva som er endret og om det er nødvendig å oppdatere til en ny versjon. 4.3 VELGE KOMMUNIKASJONSDATA Neste steg er å angi hvilket system som skal testes, og hvilke kommunikasjonsparametre som skal benyttes i meldingsutvekslingen. Adresse er forhåndsregistrert av oss og må velges fra nedtrekkslisten. De andre parametrene kan defineres etter behov. Data som defineres her blir tilgjengelig i alle tester knyttet til din organisasjon. Merk at de to nederste parametrene (kopimottaker og testpasient) kun er relevant når man skal motta testmeldinger. System: Oppgi navn på fagsystemet og kommunikasjonsmodul som skal testes. Versjonsnummeret oppgis ikke før man kommer til innsending av egenerklæringsskjemaet. EDI-adresse: Navn, HER-id og adresse som er forhåndsregistrert av NHN. Dersom man vil bruke andre adresser, må det sendes beskjed om dette til testsenter. Det er mulig å ha flere adresser pr. organisasjon/bruker. Tjeneste: Oppgi navn og HER-id for part (på nivå 2) som skal være adressat i mottakstester. Velg person (testlege) for primærhelsetjenesten, eller tjeneste for kommune- og spesialisthelsetjenesten. Kopi til: Oppgi navn og HER-id for kopimottaker som skal være adressat i mottakstest. Dette er kun relevant ved test av mottak. Pasient: Oppgi testpasient som er registrert i fagsystemet og som skal benyttes ved mottakstest. For å teste pasienthåndtering blir det i tillegg sendt noen testmeldinger med andre pasienter. Hvilke pasienter som benyttes under testen finner du i oversikten over gjeldende kommunikasjonsdata ("Steg 2. Kontroller"). Veiledning samsvarstestveiledning samsvarstest side 7
4.4 GJELDENDE KOMMUNIKASJONSDATA Gå til steg 2. Kontroller. Her presenteres først kommunikasjonsdata for samhandlingspart i NHN Testsenter. Vi har to ulike adresser avhengig av om det skal adresseres til/fra lege eller tjeneste. Hvilken som benyttes avhenger av meldingstype/testcase. For begge alternativene er adressen til Samsvarstest: samsvar@samsvar.test.nhn.no Adressering til tjeneste i NHN: HER-id nivå 1: 91393 HER-id nivå 2: 93950 Adressering til lege i NHN: HER-id nivå 1: 93951 HER-id nivå 2: 93952 Lenger ned i skjermbildet presenteres kommunikasjonsdataene du har valgt for din kommunikasjonspart. Sjekk at informasjonen stemmer. Tomme felt tyder på at man ikke har valgt noe i steg 1. Veiledning samsvarstestveiledning samsvarstest side 8
Nederst i skjermbildet presenteres en oversikt over testpasienter som benyttes i mottakstestene. Øverst i listen står pasienten du selv valgte i steg 1. Denne pasienten benyttes i de fleste testcasene. Pasientene som står oppført nedenfor benyttes til ulike testcase som omhandler kontroll av pasienthåndtering. De skal registreres i systemet med tilhørende identifikasjonsdata. Pasienten til høyre skal ikke være registrert i systemet. Den brukes til å teste håndtering av ukjent pasient. Veiledning samsvarstestveiledning samsvarstest side 9
4.5 FYLLE UT SKJEMA OG LASTE OPP VEDLEGG Under 3. Erklær finner du samsvarserklæringen og testcasene. Øverst i skjermbildet ligger en referanseliste med lenker til standarder som utgjør grunnlaget for testen. Sett en hake på hvert krav for å bekrefte at kravet er oppfylt. Forklaringer og nærmere beskrivelser registreres i kommentarfeltet under hvert krav. I kommentarfeltet kan man også legge inn referanser til f.eks. MeldingsID eller navn på vedlegg. Alternativt kan mer omfattende kommentarer legges sammen med skjermbildeutskrifter i et eget dokument og lastes opp som vedlegg. Merk dem i så fall med hvilket krav de tilhører. Vær oppmerksom på at lagring skjer automatisk når du klikker utenfor feltet du har skrevet i. Du kan gå inn og ut av skjemaet uten å tenke på lagring underveis. Under noen av punktene i skjemaet ligger lenke til testcase som benyttes ved utveksling av elektroniske testmeldinger. Sending og mottak av testcasene er nærmere beskrevet nedenfor. I flere av kravene ber vi om dokumentasjon av skjermbilder som viser funksjonalitet i systemet som testes. Dokumentasjon av skjermbilder og andre aktuelle filer kan lastes opp ved å klikke på knappen Legg til vedlegg øverst til høyre i skjermbildet. For at det skal være enkelt for oss å finne fram i vedleggene ber vi om at kravnummeret inngår i filnavnet. For eksempel, hvis man dokumenterer krav 2-18 med tre skjermbilder, ønsker vi at følgende navngiving benyttes som et minimum: 2-18_1 2-18_2 2-18_3 Dersom alle skjermbilder samles i ett dokument, velger man filnavn selv. 4.6 SENDE TESTCASE (MELDING) Sende-tester inneholder ett eller flere testcase som skal opprettes i eget fagsystem og sendes til NHN Samsvar. Når du klikker på lenken for visning av case vil innholdet i testmeldingen bli presentert, og du skal registrere tilsvarende melding i eget system. Ved innsending skal NHN Samsvar returnere applikasjonskvittering til innsender. Eksempel på testbeskrivelse når melding skal sendes inn: I forbindelse med meldingsutvekslingen skal man også dokumentere funksjonalitet i systemet. Dette omfatter: Kopi av skjermbilder som viser hvordan man legger inn informasjon i en melding før sending Dokumentasjon av hvordan systemet ser ut når man mottar en forespørsel som skal trigge en bestemt type melding. Dokumentasjon av at den riktige meldingstypen kommer opp som standard svarmelding. Veiledning samsvarstestveiledning samsvarstest side 10
I noen sendetester skal man teste et forløp som består av flere meldinger. Man bestiller først en melding fra tjenesten og returnerer applikasjonskvittering til NHN Samsvar. Den mottatte meldingen skal trigge sending av melding. Et eksempel på dette for et kommunesystem er når man mottar en forespørsel om opplysninger om den helsemessige tilstanden til pasienten (tilstandsvurdering). En slik forespørsel skal medføre at meldingstypen Helseopplysninger til lege kommer opp som standard svarmelding i systemet. Tilsvarende eksempel for et allmennlegesystem er når man mottar en forespørsel om opplysninger om helseopplysninger. En slik forespørsel skal medføre at meldingstypen Medisinske opplysninger kommer opp som standard svarmelding i systemet. 4.7 MOTTA TESTCASE (MELDING) I mottakstester trykker man på Bestill-knappen ved hvert testcase for å få det aktuelle testcaset tilsendt. Melding sendes da med kommunikasjonsparametre som ble oppgitt i steg 1. Ved mottak av testcase må man returnere applikasjonskvittering til NHN Samsvar. Eksempel på testbeskrivelse der mottak av melding skal bestilles: En oversikt over bestilte meldinger og deres UUID vises øverst i skjermbildet: I forbindelse med meldingsutvekslingen skal man også dokumentere funksjonalitet i systemet. Dette omfatter dokumentasjon av at: Mottatte meldinger kan hentes frem og vises i xml-format Mottatte meldinger kan åpnes i visningsformat (eget og/eller standardisert) Merking av endring/kansellering er tydelig inne i systemet, både for endrings-/kanselleringsmeldingen og foregående melding(er) Meldinger som gir negativ applikasjonskvittering blir logget utenfor systemet Meldinger som krever manuell oppfølging blir flagget på en hensiktsmessig måte inne i systemet Veiledning samsvarstestveiledning samsvarstest side 11
4.8 SENDE INN SKJEMA MED VEDLEGG I siste steg oppgis versjon av fagsystem og kommunikasjonsmodul. Velg Neste for å sende inn skjema og vedlegg. NHN Testsenter vil manuelt returnere en mail der vi bekrefter at vi har mottatt dokumentasjon fra testen. Dersom det blir behov for å sende tilleggsinformasjon eller mer dokumentasjon kan det gjøres med mail til testsenter@nhn.no. 4.9 KONTROLL OG GODKJENNING AV RESULTAT Norsk Helsenetts testkonsulent gjennomgår alt mottatt materiell, inkludert testfiler og applikasjonskvitteringer. Filene kjøres gjennom valideringstjenesten og en manuell gjennomgang fanger opp det som ikke ble tatt i den automatiske testen. Bekreftelse på godkjent resultat sendes pr. epost. Dersom det avdekkes feil og mangler i mottatt testmateriell, vil du få beskrivelse av avvikene slik at feil kan rettes. Test gjentas inntil det er verifisert at mottatt testmateriell er uten feil og mangler. Dersom Norsk Helsenett er i tvil om resultatet er i henhold til standard, skal Direktoratet for e-helse være avgjørende myndighet. Vi må i så fall innhente en avklaring fra Direktoratet før vi kan konkludere. Mottatt testmateriell og dokumentasjon fra testen skal lagres hos Norsk Helsenett slik at det er tilgjengelig så lenge de aktuelle meldingene er i bruk. 4.10 STATUSOVERSIKTER FRA SAMSVARSTEST Norsk Helsenett skal holde oversikt over status for samsvarstest av meldinger for de ulike systemene. Det innbefatter også oversikt over hvilken versjon av systemet/system-modulene som er testet. En statusoversikt som viser testresultatene ligger på nettsidene våre, nhn.no. Oversikt for det aktuelle fagsystemet oppdateres når en test er avsluttet og godkjent. Veiledning samsvarstestveiledning samsvarstest side 12