1. Introduktion
Den nationale, fælles platform for telemedicin, herefter betegnet eHealth Infrastrukturen, er baseret på brug af klassifikationer i modellering og snitflader. eHealth Infrastrukturens services bygger på Health Level 7 (HL7) Fast Healthcare Interoperability Resources (FHIR), der gør udstrakt brug af klassifikationer under en fælles betegnelse, terminologi.
1.1. Læsevejledning
Nærværende vejledning omhandler processen omkring vedligeholdelse af terminologi og altså ikke processen for bestemmelse af hvilke konkrete koncepter, der skal indgå i en given klassifikation. Målgruppen er primært personer, der skal vedligeholde terminologi i eHealth Infrastrukturen, men kan have interesse for anvendere af terminologien.
Nøgleordene SKAL, MÅ IKKE, BØR, BØR IKKE, KAN, MÅ skrevet i versaler skal fortolkes som beskrevet i RFC2119.
1.2. Referencer
Reference |
Titel |
Beskrivelse |
Key words for use in RFCs to Indicate Requirement Levels |
RFC key words |
1.3. Dokumenthistorik
Revision |
Dato |
Ansvarlig |
Beskrivelse |
1.0 |
24. februar 2020 |
EN, Systematic |
Første udgave |
2. Begreber
Klassifikation |
Benyttes oftest som betegnelse for klassifikationssystem men anvendes i nogle sammenhænge om både klassifikationssystem og udfaldsrum. |
Klassifikationssystem |
En ordning af begreber, der opfylder kriterier for at beskrive et emne eller begreb. Se CodeSystem. |
Begreb |
Ide eller forestilling. |
Koncept |
I denne sammenhæng betegner koncept beskrivelsen af et begreb i et CodeSystem. |
Governance |
I denne sammenhæng betegner governance styring af hvordan terminologi anvendt i et projekt eller program oprettes, vedligeholdes, udgives og udfases. Formålet med governance er at sikre at terminologien udvikler sig konsistent, sammenhængende og med fokus på effektiv anvendelse. |
Udfaldsrum |
Mængde af begreber, der må anvendes i en given kontekst. Se ValueSet. |
Terminologi |
I denne sammenhæng er terminologi en fællesbetegnelse for FHIR CodeSystem, ValueSet, NamingSystem og ConceptMap. Se https://www.hl7.org/fhir/terminologies.html. |
FHIR CodeSystem |
Identificerbar og versioneret FHIR ressource, der beskriver et klassifikationssystem og udtrykker hvilke koncepter, der indgår. Se FHIR CodeSystem. |
FHIR ValueSet |
Identificerbar og versioneret FHIR ressource, der beskriver et udfaldsrum. Se ValueSet. |
FHIR NamingSystem |
Et NamingSystem kan beskrive CodeSystem eller registre, sidstnævnte i FHIR kendt som identifier system. |
FHIR ConceptMap |
Et ConceptMap beskriver en mapning fra koncepter i et ValueSet til koncepter i et andet. |
2.1. Aktører
Hvad angår vedligeholdelse af terminologi findes alene rollen Terminologiadministrator i eHealth Infrastrukturen. Denne rolle giver adgang til at vedligeholde de fleste interne CodeSystem og ValueSet.
Der kan i tillæg være behov for at sammensætte en gruppe eller et governance-organ, der fungerer som ordstyrende i forhold til udviklingen i terminologien. Gruppen vil formodentlig koordinere og formidle denne governance via yderligere værkøjer end de, der er tilgængelige i infrastrukturen.
3. Brug af terminologi i eHealth Infrastrukturen
CodeSystem ressourcer skabes for klassifikationer hvad enten de er eksternt definerede eller internt vedligeholdt af eHealth programmet.
ValueSet ressourcer skabes for udfaldsrum, igen, hvad enten de er eksternt eller internt definerede. Et ValueSet kan på definitionstidspunktet beskrives ekstensionelt eller intensionelt. Et ekstensionelt ValueSet indeholder eksplicit nævnelse af alle de koncepter, der indgår fra et eller flere CodeSystem og/eller ValueSet. Et intensionelt ValueSet indeholder udtryk, der bevirker udvælgelse af koncepter eller inkluderer hele CodeSystem eller ValueSet. Det intensionelle ValueSet kan godt indeholde eksplicit nævnelse af nogle koncepter samtidig med et eller flere intensionelle udtryk. Det intensionelle ValueSet er lettere at vedligeholde. Når der er behov for at kende præcist hvilke koncepter, der indgår i et ValueSet, kan Terminologiserver-operationen $expand udføres på et ValueSet. Se https://www.hl7.org/fhir/valueset-operation-expand.html.
NamingSystem kan beskrive CodeSystem eller registre, sidstnævnte i FHIR kendt som identifier system. Eksempelvis findes et NamingSystem, der beskriver hvordan man i eHealth Infrastrukturen udtrykker et dansk, centralt personregister (CPR) nummer for en person.
ConceptMap beskriver en mapning mellem koncepter fra et ValueSet til et andet.
3.1. Binding til ValueSet fra profiler
FHIR ressourcer indeholder typisk og ofte flere elementer, der udtrykkes via kodet udtryk i form af Coding eller CodeableConcept (se Using Codes in Resources).
FHIR ressourcedefinitionerne udgør standard-profiler, der kan ændres med egne profiler. Dette er foretaget for de fleste FHIR ressourcer i eHealth Infrastrukturen. I profiler kan og er der for kodet udtryk typisk udpeget en binding til det ValueSet, der beskriver udfaldsrummet.
3.2. I ressourcer refereres til CodeSystem url
Når der oprettes en FHIR ressource er kodede elementer beskrevet ved hjælp af Coding. Per guideline for eHealth Infrastrukturen SKAL:
-
Coding.system
udpege url for det CodeSystem, hvor konceptet er defineret -
Coding.code
udpege koden for konceptet som beskrevet i CodeSystem -
Coding.display
beskrive den tilhørende display for konceptet i CodeSystem
En FHIR ressource kan derfor valideres i forhold til den profil, den påstår at overholde, da et kodet udtryk kan kontrolleres mod en ekspansion af det ValueSet, der er lavet binding til.
Som eksempel indeholder en ActivityDefinition et kodet element i ActivityDefinition.code
, der udtrykker hvilken type aktivitet, der er tale om. I profilen ehealth-activitydefinition
er der lavet binding til et ValueSet, defineret ved udvalgte koncepter fra CodeSystem SNOMED CT
og alle koncepter fra ValueSet ObservationCodes
. ValueSet ObservationCodes
er defineret ved udvalgte koncepter fra CodeSystem SNOMED CT
, koncepter fra CodeSystem NPU-DK
og koncepter fra MCS
.
ActivityDefinition.code
i en ActivityDefinition-ressource, der overholder profilen ehealth-activitydefinition
I en konkret ActivityDefinition-instans indeholder ActivityDefinition.code
en Coding
, fx:
-
Coding.system
sat tilurn:oid:1.2.208.176.2.1
(for NPU-DK klassifikationen) -
Coding.code
sat tilNPU03011
som er koden for konceptet iltmætning i NPU-DK. -
Coding.display
sat tilHb(Fe; O<sub>2</sub>-bind.; aB)—Oxygen(O<sub>2</sub>); mætn. = ?
som er display-teksten for iltmætning i NPU-DK.
3.3. Betydning af binding strength
Når en profil for en ressource indeholder et element med binding til et ValueSet, så er der sat en binding strength. Binding strength anfører hvor rigidt, der valideres for overensstemmelse. Binding strength kan antage en af følgende værdier:
required
|
Et koncept SKAL være indeholdt i en ekspansion af det ValueSet, der er binding reference til. |
extensible
|
Et koncept SKAL være anført med den tilhørende kode, hvis det er indeholdt i en ekspansion af det ValueSet, der er binding reference til. Der må anføres koder for koncepter fra andre ValueSet og CodeSystem. |
preferred
|
Et koncept BØR være anført med den tilhørende kode, hvis det er indeholdt i en ekspansion af det ValueSet, der er binding reference til. Der må anføres koder for koncepter fra andre ValueSet og CodeSystem. |
example
|
Et koncept KAN være anført med den tilhørende kode, hvis det er defineret i det ValueSet, der er binding reference til. Det er anført som eksempel og der kan frit vælges koncepter fra andre ValueSet/CodeSystem. |
4. Governance
Følgende retningslinier udgør styring af, hvordan terminologi kan oprettes, ændres og nedlægges.
Important
|
En publiceret version af et klassifikationssystem eller udfaldsrum er uforanderligt. |
Den eneste ændring, der tillades for samme version er skift fra publiceret til udfaset.
Important
|
Et klassifikationssystem eller udfaldsrum kan ændres via publicering af ny(e) version(er). |
Important
|
Et koncept SKAL bevares med uforandret kode og betydning når først indeholdt i publiceret klassifikationssystem. |
Important
|
Et koncept KAN udfases men MÅ IKKE slettes når først indeholdt i publiceret klassifikationssystem. |
Important
|
Et publiceret udfaldsrum SKAL været defineret ved publicerede klassifikationssystem(er) og/eller udfaldsrum. |
Important
|
Et udfaldsrum KAN udfases men MÅ IKKE slettes når først bundet (via binding) til element i en profil. |
Important
|
Profiler anvendt i eHealth infrastrukturen SKAL referere ValueSet uden versionsnummer. |
Profilernes binding gælder dermed til seneste version af pågældende ValueSet.
Important
|
ValueSet anvendt i eHealth infrastrukturen BØR referere CodeSystem og ValueSet uden versionsnummer. |
Dermed kan ændringer i CodeSystem og ValueSet slå igennem i udfaldsrum for elementer i FHIR ressourcerne.