BRUKERVEILEDNING MELDINGSVALIDATOR TEST OG GODKJENNING SAMSVARSTEST AV ELEKTRONISKE MELDINGER I NORSK HELSENETTS TESTSENTER DOKUMENTHISTORIKK

Transkript

1 BRUKERVEILEDNING MELDINGSVALIDATOR TEST OG GODKJENNING SAMSVARSTEST AV ELEKTRONISKE MELDINGER I NORSK HELSENETTS TESTSENTER DOKUMENTHISTORIKK DATO VERSJON BESKRIVELSE Klar til publisering

2 INNHOLD 1 Ordforklaringer Om samsvarstest i Norsk Helsenett Godkjenninger Validering (deler av tjenesten krever innlogging) Samsvarstest (krever innlogging) Teknisk arkiv Innlogging Validering Status Validerte meldinger XML-validering Samsvarstest Kommunikasjonspart hos NHN for test og godkjenning Legg til nytt system Ny samsvarstest Oppsett av samsvarstest Manuell test Manuell input Restart eller Avbryt test-case Innsending av Manuell test for godkjenning Automatisk test Godkjenninger Oversikt over godkjenninger Sammenligning av EPJ systemer med meldingstjener Detaljert oversikt pr EPJ leverandør Veiledning samsvarstest side 2

3 1 ORDFORKLARINGER Meldingsvalidator Multifunksjonelt verktøy for validering av meldinger opp mot standarder for elektronisk samhandling. Flere instanser er gjort tilgjengelige for bruk både på Helsenett og Internett (se under). Meldingsvalidator Statistikk Instans av Meldingsvalidatoren som er tilgjengelig på Helsenett og kan nås via Den viser statistikk og rapporter over avvik i konvolutten i den daglige meldingstrafikken på Helsenett. Tilbyr også fullvalidering (se under). Krever innlogging for å se detaljer for egen virksomhet. Meldingsvalidator Test og godkjenning Instans av Meldingsvalidatoren som er tilgjengelig på Internett og kan nås via Den tilbyr samsvarstest (se under), fullvalidering (se under), samt visning av godkjente kombinasjoner av EPJ-system/meldingstjener pr. meldingsprofil. Enkelte av funksjonene krever innlogging. Samsvarstest En test og godkjenning av EPJ-system mht. sending eller mottak av en gitt versjon av en meldingsstandard. Samsvarstester skal hjelpe systemleverandører med enhetlig bruk og korrekt implementering av standarder for elektronisk samhandling. Samsvarstest er en funksjon i Meldingsvalidator Test og godkjenning. Fullvalidering En funksjon i Meldingsvalidator på både Helsenett og Internett, hvor man kan sende elektroniske meldinger til - eller motta elektroniske meldinger fra Meldingsvalidator. Meldingene valideres både på konvolutt- og fagmeldingsnivå, samt koblinger og sammenheng mellom de to nivåene. Validerer også tilhørende samtale (se under). Samtale Et sett av elektroniske meldinger med originalmelding med eventuelle kopier og med tilhørende transport- og applikasjonskvitteringer. Sarepta Teknisk arkiv for standarder. Sarepta inneholder dokumentasjon knyttet til sentrale nasjonale e-helsestandarder. Dette omfatter teknisk dokumentasjon av standardene som kravdokumenter, informasjonsmodeller, XML-meldingsbeskrivelser, XML-schema, eksempelfiler, visningsfiler m.m. Veiledning samsvarstest side 3

