Informasjonsmodell for elektronisk meldingsutveksling i SYSVAK Versjon 1.1 for utprøving 1999-02-08 KITH R 2/99 ISBN 82-7846-055-8
KITH-rapport Tittel Informasjonsmodell for elektronisk meldingsutveksling i SYSVAK v.1.1, for utprøving Forfatter(e) Jim J. Yang Oppdragsgiver(e) Sosial- og helsedepartementet Rapportnummer R 2/99 ISBN 82-7846-055-8 Godkjent av Bjørn Engum Direktør Sammendrag URL: http://www.kith.no/rapportarkiv/sysvak-infomod-v11.pdf Dato 1999-02-08 Antall sider 58 Kvalitetssikret av Edgar Glück Kompetansesenter for IT i helsevesenet AS Postadresse Sukkerhuset 7005 Trondheim Besøksadresse Sverresgt 15 Telefon 73 59 86 00 Telefaks 73 59 86 11 e-post firmapost@kith.no Foretaksnummer 959 925 496 Prosjektnummer Gradering Åpen SYSVAK er et nasjonalt registersystem for vaksinasjoner. Systemet består av lokale SYSVAK-registre som kommuniserer med et sentralt SYSVAK-register. Opplysninger om vaksinander og vaksinasjoner skal kunne overføres mellom lokale registre og det sentrale registeret i form av elektroniske meldinger. Dette dokumentet inneholder informasjonsmodellen for elektro-nisk meldingsutveksling i SYSVAK. Informasjonsmodellen i dette dokumentet er implementasjonsuavhengige beskrivelser av datagrunnlaget for meldingsutveksling, samt implementasjons-uavhengige beskrivelser av typer meldinger som utveksles i SYSVAK. Dette dokumentet dekker kun den delen av informasjonsutveks-ling i dagens SYSVAK som handler om enkelte vaksinander og vaksinasjonsopplysninger: Overføring av person- og vaksina-sjonsopplysninger fra et lokalt register til det sentrale SYSVAK-register for oppdatering; Kvittering på oppdateringsmeldinger; Søk i det sentrale SYSVAK-registeret etter personopplysninger med eller uten vaksinasjons-opplysninger; Svar på søk. i
Forord Dette dokumentet er utarbeidet i forbindelse med Sosial- og helsedepartementets program for Standardisering av informasjonsutveksling i helsesektoren (Standardiseringsprogrammet). SYSVAK er et nasjonalt registersystem for vaksinasjoner. Systemet består av lokale SYSVAK-registre som kommuniserer med et sentralt SYSVAK-register. Dokumentet beskriver datagrunnlaget i og strukturen av elektroniske meldinger i SYSVAK. Arbeidet er gjennomført som en konsensusprosess hvor leverandørene som allerede er involvert i dagens SYSVAKløsninger også aktivt bidrar: = Liv Engelstad og Terje Aastorp, EDB = Håkon Buvig, Infodoc = Roger Hansen og Geir Eidissen, Sysdeco Profdoc = Edgar Glück, KITH = Arnt Ole Ree, Statens helsetilsyn = Jim J. Yang, KITH (ansvarlig). KITH vil bruke anledningen til å takke alle ovennevnte for et godt samarbeid. Dette dokumentet erstatter KITH R 1/98 "Informasjonsmodell for elektronisk meldingsutveksling i SYSVAK versjon 1.0" av 23. februar 1998, ISBN 82-7846-042-6. De viktigste endringene fra versjon 1.0 til denne versjonen er dokumentert i vedlegg C av dette dokumentet. iii
Innhold 1. INNLEDNING 1 1.1 Bakgrunn 1 1.2 Bruksområder 1 1.3 Om dette dokumentet 2 2. MELDINGSFLYT I SYSVAK 5 2.1 Dagens meldingsflyt i SYSVAK 5 2.2 Meldingsflyt som dekkes av denne informasjonsmodellen 7 3. DIM - DOMENE INFORMASJONSMODELL 9 3.1 Introduksjon 9 3.1.1 Modelleringsmetoden 9 3.1.2 Grafisk fremstilling av DIM 9 3.1.3 Tekstlig beskrivelse av DIM 9 3.1.4 Repetisjon av DIM komponenter 10 3.2 DIM diagram 10 3.2.1 Om relasjonene 10 3.2.2 Overordnet modell for SYSVAK-meldinger 10 3.3 Tekstlig beskrivelse av objekter og deres attributter 13 3.3.1 Generelt 13 3.3.2 Beskrivelse av datatyper 13 3.3.3 Avsender 14 3.3.4 Helsetjenesteenhet 14 3.3.5 Hendelse 16 3.3.6 Mottaker 19 3.3.7 Pårørende 19 3.3.8 Sentralt SYSVAK-register 20 3.3.9 SYSVAK-melding 20 3.3.10 SYSVKVIT (Kvitteringsmelding) 23 3.3.11 SYSVOPPD (Oppdateringsmelding) 24 3.3.12 SYSVSPØR (Forespørselsmelding) 24 3.3.13 SYSVSVAR (Svarmelding) 24 3.3.14 Vaksinand 25 3.3.15 Vaksinasjonsenhet 29 3.4 Tekstlig beskrivelse av felles attributtgrupper 29 3.4.1 Adresse 29 3.4.2 Personlig Navn 30 4. GMD - GENERELLE MELDINGSBESKRIVELSER 31 4.1 Introduksjon 31 4.2 GMD - SYSVOPPD Oppdateringsmelding 32 4.3 GMD - SYSVKVIT Kvitteringsmeldinger 33 4.4 GMD - SYSVSPØR - Forespørselsmelding 35 4.5 GMD - SYSVSVAR Svarmelding 36 4.6 Meldingsinnhold og krav til attributter 38 VEDLEGG A MAPPING FRA DAGENS MELDINGER TIL INFORMASJONSMODELLEN 43 VEDLEGG B VAKSINEKODER 47 VEDLEGG C VIKTIGSTE ENDRINGER FRA V.1.0 TIL V.1.1 49 v
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK 1. Innledning Dette kapitlet gir en kort beskrivelse av dokumentet: Bakgrunn for arbeidet, bruksområder av dette dokumentet samt en kort oversikt over innholdet i dokumentet. 1.1 Bakgrunn Nasjonalt vaksinasjonsregister Vaksinasjonsmeldinger Standardisering av SYSVAK-meldinger SYSVAK er et nasjonalt registersystem for vaksinasjoner. Systemet består av lokale SYSVAK-registre som skal kunne kommunisere med et sentralt SYSVAK-register elektronisk. Fra 1. januar 1996 ble alle landets kommuner pålagt å melde vaksinasjoner for barn og unge til det sentrale SYSVAK-registeret. I begynnelsen ble alle meldingene sendt inn på papirskjemaer. Per mai 1997 har derimot i overkant av halvparten av landets ca. 1100 helsestasjoner elektronisk kommunikasjon med det sentrale SYSVAKregisteret. Siden dette omfatter alle de største kommunene og bydelene, antas det at ca. 60-70% av alle vaksinasjoner hos barn og unge nå meldes elektronisk til det sentrale SYSVAK-registeret. Planen er at alle som vaksinerer skal melde vaksinasjoner til det sentrale SYSVAKregisteret, fortrinnsvis elektronisk. Meldingene som i dag utveksles mellom lokale og det sentrale SYSVAK-registeret er imidlertid lite standardisert. Meldingene er i dag basert på binære eller vanlige ASCII-filer. Som et ledd i standardisering av informasjonsutveksling i helsesektoren, blir det derfor igangsatt dette arbeidet for å standardisere meldingene i SYSVAK. Denne foreliggende informasjonsmodellen sammen med etterfølgende implementasjonsguider vil til sammen utgjøre definisjon og spesifikasjon av standardiserte meldinger i SYSVAK. 1.2 Bruksområder Informasjonsmodell Dette dokumentet inneholder informasjonsmodellen for elektronisk meldingsutveksling i SYSVAK. Informasjonsmodellen i dette dokumentet er implementasjonsuavhengige beskrivelser av datagrunnlaget og meldingsoppbygging/-innhold, med utgangspunkt i behov for informasjonsutveksling mellom lokale og det sentrale SYSVAK-registeret. Dokumentet danner grunnlag for senere å 1
KAP. 1 INNLEDNING beskrive og realisere elektroniske meldinger for SYSVAK, basert på de(n) valgte implementeringssyntaks, eksempelvis EDIFACT. Hva denne informasjonsmodellen dekker Hva denne informasjonsmodellen ikke dekker Dette dokumentet dekker følgende behov for informasjonsutveksling mellom et lokalt SYSVAK-register og det sentrale SYSVAKregisteret: 1. Oppdatering av person- og vaksinasjonsopplysninger om en eller flere personer, sendt fra et lokalt SYSVAK-register til det sentrale SYSVAK-registeret. 2. Kvittering på mottatte oppdateringsmeldinger nevnt under forrige punkt. 3. Forespørsel om opplysninger om en eller flere personer, med eller uten vaksinasjonsopplysninger, sendt fra et lokalt SYSVAK-register til det sentrale SYSVAK-registeret. 4. Svar på forespørsler nevnt under forrige punkt. Dette dokumentet dekker derimot ikke meldinger som ikke omhandler enkelte vaksinander. Dette betyr at rapporter og statistikker (f.eks. dekningsgrad) ikke er dekket av denne informasjonsmodellen, verken forespørsel om eller svar på forespørsler om rapporter/statistikker. Tilsvarende er oppdatering av hjelperegistre (f.eks. vaksinekoder, institusjonsnumre) heller ikke dekket av denne informasjonsmodellen, verken forespørsler om eller svar på forespørsler om oppdatering av hjelperegistre. Dette dokumentet har heller ikke hatt som mål å kunne dekke meldinger som inneholder "rene personopplysninger", dvs. meldinger som bare inneholder "folkeregisteropplysninger", selv om meldingene beskrevet i dette dokumentet til dels kan brukes til dette formål. 1.3 Om dette dokumentet Konsensusprosess Dokumentets oppbygging Det foreliggende dokumentet er et resultat av en prosess hvor leverandørene som allerede er involvert i dagens SYSVAK-løsninger, Helsetilsynet og KITH alle aktivt bidrar. Dokumentet inneholder således en konsensus mellom disse partene på hva elektroniske meldinger i SYSVAK skal inneholde og hvordan. Dokumentet er videre organisert som følger: = Kap. 2 beskriver meldingsflyten i dagens SYSVAK, samt hvilke deler av dagens meldingsflyt som vil bli dekket av informasjonsmodellen presentert i dette dokumentet. = Kap. 3 inneholder en "domene informasjonsmodell" (DIM, engelsk domain information model) for SYSVAK, med 2
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK utgangspunkt i behovet for utveksling av vaksinand- og vaksinasjonsopplysninger mellom lokale SYSVAK-registre og det sentrale SYSVAK-registeret. = Kap. 4 inneholder generelle meldingsbeskrivelser (GMD, engelsk general message description) av de meldingstypene som dette dokumentet dekker. = Vedlegg A inneholder kryssreferanser mellom innholdet i dagens meldingsflyt og innholdet i denne informasjonsmodellen. = Vedlegg B inneholder en oversikt over dagens gyldige vaksinekoder i SYSVAK-registeret. = Vedlegg C beskriver de viktigste endringene fra forrige versjon (v.1.0) til denne versjonen av dokumentet. 3
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK 2. Meldingsflyt i SYSVAK Dette kapitlet gir en kort beskrivelse av dagens meldingsflyt i SYSVAK, samt hva denne informasjonsmodellen dekker av dagens meldingsflyt i SYSVAK. 2.1 Dagens meldingsflyt i SYSVAK Figur 1: Dagens meldingsflyt i SYSVAK Lokalt register Sentralt register 1 Oppdatering av personer og vaksinasjoner Lokalt register 7 Søk etter person m/ vaksinasjoner Sentralt register 2 Kvittering 8 En/flere person som passer til kriteriet, med vaksinasjoner 3 9 Søk etter person Be om rapport 4 En/flere person som passer til kriteriet 10 Rapport 5 Be om oppdatering av hjelpetabell 14 Oppdatering av hjelpetabell 6 Oppdatering av hjelpetabell 16 Operatørmelding Figur 1 viser dagens meldingsflyt i SYSVAK. Numrene i figuren viser til oppgavetypene som er forklart i tabell 1. Figuren og tabellen er hentet fra dokumentasjonen «Kommunikasjon mellom det sentrale SYSVAK-registeret og lokal SYSVAK løsning», v.1.2, 20.12.1996, utarbeidet av EDB, med mindre modifikasjoner av redaksjonell art. Tabell 1: Forklaring på dagens oppgavetyper i SYSVAK (SR = Sentralt SYSVAKregister, LR = Lokalt SYSVAK-register) Type Navn Til/fra Prioritet Beskrivelse SR 1 Oppdatering til SR Til Lav Oppdatering til SR. Alle personer eller vaksinasjoner som er registrert/endret i LR sendes til SR i hver sin instruksjon. Dette er lavprioritetsmeldinger, da det i løpet av dagen er viktigere å få svar på forespørsler til SR enn å oppdatere med ny informasjon. I SYSVAK Lokal defineres dette som nattpost og sendes på gitt tidspunkt i løpet av natten. 5
KAP. 2 MELDINGSFLYT I SYSVAK Type Navn Til/fra SR 2 Kvittering for Fra "Oppdatering til SR" 3 Personsøk i SR 4 Svar på "Personsøk i SR" 5 Be om tabellendringer fra SR 6 Svar på tabellendringer fra SR 7 Personsøk m/ vaksinasjoner 8 Svar på "Personsøk m/ vaksinasjoner" 9 Be om rapport fra SR 10 Rapport fra SR 11 Ikke i bruk Prioritet Beskrivelse Kvittering på oppdatering til SR. SR returnerer koder for hvordan oppdateringen gikk, evt. med korrektur av nøkkelverdier eller feilmeldinger. Til Høy/Lav Søk etter personinformasjon i SR. Søkekriteriet ligger i en jobb. Dette er vanligvis høyprioritetsmeldinger, men avsender står fritt til å sette denne til lav prioritet. Fra Resultat av søk etter personinformasjon i SR. Returnerer antall personer som passet til søkekriteriet og personinformasjon for disse i instruksjoner med referanse til hvilken jobb søkekriteriet lå i. Til Lav/Høy LR ber om å få oppdatert tabeller. En tabell pr. jobb. Avsender bestemmer prioritet. Fra Tabell fra SR. Hver jobb er fra en tabell, hver instruksjon er en rad i tabellen. Til Høy/Lav Søk etter person- og vaksinasjonsinformasjon i SR. Søkekriteriet ligger i en jobb. Dette er vanligvis høyprioritetsmeldinger, men avsender står fritt til å sette denne til lav prioritet. Fra Resultat av søk etter person- og vaksinasjonsinformasjon i SR. Returnerer antall personer som passet til søkekriteriet og personog vaksinasjonsinformasjon for disse i instruksjoner med referanse til hvilken jobb søkekriteriet lå i. Til Lav/høy LR ber om å få rapport. Rapportene som kjøres i SR er årsstatistikkene (produksjons- og dekningsstatistikker). Input for å kjøre en rapport ligger i en jobb. Dette er lavprioritetsmeldinger, da det i løpet av dagen er viktigere å få svar på forespørsler til SR enn å hente ned årsstatistikker. I SYSVAK Lokal defineres dette som nattpost og sendes på gitt tidspunkt i løpet av natten. Fra Rapport fra SR. Rapportene sendes med bestemte format for de ulike type rapporter. 6
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK Type Navn Til/fra SR 12 Ikke i bruk 13 Ikke i bruk 14 Tabellendringer Fra fra SR (initiert fra SR) 15 Ikke i bruk 16 Operatørmelding Fra Prioritet Beskrivelse Virker på samme måte som Oppgavetype 6 - Svar på tabellendringer fra SR, men er initiert fra SR når denne vil sende ut oppdaterte tabeller. Melding fra SR. Jobben inneholder en tekstmelding som brukere av SYSVAK trenger. Det kan være opplysninger om problemer med server, nye vaksinekoder etc. 2.2 Meldingsflyt som dekkes av denne informasjonsmodellen Denne informasjonsmodellen dekker følgende deler av meldingsflyt i dagens SYSVAK (jfr. også figur 2): = Oppgave 1: "Oppdatering av personer og vaksinasjoner", fra et lokalt register til det sentrale SYSVAK-registeret, beskrevet som Oppdateringsmelding (SYSVOPPD) i dette dokumentet. = Oppgave 2: "Kvittering" på mottatte oppgaver av type 1, fra det sentrale SYSVAK-registeret til et lokalt register, beskrevet som Kvitteringsmelding (SYSVKVIT) i dette dokumentet. = Oppgave 3: "Søk etter person", fra et lokalt register til det sentrale SYSVAK-registeret, beskrevet som Forespørselsmelding (SYSVSPØR) i dette dokumentet. = Oppgave 4: "En/flere personer som passer til kriteriet", fra det sentrale SYSVAK-registeret til et lokalt register, beskrevet som Svarmelding (SYSVSVAR) i dette dokumentet. = Oppgave 7: "Søk etter person med vaksinasjoner", fra et lokalt register til det sentrale SYSVAK-registeret, beskrevet som Forespørselsmelding (SYSVSPØR) i dette dokumentet. = Oppgave 8: "En/flere person som passer til kriteriet, med vaksinasjoner", fra det sentrale SYSVAK-registeret til et lokalt register, beskrevet som Svarmelding (SYSVSVAR) i dette dokumentet. Oppgavene som ikke er nevnt i listen ovenfor vil bli håndtert senere i andre sammenhenger. 7
KAP. 2 MELDINGSFLYT I SYSVAK Figur 2: Anvendelsesområder av meldingene beskrevet i dette dokumentet Lokalt register Oppdateringsmelding (SYSVOPPD) for "Oppgave 1: Oppdatering av personer og vaksinasjoner" Sentralt register Kvitteringsmelding (SYSVKVIT) for "Oppgave 2: Kvittering på mottatte oppgaver av type 1" Forespørselsmelding (SYSVSPØR) for "Oppgave 3: Søk etter person", eller "Oppgave 7: Søk etter person m/ vaksinasjoner" Svarmelding (SYSVSVAR) for "Oppgave 4: En/flere person som passer til kriteriet", eller "Oppgave 8: En/flere person som passer til kriteriet, med vaksinasjoner" 8
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK 3. DIM - Domene informasjonsmodell Dette kapitlet inneholder den overordnede informasjonsmodellen (DIM - Domene informasjonsmodell) for SYSVAKmeldinger. DIM er i dette kapitlet beskrevet grafisk (DIMdiagram) og tekstlig (med tekstlig beskrivelse av objekter og deres attributter). Generelle meldingsbeskrivelser (GMD - engelsk: General Message Description) finnes i neste kapittel. 3.1 Introduksjon 3.1.1 Modelleringsmetoden DIM - Domene informasjonsmodell Domene informasjonsmodeller (eng. Domain Information Models, DIM) er bygd opp som objektorienterte modeller, med UMLnotasjoner 1. DIM er presentert grafisk (se avsnitt 3.2) og med tekstlige beskrivelser (se avsnitt 3.3). 3.1.2 Grafisk fremstilling av DIM Den grafiske presentasjonen av modellen viser informasjonen som kan bli overført i SYSVAK-meldinger. Diagrammet viser også relasjoner mellom disse komponentene. 3.1.3 Tekstlig beskrivelse av DIM Den tekstlige beskrivelsen beskriver i detalj hvert enkelt objekt og dets attributter og attributtgrupper. Datatyper Datatypen av hvert attributt er definert ved hjelp av forkortelsene som skal tolkes i henhold til datatypedefinisjonene som er oppgitt i tabell 2 i avsnitt 3.2.2. 1 UML: Unified Modeling Language. 9
KAP. 3 DIM - DOMENE INFORMASJONSMODELL 3.1.4 Repetisjon av DIM komponenter Kardinalitet (cardinality) Krav til repetisjon av et objekt er indikert ved kardinalitet ("mengdeangivelse", engelsk: cardinality eller multiplicity) til relasjoner vist i den grafiske fremstillingen av DIM. Repetisjon av et attributt er indikert ved prefikset "L-" foran attributtnavnet i den tekstlige beskrivelsen. Repetisjon av en attributtgruppe innen et objekt eller innen en annen attributtgruppe er indikert ved prefikset "L-" foran navnet til attributtgruppen i den tekstlige beskrivelsen. 3.2 DIM diagram 3.2.1 Om relasjonene Repetisjonskrav, kardinalitet Brukerkrav I datamodellen er repetisjonskravet til objektene beskrevet ved hjelp av kardinalitet ("mengdeangivelse", engelsk: cardinality eller multiplicity) til den aktuelle relasjonen. Eksempel: 1-tallene på relasjonen mellom Oppdateringsmelding (SYSVOPPD) og Kvitteringsmelding (SYSVKVIT) i modellen som er vist i figur 3, uttrykker en-til-enrelasjon mellom Oppdateringsmeldingene og Kvitteringsmeldingene. Det gjøres samtidig oppmerksom på at kardinalitetene viser "logiske" brukerkrav og ikke fysiske krav. Eksempel: en-til-en-relasjonen mellom Oppdateringsmeldingene og Kvitteringsmeldingene uttrykker brukerkravet at det sentrale SYSVAK-registeret ved mottak av en Oppdateringsmelding alltid skal sende én og bare én Kvitteringsmelding og at en Kvitteringsmelding alltid skal gjelde kun én Oppdateringsmelding. Dette på den annen siden vil ikke alltid kunne gjelde fysisk i en konkret realisering av systemet, da det alltid vil ta noe tid mellom utsendelse av en Oppdateringsmelding og mottak at den tilsvarende Kvitteringsmeldingen. 3.2.2 Overordnet modell for SYSVAK-meldinger Figur 3: Overordnet modell for SYSVAK-meldinger Den overordnede informasjonsmodellen for SYSVAK-meldinger er vist i figur 3. Komponentene i modellen er beskrevet nærmere i andre avsnitt: = Avsender (jfr. avsnitt 3.3.3). = Helsetjenesteenhet (jfr. avsnitt 3.3.4). = Hendelse (jfr. avsnitt 3.3.5). = Mottaker (jfr. avsnitt 3.3.6). = Pårørende (jfr. avsnitt 3.3.7). = Sentralt SYSVAK-register (jfr. avsnitt 3.3.8). = SYSVAK-melding (jfr. avsnitt 3.3.9). = SYSVKVIT (Kvitteringsmelding, jfr. avsnitt 3.3.10). 10
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK = SYSVOPPD (Oppdateringsmelding, jfr. avsnitt 3.3.11). = SYSVSPØR (Forespørselsmelding, jfr. avsnitt 3.3.12). = SYSVSVAR (Svarmelding, jfr. avsnitt 3.3.13). = Vaksinand (jfr. avsnitt 3.3.14). = Vaksinasjonsenhet (jfr. avsnitt 3.3.15). SYSVAK-melding Oppdateringsmelding (SYSVOPPD) Forespørselsmelding (SYSVSPØR) 1 1 1 Kvitteringsmelding (SYSVKVIT) 1 Svarmelding (SYSVSVAR) 1 Vaksinasjonsenhet 1 Sentralt SYSVAK-register Avsender 0..1 0..1 Mottaker * * * SYSVAK-melding * * Helsetjenesteenhet * Pårørende Vaksinand 0..1 1 * Hendelse * * A 0..1 B A er assosiert med maksimalt én B A 1 B A er assosiert med én og bare én B A B A er assosiert med minst én B A * B A er assosiert med ubegrenset antall B A B A er en spesialisering av B Hovedbudskapene av denne overordnede modellen er som følger: = Denne informasjonsmodellen dekker 4 typer SYSVAKmeldinger: Oppdateringsmelding (SYSVOPPD), 11
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Kvitteringsmelding (SYSVKVIT), Forespørselsmelding (SYSVSPØR) og Svarmelding (SYSVSVAR). = Det skal alltid være én og bare én Kvitteringsmelding (SYSVKVIT) for hver Oppdateringsmelding (SYSVOPPD). = Enhver Forespørselsmelding (SYSVSPØR) skal besvares med kun én Svarmelding (SYSVSVAR) og enhver Svarmelding (SYSVSVAR) svarer til kun én Forespørselsmelding (SYSVSPØR). Dette betyr at ved for mange treff grunnet for dårlige søkekriterier i Forespørselsmeldingen vil det ikke bli sendt mange Svarmeldinger, men kun en som forteller at det er for mange treff. Spørrende enheten skal i så fall spesifisere søkekriteriene ytterligere og sende Forespørselsmeldingen på nytt. = Enhver SYSVAK-melding handler om minst én Vaksinand 2. = Enhver Hendelse er relatert til én og alltid én Vaksinand. En Hendelse kan være relatert til ingen eller flere Helsetjenesteenheter 3. = Enhver Vaksinand skal være rapportert/involvert i minst én SYSVAK-melding 4. = En Helsetjenesteenhet kan være en "Vaksinasjonsenhet" (enheten som registrerer/rapporterer eller spør om en vaksinand/hendelse), "Sentralt SYSVAK-register" (det sentrale SYSVAK-registeret), "Avsender" (enheten som sender en Oppdateringsmelding eller Forespørselsmelding på vegne av en annen enhet som selv ikke har mulighet for å sende EDI-meldinger), eller "Mottaker" (enheten som mottar en Kvitteringsmelding eller Svarmelding på vegne av en annen enhet som selv ikke har mulighet for å motta EDI-meldinger). 2 3 4 "Minst én Vaksinand", selv også når man sender en Forespørselsmelding hvor man spør om (søker etter) opplysninger om en Vaksinand som kanskje ikke finnes registrert. "Minst én" betyr også at flere Vaksinander kan rapporteres i en og samme Oppdateringsmelding. "Ingen Helsetjenesteenhet": i tilfeller når opplysninger om de(n) involverte Helsetjenesteenheten(e) ikke er tilgjengelig. "Flere Helsetjenesteenheter", f.eks. en som vaksinerte, en som registrerte, en som oppdaterte opplysningene. "Minst én": logisk krav slik at alle Vaksinander blir rapportert til det sentrale SYSVAKregisteret. En Vaksinand kan dessuten være omhandlet i flere SYSVAK-meldinger (eksempel: første gang når vedkommende blir rapportert til det sentrale SYSVAKregisteret vha. en Oppdateringsmelding, andre gang når en annen Helsetjenesteenhet spør om vedkommende vha. en Forespørselsmelding, tredje gang når sentralen svarer på forespørsel om vedkommende vha. en Svarmelding, osv.). 12
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK 3.3 Tekstlig beskrivelse av objekter og deres attributter 3.3.1 Generelt Den tekstlige beskrivelsen er et supplement til den grafiske beskrivelsen i forrige avsnitt. Objektene er beskrevet i den alfabetiske rekkefølge av objektnavn. Den overordnede beskrivelsen av objektene benytter stikkordene Hensikt, Kommentar og Eksempler. Attributtene er gruppert under de objektene de tilhører. For å skille mellom attributtgrupper og vanlige attributter, er navnet til en attributtgruppe skrevet i kursiv skrifttype. Innrykk er brukt til å indikere komponentene i en attributtgruppe. For å understreke innrykket, er navnene til komponentene i en attributtgruppe skrevet med ">"- prefikset. Navnene til komponentene i en attributtgruppe innen en annen attributtgruppe er skrevet med "»"-prefikset. Attributtgrupper som er felles til flere objekter er beskrevet i avsnitt 3.3.15. Krav til attributtene Krav til attributtene er ikke tatt med i dette kapitlet, men i avsnitt 4.6. 3.3.2 Beskrivelse av datatyper Tabell 2: Beskrivelse av datatyper Datatype Forkortelse Definisjon tekststreng S En streng av tegn fra ISO 8859 tegnsett. kodet verdi C/S Verdi som kan uttrykkes enten som en eller tekststreng kodet verdi eller som en tekststreng. kalenderdato tid av en kalenderdato CD TOCD Streng begrenset til å representere år, måned og dag (definisjon i følge ISO 8601). Streng begrenset til å representere år, måned, dag, time, minutter, sekunder og lokal tid differanse faktor. reeltall R En enkel type med forskjellige verdier som er medlemmer av settet med reelle tall (definisjon i følge ISO 8824). 13
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Datatype Forkortelse Definisjon kodeverdi V Denne datatype består av 2 komponenter: = ICD (International Coding Scheme Designator som er definert i ISO 6523): av datatype streng, er en valgfri komponent. = Kodeverdi: av datatype streng, er en obligatorisk komponent. Koding er krevd. attributtgruppe AG Sammensatt datatype som brukes til å gruppere et sett av logisk sammenhørende attributter og/eller andre attributtgrupper felles attributtgruppe CAG som er brukt i spesifikke sammenhenger. Sammensatt datatype som brukes til å gruppere et sett av logisk sammenhørende attributter og som er brukt på en felles måte i flere forskjellige sammenhenger. (CAG = common attribute group). 3.3.3 Avsender Objektnavn: Avsender Hensikt: For opplysninger om den enheten som sender en SYSVAK-melding på vegne av en annen enhet som selv ikke har mulighet for å sende EDImeldinger. Kommentar: 1. Avsender er en spesialisering av Helsetjenesteenhet. Objektene av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene som er definert i objektklassen Helsetjenesteenhet. 2. Avsender av en Oppdateringsmelding tilsvarer Mottaker (avsnitt 3.3.6) av den tilsvarende Kvitteringsmeldingen. Tilsvarende gjelder for forholdet mellom Avsenderen av en Forespørselsmelding og Mottakeren av den tilsvarende Svarmeldingen. Eksempler: 3.3.4 Helsetjenesteenhet Objektnavn: Helsetjenesteenhet Hensikt: For opplysninger om en Helsetjenesteenhet som er relatert til (eller referert i) en SYSVAK-melding. 14
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK Kommentar: Helsetjenesteenhet kan spesialiseres til "Vaksinasjonsenhet", "Sentralt SYSVAK-register", "Avsender " (enheten som sender en melding på vegne av en annen enhet som selv ikke har mulighet for å sende EDImeldinger), eller "Mottaker" (enheten som mottar en melding på vegne av en annen enhet som selv ikke har mulighet for å motta EDImeldinger). Eksempler: Helsetjenesteenhet Attributtnavn Kommentar Datatype institusjons rolle Rollen til institusjon i meldingssammenheng, med kodeverdi som tilsvarer: = "Vaksinasjonsenhet": enheten som rapporterer eller spør om en vaksinand/hendelse, = "Sentralt SYSVAKregister": det sentrale SYSVAK-registeret, = "Avsender": enheten som sender en Oppdateringsmeldingen eller Forespørselsmelding på vegne av en "Vaksinasjonsenhet" som selv ikke har mulighet for å sende EDImeldinger, eller = "Mottaker": enheten som mottar en Kvitteringsmeldingen eller Svarmeldingen på vegne av en "Vaksinasjonsenhet" som selv ikke har mulighet for å motta EDI-meldinger. V 15
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Helsetjenesteenhet Attributtnavn Kommentar Datatype institusjon (nummer Nummer (og/eller navn) til institusjonen. C/S og/eller navn) avdeling 5 Evt. avdelingsidentifikasjon. C/S L-adresse og telekommunikasjonsnummer Liste av adresser og telekommunikasjonsnummer til institusjonen, vha. attributtgruppen Adresse (se avsnitt 3.4.1). CAG 3.3.5 Hendelse Objektnavn: Hendelse Hensikt: For opplysninger om de ulike typer hendelser som en SYSVAKmelding kan omhandle. Kommentar: Hendelser kan være Vaksinasjon, Vaksinasjonsreaksjon eller Kontraindikasjon. Eksempler: Hendelse Attributtnavn Kommentar Datatype type hendelse Type hendelse, dvs. kodeverdi V som tilsvarer: "Vaksinasjon", "Vaksinasjonsreaksjon", eller "Kontraindikasjon". aksjonskode For bruk i Oppdateringsmeldinger (SYSVOPPD): type aksjon ang. den aktuelle Hendelsen, dvs. kodeverdi som tilsvarer: = "Ny": Hendelsen er (antatt) ny 6 ; = "Endring": opplysningene tilsendt skal oppdatere V 5 Attributtet/attributtgruppen brukes ikke i tilsvarende meldinger i dagens SYSVAK og vil ikke i første omgang bli brukt i de nye EDI-meldingene heller. Attributtet/attributtgruppen er tatt med her for å kunne ta høyde for fremtidige behov. 16
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK Hendelse Attributtnavn Kommentar Datatype eksisterende opplysninger om Hendelsen; eller = "Sletting": Hendelsen skal slettes. suksesskode For bruk i Kvitteringsmelding V (SYSVKVIT): kodeverdi som tilsvarer: = "OK": opplysningene om Hendelsen er feilfritt håndtert av det sentrale SYSVAK-registeret; = "Nyere opplysninger finnes i sentralt register", det finnes nyere opplysninger om denne Hendelsen i det sentrale SYSVAK-registeret enn de som er blitt rapportert i Oppdateringsmeldingen, det lokale SYSVAKregisteret bør hente over opplysningene ved å sende Forespørselsmelding til det sentrale SYSVAK-registeret; = "Varsel": det sentrale SYSVAK-registeret oppdaget "mistenkelige data" ved håndtering av denne Hendelsen; eller = "Feil": det sentrale SYSVAK-registeret fant en eller flere feil ved håndtering av denne Hendelsen. L-feilmeldingstekst Evt. nærmere beskrivelse av S varsel-/feilmeldingen. dato for hendelse Dato når hendelsen oppstår CD 6 "Antatt ny" fordi det kan hende at det i det sentrale SYSVAK-registeret allerede er registrert opplysninger om den aktuelle hendelse som meldeenheten ikke vet om. 17
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Hendelse Attributtnavn Kommentar Datatype (eller blir rapportert), f.eks. når vaksinen er satt, når kontraindikasjon blir rapportert. institusjon for hendelse Nummer eller navn til helsetjenesteenheten hvor hendelsen oppstår/rapporteres, f.eks. den institusjonen som satte en vaksine. C/S avdeling for hendelse 7 dato for ajourføring institusjon for ajourføring L-kommentar vaksine Institusjonsnummeret skal brukes såfremt dette er tilgjengelig. Evt. avdelingsidentifikasjon for hvor hendelsen oppstår/rapporteres. Dato når opplysninger om hendelsen sist ble registrert/oppdatert (inklusiv førstegangs registrering). Nummer eller navn til institusjonen som sist ajourførte opplysningene. Evt. kommentar ang. Hendelsen. Attributtgruppe bestående av følgende > vaksinekode Vaksinen som ble satt, eller som det ble rapportert vaksinasjonsreaksjon eller kontraindikasjon for. CD C/S S AG V Se vedlegg B for dagens gyldige vaksinekoder i SYSVAKregisteret. > produksjonsnummer 7 Batch- /serienummer til preparatet. S > preparat 7 Navn eller varenummer til C/S 7 Attributtet/attributtgruppen brukes ikke i tilsvarende meldinger i dagens SYSVAK og vil heller ikke i første omgang bli brukt i de nye EDI-meldingene. Attributtet/attributtgruppen er tatt med her for å kunne ta høyde for fremtidige behov. 18
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK Hendelse Attributtnavn Kommentar Datatype preparatet. L-kommentar vaksine 7 Evt. kommentar > dose 7 Attributtgruppe bestående av AG følgende to attributter:» dosestørrelse dosen. R» måleenhet måleenhet. V 3.3.6 Mottaker Objektnavn: Mottaker Hensikt: For opplysninger om den enheten som mottar en Kvitteringsmelding eller Svarmelding på vegne av en annen enhet som selv ikke har mulighet for å motta EDI-meldinger. Kommentar: 1. Mottaker er en spesialisering av Helsetjenesteenhet. Objektene av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene som er definert i objektklassen Helsetjenesteenhet. 2. Mottaker av en Kvitteringsmelding tilsvarer Avsender av den tilsvarende Oppdateringsmeldingen. Tilsvarende gjelder for forholdet mellom Mottaker av en Svarmelding og Avsender av den tilsvarende Forespørselsmeldingen. Eksempler: 3.3.7 Pårørende Objektnavn: Pårørende Hensikt: For opplysninger om evt. pårørende til en vaksinand. Kommentar: Brukes typisk til barn som ennå ikke har fått eget personnummer. Objekt Pårørende brukes kun sammen med tilhørende Vaksinand. Eksempler: Mor til et barn. 19
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Pårørende Attributtnavn Kommentar Datatype type relasjon til Type relasjon pårørende har til V vaksinanden vaksinanden, med kodeverdi som tilsvarer: = "Mor (inkl. adoptiv- /fostermor)", = "Far (inkl. apotiv- /fosterfar)", = "Annen" (annen type relasjon). fødselsnummer Pårørendes fødselsnummer, i V henhold til Folkeregisteret. fødselsdato Pårørendes fødselsdato. CD navn Pårørendes navn, vha. attributtgruppen Personlig Navn (se avsnitt 3.4.2). CAG 3.3.8 Sentralt SYSVAK-register Objektnavn: Sentralt SYSVAK-register Hensikt: For opplysninger om det Sentrale SYSVAK-registeret som mottar en Oppdateringsmelding eller Forespørselsmelding, eller som sender en Kvitteringsmelding eller Svarmelding. Kommentar: Dette er en spesialisering av Helsetjenesteenhet. Objekter av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene i objektklassen Helsetjenesteenhet. Eksempler: 3.3.9 SYSVAK-melding Objektnavn: SYSVAK-melding Hensikt: For opplysninger om en SYSVAK-melding. Kommentar: SYSVAK-melding kan spesialiseres til SYSVOPPD (Oppdateringsmelding), SYSVKVIT (Kvitteringsmelding), SYSVSPØR (Forespørselsmelding) eller SYSVSVAR (Svarmelding). Eksempler: 20
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK SYSVAK-melding Attributtnavn Kommentar Datatype meldingens betegnelse Spesifikasjon av type V SYSVAK-melding, med kodeverdi som tilsvarer: = "SYSVOPPD (Oppdateringsmelding)", = "SYSVKVIT (Kvitteringsmelding)", = "SYSVSPØR (Forespørselsmelding)", eller = "SYSVSVAR (Svarmelding)". meldingens referansenummer Entydig referansenummer for S meldingen. Tildeles vanligvis av EDI programvaren hos avsenderen. tidspunkt for generering Tidspunkt for generering av TOCD av meldingen prioritet meldingen. Prioritet av meldingen, kodeverdi som tilsvarer: = "Høy prioritet" eller = "Lav prioritet". avsendende applikasjon Attributtgruppe bestående av følgende 2 attributter: > avsendende Navn til applikasjonen som er applikasjons navn brukt til å generere meldingen. > avsendende Versjon til applikasjonen som er applikasjons versjon brukt til å generere meldingen. referanse til et annet Attributtgruppe bestående av dokument følgende 2 attributter: > type referert dokument For bruk i Kvitteringsmelding (SYSVKVIT): kodeverdi som tilsvarer "Oppdateringsmeldingen (SYSVOPPD)" som det kvitteres for. For bruk i Svarmelding (SYSVSVAR): kodeverdi som tilsvarer "Forespørselsmelding (SYSVSPØR)" som det svares for. > referansenummer Id til det refererte dokumentet som er den tilsvarende Oppdate- V AG C S AG C S 21
KAP. 3 DIM - DOMENE INFORMASJONSMODELL SYSVAK-melding Attributtnavn Kommentar Datatype ringsmeldingen hhv. Forespørselsmeldingen. suksesskode For bruk i Kvitteringsmelding (SYSVKVIT): om hvorvidt den tilsvarende Oppdateringsmeldingen er feilfri, med kodeverdi som tilsvarer: = "OK": alle opplysninger i den tilsvarende Oppdateringsmeldingen (SYSVOPPD) er mottatt og håndtert feilfritt av det sentrale SYSVAKregisteret; = "Varsel": det er oppdaget "mistenkelige data" i den tilsvarende Oppdateringsmeldingen (SYSVOPPD). Se ellers også kommentar 3 under SYSVKVIT (avsnitt 3.3.10); eller = "Feil": det er funnet en eller flere feil i den tilsvarende Oppdateringsmeldingen (SYSVOPPD). Se ellers også kommentar nr. 4 under SYSVKVIT (avsnitt 3.3.10). V For bruk i Svarmelding (SYSVSVAR): Om hvorvidt søk er vellykket, med kodeverdi som tilsvarer: = "Vellykket søk, alle svarene tilsendt": søk i det sentrale SYSVAKregisteret ga treff på konkrete personer og opplysningene om disse er tilsendt i Svarmeldingen, eller = "For mange treff, ingen svar tilsendt": pga. for uspesifiserte søkekriterier 22
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK SYSVAK-melding Attributtnavn Kommentar Datatype som er oppgitt i den tilsvarende Forespørselsmeldingen (SYSVSPØR), ga søk i det sentrale SYSVAK-registeret for mange treff og det blir derfor ikke tilsendt noe konkret svar i Svarmeldingen. Den spørrende enheten skal derfor spesifisere søkekriteriene nærmere og sende Forespørselsmeldingen på nytt. 3.3.10 SYSVKVIT (Kvitteringsmelding) Objektnavn: SYSVKVIT (Kvitteringsmelding) Hensikt: For opplysninger om en Kvitteringsmelding (SYSVKVIT). Kommentar: 1. Kvitteringsmelding (SYSVKVIT) er en spesialisering av SYSVAK-melding. Objektene av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene som er definert i objektklassen SYSVAK-melding. 2. En Kvitteringsmelding (SYSVKVIT) brukes til å sende kvitteringer med tilbakemeldinger/feilmeldinger, på mottatte Oppdateringsmeldinger (SYSVOPPD). 3. Når det er oppdaget "mistenkelige data" i Oppdateringsmeldingen, vil "Suksesskode" i objektet SYSVAK-melding (avsnitt 3.3.9) settes lik kodeverdien som tilsvarer "Varsel", samt at varselmeldinger blir rapportert i attributtet "Suksesskode" evt. kombinert med attributtet "L-feilmeldingstekst" i de aktuelle objektene for Vaksinanden (avsnitt 3.3.14) og/eller Hendelsen (avsnitt 3.3.5) hvor "mistenkelige data" blir oppdaget. 4. Ved feil i Oppdateringsmeldingen, vil "Suksesskode" i objektet SYSVAK-melding (avsnitt 3.3.9) settes lik kodeverdien som tilsvarer "Feil", samt at feilmeldinger blir rapportert i attributtet "Suksesskode" evt. kombinert med attributtet "L-feilmeldingstekst" i de aktuelle objektene for Vaksinanden (avsnitt 3.3.14) og/eller Hendelsen (avsnitt 3.3.5) hvor feil blir oppdaget. Eksempler: 23
KAP. 3 DIM - DOMENE INFORMASJONSMODELL 3.3.11 SYSVOPPD (Oppdateringsmelding) Objektnavn: SYSVOPPD (Oppdateringsmelding) Hensikt: For opplysninger om en Oppdateringsmelding (SYSVOPPD) som brukes til overføring av opplysninger om en eller flere personer (Vaksinander), med eller uten vaksinasjonsdata (Hendelser). Kommentar: SYSVOPPD er en spesialisering av SYSVAK-melding. Objektene av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene som er definert i objektklassen SYSVAKmelding. Eksempler: 3.3.12 SYSVSPØR (Forespørselsmelding) Objektnavn: SYSVSPØR (Forespørselsmelding) Hensikt: For opplysninger om en Forespørselsmelding (SYSVSPØR) som brukes til å sende forespørsler om opplysninger om en eller flere personer (Vaksinander), med eller uten vaksinasjonsdata (Hendelser). Kommentar: SYSVSPØR er en spesialisering av SYSVAK-melding. Objektene av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene som er definert i objektklassen SYSVAKmelding. Eksempler: 3.3.13 SYSVSVAR (Svarmelding) Objektnavn: SYSVSVAR (Svarmelding) Hensikt: For opplysninger om en Svarmelding (SYSVSVAR) som brukes til å sende svar på en Forespørselsmelding (SYSVSPØR), om en eller flere personer (Vaksinander), med eller uten vaksinasjonsdata (Hendelser). Kommentar: SYSVSVAR er en spesialisering av SYSVAK-melding. Objektene av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene som er definert i objektklassen SYSVAKmelding. 24
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK Eksempler: 3.3.14 Vaksinand Objektnavn: Vaksinand Hensikt: For opplysninger om personen som en SYSVAK-melding handler om. Kommentar: Eksempler: Vaksinand Attributtnavn Kommentar Datatype aksjonskode For bruk i Oppdateringsmelding V (SYSVOPPD): kodeverdi som tilsvarer: = "Ny": Vaksinanden er (antatt) ny 8 ; = "Endring": opplysningene tilsendt skal oppdatere eksisterende opplysninger om Vaksinanden; eller = "Sletting": Vaksinanden skal slettes fra det sentrale SYSVAK-registeret. = "Uendret": Vaksinandopplysnignene er uendret. For å overføre tilhørende vaksinasjonsopplysninger eller endringer i disse. søkespesifikasjon For bruk i Forespørselsmelding (SYSVSPØR): kodeverdi som tilsvarer: = "Søk med vaksinasjonsdata": det ønskes tilsendt fra det sentrale SYSVAKregisteret alle vaksina- V 8 "Antatt ny": det kan hende at Vaksinanden allerede er registrert i det sentrale SYSVAKregisteret uten at meldeenheten vet om det. 25
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Vaksinand Attributtnavn Kommentar Datatype sjonsopplysninger og personopplysninger om den aktuelle Vaksinanden; eller = "Søk uten vaksinasjonsdata": det ønskes tilsendt fra det sentrale SYSVAKregisteret kun personopplysninger om den aktuelle vaksinanden. suksesskode For bruk i Svarmelding (SYSVSVAR): kodeverdi som tilsvarer: = "Funnet": Vaksinanden er funnet i det sentrale SYSVAK-registeret og opplysningene om denne er tilsendt; eller = "Ikke funnet": Vaksinanden er ikke registrert i det sentrale SYSVAK-registeret. V For bruk i Kvitteringsmelding (SYSVKVIT): kodeverdi som tilsvarer: = "OK": Vaksinanden er feilfritt håndtert av det sentrale SYSVAKregisteret; = "Nyere opplysninger finnes i sentralt register", det finnes nyere opplysninger om denne Vaksinanden i det sentrale SYSVAK-registeret enn de som er blitt rapportert i Oppdateringsmeldingen, det lokale SYSVAKregisteret bør hente over opplysningene ved å sende Forespørselsmelding til det sentrale SYSVAK-registeret; 26
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK Vaksinand Attributtnavn Kommentar Datatype = "Varsel": det sentrale SYSVAK-registeret fant "mistenkelige data" ved håndtering av denne Vaksinanden; eller = "Feil": det sentrale SYSVAK-registeret fant en eller flere feil ved håndtering av denne Vaksinanden. L-feilmeldingstekst Evt. nærmere beskrivelse av S varsel-/feilmeldingen. fødsels-/d-nummer 9 Det offisielle fødsels- eller D- nummer til Vaksinanden, i henhold til Folkeregisteret. V alternativ vaksinand ID 9 For personer som ikke får tildelt V fødsels- eller D-nummer (noe som er svært sjeldent), brukes dette feltet til SYSVAK-tildelt hjelpenummer som entydig identifikasjon av Vaksinanden. navn adresse og telekommunikasjonsnummer For oppdatering av ID-nr til Vaksinanden (f.eks. ved overgang fra D-nummer til fødselsnummer, fra hjelpenummer til D-/fødselsnummer, ved oppdatering av feilregistrert ID-nr, etc.), brukes feltet til det forrige ID-nummer. Navnet til vaksinanden, vha. attributtgruppen Personlig Navn (se avsnitt 3.4.2). Adresse til vaksinanden, vha. attributtgruppen Adresse CAG CAG 9 I en Oppdateringsmelding (SYSVOPPD) må enten "fødsels-/d-nummer" eller "alternativ vaksinand ID" fylles ut. Ved oppdatering av ID-nr må begge felter være fylt ut hvor "alternativ vaksinand ID" inneholder det forrige ID-nr som skal oppdateres til det nye IDnr som er i "fødsels-/d-nummer". Se KITH R 1/99 for "Rutiner og løsninger for å sikre entydig person- og hendelsesidentifikasjon i SYSVAK", ISBN 82-7846-056-6, som også er elektronisk tilgjengelig på http://www.kith.no/rapportarkiv/sysvak-nokkel-v10.pdf. 27
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Vaksinand Attributtnavn Kommentar Datatype (se avsnitt 3.4.1). fødselsdato Vaksinandens fødselsdato. CD kjønn Vaksinandens registrerte kjønn, med kodeverdi som tilsvarer: = "Mann", = "Kvinne", eller V L-supplerende personopplysninger institusjon som vanligvis benyttes = "Ukjent". Annen informasjon nødvendig for entydig identifisering av vaksinanden. Nummer eller navn til institusjonen (eks. helsestasjon) som vaksinanden vanligvis bruker. S S dato for ajourføring institusjon for siste ajourføring dødsdato Institusjonsnummer skal brukes såfremt dette er tilgjengelig. Dato når opplysningene om vaksinanden sist ble registrert/oppdatert, inklusiv førstegangs registrering. Nummer eller navn til institusjon som sist ajourførte opplysningene. Institusjonsnummer skal brukes såfremt dette er tilgjengelig. Dato for når en person er registrert død. Dødsdatoen oppdateres kun av det sentrale SYSVAKregisteret. Dersom en person er registrert død skal ikke person- eller vaksinasjonsopplysningene kunne endres i lokalt register. CD C/S CD 28
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK 3.3.15 Vaksinasjonsenhet Objektnavn: Vaksinasjonsenhet Hensikt: For opplysninger om en Vaksinasjonsenhet (f.eks. en helsestasjon) som er involvert i meldingsutvekslingen (f.eks. den som registrerer, rapporterer eller spør om en hendelse). Kommentar: Vaksinasjonsenhet er en spesialisering av Helsetjenesteenhet. Objektene av denne klassen har ingen spesifikk attributt, men bruker de generelle attributtene som er definert i objektklassen Helsetjenesteenhet. Eksempler: En Vaksinasjonsenhet kan være den enheten som rapporterer (ved hjelp av Oppdateringsmelding) eller spør om en vaksinand og eller hendelse (ved hjelp av en Forespørselsmelding). 3.4 Tekstlig beskrivelse av felles attributtgrupper 3.4.1 Adresse Adresse Attributtnavn Kommentar Datatype adressetype For Vaksinand: kodeverdi som tilsvarer "bostedsadresse". V For Helsetjenesteenhet: kodeverdi som tilsvarer "jobbadresse". ustrukturert gateadresse Gateadresse oppgitt som f.eks. S "Storgate 1B ". postnummer selvforklarende. V poststed selvforklarende. S bydelsnummer selvforklarende. V kommunenummer selvforklarende. V fylkesnummer selvforklarende. V land 10 selvforklarende. V 10 Attributtet brukes ikke i dagens SYSVAK, og heller ikke i første omgang i de nye meldingene. Attributtet er tatt med for fremtidige behov. 29
KAP. 3 DIM - DOMENE INFORMASJONSMODELL Adresse Attributtnavn Kommentar Datatype L-telekommunikasjon Telekommunikasjonsnummer AG bestående av følgende 2 attributter: > type tele- Eks.: telefon, telefaks, epost C kommunikasjons- nummer > telekommunikasjonsnummer selve nummeret. S 3.4.2 Personlig Navn Personlig Navn Attributtnavn Kommentar Datatype familienavn selvforklarende. S fornavn inkl. evt. mellomnavn. S ustrukturert navn Merknad: dette brukes isteden for S strukturerte navn når kommunikasjonspartnerne ikke støtter strukturerte navn. I noen tilfeller kan det også være vanskelig å bestemme hva som skal inn i hvilke elementer av et strukturert navn. 30
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK 4. GMD - generelle meldingsbeskrivelser Dette kapitlet inneholder generelle meldingsbeskrivelser, som beskriver SYSVAK-meldingene uavhengig av implementasjonsspråk/-syntaks. 4.1 Introduksjon GMD - Generell meldingsbeskrivelse Antall repetisjoner En SYSVAK-melding utvekslet mellom kommuniserende parter har en hensikt som vanligvis krever bare en begrenset del av den totale informasjonen i informasjonsmodellen beskrevet i kapittel 3. Noen objekter og attributter trengs ikke for en bestemt meldingstype. Disse vil derfor ikke forekomme i GMD (generell meldingsbeskrivelse - engelsk: General Message Description) for meldingen. Tilsvarende kan kardinalitetene i relasjonene mellom objekter i en gitt meldingsbeskrivelse være forskjellige fra kardinalitetene for de tilsvarende relasjonene i DIM. Denne informasjonsmodellen begrenser ikke antall repetisjoner av objekter, attributtgrupper og attributter 11. Konkrete implementeringer som setter begrensninger på antall repetisjoner skal derfor betraktes som å være i samsvar med denne informasjonsmodellen. For en hver meldingstype vil en GMD spesifisere objektene som inngår og deres relasjoner i forhold til den aktuelle meldingstypen. Følgende 4 generelle meldingsbeskrivelser (GMD) er definert i dette dokumentet: = SYSVOPPD - Oppdateringsmelding: Oppdatering av person- og vaksinasjonsopplysninger, fra et lokalt SYSVAK-register til det sentrale SYSVAK-registeret. = SYSVKVIT - Kvitteringsmelding: Kvittering på mottatt Oppdateringsmelding (SYSVKVIT), fra det sentrale SYSVAKregisteret til et lokalt SYSVAK-register. 11 Eksempel: Dette dokumentet beskriver ikke krav på hvor mange Vaksinander en SYSVAK-melding maksimalt kan handle om. 31
KAP. 4 GMD - GENERELLE MELDINGSBESKRIVELSER = SYSVSPØR - Forespørselsmelding: Forespørsel om personopplysninger med eller uten vaksinasjonsopplysninger, fra et lokalt SYSVAK-register til det sentrale SYSVAK-registeret. = SYSVSVAR - Svarmelding: Svar på forespørsel om personopplysninger med eller uten vaksinasjonsopplysninger, fra det sentrale SYSVAK-registeret til et lokalt SYSVAK-register. Grafisk og tekstlig beskrivelse Hver enkelt meldingsbeskrivelse består av et diagram som spesifiserer relasjoner mellom objektene i meldingen. Symbolene som brukes i diagrammene er de samme som de i DIM i kapittel 3. Tabellen i avsnitt 4.6 beskriver innholdet i de enkelte meldingstypene samt hvilke av attributtene skal være obligatoriske innen instanser av de enkelte meldingstypene. Tabellen indikerer også attributtene som er valgfrie og de som ikke er anvendbare/anvendt i de enkelte meldingstypene. 4.2 GMD - SYSVOPPD Oppdateringsmelding GMD for SYSVOPPD består av følgende komponenter som beskrives i andre avsnitt: = Avsender (jfr. avsnitt 3.3.3). = Helsetjenesteenhet (jfr. avsnitt 3.3.4). = Hendelse (jfr. avsnitt 3.3.5). = Mottaker (jfr. avsnitt 3.3.6). = Pårørende (jfr. avsnitt 3.3.7). = Sentralt SYSVAK-register (jfr. avsnitt 3.3.8). = SYSVAK-melding (jfr. avsnitt 3.3.9). = SYSVOPPD (Oppdateringsmelding, jfr. avsnitt 3.3.11). = Vaksinand (jfr. avsnitt 3.3.14). = Vaksinasjonsenhet (jfr. avsnitt 3.3.15) Viktigste budskaper av GMD for Oppdateringsmelding (SYSVOPPD) er: = Enhver Oppdateringsmelding skal inneholde opplysninger om minst én Vaksinand. = Til en Vaksinand kan det knyttes ingen eller flere hendelser. Dette betyr at det er mulig å sende denne type meldinger for oppdatering av personopplysninger i det sentrale SYSVAKregisteret, uten å måtte ta med vaksinasjonsdata. = Til enhver Vaksinand som er rapportert i en Oppdateringsmelding, skal det alltid knyttes minst én Helsetjenesteenhet. 32
INFORMASJONSMODELL FOR EDI-MELDINGER I SYSVAK = Til enhver Hendelse som er rapportert i en Oppdateringsmelding, skal det alltid knyttes minst én Helsetjenesteenhet. Figur 4: GMD - SYSVOPPD - Oppdateringsmelding 1 Vaksinasjonsenhet 1 Sentralt SYSVAK-register Avsender * Oppdateringsmelding (SYSVOPPD) 0..1 SYSVAK-melding Vaksinand Helsetjenesteenhet 1 0..1 Pårørende 0..* Hendelse A 0..1 B A er assosiert med maksimalt én B A 1 B A er assosiert med én og bare én B A B A er assosiert med minst én B A * B A er assosiert med ubegrenset antall B A B A er en spesialisering av B 4.3 GMD - SYSVKVIT Kvitteringsmeldinger GMD for SYSVKVIT består av følgende komponenter som beskrives i andre avsnitt: = Helsetjenesteenhet (jfr. avsnitt 3.3.4). = Hendelse (jfr. avsnitt 3.3.5). = Mottaker (jfr. avsnitt 3.3.6). = Sentralt SYSVAK-register (Jfr. avsnitt 3.3.8). = SYSVAK-melding (jfr. avsnitt 3.3.9). = SYSVKVIT (Kvitteringsmelding, jfr. avsnitt 3.3.10). = SYSVOPPD (Oppdateringsmelding, jfr. avsnitt 3.3.11). = Vaksinand (jfr. avsnitt 3.3.14). = Vaksinasjonsenhet (jfr. avsnitt 3.3.15). 33
KAP. 4 GMD - GENERELLE MELDINGSBESKRIVELSER Figur 5: GMD - SYSVKVIT - Kvitteringsmelding Vaksinasjonsenhet 1 Helsetjenesteenhet Sentralt SYSVAK-register 1 Mottaker 0..1 * Kvitteringsmelding (SYSVKVIT) SYSVAK-melding Vaksinand 1 1 Oppdateringsmelding (SYSVOPPD) 1 0..* Hendelse A 0..1 B A er assosiert med maksimalt én B A 1 B A er assosiert med én og bare én B A B A er assosiert med minst én B A * B A er assosiert med ubegrenset antall B A B A er en spesialisering av B Viktigste budskaper av GMD for Kvitteringsmelding (SYSVKVIT) er: = Det skal alltid være én og bare én Kvitteringsmelding (SYSVKVIT) for enhver mottatt Oppdateringsmelding (SYSVOPPD). = Enhver Kvitteringsmelding (SYSVKVIT) skal handle om minst én Vaksinand, selv også når hele den mottatte Oppdateringsmeldingen (SYSVOPPD) som det kvitteres for er godkjent og feilfri. Mottagende system kan ignorere Vaksinand-opplysningene sendt i Kvitteringsmeldingen bare når det kvitteres for feilfri mottagelse av tilsvarende Oppdateringsmelding. = Til enhver Vaksinand som er omhandlet i en Kvitteringsmelding (SYSVKVIT) skal det alltid være minst én Hendelse, selv også når alle Hendelsene om Vaksinanden er godkjent/feilfrie. Mottagende system kan ignorere Hendelsesopplysningene sendt i Kvitteringsmeldingen bare når det kvitteres for feilfri mottagelse av tilsvarende Oppdateringsmelding. 34