Innehåll

Status

DEV

Versionshistorik

Begrepp

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]

• Socialstyrelsens kodverkslista för uppmärksamhetsinformation - bilaga till informationsspecifikationen för uppmärksamhetsinformation [R2]

• 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
Open	Medicinska tillstånd och behandlingar	Annat medicinskt tillstånd
		Behandling
		Förekomst av implantat Implantation Avlägsnande av implantat
		Förekomst av transplantat Transplantation
Open	Smitta	Förekomst av smittämne
		Förekomst av smittsam sjukdom
	Överkänslighet: Livshotande överkänslighet Skadlig överkänslighet Besvärande ö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

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

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.

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 [R3]):

• Health summary-arketyp [R4],

• Ad hoc heading-arketyp [R5],

• Precaution-arketyp [R6],

• Adverse reaction risk-arketyp [R7],

• Medication details-arketyp [R8].

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.

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.

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.

Implantation och Avlägsnande av implantat

Hanteras inte inom ramen för sekundärdokumentation eftersom det relevanta är att förekomst av implantat indikeras. Finns det i primärdokumentationen dokumentation gällande implantation, deducerar detta att det finns förekomst av implantat. På samma sätt deducerar 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.

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.

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.

Ö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.

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.

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.

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

Referenser

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.