4 2 OM SAMSVARSTEST I NORSK HELSENETT Norsk Helsenett SF (heretter kalt 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. Kravene er blant annet beskrevet i Forskrift om IKT-standarder i helse- og omsorgstjenesten. Dette dokumentet beskriver hvordan samsvarstest av elektroniske meldinger i NHNs testsenter gjennomføres. Ta kontakt med oss på e-post testsenter@nhn.no om dere har spørsmål. Testmateriell og testverktøy som benyttes i samsvarstesten er tilgjengelig på også kalt Meldingsvalidator Test og godkjenning (heretter kalt MV-Togg). MV-Togg er delt inn i Godkjenninger, Validering, Samsvarstest og link til Teknisk arkiv. Dette er nærmere beskrevet i påfølgende kapitler. 2.1 Godkjenninger Under Godkjenninger gis en offentlig oversikt over leverandørsystemer som har gjennomgått samsvarstesting og hvilke meldingstyper de er godkjent for. Kun godkjente samsvarstester publiseres; påbegynte eller underkjente samsvarstester vises ikke i oversikten. Se også kapittel Validering (deler av tjenesten krever innlogging) Under Validering kan dere selv kontrollere at ebxml-konvolutter, fagmeldinger og kvitteringer dere sender er i henhold til standarder for meldingsutveksling i helsesektoren. Det forutsettes at dere har kvalitetssikret sending, mottak og innhold av meldingene deres under Validering før dere setter i gang med Samsvarstest. Se også kapittel 4. Veiledning samsvarstest side 4

5 2.3 Samsvarstest (krever innlogging) Under Samsvarstest blir deres system grundig testet for å se om det er i samsvar med anbefalte standarder for meldingsutveksling i helsesektoren. En samsvarstest innebærer sending eller mottak av en hel rekke testmeldinger som er designet for å kontrollere ulike aspekter i meldingsutvekslingen. Dette er aspekter som endring og kansellering, ulike pasientscenario, adressering, duplikathåndtering mv. Samsvarstester inneholder mange automatiske steg, men også enkelte manuelle steg hvor det kreves en opplastning av ytterligere dokumentasjon. Slik dokumentasjon vil gjennomgås av en testkonsulent i NHN. Ved start av en samsvarstest kan dere velge å hoppe over alle de manuelle stegene ved å huke av en egenerklæring for at manuelle steg etterleves. Dette kalles da en automatisk samsvarstest. En automatisk samsvarstest blir ikke gjennomgått av testkonsulent, men NHN kan ta kontakt på et senere tidspunkt for å verifisere etterlevelse av manuelle steg. En automatisk samsvarstest godkjennes automatisk når feilfri og publiseres på godkjenningssiden hvis ikke annet er bedt om. Godkjenningssiden skiller mellom automatiske og manuelle samsvarstester. Se også kapittel Teknisk arkiv Dette er en lenke til teknisk arkiv for standarder på ehelse.no også kalt Sarepta. Sarepta inneholder dokumentasjon knyttet til sentrale nasjonale e-helsestandarder. Dette omfatter teknisk dokumentasjon av standardene som kravdokumenter, informasjonsmodeller, XML-meldingsbeskrivelser, XML-schema, eksempelfiler, visningsfiler m.m. Informasjon om standardene og tilhørende filer blir kontinuerlig oppdatert, slik at den til enhver tid gjeldende versjon av hver enkelt fil kan finnes her. Veiledning samsvarstest side 5

6 3 INNLOGGING For å bruke Meldingsvalidator Test og godkjenning må du: 1. Registrere virksomheten hos Norsk Helsenett i Test Adresseregisteret, TestAR. 2. Ha en tilknyttet bruker i TestAR. Kontakt din IT-ansvarlige dersom du ikke vet påloggingsinformasjonen for din virksomhet eller ta kontakt med Kundesenter hos Norsk Helsenett. 3. Kontakt kundesenter hos Norsk Helsenett for å få knyttet brukeren i TestAR til Meldingsvalidator test og godkjenning, samt virksomheten du skal ha tilgang til. Husk å gi informasjon om brukernavn, virksomhet og formål med registrering. Som EPJ leverandør vil du tildeles rollen "Meldingsvalidator Samsvar Leverandør". 4. Logg deg på Meldingsvalidator med samme pålogging som for TestAR. Har du problemer med pålogging? Kontakt din IT-ansvarlige eller be om bistand fra kundesenter hos Norsk Helsenett kundesenter@nhn.no Med kan dere nå TestAR fra internett for videre registrering. Med kan dere nå TestAR fra helsenettet for videre registrering. MV-Togg vil sjekke mot TestAR og gi dere tilgang til tjenester tilsvarende de rettigheter brukeren deres har. Kommunikasjonsparten ved Samsvarstesting er Meldingsvalidering med HER-ID Dere må registrere denne partneren i deres system for utveksling av data under Norsk Helsenett SF Hovedkontor Veiledning samsvarstest side 6

7 4 VALIDERING Det forutsettes at dere har kvalitetssikret sending, mottak og innhold av meldingene deres under Validering før dere setter i gang med Samsvarstest. Valideringstjenesten er tilgjengelig på Internett og kan benyttes av innlogget bruker. 4.1 STATUS Denne siden krever innlogging. Siden samler resultatet av siste fullvalidering for alle kommunikasjonsparter i det valgte filteret, presentert per meldingstype. Kun deres egne virksomheter og kommunikasjonsparter kan bli valgt i filteret. For å få en grønn andel for en meldingstype må en full samtale bli validert korrekt. Validering av sending inkluderer en fagmelding fra kommunikasjonsparten, transportkvittering og applikasjonskvittering som svar fra MV-Togg og en transportkvittering fra kommunikasjonsparten tilbake til MV-Togg. Validering av mottak inkluderer en fagmelding fra MV-Togg, transportkvittering og applikasjonskvittering fra kommunikasjonsparten og en transportkvittering tilbake fra MV- Togg. Hvis dere begrenser filteret til én kommunikasjonspart vil dere finne detaljer om fullvalideringer gjort til og fra denne kommunikasjonsparten. Veiledning samsvarstest side 7

8 4.2 VALIDERTE MELDINGER Denne siden krever innlogging. På denne siden kan dere selv kontrollere at ebxmlmeldinger og fagmeldinger dere sender er i henhold til standarder for meldingsutveksling i helsesektoren. Egne meldinger som dere sender til Meldingsvalidering (HER-Id på internett og på helsenett) for validering vil lagres her, og dere kan se detaljer rundt resultatene. Dere kan bare se meldinger fra deres egne kommunikasjonsparter. Dere kan også motta meldinger FRA Meldingsvalidator som følger standarden ved å sende en melding herfra til en av deres kommunikasjonsparter: Velg først hvilken meldingstype dere ønsker å motta, og med hvilken testpasient. Pasientene velges fra en liste med forhåndsdefinerte pasienter. Oppgi deretter hvilken kommunikasjonspart som skal være hovedmottaker av meldingen. Etter oppgitt hovedmottaker kan flere mottakere legges til som kopimottakere. Trykk deretter 'Send', og mottakerne vil motta en melding som er i henhold til standard. Om dere ønsker å motta en egenspesifisert melding, kan dere trykke 'Velg fil' og laste opp en XML-fil som deretter pakkes inn i ebxml-konvolutt og sendes ut når man trykker 'Send'. Det vil også kontrolleres for at det kommer korrekte kvitteringer i retur til MV-Togg. Kvitteringer lagres sammen med fagmeldinger så lenge referansene dem imellom er korrekte. Detaljer for validerte meldinger er lik i både Fullvalidering og i Samsvarstesting. Veiledning samsvarstest side 8

9 4.3 XML-VALIDERING Hvis dere ønsker å validere kun fagmelding uten bruk av konvolutt og ebxml innpakking, kan dere benytte tjenesten XML-validering. Velg XML-fil (med eller uten ebxml-konvolutt) som skal lastes opp, trykk 'Valider'. 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) Tjenesten gir umiddelbart tilbakemelding på resultatet av valideringen i samme skjermbilde. Vil dere se hele resultatet, trykk 'Se fullstendig valideringsresultater'. Her vil tilbakemelding på feil bli oppgitt med rød tekst, kommentarer med blå tekst, og godkjent validering med sort tekst. Om det er funnet avvik i meldingens innhold eller i forhold til skjema vil dette angis med rød sirkel på fanene. Det gis også fyldig feilmelding med henvisning til linjenummer i meldingen hvor avviket er registrert. Resultatene av XML-valideringen blir ikke lagret. Veiledning samsvarstest side 9

