Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem

Transkript

1 for Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Versjon 1.1 KITH Rapport 28/02 ISBN

2

3 KITH-rapport TITTEL for: Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Forfatter(e): Torbjørn Nystadnes Oppdragsgiver(e) Sosial og helsedirektoratet / Standardiserings- og samordningsprogrammet Kompetansesenter for IT i helsevesenet AS Postadresse Sukkerhuset NO-7489 Trondheim Besøksaddresse Sverresgt 15 Telefon Telefaks e-post firmapost@kith.no Rapportnr. R 28/02 URL Foretaksnummer Prosjektnr. ISBN Dato Antall sider Kvalitetssikret av Gradering Iver Nordhuus Åpen Godkjent av: Jacob Hygen, Direktør Sammendrag Denne kravspesifikasjonen beskriver et IT-verktøy som er ment å gi mulighet for effektiv og sikker håndtering av begreper, kodeverk og klassifikasjonssystemer til bruk innenfor helsevesenet. Dette verktøyet skal både kunne benyttes til sentral utvikling, vedlikehold og distribusjon av begrepssamlinger, kodeverk og klassifikasjonssystemer, og av virksomheter innenfor helsevesenet for import av sentrale kodeverk og klassifikasjonssystemer samt vedlikehold av lokale kodeverk. en består av tre hoveddeler: 1. En detaljert informasjonsmodell 2. Et sett av funksjonelle krav 3. Krav til programmeringsgrensesnitt. Den informasjonsmodell som er beskrevet er ment å være så generell at verktøyet med små tilpassinger også bør kunne benyttes til andre formål hvor strukturert informasjon skal knyttes opp mot begreper og/eller koder. Det verktøyet som beskrives er primært beregnet for utvikling og vedlikehold av kodeverk og klassifikasjonssystemer, men det skal også gi mulighet for arbeid med begreper som det (ennå) ikke er knyttet noen kode opp mot.

4

5 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 5 av 80 Innholdsfortegnelse Innledning Overordnet systembeskrivelse Anvendelse av systemet Arkitektur Krav til teknisk utforming Krav til sikkerhet Datamodell Kort introduksjon til datamodellene Klasser, assosiasjoner og kardinaliteter Aggregeringer Generaliseringer og spesialiseringer Abstrakte klasser Spesielt om diagrammene i denne kravspesifikasjonen Begrepsdatabasen Hovedstruktur for kodeverk Publikasjon Kodeverk (KVERK) Kodeverksnode (KVNODE) Kodeverksstruktur (KVSTRUKT) Kodeverkselement (KVELEMENT) Publikasjonsrevisjon (KVREV) Koblinger mellom kodeverk Kodelink (KVLINK) Anvendt Kodeverkselement (KVANVEND) Tilknytning av termer, begrep og begrepsdefinisjoner til kodeverkselement Term (KVTERM) Element-Term (KVELEMTERM) Termlink (KVTERMLINK) Tilleggsinformasjon for kodeverk Kodenodeinfo (KVNINFO) Kodenodeinfo link (KVNINFOLINK) Kodeformat (KVKFORMAT) KITH

6 Side 6 av 80 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem 2.7. Begreper Begrepssamling (BEGREPSAM) Begrep (BEGREP) Begrepsrevisjon (BEGREV) Inkludert begrep (BDINKBE) Begrepsdefinisjon BDBDEF) Begrep-Term (BEGTERM) Begrepsrelasjon (BDBREL) Begrepsinfo (BEGINFO) Begrepsinfo link (BEGINFOLINK) Personer og organisatoriske enheter Person (BDPERSON) Organisatorisk enhet (BDORGENH) Organisasjonsstruktur (BDORGSTRUK) Tjenesteyter (BDTJYTER) Redigeringstilgang (BDREDTIL) Utveksling og eksportformater Komplett XML-basert eksport Eksport- og avleveringsformat Format for eksport av klasseinformasjon Eksempel på eksportert fil Funksjonelle krav Overordnede krav Generelle krav til registreringsfunksjoner Generelle krav til søking og framvising Krav til brukergrensesnitt Begrepsorientert Kodeverksorientert Programmeringsgrensesnitt (API) Funksjoner Refererte kodeverk...78 KITH 2002

7 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 7 av 80 Innledning Denne kravspesifikasjonen beskriver et IT-verktøy som er ment å gi mulighet for effektiv og sikker håndtering av begreper, kodeverk og klassifikasjonssystemer til bruk innenfor helsevesenet. Dette verktøyet skal ha to bruksområder: 1. Det skal kunne benyttes til sentral utvikling, vedlikehold og distribusjon av begrepssamlinger, kodeverk og klassifikasjonssystemer. 2. Det skal kunne benyttes av virksomheter innenfor helsevesenet for import av sentrale kodeverk og klassifikasjonssystemer samt vedlikehold av lokale kodeverk. Verktøyet skal her gi mulighet for integrasjon med EPJ-systemer og andre IT-systemer. Den informasjonsmodell som er beskrevet er imidlertid så generell at verktøyet med små tilpassinger også bør kunne benyttes til andre formål hvor strukturert informasjon skal knyttes opp mot begreper og/eller koder. Det verktøyet som beskrives er primært beregnet for utvikling og vedlikehold av kodeverk og klassifikasjonssystemer, men det skal også gi mulighet for arbeid med begreper som det (ennå) ikke er knyttet noen kode opp mot. Det kan være stor variasjon i kompleksiteten når det gjelder kodeverk og klassifikasjonssystemer. Her inngår alt fra enkle kodelister til store multiaksiale klassifikasjonssystemer med komplekse strukturer. For å kunne håndtere dette, er det utviklet en generell informasjonsmodell, se kapittel 2, som er ment å skulle kunne benyttes for alle typer kodeverk og klassifikasjonssystemer, uavhengig av kompleksiteten. I denne kravspesifikasjonen er det derfor ikke nødvendig å skille mellom kodeverk og klassifikasjonssystemer. For enkelhets skyld er derfor termen kodeverk ofte benyttet som en fellesbetegnelse for kodeverk og for klassifikasjonssystem. I tillegg til å gi mulighet for å arbeide med det enkelte kodeverk, skal verktøyet også gi mulighet til å ta utgangspunkt i selve begrepsapparatet og arbeide med de enkelte begrep, uavhengig av hvilke kodeverk de eventuelt måtte være referert fra. For å kunne organisere arbeidet med begrepsapparatet på en effektiv måte, stilles det krav om at skal det kunne opprettes begrepssamlinger bestående av et utvalg begreper med tilhørende definisjoner. Med utgangspunkt i en slik begrepssamling, skal en kunne arbeide med de begrep som allerede inngår i samlingen, legge til nye begrep, nye definisjoner og nye relasjoner mellom begreper. Relasjoner mellom begrep og koder i kodeverk skal kunne opprettes både med utgangspunkt i begrepene og i kodene i de enkelte kodeverk. For å ha et felles forankringspunkt når det gjelder administrasjon av kodeverk og begrepssamlinger, er termen publikasjon tatt i bruk som en fellesbetegnelse for kodeverk og begrepssamlinger. Til en publikasjon skal det kunne knyttes en ansvarlig utgiver og en ansvarlig redaktør, og personer skal kunne tildeles forskjellige former for redigeringsrett innenfor en publikasjon KITH

