folkehelseinstitutt XML-import Filformat Forfatter: Roar Andersen Godkjent av: - 1 av 1 ENDRINGSOVERSIKT... 3 2 INTRODUKSJON... 4 2.1 IMPORTFILEN... 4 3 INFEKSJONSREGISTRERING FOR SPESIALISTHELSETJENESTEN... 5 3.1 EKSEMPEL... 5 3.2 ELEMENT: INFEKSJONERSI... 5 3.3 ELEMENT: METADATA... 6 3.4 ELEMENT: INSTITUSJON... 6 3.5 ELEMENT: TIDSPUNKTGENERERT... 6 3.6 ELEMENT: GENERERTAVPROGRAMVARE... 7 3.7 ELEMENT: NAVN... 7 3.8 ELEMENT: VERSJON... 7 3.9 ELEMENT: KLIENTID... 8 3.10 ELEMENT: REGISTRERING... 8 3.11 ELEMENT: SPESIALITETKODE... 8 3.12 ELEMENT: AVDELINGSNAVN... 9 3.13 ELEMENT: ANTALLPASIENTER... 9 3.14 ELEMENT: ANTALLPASIENTERMEDINFEKSJON... 9 3.15 ELEMENT: ANTALLPASIENTEROPERERT... 9 3.16 ELEMENT: ANTALLURINVEISINFEKSJONER... 10 3.17 ELEMENT: ANTALLURINVEISINFEKSJONER... 10 3.18 ELEMENT: ANTALLNEDRELUFTVEISINFEKSJONER... 11 3.19 ELEMENT: ANTALLOVERFLATISKEPOSTOPSARINFEKSJONER... 11 3.20 ELEMENT: ANTALLDYPEPOSTOPSARINFEKSJONER... 12 3.21 ELEMENT: ANTALLPOSTOPINFEKSJONERINDREORGANHULROM... 12 3.22 ELEMENT: ANTALLPRIMAREBLODBANEINFEKSJONER... 12 3. ELEMENT: ANTALLSEKUNDAREBLODBANEINFEKSJONER... 13 3.24 ELEMENT: ANTALLINFEKSJONERBENLEDD... 13 3.25 ELEMENT: ANTALLINFEKSJONERSENTRALNERVESYSTEMET... 14 3.26 ELEMENT: ANTALLINFEKSJONERHJERTEKAR... 14 3.27 ELEMENT: ANTALLINFEKSJONERMAGETARM... 15 3.28 ELEMENT: ANTALLINFEKSJONERKJONNSORGANENE... 15 3.29 ELEMENT: ANTALLINFEKSJONEROYEORENESEHALSMUNN... 16 3.30 ELEMENT: ANTALLINFEKSJONERHUDBLOTVEV... 16 3.31 ELEMENT: ANTALLINFEKSJONERANDREDISSEMINERTE... 17 4 KODEVERK... 18 4.1 SPESIALITETER... 18
2 av 5 VALIDERINGSREGLER... 20 6 XML-SKJEMA... 22
3 av 1 Endringsoversikt Versjon Dato Av Beskrivelse 0.7 20150220 Morgan Kauppi Første versjon 0.8 20150316 Cathrine Slorbak Review og korrigeringer etter diskusjon med Gero. 0.9 20150325 Roar Andersen Skrev om slik at denne dokumenterer formatet på xml-filen som skal benyttes ved import.
4 av 2 Introduksjon Dette dokumentet er å beskrive filformatet som benyttes ved XML-import i. Dokumentet er beregnet på teknisk personell som skal utvikle integrasjon med. Hensikten er å beskrive formatet i tilstrekkelig detalj for å gjøre leseren i stand til å generere en gyldig fil for opplastning. Det forventes kjennskap til XML og XSD. 2.1 Importfilen XML-filens skal benytte character encodingen «UTF8 no BOM» (UCS Transformation Format 8- bit, no Byte Order Mark). Dette er det mest vanlige formatet som benyttes av XML-genererende applikasjoner. Maksimal filstørrelse er 5mb.
5 av 3 Infeksjonsregistrering for spesialisthelsetjenesten 3.1 Eksempel Følgende er et eksempel på en gyldig XML-fil: 3.2 Element: infeksjonersi Dette er rot-elementet i xml-filen.
6 av Navn Beskrivelse Obligatorisk schemaversionmajor Hovedversjonsnummer. Versjonsnummeret Ja Heltall angir hvilken versjon av XML-skjemaet som er benyttet. Hovedversjonsnummeret blir hardkodet av XML-skjemaet. schemaversionminor Underversjonsnummer Ja Heltall 3.3 Element: metadata Dette er rot-elementet til metadataene. Metadataene benyttes kun til logging og feilsøking. Disse vil ikke benyttes til import i vår database. <metadata> </metadata> 3.4 Element: institusjon Elementet skal inneholde navnet på institusjonen som importerer data. Dette elementet brukes kun til logging og feilsøking. Verdien blir ikke importert i databasen. <metadata> <institusjon> </institusjon> </metadata> Tekststreng: 1-512 karakterer 3.5 Element: tidspunktgenerert Elementet skal inneholde tidspunktet filen ble generert. Dette elementet brukes kun til logging og feilsøking. Verdien blir ikke importert i databasen. <metadata> <tidspunktgenerert> </tidspunktgenerert> </metadata>
7 av xs:datetime 3.6 Element: generertavprogramvare Elementet inneholder elementer som beskriver hvilken programvare som institusjonen har benyttet for å generere XML-filen. Dette elementet brukes kun til logging og feilsøking. Verdien blir ikke importert i databasen. <metadata> <generertavprogramvare> </generertavprogramvare > </metadata> 3.7 Element: navn Elementet inneholder navnet på programvaren som institusjonen har benyttet for å generere XML-filen. Dette elementet brukes kun til logging og feilsøking. Verdien blir ikke importert i databasen. <metadata> <generertavprogramvare> <navn> </navn> </generertavprogramvare > </metadata> Tekststreng: 1-512 karakterer 3.8 Element: versjon Elementet inneholder versjonsnummeret til programvaren som institusjonen har benyttet for å generere XML-filen. Dette elementet brukes kun til logging og feilsøking. Verdien blir ikke importert i databasen. <metadata> <generertavprogramvare> < versjon> </ versjon> </generertavprogramvare > </metadata>
8 av Tekststreng: 1-512 karakterer 3.9 Element: klientid Frivillig element som kan benyttes til å angi en ID fra klienten (programvaren som genererer xml-filen). Dette elementet brukes kun til logging og feilsøking. Verdien blir ikke importert i databasen. <metadata> < klientid> </ klientid> </metadata> Tekststreng: 1-512 karakterer 3.10 Element: registrering Dette er rot-elementet for en registrering. Alle elementene under denne beskriver innholdet i en registrering. Kardinalitet [1..] 3.11 Element: spesialitetkode Elementet skal inneholde en gyldig kode fra kodeverket Spesialiteter (se kapittel 4.1). <spesialitetkode> </spesialitetkode>
9 av Tekststreng: 1-38 karakterer 3.12 Element: avdelingsnavn Elementet skal inneholde navnet på avdelingen som registreringen er fra. < avdelingsnavn> </ avdelingsnavn> Tekststreng: 1-255 karakterer 3.13 Element: antallpasienter Elementet skal inneholde antall innlagte pasienter kl 08:00 på prevalenstidspunktet. <antallpasienter> </antallpasienter> Heltall: 0..9999 3.14 Element: antallpasientermedinfeksjon Elementet skal inneholde antall innlagte pasienter med HAI på prevalenstidspunktet. <antallpasientermedinfeksjon> </antallpasientermedinfeksjon> Heltall: 0..9999 3.15 Element: antallpasienteroperert Elementet skal inneholde antall innlagte pasienter operert på prevalenstidspunktet.
10 av <antallpasienteroperert> </antallpasienteroperert> Heltall: 0..9999 3.16 Element: antallurinveisinfeksjoner Elementet skal inneholde antall urinveisinfeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. <antallurinveisinfeksjoner> </antallurinveisinfeksjoner> Navn Beskrivelse Obligatorisk 3.17 Element: antallurinveisinfeksjoner Elementet skal inneholde antall urinveisinfeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. <antallurinveisinfeksjoner> </antallurinveisinfeksjoner>
11 av Navn Beskrivelse Obligatorisk 3.18 Element: antallnedreluftveisinfeksjoner Elementet skal inneholde antall nedre luftveisinfeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antallnedreluftveisinfeksjoner> </ antallnedreluftveisinfeksjoner> Navn Beskrivelse Obligatorisk 3.19 Element: antalloverflatiskepostopsarinfeksjoner Elementet skal inneholde antall overflatiske postoperative sårinfeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antalloverflatiskepostopsarinfeksjoner > </ antalloverflatiskepostopsarinfeksjoner > Navn Beskrivelse Obligatorisk
12 av 3.20 Element: antalldypepostopsarinfeksjoner Elementet skal inneholde antall dype postoperative sårinfeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antalldypepostopsarinfeksjoner > </ antalldypepostopsarinfeksjoner > Navn Beskrivelse Obligatorisk 3.21 Element: antallpostopinfeksjonerindreorganhulrom Elementet skal inneholde antall postoperative infeksjoner i indre organ/hulrom på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antallpostopinfeksjonerindreorganhulrom > </ antallpostopinfeksjonerindreorganhulrom > Navn Beskrivelse Obligatorisk 3.22 Element: antallprimareblodbaneinfeksjoner Elementet skal inneholde antall primære blodbaneinfeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen.
13 av < antallprimareblodbaneinfeksjoner > </ antallprimareblodbaneinfeksjoner > Navn Beskrivelse Obligatorisk 3. Element: antallsekundareblodbaneinfeksjoner Elementet skal inneholde antall sekundære blodbaneinfeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antallsekundareblodbaneinfeksjoner > </ antallsekundareblodbaneinfeksjoner > Navn Beskrivelse Obligatorisk 3.24 Element: antallinfeksjonerbenledd Elementet skal inneholde antall infeksjoner i ben og ledd på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen.
14 av < antallinfeksjonerbenledd > </ antallinfeksjonerbenledd > Navn Beskrivelse Obligatorisk 3.25 Element: antallinfeksjonersentralnervesystemet Elementet skal inneholde antall infeksjoner i sentralnervesystemet på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antallinfeksjonersentralnervesystemet > </ antallinfeksjonersentralnervesystemet > Navn Beskrivelse Obligatorisk 3.26 Element: antallinfeksjonerhjertekar Elementet skal inneholde antall infeksjoner i hjerte/kar systemet på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen.
15 av < antallinfeksjonerhjertekar > </ antallinfeksjonerhjertekar > Navn Beskrivelse Obligatorisk 3.27 Element: antallinfeksjonermagetarm Elementet skal inneholde antall infeksjoner i mage/tarm systemet på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antallinfeksjonermagetarm > </ antallinfeksjonermagetarm > Navn Beskrivelse Obligatorisk 3.28 Element: antallinfeksjonerkjonnsorganene Elementet skal inneholde antall infeksjoner i kjønnsorganene på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen.
16 av < antallinfeksjonerkjonnsorganene > </ antallinfeksjonerkjonnsorganene > Navn Beskrivelse Obligatorisk 3.29 Element: antallinfeksjoneroyeorenesehalsmunn Elementet skal inneholde antall infeksjoner i øye,øre,nese,hals eller munn på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antallinfeksjoneroyeorenesehalsmunn > </ antallinfeksjoneroyeorenesehalsmunn > Navn Beskrivelse Obligatorisk 3.30 Element: antallinfeksjonerhudblotvev Elementet skal inneholde antall infeksjoner i hud- og bløtvev på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen.
17 av < antallinfeksjonerhudblotvev > </ antallinfeksjonerhudblotvev > Navn Beskrivelse Obligatorisk 3.31 Element: antallinfeksjonerandredisseminerte Elementet skal inneholde antall andre / disseminerte infeksjoner på prevalenstidspunktet. Antallet er fordelt på 3 attributter som angir opphavet til infeksjonen. < antallinfeksjonerandredisseminerte > </ antallinfeksjonerandredisseminerte > Navn Beskrivelse Obligatorisk
18 av 4 Kodeverk 4.1 Spesialiteter Kode S02 S0201 S0202 S0203 S0204 S0205 S0206 S0207 S0208 S0209 S0210 S0211 S03 S0301 S0302 S0303 S0304 S0305 S0306 S0307 S0308 S0309 S04 S0401 S0402 S0403 S05 S06 S0601 S0602 S07 S0701 S0702 S0703 S09 S10 S11 S12 S16 A02 K A03/A04 Beskrivelse Kirurgi Generell kirurgi Barnekirurgi Endokrin kirurgi Gastroenterologisk kirurgi Karkirurgi Kjeve- og ansiktskirurgi Nevrokirurgi Ortopedisk kirurgi Plastikkirurgi Thoraxkirurgi Urologi Indremedisin Endokrinologi og metabolisme Fordøyelsessykdommer Geriatri Hematologi (blodsykdommer) Infeksjonsmedisin Hjertesykdommer Lungesykdommer Nyresykdommer Dialyse Fødselshjelp og kvinnesykdommer Generell gynekologi Gynekologisk onkologi Obstetrikk Hud- og veneriske sykdommer Barnesykdommer Nyfødtmedisin Barneintensiv Nevrologi Generell nevrologi Cerebrovaskulære sykdommer Epilepsi Øre-nese-hals Øyesykdommer Onkologi Revmatologi Fysikalsk medisin/rehabilitering Observasjon Kirurgisk intensiv / overvåking
19 av M A03/A04 Medisinsk intensiv / overvåking A06 Akuttmottak 100 Annet/ukjent
20 av 5 Valideringsregler Følgende valideringer er påkrevd for at registreringen skal være gyldig. Felt Valideringsregel Feilmelding som oppgis i fagapplikasjonen Antall innlagte pasienter Om «Antall innlagte pasienter kl 08:00» = 0, Antall innlagte pasienter kl. kl 08:00 Antall innlagte pasienter med HAI Antall innlagte pasienter med HAI Antall innlagte pasienter med HAI Antall innlagte pasienter som er operert Antall innlagte pasienter som er operert kan ingen av de andre feltene være <> 0. Om «Antall innlagte pasienter med HAI» = 0, kan ingen av infeksjonsregistreringene være <> 0 «Antall innlagte pasienter med HAI» <= «Antall innskrevne pasienter kl 08:00» Summen av antall infeksjoner som registreres må være >= «Antall innlagte pasienter med HAI». «Antall innlagte pasienter som er operert» <= «Antall innskrevne pasienter kl 08:00» Om «Antall innlagte pasienter som er operert» = 0 må: «Antall dype postoperative sårinfeksjoner» = 0 og Antall overflatiske postoperative sårinfeksjoner = 0 og Antall postoperative infeksjoner i organ/hulrom = 0 08:00 må registreres Antall innlagte pasienter med HAI må registreres Antall innlagte pasienter med HAI > antall innlagte pasienter kl. 08:00 Antall innlagte pasienter med HAI >summen av antall infeksjoner registrert Antall innlagte pasienter som er > antall innlagte pasienter kl. 08:00 Antall innlagte pasienter som er operert må registreres Antall urinveisinfeksjoner Antall nedre luftveisinfeksjoner Antall dype postoperative sårinfeksjoner Antall overflatiske postoperative sårinfeksjoner Antall postoperative infeksjoner i organ/hulrom Antall primære blodbaneinfeksjoner Summen av «Antall urinveisinfeksjoner» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Summen av «Antall nedre luftveisinfeksjoner» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Ingen øvrig validering. Ingen øvrig validering. Ingen øvrig validering. Summen av «Antall primære blodbaneinfeksjoner» for «Eget sykehus», Antall urinveisinfeksjoner > antall innlagte pasienter med HAI Antall nedre luftveisinfeksjoner > antall innlagte pasienter med HAI Antall primære blodbaneinfeksjoner> antall
Antall sekundære blodbaneinfeksjoner Antall blodbaneinfeksjoner totalt Antall infeksjoner i ben og ledd Antall infeksjoner i sentralnervesystemet Antall infeksjoner i hjerte/kar systemet Antall infeksjoner i mage/tarm systemet Antall infeksjoner i kjønnsorganene Antall infeksjoner i øye, øre, nese, hals eller munn Antall infeksjoner i hudog bløtvev Antall andre/ disseminerte infeksjoner «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Summen av «Antall sekundære blodbaneinfeksjoner» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Summen av «Antall primære blodbaneinfeksjoner» og «Antall sekundære blodbaneinfeksjoner» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Ingen øvrig validering. Summen av «Antall infeksjoner i sentralnervesystemet» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Summen av «Antall infeksjoner i hjerte/kar systemet» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Summen av «Antall infeksjoner i mage/tarm systemet» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Summen av «Antall infeksjoner i kjønnsorganene» for «Eget sykehus», «Annet sykehus» og «Annet sykehjem» må være <= «Antall innlagte pasienter med HAI». Ingen øvrig validering. Ingen øvrig validering. Ingen øvrig validering. 21 av innlagte pasienter med HAI Antall sekundære blodbaneinfeksjoner > innlagte pasienter med HAI Antall blodbaneinfeksjoner (primære + sekundære) > antall innlagte pasienter med HAI Antall infeksjoner i sentralnervesystemet > antall innlagte pasienter med HAI Antall infeksjoner i hjerte/karsystemet > antall innlagte pasienter med HAI Antall infeksjoner i mage/tarm systemet > antall innlagte pasienter med HAI Antall infeksjoner i kjønnsorganene > antall innlagte pasienter med HAI
22 av 6 XML-skjema <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/xmlschema" xmlns="http://fhi.no/nois-piah/import" targetnamespace="http://fhi.no/nois-piah/import" elementformdefault="qualified" attributeformdefault="unqualified" version="1.0"> <xs:simpletype name="antallinfeksjoner"> <xs:restriction base="xs:int"> <xs:mininclusive value="0"/> <xs:maxexclusive value="10000"/> </xs:restriction> </xs:simpletype> <xs:simpletype name="antallpasienter"> <xs:restriction base="xs:int"> <xs:mininclusive value="0"/> <xs:maxexclusive value="10000"/> </xs:restriction> </xs:simpletype> <xs:simpletype name="kodeverkkode"> <xs:restriction base="xs:string"> <xs:minlength value="1"/> <xs:maxlength value="38"/> </xs:restriction> </xs:simpletype> <xs:simpletype name="navn"> <xs:restriction base="xs:string"> <xs:minlength value="1"/> <xs:maxlength value="255"/> </xs:restriction> </xs:simpletype> <xs:attributegroup name="antallinfeksjonerattributegroup"> <xs:attribute name="egeninstitusjon" type="antallinfeksjoner" use="required"/> <xs:attribute name="annetsykehus" type="antallinfeksjoner" use="required"/> <xs:attribute name="annetsykehjem" type="antallinfeksjoner" use="required"/> </xs:attributegroup> <xs:complextype name="antallinfeksjonerelement"> <xs:attributegroup ref="antallinfeksjonerattributegroup"/> </xs:complextype> <xs:complextype name="registrering"> <xs:sequence> <xs:element name="spesialitetkode" type="kodeverkkode"/> <xs:element name="avdelingsnavn" type="navn"/> <xs:element name="antallpasienter" type="antallpasienter"/> <xs:element name="antallpasientermedinfeksjon" type="antallpasienter"/> <xs:element name="antallpasienteroperert" type="antallpasienter"/> <xs:element name="antallurinveisinfeksjoner" type="antallinfeksjonerelement"/> <xs:element name="antallnedreluftveisinfeksjoner" type="antallinfeksjonerelement"/> <xs:element name="antalloverflatiskepostopsarinfeksjoner" type="antallinfeksjonerelement"/> <xs:element name="antalldypepostopsarinfeksjoner" type="antallinfeksjonerelement"/> <xs:element name="antallpostopinfeksjonerindreorganhulrom" type="antallinfeksjonerelement"/> <xs:element name="antallprimareblodbaneinfeksjoner" type="antallinfeksjonerelement"/> <xs:element name="antallsekundareblodbaneinfeksjoner" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjonerbenledd" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjonersentralnervesystemet" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjonerhjertekar" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjonermagetarm" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjonerkjonnsorganene" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjoneroyeorenesehalsmunn" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjonerhudblotvev" type="antallinfeksjonerelement"/> <xs:element name="antallinfeksjonerandredisseminerte" type="antallinfeksjonerelement"/> </xs:sequence> </xs:complextype> <xs:simpletype name="metadatastring"> <xs:restriction base="xs:string"> <xs:minlength value="1"/> <xs:maxlength value="512"/>
av </xs:restriction> </xs:simpletype> <xs:complextype name="generertavprogramvare"> <xs:sequence> <xs:element name="navn" type="metadatastring"/> <xs:element name="versjon" type="metadatastring" ></xs:element> </xs:sequence> </xs:complextype> <xs:complextype name="metadata"> <xs:sequence> <xs:element name="institusjon" type="metadatastring"/> <xs:element name="tidspunktgenerert" type="xs:datetime"/> <xs:element name="generertavprogramvare" type="generertavprogramvare"/> <xs:element name="klientid" type="metadatastring" minoccurs="0"/> </xs:sequence> </xs:complextype> <xs:element name="infeksjonersi"> <xs:complextype> <xs:sequence> <xs:element name="metadata" type="metadata" minoccurs="1" /> <xs:element name="registrering" type="registrering" minoccurs="1" maxoccurs="unbounded"/> </xs:sequence> <xs:attribute name="schemaversionmajor" type="xs:integer" use="required" fixed="1"/> <xs:attribute name="schemaversionminor" type="xs:integer" default="0"/> </xs:complextype> </xs:element> </xs:schema>