10 Veiledning samsvarstest side 10

11 5 SAMSVARSTEST Det forutsettes at dere har kvalitetssikret sending, mottak og innhold av meldingene deres under Validering før man setter i gang med Samsvarstest. Alle steg i samsvarstest valideres på samme måte som for Fullvalidering av både konvolutt, fagmelding og kryssvalidering. Før dere kan ta i bruk Samsvarstest-tjenesten må dere være innlogget. Følg instruksjonene i kapittel Innlogging for detaljer. Trykk så på 'Samsvarstest' og deretter 'Mine samsvarstester'. Siden dere da kommer til gir en oversikt over hvilke system dere har registrert og hvilke samsvarstester dere har utført eller er pågående. Nye brukere må først registrere sitt system med EPJ system og Meldingstjener med riktig versjon. Det er denne beskrivelsen som vil bli synliggjort på offentlige sider for godkjenning. 5.1 KOMMUNIKASJONSPART HOS NHN FOR TEST OG GODKJENNING. Kommunikasjonsparten Meldingsvalidering med HER-ID brukes i test og godkjenning, og dere må registrere denne partneren i deres system for utveksling av data under Norsk Helsenett SF Hovedkontor Veiledning samsvarstest side 11

12 5.2 LEGG TIL NYTT SYSTEM For å registrere systemet deres, trykk 'Legg til nytt system'. Oppgi systemnavn og hvilken sektor av helse- og omsorgstjenesten systemet deres dekker. Dere kan velge flere sektorer. Godkjenningssiden kan sorteres etter sektor, så vær sikker på at dere velger alle aktuelle sektorer. Last også opp en logo om dere ønsker. Trykk 'OK' og deres system vil komme opp på oversiktssiden. Oppsett av kombinasjon med Meldingstjener utføres i neste steg. 5.3 NY SAMSVARSTEST Trykk på systemet dere ønsker å utføre samsvarstest på i oversikten. Siden dere da kommer til gir en oversikt over alle godkjenninger som er gitt for det valgte systemet. For å starte en ny godkjenning trykk 'Ny godkjenning'. Veiledning samsvarstest side 12