8 Side 8 av 80 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Figur 1 er et forsøk på å illustrere sammenhengen mellom en del av de sentrale begreper som benyttes i denne kravspesifikasjonen. Begrep* Rainbow Regnbue Arc de ciel * tankemessig enhet dannet ved abstraksjon på grunnlag av egenskaper felles for en eller flere referenter [ISO CD ] Term Referent Ankomst fra 01 Vanlig bosted 02 Skade- eller funnsted 03 Annen institusjon 04 Poliklinikk, egen inst. 06 Annet 09 Annen somatisk avd. Kodeverk En samling koder med tilhørende termer som hver i dentifiserer ett begrep Definisjon Begrepssamling En samling begrepsdefinisjoner knyttet til termer uttrykt i naturlig språk Figur 1. Begrepstetraederet Et Begrep er i følge ISO en "tankemessig enhet dannet ved abstraksjon på grunnlag av egenskaper til en eller flere referenter". (Merk at denne definisjonen også dekker sammensatte begreper.) I begrepsdatabasen representeres et begrep en unik identifikator, et begreps-id. Ethvert begrep vil ha en Definisjon, selv om denne ikke alltid vil foreligge for de begreper som inngår i et kodeverk. I en del tilfeller kan det også være aktuelt å uttrykke definisjonen på flere måter, f.eks. rettet mot forskjellige målgrupper. En Term er en verbal representasjon av begrepet, ofte beregnet til bruk innenfor en avgrenset område. (Merk at i et kodeverk så vil både en kode og den tekst som benyttes for å beskrive kodens betydning, formelt sett være å betrakte som termer. I denne kravspesifikasjonen benyttes imidlertid Term kun for termer i naturlig språk. Et Kodeverk er en avgrenset samling koder med tilhørende termer uttrykt i naturlig språk som hver identifiserer ett begrep innenfor et funksjonsområde. (Det stilles imidlertid ikke krav om at begrepet med tilhørende definisjon skal være registrert i begrepsdatabasen.) KITH 2002

9 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 9 av 80 En Begrepssamling er en samling begrepsdefinisjoner knyttet til termer uttrykt i naturlig språk. Til de enkelte begrep kan det også være tilknyttet koder tilhørende et eller flere kodeverk. Merk at selv om det i begrepsdatabasen skal skilles klart mellom begreper, begrepsdefinisjoner, termer og koder, så skal ikke dette være til hinder for at en i brukergrensesnittet kan arbeide samlet med alt som er knyttet til et begrep. For å sikre at dette blir mulig, stilles det eksplisitte krav om dette i kapittel KITH

10 Side 10 av 80 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem 1. Overordnet systembeskrivelse Anvendelse av systemet Figur 2 beskriver vha UML Use-Case hvilke aktører som har relasjoner til systemet og hvilken type handling det er snakk om. Redaktør Motta kodeverksmelding Redigering Produser kodeverksmelding BeKK Annen kodedatabase Import Søk, navigering, etc. API Eksport evt. konvertering Annen kodedatabase, virksomhet I helsevesenet eller arkivdepot Rådata Statistikkdata etc EPJ-system etc. Eksport Helseregister Helsepersonell Anvendt IT Figur 2. Aktører og prosesser i tilknytning til verktøyet Figurens aktører beskrives under hver Use-Case nedenfor. Import Verktøyet skal kunne importere begrepssamlinger, kodeverk og klassifikasjonssystemer fra kilder som kan levere data på et av de eksportformatene som er beskrevet i kapittel 3. Kildene kan enten være andre virksomheter som benytter samme verktøy, eller det kan være andre kilder som kan produsere et av de nevnte formatene. Eksport Verktøyet skal kunne eksportere begrepssamlinger, kodeverk og klassifikasjonssystemer på flere formater. Dette skal inkluderer både mulighet for komplette uttrekk med alle registrerte data og enklere uttrekk hvor kun avgrensede deler av informasjonen tas med. Et eksempel på det siste kan være rene kodelister KITH 2002

11 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 11 av 80 bestående av en linje for hver kode og <tab> som skille mellom koden og den tilknyttede termen. En annen bruk av eksport kan være for å overføre (deler av) et kodeverk til et annet verktøy for eksempel for å oversette kodeverket fra ett språk til et annet. Redigering Redigering innebærer både utvikling av nye begrepssamlinger, kodeverk og klassifikasjonssystemer samt alle former for endringer av slike. En del spesiell redigering som for eksempel oversettelse, kan tenkes å skje i andre verktøy. Eksport/importfunksjoner benyttes da for å overføre begrepssamlinger, kodeverk og klassifikasjonssystemer mellom verktøyene. API Det skal gjøres tilgjengelig et programmeringsgrensesnitt kalt API - som gjør det mulig for IT-leverandører å kunne anvende til alle begrepssamlinger, kodeverk og klassifikasjonssystemer på en ensartet måte fra sin egen programvare. Anvendt IT Prosessen er tatt med for å understreke at helsepersonell ikke har noen direkte interaksjon med dette verktøyet. Helsepersonell vil imidlertid på sikt kunne få fordeler av systemet fordi det muliggjør konstruksjon av et ensartet grensesnitt mot begrepssamlinger, kodeverk og klassifikasjonssystemer i IT-systemene Arkitektur En prinsippskisse for verktøyet er vist i Figur 3. Begrepssamlingene, kodeverkene og klassifikasjonssystemene ligger her i en SQLdatabase heretter kalt begrepsdatabasen. Verktøyets forretningslag utgjøres av en komponent som inneholder all nødvendig funksjonalitet for å kunne manipulere innholdet i begrepsdatabasen. Komponenten skal tilby de nødvendige funksjoner for oppslag i begrepssamlinger, kodeverk og klassifikasjonssystemer, herunder også søkefunksjoner basert på de termer som benyttes og på kodeverdier. Verktøyet består for øvrig av et klientlag, vist til høyre på figuren, som skal kunne benyttes ved utvikling og vedlikehold av begrepssamlinger, kodeverk og klassifikasjonssystemer, samt eksport og import av kodeverk mv. De forskjellige sluttbrukersystemer skal kunne benytte seg av funksjonene i denne komponenten for å gi brukerne tilgang til de begrepssamlinger, kodeverk og klassifikasjonssystemer som finnes i begrepsdatabasen. Videre skal det enkelte sluttbrukersystem, i stedet for å lagre selve kodeverdien, kunne benytte en unik referanse til det kodeverk den inngår i, samt en unik referanse til gjeldene versjon av koden med tilhørende termer mv, i kodeverket. Bruk av en slik komponent skal garantere at disse referansene aldri endres, slik at de korrekte 2002 KITH

12 Side 12 av 80 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem revisjoner av alle koder kan bevares sammen med de registreringer, f.eks. i journalen, hvor kodene er benyttet. Intensjonen er at komponenten etter hvert skal tilbys for integrasjon med sluttbrukersystemer gjennom de til enhver tid allment benyttede fasader (f.eks. COM, CORBA, Java), og med mulighet for bruk av de mest populære databasesystemene. Sluttbruker systemer Fasader PAS EPJ PACS xxx COM CORBA DLL Java Funksjoner for utvikling og vedlikehold av kodeverk Komponent Komponent for kodeverk og klassifikasjonssystemer Eksport og import av kodeverk Database med kodeverk Oracle SQL Server Sybase xxx Figur 3. Prinsippskisse Verktøyet skal kunne håndtere både små lokale kodeverk og store, sentralt vedlikeholdte klassifikasjonssystemer. Overføring av nye kodeverk og endringer i eksisterende kodeverk bør kunne skje på to forskjellige måter: Det skal finnes en egen eksportfunksjon som kan trekke ut en publikasjon (dvs. en begrepssamling eller et kodeverk), eller deler av dette i form av en eller flere filer. Disse kan for eksempel legges ut på Web og lastes ned av de som har behov for publikasjonen. Gjennom egne importfunksjoner skal så publikasjonen kunne lastes inn hos mottakeren. Dette prinsippet skal også benyttes for eksport av publikasjoner i et format som er egnet for langtidslagring og eventuelt deponering i arkivdepot. Verktøyet skal inkluder nødvendige funksjoner for utvikling og vedlikehold av begrepssamlinger, kodeverk og klassifikasjonssystemer. Dette vil måtte inkludere funksjoner for nyregistrering, redigering, søking etc., og det skal være fulle muligheter for revisjonskontroll. KITH 2002

13 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 13 av Krav til teknisk utforming Nr. Kravbeskrivelse Svar K.1 Systemet må være tilrettelagt for bruk sammen med standardløsninger for sikkerhetskopiering. Beskrivelse av rutiner for sikkerhetskopiering skal inngå som en del av systemets dokumentasjon. K.2 Systemet må ha recoveryfunksjoner slik at informasjonsintegritet bevares ved avbrudd pga. strømstans eller maskinhavari. K.3 Systemet må være sikret mot inkonsistens. Dette innebærer blant annet: Det skal ikke være mulig å slette informasjon som refereres fra andre steder i begrepsdatabasen. Det skal ikke være mulig å endre nøkkelattributter som benyttes ved referanse fra andre steder i begrepsdatabasen, uten at tilsvarende attributter endres på de steder som refererer. Alle funksjoner som medfører oppdatering av mer enn ett sted i begrepsdatabasen skal utføres på en slik måte at enten blir alle oppdateringene utført eller så blir ingen oppdatering utført. K.4 Systemet skal i alle relevante sammenhenger håndtere datoer på begge sider av år Krav til sikkerhet Nr. Kravbeskrivelse Svar K.5 Kun autorisert personale skal kunne opprette, endre eller slette informasjon i publikasjoner (begrepssamlinger eller kodeverk) KITH

14 Side 14 av 80 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Nr. Kravbeskrivelse Svar K.6 Personale skal kunne autoriseres for en eller flere av følgende funksjoner i en publikasjon som helhet, eller den delen av et kodeverk som ligger under en angitt node: Opprette ny publikasjon Importere publikasjoner eller revisjoner av slike. Eksportere publikasjoner. Opprette nytt informasjonsinnhold i en publikasjon. Endre informasjonsinnhold i en publikasjon. Opprette link mellom kodenoder og/eller mellom begrep. Gjøre informasjon gyldig for bruk. Ugyldiggjøre informasjon. Slette informasjon. For kodeverk skal rettighetene kunne begrenses til den informasjon som ligger under en kodenode. Alle brukere skal ha lesetilgang til alle kodeverk. K.7 Informasjon som har vært publisert, og derfor kan være referert f.eks. fra en pasientjournal, skal ikke kunne endres, men den skal kunne markeres som ugyldig. K.8 Informasjon som har vært publisert men som nå er markert som ugyldig skal ikke kunne endres eller slettes. Den skal heller ikke kunne markeres som gyldig igjen. K.9 Informasjon som aldri har vært markert som gyldig, skal kunne slettes av de som er autorisert for dette. KITH 2002

15 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 15 av Datamodell Selv om beskrivelsen av klasser og attributter er detaljert i denne kravspesifikasjonen, så er det ikke ment at dette skal være den eksakte interne datastruktur i det verktøyet som skal utvikles. Denne beskrivelsen viser kun hvordan informasjonen i BeKK skal kunne sees gjennom det programmeringsgrensesnittet (API) de produkter som skal benytte verktøyet skal forholde seg til. Ved utvikling av BeKK står en derfor fritt til å benytte en annen intern datamodell så lenge den informasjonen og de funksjoner som beskrives, blir gjort tilgjengelig for BeKKs brukere. Det er dog en forutsetning at datatypen til de enkelte attributter i kravspesifikasjonen, er kompatibel med det format som er angitt for tilsvarende attributter i dette kapitlet. Dette innebærer spesielt at det ikke tillates at den interne datamodell som benyttes for verktøyet, inneholder tekst eller numeriske attributter med større lengde enn det som er angitt for tilsvarende attributter i denne kravspesifikasjonen. Ved eksport av publikasjoner er kravene absolutte både når det gjelder attributtenes format og fordeling på klasser Kort introduksjon til datamodellene I denne kravspesifikasjonen er notasjonsspråket UML (Unified Modeling Language) benyttet ved utarbeidelsen av de tekniske kravene. Dette er et meget kraftfullt notasjonsspråk som vinner stadig større utbredelse blant leverandørene av programvare over hele verden, og det er også meget benyttet i internasjonalt standardiseringsarbeid. I figurene som inngår i denne kravspesifikasjonen benyttes kun et lite subsett av de mulighetene som UML tilbyr. Disse er kort beskrevet i det etterfølgende Klasser, assosiasjoner og kardinaliteter En klasse er tegnet som en boks med klassens navn inni. Navnet til klasser skrives alltid med stor forbokstav, mens attributter skrives med små bokstaver. Denne konvensjonen er også forsøkt fulgt i denne rapporten. I dokumentteksten benyttes kursiv både for klassenavn og attributtnavn. Selv om navn på klasser og attributter i utgangspunktet er på entallsform, blir det i løpende tekst benyttet flertallsform der dette språklig sett er det korrekte. A 1 0..* B Assosiasjoner mellom klasser vises med heltrukne linjer. Er assosiasjonen retningsbestemt, vises dette med en pilspiss i den ene enden. I figuren ovenfor representerer A og B to klasser, og det er en assosiasjon fra B til A. For eksempel kan A her representere et register med beskrivelse av flytyper, mens B er et register med flyruter. Det vil da være en referanse fra hver enkelt flyrute til den flytypen som benyttes på ruten, men det er ikke lagt opp til at det med utgangspunkt i flytypen skal være mulig å finne ut hvilke flyruter den benyttes på KITH

16 Side 16 av 80 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Tallene (kardinaliteten) som er vist ved linjens ender, angir at det for hver forekomst av B må finnes en (1) forekomst av A, og at det for hver forekomst av A kan finnes 0 eller flere (0..*) forekomster av B Aggregeringer Aggregering er en spesiell form for assosiasjon som benyttes når et hele skal bygges opp av flere deler. Aggregering symboliseres med et rutersymbol i den delen som utgjør helheten. En spesielt sterk form for aggregering er sammensetning (composition), som angis ved at rutersymbolet er fylt. Dette benyttes når en del alltid må inngå i ett, og bare ett, hele, delen kan altså ikke eksistere utenfor den enhet som den inngår i. Kardinaliteten blir da alltid 1 eller 0..1 og angis normalt ikke dersom den er 1. Idrettsanlegg * 0..1 Byer * Hus 1..* 1..* Etasjer Hvordan aggregeringer benyttes, er enklest å forklare med et eksempel slik som vist i figuren foran. Figuren uttrykker følgende: Et Hus består av en eller flere Etasjer. Enhver Etasje må inngå i ett, og bare ett, enkelt Hus og eksisterer ikke utenfor den sammenheng som Huset utgjør. Etasjer kan bare refereres til som en del av det spesifikke Huset den inngår i. Et Hus derimot, har en selvstendig mening og kan inngå i flere sammenhenger. Et Hus kan maksimalt inngå i et Idrettsanlegg, mens et Idrettsanlegg kan bestå av flere hus, men det finnes også Idrettsanlegg uten Hus. Hvert enkelt Hus eller Idrettsanlegg kan maksimalt inngå i en By, men de kan også ligge utenfor byene. En By består av et eller flere Hus, og det kan også finnes Idrettsanlegg der. En By uten Hus gir knapt noen mening, men det er ikke noe krav at det skal finnes et Idrettsanlegg der Generaliseringer og spesialiseringer En generalisering benyttes for å samle en del egenskaper (attributter og relasjoner) som er felles for flere klasser. Figuren nedenfor viser to eksempler på generaliseringer: Person er en generalisering av Pasient og Helsepersonell. KITH 2002

17 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 17 av 80 Transportmiddel er en generalisering av Buss og Tog. Person Transportmiddel Pasient Helsepersonell Buss Tog En annen måte å uttrykke det samme på er: Pasient og Helsepersonell er begge spesialiseringer av Person. Buss og Tog er begge spesialiseringer av Transportmiddel Abstrakte klasser I forbindelse med generaliseringer benyttes det ofte abstrakte klasser. Dette er klasser som kun eksisterer i form av sine spesialiseringer. At en klasse er abstrakt, angis ved at klassenavnet i figuren står i kursiv. I figuren foran er Transportmiddel en abstrakt klasse, det vil si at konkrete transportmidler kun forekommer i form av spesialiseringene Buss og Tog, og det finnes ikke transportmiddel som er både Buss og Tog. Det vil ofte likevel gi mening å referere til Transportmiddel som sådan, en del egenskaper (som hastighet, energiforbruk etc.) kan være felles for disse, og når en for eksempel skal ut på en kortere reise, kan det være bekvemt å bestille denne uten i første omgang å ta stilling til om en skal benytte Buss eller Tog. Person, derimot, er en konkret klasse. Dette innebærer at det kan finnes Personer som verken er Pasient eller Helsepersonell (heldigvis!), og at samme Person kan være både Pasient og Helsepersonell Spesielt om diagrammene i denne kravspesifikasjonen Etter hver figur følger en beskrivelse av de fleste klassene som inngår i figuren. De fleste figurene inneholder også en del klasser som er tatt med for å vise sammenhengen med resten av datamodellen, og beskrives andre steder i dokumentet. Slike klasser er markert ved at klassenavnet er angitt med en annen skrift, f.eks. Term i stedet for Term. Merk at de fleste assosiasjoner mellom klassen Publikasjonssrevisjon og de øvrige klassene er utelatt i diagrammene. Denne klassen refereres fra en rekke forskjellige steder i datamodellen, og som kan ses på som sekundær i forhold til det modellen skal illustrere. Assosiasjonene er representert ved attributter i de klassene hvor Publikasjonssrevisjon refereres fra. Alle andre assosiasjoner er for øvrig også beskrevet med attributter. Dette er gjort fordi det ved eksport, se kapittel 3, så skal en av mulighetene være at det legges ut en fil for hver klasse. Disse attributtene er da nødvendige for å opprettholde assosiasjonen KITH

18 Side 18 av 80 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Kardinalitet er også angitt for de aller fleste assosiasjoner. Unntaket er ved den sterke formen for aggregering, sammensetning, når kardinaliteten er 1 i den enden av assosiasjonen som utgjør helheten. I beskrivelsen av de enkelte klasser og attributter benyttes følgende forkortelser mv: Betegnelse Betegnelse for attributtet. Denne benyttes i de fleste tilfeller hvor det refereres til attributtet fra andre deler av denne kravspesifikasjonen. O - Obligatorisk innhold. Markert med x dersom attributtet alltid skal ha verdi. Markert med b dersom attributtet må ha verdi når nærmere spesifiserte betingelser er oppfylt. Beskrivelsen av betingelsene er enten angitt i merknadsfeltene eller under klassen. Format Format på attributtet ved utveksling og eksport, f.eks. for avlevering til arkivdepot. (Merk: et annet format kan gjerne benyttes ved lagring m.v.) Følgende koder benyttes: ST(n) - Tekststreng med maksimal lengde n tegn. INT(n) - Tall med maksimalt n siffer. Eksporteres med sin virkelige lengde eller med ledende 0 til full lengde. MERK: INT uten lengdeangivelse benyttes i denne kravspesifikasjonen for "long integer" og gir da en øvre grense på (Negative verdier benyttes ikke for attributter i denne kravspesifikasjonen) TS - dato og klokkeslett på formen YYYY-MM-DDThh:mm:ss [ISO 8601] (Merk: dette formatet bør ikke benyttes ved fremvising på skjerm mv.) TS[date] - Dato på formen YYYY-MM-DD. (Merk: et annet format kan benyttes ved fremvising på skjerm m.v.) ST - Tekst av fri lengde. BL - Boolean, verdi "True" eller "False". CS - Enkel, kodet verdi. En unik identifikator for kodeverket er da alltid angitt i merknaden til attributtet. (Merk at de fleste kodede verdier forutsettes håndtert av BeKK selv. For å registrere slike benyttes an attributt av datatype INT som skal inneholde kodenodeid til den node i kodeverket som det refereres til. Kortnavn Alfanumerisk kortnavn for attributtet. Kortnavnet er unikt for hele kravspesifikasjonen. Benyttes som XML-tagg til elementet ved uttrekk for eksport. Benyttes også andre steder i kravspesifikasjonen hvor det er behov for en kort, entydig referanse til et attributt. Merknader Beskrivelse av attributtet med regler for innholdet dersom slike finnes. KITH 2002

19 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 19 av Begrepsdatabasen Person lokal person ID : INT fornavn : ST(50) etternavn : ST(50) ekstern personreferanse : ST(50) e-post adresse : ST (255) telefon : ST(15) 0..* Tjenesteyter tjenesteyter ID : INT lokal person ID : INT lokal enhet ID : INT rolle : S opprette ( 0) ny begrepssamling : BL opprette nytt kodeverk : BL fra tidspunkt : TS tiltidspunkt : TS 0..* 1 Organisatorisk enhet lokal enhet ID : INT enhetsbetegnelse : ST(70) kortnavn : 30 virksomhet : BL ekstern enhetsreferanse : ST(30) postadresse : ST(255) e-post adresse : ST(255) telefon : ST(15) 1 0..* 0..1 Organisasjonsstruktur overordnet enhet : INT underordnet enhet : INT Begrepsinfo begrepsinfo ID : INT begrep ID : INT språk : INT kodeverk begrepsinfotype : INT begrepsinfo type : INT informasjon-1 : ST(255) informasjon-2 : ST registreringsinfo : INT 0..* Redigeringstilgang redigeringstilgang ID : INT lokal tjenesteyter ID : INT publikasjon ID : INT kodenode ID : INT registrere ny : BL endre : BL opprette ny link : BL gjøre gyldig : BL gjøre ugyldig : BL slette : BL fra tidspunkt : TS til tidspunkt : TS merknad : S (2 ) 0..* 1 Publikasjonssrevisjon publikasjon ID : INT revisjonsnummer : INT revisjonstidspunkt : TS endringsansvarlig : INT revisjonstype : CS merknad : ST(255) Begrepsdefinisjon begrep ID : INT definisjon nr : INT tekst : ST definisjonstype : CS språk : CS oversatt fra definisjon : INT kilde til definisjon : Sgyldig fra : INT gyldig til : INT 0..* 0..* Begrepsinfo Link begrep ID : INT definisjon nr : INT begrepsinfo ID : INT sortering : INT gyldig fra : INT gyldig til : INT 1..* 1 Figur 4. Komplett informasjonsmodell Publikasjon lokal publikasjon ID : INT publikasjon OID : ST(255) tittel : ST(255) 0..* kortnavn for publikasjon : ST(10) hovedrevisjon/versjon : X(30) 1 intern publikasjon : BL ansvarlig utgiver ID : INT ansvarlig redaktør ID : INT opprettet dato : TS merknad : ST 1 1..* 0..* 0..* 1 Begrepssamling anvendelsesområde : INT 1 0..* Inkludert begrep begrepsinklusjon ID : INT begrep ID : INT publikasjon ID : INT primær publikasjon : definisjon nr : INT gyldig fra : INT gyldig til : INT kan redigeres : BL Begrep begrep ID : INT begrep OID : ST(255) 1 Begrepsrelasjon fra begrep ID : INT til begrep ID : INT type begrepsrelasjon : CS sortering : INT relasjonsbeskrivelse gyldig fra : INT gyldig til : INT * 0..* 0..* 0..* Kodeformat kodeformat ID : INT nivåprefiks : ST(10) nivåsuffiks : ST(10) kodeverdiformat : X(70) 0..1 Kodeverk status : INT bruksområde : INT tatt i bruk tidspunkt : TS bruk avsluttet tidspunkt : TS 0..* Begrepsrevisjon begrep ID : INT revisjonsnummer : INT revisjonstidspunkt : TS endringsansvarlig : INT 1..* 1 Kodenodeinfo link kodenode ID : INT publikasjon ID : INT kodenodeinfo ID : INT sortering : INT gyldig fra : INT gyldig til : INT 0..* {en og bare en av disse } Kodeverkselement fullstendig kode : ST(70) kodebidrag : ST(30) elementtype : INT kodenode ID : INT 1 publikasjon ID : INT begrep ID : INT 1 0..* * 0..* 0..* Kodeverksnode kodenode ID : INT 1 publikasjon ID : INT status : INT gyldig fra : INT gyldig til : INT 1 kodeformat ID : INT 1..* Anvendt Kodeverkselement kodenode ID : INT publikasjon ID : INT gjelder også underliggende element : BL anvender kodenodeid anvender publikasjon ID Element-Term Begrep-Term kodenode ID : INT begrep ID : INT publikasjon ID : INT term ID : term ID : 1 INT anvendelsesområde : CS anvendelsesområde : CS sortering : INT sortering : INT 0..* gyldig fra : INT gyldig fra : INT gyldig til : INT gyldig til : INT 1 0..* Kodenodeinformasjon kodenodeinfo ID : INT språk : INT anvendelsesområde : INT kodeverk kodenodeinfotype : INT kodenodeinfo type : INT informasjon-1 : S informasjon-2 (2 ) : ST Kodelink link ID : linktype : INT linkinfo : ST(70 sortering : INT fra kodenode ID : INT 0..* fra publikasjon ID : INT til kodenode ID : INT til publikasjon ID : INT 0..* gyldig fra : INT ugyldig fra : INT gjelder også underliggende noder : BL * Kodeverksstruktur publikasjon ID : INT fars kodenode ID : INT barns kodenode ID : INT sortering : INT gyldig fra : INT ugyldig fra : INT 0..* 1 Term språk : CS Termlink fra term ID : til term ID : INT termlinktype : CS 0..* 1 term ID : INT tekst ST(255) 2002 KITH

20 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 20 av Hovedstruktur for kodeverk Hovedstrukturen for kodeverk er vist i Figur 5 nedenfor. Den viser at et Kodeverk er bygd opp av Kodeverkselement i en hierarkisk struktur. Den hierarkiske strukturen realiseres ved hjelp av klassene Kodeverksnode og Kodeverkstruktur. Til et kodeverkelement kan det knyttes en eller flere termer på forskjellige språk. Kodeverk med en flat struktur, dvs. hvor det ikke er hierarkiske avhengigheter mellom noen av kodeverkelementene, blir her betraktet som et spesialtilfelle av en hierarkisk struktur med bare et nivå. Modellen inkluderer muligheter for å håndtere revisjoner av større eller mindre deler av et kodeverk, på en slik måte at kodeverket til enhver tid enkelt kan gjenskapes slik det framsto da en spesifikk revisjon av en kode ble benyttet ved registrering. Dette realiseres ved at det i de sentrale klasser finnes attributter som angir ved hvilken revisjon av kodeverket den aktuelle instansen av klassen ble tatt i bruk, og når bruken eventuelt opphørte. Kodeverk * 0..* Kodeverknode Kodeverkselement 0..* 0..* Term 1..* 0..1 Publikasjonsrevisjon Kodeverksstruktur Figur 5. Hovedstruktur for kodeverk KITH 2002

21 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 21 av Publikasjon Dette er en abstrakt klasse som benyttes for å beskrive attributter og relasjoner som skal være felles for kodeverk og begrepssamlinger. Sentral informasjon her er hvilken virksomhet som er ansvarlig utgiver av publikasjonen og hvem som er redaktør. Merk: Ettersom dette er en abstrakt klasse, vil den ikke være identifiserbar i en konkret implementasjon, den vil f.eks. ikke forekomme som en tabell i begrepsdatabasen. Alle attributtene som inngår i Publikasjon vil finnes i de to spesialiseringene, dvs. klassene Kodeverk og Begrepssamling. Betegnelse O Format Kortnavn Merknader lokal publikasjon ID x INT KVP_ID Skal inneholde et lokalt unikt ID-nummer som identifiserer publikasjonen, dvs. kodeverket eller begrepssamlingen, innenfor begrepsdatabasen. publikasjon OID ST(255) KVP_OID Skal inneholde en globalt unik identifikator for publikasjonen, dvs. kodeverket eller begrepssamlingen, i form av en ISO Object Identifier (OID). tittel x ST(255) KVP_TITTEL Full tittel for publikasjonen, dvs. kodeverket eller begrepssamlingen. For eksempel "Den internasjonale statistiske klassifikasjon av sykdommer og beslektede helseproblemer, 10. revisjon." kortnavn for publikasjon ST(10) KVP_KORTN Kortnavn for publikasjonen, dvs. kodeverket eller begrepssamlingen, f.eks. ICD-10. hovedrevisjon/versjon ST(30) KVP_HOVREV Den offisielle betegnelse på den hovedrevisjon/versjon av publikasjonen som er installert. Merk at det i ettertid kan være foretatt endringer. Disse identifiseres i så fall gjennom klassen Publikasjonssrevisjon. intern publikasjon x BL KVP_LOKAL "True" dersom dette er en intern publikasjon, f.eks. et lokalt kodeverk, "False" dersom det er en publikasjon som benyttes av flere, f.eks. et sentralt kodeverk som ICD-10. opprettet dato TS[date] KVP_OPPDATO Den dato publikasjonen, dvs. kodeverket eller begrepssamlingen, ble opprettet/tatt i bruk av virksomheten KITH

22 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 22 av 80 Betegnelse O Format Kortnavn Merknader ansvarlig utgiver ID INT KVP_ORGID Referanse til den virksomhet som er ansvarlig utgiver av publikasjonen, dvs. kodeverket eller begrepssamlingen. For lokale publikasjoner skal attributtet inneholde navn på virksomheten selv og eventuelt også den avdeling eller lignende som har ansvar for vedlikehold av publikasjonen. Dersom publikasjonen er et kodeverk som er knyttet opp mot et (eller flere) produkt fra en bestemt leverandør, bør navnet på leverandøren og produktnavnet registreres i attributtet merknad. Det anses ikke å være behov for å kunne bevare en historikk om eventuelle endringer i ansvarlig utgiver over tid. ansvarlig redaktør ID INT KVP_REDID Referanse til den person som er ansvarlig redaktør for publikasjonen, dvs. kodeverket eller begrepssamlingen. Attributtet er kun ment som informasjon om hvem en skal henvende seg til i forbindelse med forbedringsønsker mv, og det er derfor ikke behov for historikk. merknad ST KVP_MERKNAD Her kan eventuelt spesielle forhold rundt bruk av publikasjonen beskrives. Dette er en abstrakt klasse, og den har derfor ikke noe kortnavn. Unik nøkkel: KVP_ID (arves til klassene Kodeverk og Begrepssamling) KITH 2002

23 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 23 av Kodeverk (KVERK) Denne klassen benyttes for en overordnet beskrivelse av et kodeverk. Klassen er en spesialisering av den abstrakte klassen Publikasjon, og klassen Kodeverk arver derfor alle attributter og relasjoner fra Publikasjon. Betegnelse O Format Kortnavn Merknader status x INT KVK_STATUS Kode som blant annet angir om kodeverket er i bruk eller ikke. Følgende verdier inngår i kodeverket: 0 - under utvikling, kan ikke benyttes ved offisiell registrering. 1 - Aktivt kodeverk, kan benyttes ved alle former for registrering 7 - Sekundert kodeverk, kodene kan kun benyttes når de er knyttet til en node i et annet kodeverk. (Se beskrivelsen av klassen Anvendt Kodeverkselement.) 8 - Bruken av kodeverket er opphørt og kodene kan ikke lengre benyttes ved registrering. Men de kan refereres til fra registreringer i andre kodeverk, f.eks. for å angi at en kode i et nytt kodeverk erstatter en kode i et utgått kodeverk. 9 - Bruken av kodeverket er opphørt. Kan ikke lengre benyttes ved registrering, og koder i kodeverket skal heller ikke kunne refereres til fra andre kodeverk. Status skal aldri kunne endres til 0 etter at kodeverket er tatt i bruk. Kodene for kodeverk status defineres i et eget, felles kodeverk med publikasjon ID = Dette attributtet skal inneholde kodenode ID til den kode som angir kodeverkets status KITH

24 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 24 av 80 Betegnelse O Format Kortnavn Merknader bruksområde INT KVK_BROMR Kodeverkene kan grupperes etter bruksområde, f.eks.: - klinisk kodeverk - teknisk kodeverk - arkivering Kodene for bruksområde defineres i et eget, felles kodeverk med publikasjon ID = Dette attributtet skal, dersom det benyttes, inneholder kodenode ID til den kode som beskriver bruksområdet best. tatt i bruk tidspunkt x TS KVK_FRADATO Dato og klokkeslett når kodeverket offisielt skal tas (ble tatt) i bruk av virksomheten. bruk avsluttet tidspunkt Når dette tidspunktet inntreffer, skal kodeverkets status automatisk endres til 1, for å angi at kodeverket kan benyttes. b TS KVK_TILDATO Dersom bruken av et kodeverk skal opphøre innenfor virksomheten, skal dato og klokkeslett for dette angis her. For denne klassen benyttes kortnavnet KVERK. Unik nøkkel: KVP_ID Når dette tidspunktet inntreffer, skal kodeverkets status automatisk endres til 9, for å angi at bruken av kodeverket er opphørt. Dersom det fremdeles skal være tillatt til å referere til koder i dette kodeverket fra andre kodeverk, må status endres til 8. KITH 2002

25 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 25 av Kodeverksnode (KVNODE) Kodenoder benyttes for å bygge opp kodeverkets struktur. En instans av Kodeverksnode inngår i et, og bare et, kodeverk, men kan refereres fra andre kodeverk. Til en instans av Kodeverksnode vil det være tilknyttet ett og bare ett, Kodeverkselement. Dette kodeverkelementet kan enten være tilknyttet direkte som en instans av Kodeverkselement, eller det kan være tilknyttet som en referanse til et kodeverkelement gjennom en instans av klassen Anvendt Kodeverkselement. Sist nevnte mulighet er hovedsakelig tenkt benyttet når en ønsker å ta i bruk et utsnitt av et kodeverk til et spesielt formål. Betegnelse O Format Kortnavn Merknader kodenode ID x INT KVN_ID Dette er et unikt ID-nummer for kodenoden, innenfor det kodeverk noden tilhører. Sammen med "publikasjon ID" utgjør dette attributtet en unik nøkkel for denne klassen. Sammen med "publikasjon OID" (fra klassen Publikasjon) utgjør dette attributtet en global unik referanse til det kodeverkselement som er knyttet til kodenoden, altså en OID for dette elementet. publikasjon ID x INT KVN_KVPID En unik referanse til det kodeverk (den instans i klassen Kodeverk) som noden tilhører KITH

26 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 26 av 80 Betegnelse O Format Kortnavn Merknader status x INT KVN_STATUS Kode som blant annet angir om kodeverkesnoden er i bruk eller ikke. Følgende verdier inngår i kodeverket: 0 - under utvikling, kan ikke benyttes ved offisiell registrering. 1 - Noden representerer en offisiell kode og kan benyttes ved alle former for registrering. 2 - Noden representerer en lokal utvidelse av et kodeverk som andre enn virksomheten selv har vedlikeholdsansvaret. Kan benyttes ved registrering, men vanligvis ikke ved rapportering til offisielle statistikker. 4 - Noden representerer et rent strukturelement som ikke kan benyttes til registrering, men noden kan refereres til fra en annen kodenode. Slike noder kan f.eks. benyttes for å samle en del kodeverkselementer som skal benyttes i en bestemt sammenheng, f.eks. de koder som er relevante for en avgrenset del av en virksomhet. Det skal ikke kunne registreres noe kodeverkselement tilknyttet denne typen noder. 8 - Bruken av koden er opphørt og kan ikke lengre benyttes ved registrering. Men den kan refereres til f.eks. for å angi at en ny kode erstatter den kode. 9 - Bruken av koden er opphørt. Kan ikke lengre benyttes ved registrering og skal heller ikke kunne refereres til fra andre koder/kodeverk. Status skal aldri kunne endres til 0 etter at koden er tatt i bruk. Kodene for kodenoder status defineres i et eget, felles kodeverk med publikasjon ID = Dette attributtet skal inneholde kodenode ID til den kode som angir kodenodens status. KITH 2002

27 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 27 av 80 Betegnelse O Format Kortnavn Merknader gyldig fra x INT KVN_FRAREV Attributtet skal inneholde "revisjon ID" til den revisjon av kodeverket hvor den aktuelle instans av Kodeverksnode ble gjort tilgjengelig for (offisiell) registrering av koder. At noden blir gjort tilgjengelig for offisiell registrering, innebærer at attributtet "status" settes til verdien 1 (eller 2 for lokale utvidelser). Dette attributtet skal da automatisk oppdateres. ugyldig fra b INT KVN_TILREV Dersom bruken av en kode skal opphøre, skal attributtet "ugyldig fra" inneholde "revisjon ID" til den revisjon av kodeverket, hvor dette skjedde. At bruken av koden skal opphøre, signaliseres ved å sette attributtet "status" for den aktuelle instans av Kodeverksnode, til verdien 9 (Bruken av koden er opphørt. Attributtet "ugyldig fra" skal da automatisk oppdateres. Merk at kodenoder bare skal settes ugyldige dersom noden, og alt som ligger under, skal utgå fullstendig og for alltid fra det kodeverk den inngår i, og fra alle kodeverk som refererer til denne gjennom en instans av Kodelink. I alle andre tilfeller bør (skal) en heller ugyldiggjøre den instans av Kodeverksstruktur som peker til nodens far, og eventuelt også relevante instanser av Kodelink. kodeformat ID INT KVN_FMTID Dette attributtet benyttes for å registrere en referanse til den instans av Kodeformat som skal benyttes ved formatering av koden i Kodeverkselement. Dersom kodeformat ikke er angitt, arves kodeformatet fra nodens far. For denne klassen benyttes kortnavnet KVNODE. Unik nøkkel: KVN_ID, KVN_KVPID 2002 KITH

28 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 28 av Kodeverksstruktur (KVSTRUKT) Denne klassen benyttes til å bygge opp en hierarkisk struktur innenfor et kodeverk Betegnelse O Format Kortnavn Merknader publikasjon ID x INT KVS_KVPID En unik referanse til det kodeverk (den instans i klassen Kodeverk) som nodene (far og barn) tilhører. fars kodenode ID x INT KVS_KVNIDFAR Unik referanse til den instans av Kodeverksnode, innenfor kodeverket, som utgjør faren. barns kodenode ID x INT KVS_KVNIDBARN Skal inneholde en unik referanse til en instans av Kodeverksnode, innenfor kodeverket, som er et barn av den instans av Kodeverksnode som er identifisert ved attributtet "fars kodenode ID". sortering INT KVS_SORT Angir den rekkefølge "barna" skal sorteres i. Dersom denne ikke er angitt, skal det sorteres direkte etter kodeverdi. gyldig fra x INT KVS_FRAREV Attributtet skal inneholde "revisjon ID" til den revisjon av kodeverket hvor dette slektskapet ble tatt i bruk. ugyldig fra b INT KVS_TILREV Dersom bruken av en underliggende kode (barn) skal opphøre, skal referanse til den revisjon av kodeverket dette skjer, angis her. For denne klassen benyttes kortnavnet KVSTRUKT. Unik nøkkel: KVS_KVPID, KVS_KVNIDFAR, KVS_KVNIDBARN KITH 2002

29 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 29 av Kodeverkselement (KVELEMENT) Denne klassen benyttes for å beskrive de enkelte kodete elementer som inngår i kodeverket. Beskrivelsen består av en kode og/eller en eller flere termer som eventuelt kan foreligge på flere språk. (Se beskrivelsen av klassene Element-Term og Term når det gjelder eventuelle termer som inngår i beskrivelsen av det kodete elementet.) Betegnelse O Format Kortnavn Merknader kodenode ID x INT KVE_KVNID Unik referanse til den instans av Kodeverksnode, innenfor kodeverket, som Kodeverkselementet tilhører. publikasjon ID x INT KVE_KVPID En unik referanse til det kodeverk (den instans i klassen Kodeverk) som kodeverkelementet tilhører. fullstendig kode b ST(70) KVE_KODE Den fullstendige kodeverdien slik den skal benyttes ved registrering/presentasjon. For instanser av Kodeverkselement med "elementtype" 'normal'. framstår denne ved en konkatenering av alle kodeverdier for de Kodeverkselementer som ligger på høyere nivå i kodeverket (dvs. fedre og fedres fedre). kodebidrag Format og skilletegn skal være som angitt i de instanser av Nodeformat som er knyttet til de aktuelle noder i kodeverket. Eksempel: D64.4 Dette attributtet skal alltid inneholde den komplette koden for alle kodeverk eller klassifikasjonssystemer som benytter koder. ST(30) KVE_DELKOD Det bidrag til den fullstendig koden som kommer fra dette kodeverkelementet. F.eks. vil "kodebidrag" for dette elementet være '4' for den fullstendige ICD-10 koden D KITH

30 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 30 av 80 Betegnelse O Format Kortnavn Merknader elementtype INT KVE_TYPE Dette attributtet benyttes til å skille mellom kodeverkelementer som er en del av selve kodeverket og skal kunne benyttes ved registrering, og kodeverkelementer som benyttes til andre formål, f.eks. for logisk oppdeling av kodeverket i logiske grupper som ikke følger den rene hierarkiske strukturen. For eksempel benyttes det i ICD-10 en kapittelinndeling som ikke er en del av selve kodeverket, men som likevel har en klar strukturell betydning. Følgende koderer benyttes: 1 - Normalt element med kode. Kan benyttes registrering. 2 - Normalt element uten kode. Kan benyttes ved registrering. 8 - Grupperingselement med kode. Kan ikke benyttes ved registrering. 9 - Grupperingselement uten kode. Kan ikke benyttes ved registrering. Elementtype kan utelates for normale element med kode som kan benyttes ved registrering (dvs. elementtype 1.) Kodene for kodeverkselementtype defineres i et eget, felles kodeverk med publikasjon ID = Dette attributtet skal inneholde kodenode ID til den kode som angir elementtypen. begrep ID INT KVE_KVBID Attributtet skal, dersom det benyttes, inneholde referanse til det Begrep som dette kodeverkelementet er en representasjon for. For denne klassen benyttes kortnavnet KVELEMENT. Unik nøkkel: KVE_KVPID, KVE_KVNID KITH 2002

31 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 31 av Publikasjonsrevisjon (KVREV) Denne klassen benyttes til å dokumentere de endringer publikasjoner, dvs. kodeverk eller begrepssamlinger, gjennomgår. Alle endringer som på en eller annen måte påvirker den offisielle bruken av publikasjonen, skal knyttes opp mot en revisjon av publikasjonen. Dette gjelder nye koder, koder som utgår, endringer i termer, definisjoner, linker mv. Endringer i forbindelse med uttesting av nye koder, registrering av merknader mv, knyttes ikke opp mot noen revisjon av publikasjonen, og skal da heller ikke kunne benyttes ved offisiell registrering. Betegnelse O Format Kortnavn Merknader publikasjon ID x INT KVR_KVPID En unik referanse til den publikasjonen revisjonen gjelder. revisjonsnummer x INT KVR_REVNR Attributtet skal inneholde et revisjonsnummer som er unikt innenfor publikasjonen. Revisjonsnummer tildeles stigende og starter på 1. revisjonstidspunkt x TS KVR_TID Det tidspunkt, dato og klokkeslett, revisjonen ble foretatt. endringsansvarlig ID INT KVR_ENDANSID Unik referanse (til klassen Tjenesteyter, se kapittel 2.8.4) til den som er ansvarlig for denne revisjonen av publikasjonen KITH

32 Verktøy for håndtering av Begrepsapparat, Kodeverk og Klassifikasjonssystem Side 32 av 80 Betegnelse O Format Kortnavn Merknader revisjonstype x INT KVR_TYPE Angir en grov identifisering av årsaken til revisjonen av publikasjonen. Revisjonstyper defineres i et eget, felles kodeverk med publikasjon ID = Dette attributtet skal inneholder kodenode ID til den relevante revisjonstype. Følgende koder er foreløpig definert 0 - Ny publikasjon dvs. kodeverk eller begrepssamling tatt i bruk 1 - Bruk av publikasjonen opphørt 2 - Bruk av publikasjonen gjenopptatt 3 - Revisjon av publikasjonen mottatt fra ansvarlig utgiver og tatt i bruk 4 - Nye koder eller begreper tatt i bruk og/eller gamle koder utgår 9 - Annen oppdatering, f.eks. i termer tilknyttet et Kodeverkselement merknad ST KVR_MERKNAD Her kan eventuelt spesielle forhold rundt revisjonen av publikasjonen beskrives. For denne klassen benyttes kortnavnet KVREV. Unik nøkkel: KVR_KVPID, KVR_REVNR KITH 2002