Uppmärksamhetsinformation i openEHR
Innehåll
- 1 Status
- 2 Versionshistorik
- 3 Begrepp
- 4 Relaterade dokument
- 5 Bakgrund
- 6 Uppmärksamhetsinformation
- 7 Hantering av uppmärksamhetsinformation i openEHR
- 7.1 Avgränsning
- 7.2 Template och arketyper
- 7.3 Användning av arketyperna och mappning från informationsspecifikationen till arketyperna
- 7.3.1 Health Summary
- 7.3.2 Ad hoc
- 7.3.3 Medicinskt tillstånd och behandling
- 7.3.3.1 Annat medicinskt tillstånd
- 7.3.3.2 Behandling
- 7.3.3.3 Förekomst av implantat, Implantation & Avlägsnande av implantat
- 7.3.3.3.1 Förekomst av implantat
- 7.3.3.3.2 Implantation och Avlägsnande av implantat
- 7.3.3.4 Förekomst av transplantat & Transplantation
- 7.3.3.4.1 Förekomst av transplantat
- 7.3.3.4.2 Transplantation
- 7.3.4 Smitta
- 7.3.4.1 Förekomst av smittämne
- 7.3.4.2 Förekomst av smittsam sjukdom
- 7.3.5 Överkänslighet
- 7.3.6 Särskild vårdrutin
- 7.3.7 Ej strukturanpassad uppmärksamhetsinformation
- 8 Appendix A: Medverkande och arbetssätt
- 9 Bilagor
Status
DEV
Versionshistorik
Version | Datum | Uppdatering | Ansvarig |
---|---|---|---|
0.1.0 | 2022-09-20 | Första utkast | Nationell arbetsgrupp för UMI i openEHR |
0.2.0 | 2023-05-30 | Fixat kommentarer | Nationell arbetsgrupp för UMI i openEHR |
0.3.0 | 2024-01-09 | Fixat återstående kommentarer | Nationell arbetsgrupp för UMI i openEHR |
0.4.0 | 2024-04-03 | Uppdaterad implementationsguide utifrån återkoppling i inkomna remissvar | Nationell arbetsgrupp för UMI i openEHR |
0.5. | 2024-06-10 | Lagt till förklarande kommentar för Medical_treatment_category (sv)-Treatment category angående vilken information som hanteras. Förtydligat att det är Precaution-arketypen som används för Implant, Transplant m.fl. | Nationell arbetsgrupp för UMI i openEHR |
0.6 | 2024-06-25 | Uppdaterat utifrån EHM:s input | Nationell arbetsgrupp för UMI i openEHR |
0.7 | 2024-08-20 | Förtydligat hur man anger tidpunkt för smittämne | Nationell arbetsgrupp för UMI i openEHR |
0.8 | 2024-09-17 | Uppdaterat implementationsguiden till att förhålla sig till version 6.0 av Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation | Nationell arbetsgrupp för UMI i openEHR |
0.9 | 2024-10-29 | Uppdaterat urval för transplantat till 113471000052100 |urval förekomst av transplantat, uppmärksamhetsinformation| Lagt till information om Last updated under Överkänslighetstillstånd. Added Valid period end to Other medical condition, Precaution (information) and Precaution (decision). Uppdaterat hur tidpunkter sätts för Implantat, Transplantat, Other medical condition, Precaution (information) och Precaution (decision) | Nationell arbetsgrupp för UMI i openEHR |
0.10 | 2024-11-12 | Uppdaterat användning av statusar resolved och refuted | Nationell arbetsgrupp för UMI i openEHR |
0.11 | 2024-11-18 | Lagt till mappning för allvarlighetsgrad | Nationell arbetsgrupp för UMI i openEHR |
0.12 | 2025-04-01 | Lagt till förtydligande om förhållande mellan tid- och statusangivelser samt beskrivning av urval för Adverse reaction risk.criticality. | Nationell arbetsgrupp för UMI i openEHR |
Begrepp
Begrepp | Beskrivning | Källa |
---|---|---|
Uppmärksamhetsinformation | Avser information i en patientjournal som behöver uppmärksammas särskilt | |
Uppmärksamhetsymbol | Symbolen signalerar för hälso- och sjukvårdspersonalen att det finns uppmärksamhetsinformation i befintlig journalinformation | Informationsspecifikation för uppmärksamhetsinformation – Version 5.1 |
Primärdokumentation | Avser till exempel en journalanteckning som innehåller information om att patienten är överkänslig mot en specifik substans i ett läkemedel, utifrån ett laboratoriesvar eller samtal med patienten. | Implementationsguide för Uppmärksamhetsinformation i openEHR |
Sekundärdokumentation | Avser till exempel information om överkänslighet i en separat modul som tänder uppmärksamhetssymbolen, dvs. informationen från primärdokumentationen används inte för att på ett automatiserat sätt tända uppmärksamhetssymbolen. | Implementationsguide för Uppmärksamhetsinformation i openEHR |
Relaterade dokument
Läs först startsidan Implementationsguider som bland annat beskriver vad dokumentstatus som DEV och rekommendationer som MUST (MÅSTE), MUST NOT (FÅR INTE), SHOULD (BÖR) osv. betyder i praktiken.
Relaterade dokument som hänvisas till i denna guide, för länk till dessa se Referenser:
Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1]
Clinical Knowledge Manager (CKM) som innehåller bl.a. arketyperna som används inom ramen för denna guide [R3]
Bakgrund
Denna implementationsguide har tagits fram av den nationella arbetsgruppen för UMI i openEHR som består av representanter från flera aktörer, som exempelvis regioner och systemleverantörer, i Sverige (se Appendix A: Medverkande och arbetssätt).
Implementationsguiden syftar till att beskriva hur openEHR kan användas i tillämpningen av uppmärksamhetsinformation på ett gemensamt leverantörsoberoende sätt. Även om det är frivilligt att använda implementationsguiden, är det viktigt för de som väljer att följa den, att noggrant följa alla instruktioner. Således står det ska (inte bör) i många av de efterföljande avsnitten med implementationsbeskrivningar.
Uppmärksamhetsinformation
Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation
Socialstyrelsen har “tagit fram en informationsspecifikation för uppmärksamhetsinformation. Specifikationen innehåller en nationellt överenskommen beskrivning av uppmärksamhetsinformation. Informationen är strukturerad utifrån nationell informationsstruktur och nationella informationsmängder, och är uttryckt med enhetliga termer och tillhörande koder från den svenska versionen av Snomed CT samt klassifikationen ICD-10-SE samt ATC. Informationen ska fungera som underlag för implementationen av uppmärksamhetsinformation i vårdinformationssystem.” [R1] Den senaste versionen är version 5.1.
I informationsspecifikationen beskrivs uppmärksamhetsinformation som information i en patientjournal som särskilt behöver uppmärksammas och som påverkar handläggningen av hälso- och sjukvård, till exempel patientens överkänsligheter. [R1]
Informationsspecifikationen beskriver även den särskilda symbolen som har tagits fram för att “signalera för hälso- och sjukvårdspersonalen att det finns uppmärksamhetsinformation i befintlig journalinformation. Symbolen är uppbyggd med ett utropstecken i mitten som betecknar överkänslighet med tre allvarlighetsgrader. De fyra övriga armarna i symbolen innehåller information om medicinskt tillstånd och behandling, smitta, särskild vårdrutin samt historiskt angiven information som inte är strukturanpassad.” [R1]
Uppmärksamhetsinformationen är indelad i “ett antal huvudgrupper som har en direkt koppling till uppmärksamhetssymbolen” [R2] och där respektive huvudgrupp har ett antal undergrupper:
Symbol | Huvudgrupp | Undergrupp |
| Medicinska tillstånd och behandlingar | Annat medicinskt tillstånd |
Behandling | ||
Förekomst av implantat Implantation Avlägsnande av implantat | ||
Förekomst av transplantat Transplantation | ||
Smitta | Förekomst av smittämne | |
Förekomst av smittsam sjukdom | ||
Överkänslighet:
| Kemikalie | |
Aktiv substans | ||
Hjälpämne läkemedel | ||
Läkemedelsprodukt | ||
Särskild vårdrutin | Information som kan leda till särskild vårdrutin | |
Beslut som kan leda till särskild vårdrutin | ||
Ej strukturanpassad uppmärksamhetsinformation | Historiskt angiven uppmärksamhetsinformation |
Tabell 1: Beskrivning av uppmärksamhetssymbolen och dess olika delar.
Primär- och sekundärdokumentation för uppmärksamhetsinformation i dagens vårdinformationssystem
I dagens vårdinformationssystem i Sverige behöver ansvarig hälso- och sjukvårdspersonal dokumentera uppmärksamhetsinformation i två separata steg för att uppmärksamhetssymbolen ska kunna tändas i enlighet med nedanstående:
hälso- och sjukvårdspersonalen skapar exempelvis en journalanteckning som innehåller information om att patienten är överkänslig mot en specifik substans i ett läkemedel, utifrån ett laboratoriesvar eller samtal med patienten (primärdokumentation)
hälso- och sjukvårdspersonalen anger information om denna överkänslighet i en separat modul (sekundärdokumentation) som tänder uppmärksamhetssymbolen, dvs. informationen från primärdokumentationen används inte för att kunna tända uppmärksamhetssymbolen.
Hantering av uppmärksamhetsinformation i openEHR
I efterföljande avsnitt beskrivs den rekommenderade hanteringen av uppmärksamhetsinformationen i openEHR utifrån aktuell version 5.1 (juni 2022) av Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation.
Fokus ligger på uppmärksamhetsinformation så som den anges vid sekundärdokumentation.
Avgränsning
Primärvårdsdokumentation
Hur primärvårdsdokumentationen skulle behöva modelleras i openEHR för att uppmärksamhetsinformation skulle kunna härledas ifrån den med hjälp av ett regelverk ligger utanför scopet för den här implementationsguiden. Anledningen till denna avgränsning är att arbetsgruppen har endast möjlighet att avsätta lite tid på arbetet med implementationsguiden och ville då fokusera på att fastställa en första version av guiden som sedan kan uppdateras. Arbetsgruppen anser att modelleringen av primärvårdsdokumentationen (som kan användas för att härleda uppmärksamhetsinformation) är viktigt men uppfattar att det är ett väldigt omfattande arbete eftersom det rör många olika delar av hälso- och sjukvårdsdokumentationen, t.ex.. läkemedelsdokumentation eller dokumentation av ingrepp (där implantat sätts in) och arbetsgruppen är fundersamt över huruvida den i sin nuvarande sammansättning är rätt gruppering för att modellera just denna information i openEHR. Arbetsgruppen anser att det vore bra om arbetet kan göras i framtiden när tid och resurser (med rätt kompetens) finns.
Angivelse av status och tid
Templaten specificerar för alla UMI-huvudgrupper vad som ska anges gällande status och tid men inte om status styr tiden eller om tiden styr status i en systemimplementation eftersom det kan hanteras på olika sätt i olika system, t.ex. så kan system 1 hanterar det genom att användaren ändrar status till aktiv och så sätts starttidpunkten av systemet till den tidpunkten då statusen har ändrats till aktiv, medan system 2 realiserar det genom att användaren sätter starttidpunkten till dagens datum och så sätts status av systemet till aktiv. . Hur detta görs är en implementationsfråga och templaten styr inte angivelse.
Template och arketyper
Inom ramen för arbetet med denna guide har den nationella arbetsgruppen för UMI tagit fram en openEHR-template som utgör en rekommendation på hur uppmärksamhetsinformation ska realiseras med hjälp av openEHR.
Templaten utgörs av filen “Medical Alert Information v2.t.json” som finns att hämta i en första alpha-version (1.0.0-alpha.1) under: Release UMI_template.1.0.0-alpha.1 · modellbibliotek/CKM-mirror (github.com). För en beskrivning av hur templaten kan öppnas i Archetype Designer se bilagan i detta dokument. Senaste version av templaten finns under CKM-mirror/local at UMI-warning-info · modellbibliotek/CKM-mirror (github.com) och kan komma att förändras med tid.
Templaten använder nedanstående arketyper som bedömdes vara relevanta för att hantera uppmärksamhetsinformation (det handlar om befintliga internationella arketyper som är publicerade i en första eller högre version i CKM:en):
Just nu använder templaten den engelska versionen av arketyperna då publicerade svenska versioner saknas. Det pågår ett parallellt arbete för att översätta de använda arketyperna till svenska.
Utöver dessa arketyper har arbetsgruppen tagit fram den nya Cluster-arketypen medical_treatment_category.v0 som finns här: CKM-mirror/local/openEHR-EHR-CLUSTER.medical_treatment_category.v0.adl at UMI-warning-info · modellbibliotek/CKM-mirror (github.com)
Nedanstående bild illustrerar hur arketyperna används för att hantera de olika grupper av uppmärksamhetsinformationen.
Användning av arketyperna och mappning från informationsspecifikationen till arketyperna
I efterföljande avsnitt beskrivs hur arketyperna ska användas för att hantera uppmärksamhetsinformation samt hur uppmärksamhetsinformation så som definierad i Socialstyrelsens informationsspecifikation översätts till arketyperna. I vissa fall beskrivs även logik som ska följas och som inte framgår i templaten.
Vissa attribut hanterar urval, som t.ex. “Annat medicinskt tillstånd.värde”. Urvalen finns tillgängliga i Socialstyrelsens kodverkslista för uppmärksamhetsinformation - bilaga till informationsspecifikationen för uppmärksamhetsinformation alternativt i templaten.
Health Summary
“Health Summary”-arketypen används för att definiera den övergripande strukturen i en sammanhängande uppsättning kliniska data, i detta fall data relaterad till uppmärksamhetsinformation.
Ad hoc
“Ad hoc”-arketypen används för att tillhandahålla generiska rubriker inom ett specifikt kliniskt sammanhang, i detta fall för att dela in samt namnge kliniska data i uppmärksamhetssymbolens olika delar.
Medicinskt tillstånd och behandling
I efterföljande avsnitt beskrivs arketyperna som ska användas för huvudgruppen “Medicinskt tillstånd och behandling”. Arketyperna presenteras per undergrupp.
Annat medicinskt tillstånd
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Annat medicinskt tillstånd”.
Nedanstående bild visar det utsnitt från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Annat medicinskt tillstånd”.
Nedanstående bild visar arketypen som ska användas för att hantera “Annat medicinskt tillstånd” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Annat medicinskt tillstånd”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass, ingående attribut samt tillåten värdemängd (där tillämpbart) i enlighet med informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp, ingående attribut samt tillåten värdemängd (där tillämpbart) | Kommentar |
---|---|---|
Annat medicinskt tillstånd | Precaution (Other medical condition) |
|
värde | Condition | Other medicial condition.condition ska sättas till Annat medicinskt tillstånd.värde Som värde anges en Snomed CT-kod från urvalet “Uppmärksamhetsinformation Annat medicinskt tillstånd (1.2.752.116.3.1.16.1.1)” Urvalet finns tillgängligt i Socialstyrelsens kodverkslista för uppmärksamhetsinformation, alternativt i templaten. |
status [observerad förekomst] | Status [Active/Resolved/Refuted] | Precaution.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Statusarna Resolved och Refuted ska leda till att UMI-symbolen släcks. |
tid [TS] | Valid period start Valid period end | Valid period start sätts till det datumet då Status ändras till Active. Valid period end sätts till det datumet då Status sätts till Resolved/Refuted. |
negation [sant/falskt] | - | Hanteras i arketypens status-attribut |
Behandling
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Behandling”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Behandling”.
Nedanstående bild visar arketypen som ska användas för att hantera “Behandling” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Behandling”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
---|---|---|
Behandling | Precaution (Treatment) |
|
kod | Condition | Treatment.condition ska sättas till Behandling.kod Som kod anges antingen Snomed CT koden “416608005 |läkemedelsbehandling|” (som pekas ut för kod i informationsmodellen) eller en av nedanstående Snomed CT-koderna från urvalet “Uppmärksamhetsinformation Behandling (1.2.752.116.3.1.16.1.2)”
|
status [pågående, utförd, avbruten] | [Active/Resolved/Refuted] | Treatment.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Status Refuted ska leda till att UMI-symbolen släcks. |
tid [IVL<TS>] | Valid period start & Valid period end | Valid period start sätts till det datumet då Status ändras till Active. Valid period end sätts till det datumet då Status sätts till Refuted. |
Active substans.typ/ | Medication details.Name |
|
- | Medical_treatment_category (sv)-Treatment category | I informationsspecifikationen anger Socialstyrelsen att “Läkemedelsbehandlingar anges i kodverket i form av ett urval av ATC-koder (1.2.752.116.3.1.16.1.2.2)”, t.ex. B01AA Vitamin K-antagonister. Dessa ATC-koder utgör urvalet under Medical treatment category. |
Logik
Om “Läkemedelsbehandling” har valts under “Condition” så ska “Medical treatment category” och “Medication details” vara obligatoriska att ange. Vid val av “BIPAP-behandling” och “Dialysbehandling” är dessa inte relevanta.
Fälten “Medical treatment category” och “Medication details” hänger ihop. Implementationen av dessa kan variera men ska följa templaten och nedanstående logik:
Läkemedlet som anges under “Medication details” ska
kunna anges med hjälp av ATC-kod, NPL-id:er eller NSL-id:er
ingå i en av ATC-grupperna som finns specade i templaten för “Medical treatment category”
Exempel
Beslut om waranbehandling (ATC-kod: B01AA03) tas och dokumenteras
Waranbehandlingen klassas som uppmärksamhetsinformation (eftersom den ingår i ATC-gruppen B01AA) och hanteras enligt följande
“Condition” sätts till: läkemedelsbehandling
“Medical treatment category” sätts till: Antikoagulantiabehandling, Vitamin K-antagonister
“Medication details” sätts till: Waranbehandling (B01AA03)
Förekomst av implantat, Implantation & Avlägsnande av implantat
Förekomst av implantat
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Förekomst av implantat”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Förekomst av implantat”.
Nedanstående bild visar arketypen som ska användas för att hantera “Förekomst av implantat” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Förekomst av implantat”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
---|---|---|
Förekomst av implantat | Precaution (Implantat) |
|
värde | Condition | Implant.condition ska sättas till Förekomst av implantat.värde. Som värde anges en Snomed CT-kod från urvalet “Uppmärksamhetsinformation Förekomst av implantat (1.2.752.116.3.1.16.1. 3.1)” Urvalet finns tillgängligt i Socialstyrelsens kodverkslista för uppmärksamhetsinformation, alternativt i templaten. Detta innebär att information i klassen Implantat inte används. |
status [observerad förekomst] | Status [Active/Resolved/Refuted] | Implant.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Statusarna Resolved och Refuted ska leda till att UMI-symbolen släcks. |
tid [TS] | Valid period start & Valid period end | Valid period start sätts till det datumet då Status ändras till Active. Valid period end sätts till det datumet då Status sätts till Resolved/Refuted. |
negation [sant/falskt] | - | Hanteras i arketypens status-attribut |
Kroppsstruktur | - | Hanteras inte inom ramen för sekundärdokumentation. |
Tillverkare | - | Hanteras inte inom ramen för sekundärdokumentation. |
Produktnamn | - | Hanteras inte inom ramen för sekundärdokumentation. |
Modellnummer | - | Hanteras inte inom ramen för sekundärdokumentation. |
Implantation och Avlägsnande av implantat
Klasserna Implantation och Avlägsnande av implantat samt tillhörande attribut har inte mappats till arketypen eftersom det relevanta för sekundärdokumentationen är att förekomst av implantat anges. Finns det i primärdokumentationen dokumentation gällande implantation, medför detta att det finns förekomst av implantat. På samma sätt medför ett avlägsnande av implantat i primärdokumentationen att förekomst av implantat negeras i sekundärdokumentationen.
Förekomst av transplantat & Transplantation
Förekomst av transplantat
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Förekomst av transplantat”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Förekomst av transplantat”.
Nedanstående bild visar arketypen som ska användas för att hantera “Förekomst av transplantat” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Förekomst av transplantat”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
---|---|---|
Förekomst av transplantat | Precaution (Transplant) |
|
värde | Condition | Transplant.condition ska sättas till Förekomst av transplantat.värde. Som värde anges en Snomed CT-kod från urvalet “113471000052100 |urval förekomst av transplantat, uppmärksamhetsinformation|” Urvalet finns tillgängligt i Socialstyrelsens kodverkslista för uppmärksamhetsinformation, alternativt i templaten. |
status [observerad förekomst] | Status [Active/Resolved/Refuted] | Transplant.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Statusarna Resolved och Refuted ska leda till att UMI-symbolen släcks. |
tid [TS] | Valid period start & Valid period end | Valid period start sätts till det datumet då Status ändras till Active. Valid period end sätts till det datumet då Status sätts till Resolved/Refuted. |
negation [sant/falskt] | - | Hanteras i arketypens status-attribut |
Kroppsstruktur | - | Hanteras inte inom ramen för sekundärdokumentation. |
Transplantation
Hanteras inte inom ramen för sekundärdokumentation eftersom det relevanta är att förekomst av transplantat indikeras. Finns det i primärdokumentationen dokumentation gällande transplantation, deducerar detta att det finns förekomst av transplantat.
Smitta
I efterföljande avsnitt beskrivs arketyperna som ska användas för huvudgruppen “Smitta”. Arketyperna presenteras per undergrupp.
Förekomst av smittämne
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Förekomst av smittämne”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Förekomst av smittämne”.
Nedanstående bild visar arketypen som ska användas för att hantera “Förekomst av smittämne” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Förekomst av smittämne”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
---|---|---|
Förekomst av smittämne | Precaution (Carrier) |
|
värde | Condition | Carrier.condition ska sättas till Förekomst av smittämne.värde, t.ex. MRSA. Urval finns tillgängligt i Socialstyrelsens kodverkslista för uppmärksamhetsinformation, alternativt i templaten. |
status [observerad förekomst] | Status [Active/Resolved/Refuted] | Carrier.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Statusarna Resolved och Refuted ska leda till att UMI-symbolen släcks. |
tid [TS|IVL] | Valid period start & Valid period end | Om enbart tidpunkt finns så ska den anges under Valid period start. Om tidsintervall anges används både Valid period start & Valid period end.
|
negation [sant/falskt] |
| Hanteras i arketypens status-attribut |
Förekomst av smittsam sjukdom
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Förekomst av smittsam sjukdom”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Förekomst av smittsam sjukdom”.
Nedanstående bild visar arketypen som ska användas för att hantera “Förekomst av smittsam sjukdom” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Förekomst av smittsam sjukdom”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
---|---|---|
Förekomst av smittsam sjukdom | Precaution (Contagious disease) |
|
värde | Condition | Contagious disease.condition ska sättas till Förekomst av smittsam sjukdom.värde, t.ex. blodsmitta hos gravid. Urval finns tillgängligt i Socialstyrelsens kodverkslista för uppmärksamhetsinformation, alternativt i templaten. |
status [observerad förekomst] | Status [Active/Resolved/Refuted] | Contagious disease.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Statusarna Resolved och Refuted ska leda till att UMI-symbolen släcks. |
tid [TS|IVL] | Valid period start & Valid period end | Om enbart tidpunkt finns så ska den anges under Valid period start. Om tidsintervall anges används både Valid period start & Valid period end. |
negation [sant/falskt] |
| Hanteras i arketypens status-attribut |
Överkänslighet
I efterföljande avsnitt beskrivs arketypen som ska användas för huvudgruppen “Överkänslighet”.
“Adverse reaction risk”-arketypen ska användas för att hantera uppmärksamhetsinformation inom huvudgruppen “Överkänslighet”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar huvudgruppen “Överkänslighet”.
Nedanstående bild visar arketypen som ska användas för att hantera “Överkänslighet” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Överkänslighet”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
|
---|---|---|---|
Överkänslighetstillstånd | Adverse reaction risk |
|
|
värde | - | Hanteras inte i arketypen. Enligt Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation ska det under “värde” anges Snomed-koden “418038007 | substansöverkänslighet |” som anger att det som har observerats är en substansöverkänslighet. Vi anser att denna information framgår i arketypen av att attributet, där substansen som överkänsligheten gäller, heter Adverse reaction risk.substance. |
|
status [observerad förekomst] | Active/inactive status [Active/Inactive] | Adverse reaction risk.active/inactive status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Status Inactive ska leda till att UMI-symbolen släcks. |
|
tid [TS] | Onset of last reaction Onset of first reaction | Adverse reaction risk.onset of last reaction ska anges och Adverse reaction risk.onset kan anges |
|
| Last updated | Last updated sätts till det datumet då Status ändras till Active, resp. Inactive. |
|
allvarlighetsgrad [livshotande, skadlig, besvärande] | Criticality [low, high, Indeterminate]
[life threatening severity, harmful, discomforting] | Adverse reaction risk.citicality ska sättas till det urval som Socialstyrelsen har definierat och som innehåller livshotande (life threatening severity), skadlig (harmful) och besvärande (discomforting). I templaten har därför urvalet som fanns i arketypen, och som innehåller low, high och indeterminate, ersatts av Socialstyrelsen urval. Vid behov kan Socialstyrelsens urval mappas enligt följande till urvalet i arketypen:
Urval finns tillgängligt i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, alternativt i templaten. |
|
visshetsgrad [misstänkt] | Verfication status [Unconfirmed/Confirmed/Refuted] | Adverse reaction risk.verfication status ska sättas enligt följande:
|
|
negation [sant/falskt] |
| Hanteras i arketypens status-attribut |
|
Active substans.typ/ | Substance |
|
|
- | Category | ska sättas enligt nedanstående, beroende på vad som har angetts under Substance
|
|
Verifieringsmetod | - | Hanteras inte i arketypen utifrån följande resonemang: När det gäller metod för att verifiera en uppgift om uppmärksamhetsinformation så ser vi att det kan vara svårt att få fram det i det sekundära steget om det inte fanns dokumenterat i primärdokumentationen. Exakt hur verifieringen skett är betydligt mindre viktigt vid sekundärdokumentationen än att det skett en verifiering och hur säker den är (visshetsgrad). Vi väljer därför att frångå Socialstyrelsen specifikation just i sekundära steget. Vi står dock kvar vid att primärdokumentationen ska utformas så att verifieringsmetod går att dokumentera. |
|
Logik
Fälten “Category” och “Substance” hänger ihop. Implementationen av dessa kan variera men ska följa templaten och nedanstående logik:
Substansen som anges under “Substance” ska
kunna anges med hjälp av ATC-kod, NPL-id:er eller NSL-id:er
ingå i en av kategorierna som finns specade i templaten för “Category” där
farmaceutiskt hjälpämne: används för hjälpämnen som anges med NSL-id för hjälpämne
läkemedel: används för läkemedelssubstanser som anges med NSL-id för aktiv läkemedelssubstans eller ATC-kod
kemikalie: används för kemikalier som anges med kod från 59871000052102 |urval kemikalieöverkänsligheter, uppmärksamhetsinformation|
läkemedel (produkt): används för läkemedelsprodukter som anges med NPL-id
Exempel
Överkänslig mot Fenoximetylpenicillin konstateras och dokumenteras
Läkemedelsöverkänslighet klassas som uppmärksamhetsinformation och hanteras enligt följande
Alternativ A
“Substance” sätts till ATC-kod: Fenoximetylpenicillin (penicillin V) (J01CE02)
“Category” sätts till: läkemedel
Alternativ B
“Substance” sätts till NSL-id: fenoximetylpenicillin (IDE4POBZU95UFVERT1)
“Category” sätts till: läkemedel
Alternativ C
“Substance” sätts till NPL-id för den produkten som har getts, t.ex. Kåvepenin (19840907000066)
“Category” sätts till: läkemedel (produkt)
Särskild vårdrutin
I efterföljande avsnitt beskrivs arketyperna som ska användas för huvudgruppen “Särskild vårdrutin”. Arketyperna presenteras per undergrupp.
Information som kan leda till särskild vårdrutin
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Information som kan leda till särskild vårdrutin”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Information som kan leda till särskild vårdrutin”.
Nedanstående bild visar arketypen som ska användas för att hantera “Information som kan leda till särskild vårdrutin” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Information som kan leda till särskild vårdrutin”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
---|---|---|
Information som kan leda till särskild vårdrutin | Precaution (Information) |
|
värde | Condition | Information.condition ska sättas till Information som kan ledan till särskild vårdrutin.värde. Urval finns tillgängligt i Socialstyrelsens kodverkslista för uppmärksamhetsinformation, alternativt i templaten. |
status [observerad förekomst] | Status [Active/Resolved/Refuted] | Information.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Statusarna Resolved och Refuted ska leda till att UMI-symbolen släcks. |
tid [TS] | Valid period start Valid period end | Valid period start sätts till det datumet då Status ändras till Active. Valid period end sätts till det datumet då Status sätts till Resolved/Refuted. |
negation [sant/falskt] | - | Hanteras i arketypens status-attribut |
Beslut som kan leda till särskild vårdrutin
“Precaution”-arketypen ska användas för att hantera uppmärksamhetsinformation inom undergruppen “Beslut som kan leda till särskild vårdrutin”.
Nedanstående bild visar det utsnittet från informationsmodellen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] som specificerar undergruppen “Beslut som kan leda till särskild vårdrutin”.
Nedanstående bild visar arketypen som ska användas för att hantera “Beslut som kan leda till särskild vårdrutin” och vilka attribut som är relevanta.
Nedanstående tabell visar hur information om “Beslut som kan leda till särskild vårdrutin”, så som definierad i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation, översätts till arketypen.
Klass och ingående attribut i informationsspecifikation för uppmärksamhetsinformation | Namn på mappad arketyp ingående attribut | Kommentar |
---|---|---|
Beslut som kan leda till särskild vårdrutin | Precaution (Decision) |
|
kod | Condition | Decision.condition ska sättas till Beslut som kan ledan till särskild vårdrutin.värde. Urval finns tillgängligt i Socialstyrelsens kodverkslista för uppmärksamhetsinformation, alternativt i templaten. |
beskrivning | Comment |
|
bifall [sant/falskt] | Status [Active/Resolved/Refuted] | Decision.status ska sättas enligt följande:
Status Active ska leda till att UMI-symbolen tänds. Statusarna Resolved och Refuted ska leda till att UMI-symbolen släcks. |
tidpunkt [TS] | Valid period start Valid period end | Valid period start sätts till det datumet då Status ändras till Active. Valid period end sätts till det datumet då Status sätts till Resolved/Refuted. |
Ej strukturanpassad uppmärksamhetsinformation
Ej strukturanpassad uppmärksamhetsinformation har inte varit relevant för modellering i openEHR.
Appendix A: Medverkande och arbetssätt
Arbetssätt
Arbetet initierades från den svenska openEHR-förvaltningen (2022-01-21) och har genomförts huvudsakligen inom ramen för den nationella arbetsgruppen för UMI i openEHR via 90-minuters distansmöten.
I en första arbetsfas bekantade och fördjupade sig arbetsgruppen i Socialstyrelsens informationsspecifikation för uppmärksamhetsinformation [R1] samt tillhörande kodverkslista [R2].
I den andra arbetsfasen utredde arbetsgruppen vilka befintliga arketyper som kan vara relevanta för att hantera uppmärksamhetsinformation. Beslutet fattades att arbetsgruppen skulle jobba med en huvudgrupp i taget och identifiera den, resp. de arketyper som är relevanta. Arbetsgruppen tog även hänsyn till det arbetet som man har gjort i Norge för att modellera “Kritisk informasjon i kjernejournal” [R9]. Där det var möjligt, återanvändes designen/strukturen i det svenska arbetet. För att testa strukturen skapade arbetsgruppen en template som innehåller de relevanta arketyperna.
Nationell arbetsgrupp för UMI i openEHR
I arbetsgruppen ingick representanter från flera aktörer, som exempelvis regioner och systemleverantörer, i Sverige. Arbetsgruppens medlemmar varierade under tiden där nedanstående listan omfattar samtliga personer som har varit med i någon omfattning sedan 2022-01-21:
Emma Molin, Cambio
Ann-Sofi Avindell, Cambio
Joana Vicente, Cambio
Mikael Nyström, Cambio
Anette A. Larsson, Tietoevry
Claudia Ehrentraut, Karolinska Universitetssjukhuset (Region Stockholm)
Erik Sundvall, Karolinska Universitetssjukhuset (Region Stockholm)
Rikard Lövström, Karolinska Universitetssjukhuset (Region Stockholm)
Carina Sandell, Region Östergötland
Thérèse Högberg Mårder, Region Östergötland
David Wetterbro, Region Östergötland
Ander Thurin, Sahlgrenska Universitetssjukhuset (Västra Götalandsregionen)
Hans Natvig, Akademiska sjukhuset (Region Uppsala)
Ruth Lochan Winton, Akademiska sjukhuset (Region Uppsala)
Daniel Karlsson, E-hälsomyndigheten
Alexandra Saraiva Leao, C.A.G Consoden
Bilagor
Öppna templaten ifrån en zipfil i Archetype Designer
För att öppna templaten i Archetype Designer följ nedanstående steg:
Gå till Release UMI_template.1.0.0-alpha.1 · modellbibliotek/CKM-mirror (github.com)
Ladda ner Source code-zipfilen
Gå till Archetype Designer och logga in
Skapa ett repository av typ local folder och öppna repositoryt
Öppna import-fliken
“Drag and drop” zipfilen in i utsedd ruta
Välj upload och stäng rutan
Skriv namnet på template-filen “Medical Alert Information v2” i sökrutan
Öppna templaten som visas under template.
För att se templaten i formulärvy, gå till fliken forms
Observera att zipfilen innehåller fler än de UMI-relaterade arketyper och templates.