13 Velg så om dere ønsker å teste meldingsmottak eller sending av melding. Velg så meldingstypen i nedtrekkslisten over tilgjengelige tester. Trykk 'OK' for å starte testen. Dere kan filtrere oversikten på systemversjon og meldingstjener. Trykk på dato i oversikten for å se testdetaljer. 5.4 OPPSETT AV SAMSVARSTEST En samsvarstest går over flere sider. Sporangivelsen på siden viser hvilken side dere står på, og er også klikkbar slik at dere kan hoppe til ønsket side. Dere kan også navigere vha. sidenavigering for å se detaljer for hver side i den komplette testen. På første side av en samsvarstest må dere konfigurere Oppsett og oppgi informasjon om systemet som skal testes. Oppgi først hvilken systemversjon av systemet som skal testes. Dersom systemversjonen allerede er benyttet til samsvarstesting så ligger den i nedtrekksmenyen. Hvis ikke, velg 'Ny versjon' og skriv inn versjonen. Oppgi deretter hvilken meldingstjener som skal benyttes og versjon av denne. Velg 'Ny meldingstjener' i menyen om den som skal benyttes ikke listes opp. Likeså for meldingstjenerversjon. Veiledning samsvarstest side 13

14 Velg så hvilken kommunikasjonspart som skal være hovedmottaker i samsvarstestingen. Dere kan velge blant kommunikasjonspartene som er registrert i Test-AR under virksomheten dere tilhører og vil være HER-ID til løsningen dere ønsker å teste. Hvis testen har lagt opp til bruk av kopimottaker, må dere også oppgi kommunikasjonspart fra deres egen virksomhet som skal være kopimottaker i testen. I gitte tilfeller vil det sendes testcase til KUN kopimottaker, så denne tjenesten vil bli en del av testgjennomføringen. Hvis dere mangler kommunikasjonspart for testen må dere opprette ny(e) kommunikasjonspart(er) i Test-AR. Først når alle disse felter er utfylt, vil dere kunne starte på en Automatisk eller Manuell test. Husk å krysse av for egenerklæring under Automatisk test. Veiledning samsvarstest side 14

15 5.5 MANUELL TEST NHN kan kreve at dere gjennomfører en manuell test i stedet for en automatisk test. Etter at oppsettet på første side av samsvarstesten er tilfredsstillende utfylt, vil Manuell test bli tilgjengelig ved at knappen aktiveres. Start en manuell test ved å klikke på knappen. En samsvarstest består av mange steg pr side, manuelle og automatiserte, hvor de 'manuelle' stegene krever input fra bruker. MV-Togg vil gå suksessivt gjennom stegene på første testside. Steg som er merket med grønn rute er godkjente steg. Steg som er merket med rød rute er enten manuelle steg som ennå ikke er utført eller underkjente steg. MV-Togg vil ikke gå til neste side i testen før alle de manuelle stegene er tilfredsstillende gjennomført på nåværende side MANUELL INPUT Manuell input kan være i form av å huke av en egenerklæring om at kravet beskrevet i steget etterleves, eller en opplastning av ytterligere informasjon i form av skjermbilder e.l. som dokumenterer at kravet etterleves. Veiledning samsvarstest side 15

16 5.5.2 RESTART ELLER AVBRYT TEST-CASE Ønsker dere å kjøre en side på nytt kan dere trykke Restart case knappen oppe til høyre over stegene. Casene på den siden blir da lagt til i 'køen' slik at de blir kjørt på nytt etter at siste side er gjennomført. Dere kan også manuelt avbryte en test ved å trykke på 'Avbryt test'- knappen. Hele testen vil da slettes fra oversikten INNSENDING AV MANUELL TEST FOR GODKJENNING Når en manuell test er gjennomført innen 14 dager og alle stegene er merket grønn, vil knappen for innsending aktiveres. Når dere trykker, vil testen bli gjennomgått i sin helhet av en testkonsulent hos NHN innen 14 dager. Etter innsending havner testen under Mine godkjenninger for gitt systemkombinasjon. Tidligere tester for samme Systemkombinasjon og Meldingsprofil vil finnes under Dersom det avdekkes feil og mangler i mottatt testmateriell, vil dere 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. Veiledning samsvarstest side 16

17 NHN 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 meldingsprofilene er i bruk. Hvis deres innsendte test blir godkjent, vil dette bli publisert på siden for Godkjenninger. Testresultatet vil bli merket med et ikonet for manuell test: 5.6 AUTOMATISK TEST Dere kan også velge en Automatisk gjennomkjøring av testen. En slik test er kjøring av den samme testen som ved en manuell test med unntak av de manuelle stegene som hoppes over. Får å få aktivert knappen for automatisk test må dere først huke av en egenerklæring hvor dere bekrefter at de manuelle stegene etterleves. Ved godkjent gjennomført Automatisk test vil resultatet automatisk publiseres på godkjenningssidene med mindre man fjerner avkrysning for offentlig visning. I en oppstartsperiode vil man måtte sende inn også automatiske tester manuelt i siste steg. Når testen er startet kan dere kunne følge med på testforløpet samt se meldingsdetaljer for hvert steg, med validering ev både ebxml konvolutt og fagmelding. Veiledning samsvarstest side 17

18 For sider i testen som enda ikke er påstartet, kan dere fortsatt se beskrivelse og forventet resultat for hvert teststeg, f.eks. forventet applikasjonskvittering fra både hoved- og kopimottaker med riktig rollebeskrivelse. Veiledning samsvarstest side 18

19 Det fremkommer av små ikon at det er en automatisk test som er godkjent, og ikke en manuell test. NHN kan ta kontakt på et senere tidspunkt for å verifisere manuelle teststeg. Veiledning samsvarstest side 19

20 6 GODKJENNINGER 6.1 OVERSIKT OVER GODKJENNINGER Den offentlige siden viser godkjente EPJ systemer pr meldidingstype i kombinasjon med meldingstjener. Kun godkjenning innenfor siste 2 årsperiode vil være synlig. Man kan sortere på "Nyeste godkjenning" eller "Antall godkjenninger" Veiledning samsvarstest side 20

21 6.2 SAMMENLIGNING AV EPJ SYSTEMER MED MELDINGSTJENER Ved å merke flere systemer for sammenligning, vil man kunne se alle godkjente tester pr profil av en meldingstype. 6.3 DETALJERT OVERSIKT PR EPJ LEVERANDØR Ved å trykke på Navnet til den enkelte leverandøren, kan man se siste godkjenning av alle profiler av en meldingstype, type godkjenning (manuell eller automatisk) for hver systemkombinasjon av EPJ og Meldingstjener. Veiledning samsvarstest side 21