/
Process för arketypmodellering

Process för arketypmodellering

Den här sidan beskriver det av openEHR Sverige rekommenderade tillvägagångsättet för att modellera arketyper. Processen beskriver vad man ska göra och i vilken ordning, men inte hur man utför själva modelleringsarbetet, då detta finns beskrivet på internationella sidor.

Innehåll

1 Grundläggande principer och förhållningssätt

Vid arketyputveckling gäller följande:

  • Använd i första hand existerande arketyper
    Om det inte finns arketyper som möter hela behovet, föreslå tillägg till befintliga arketyper.
    Om det inte räcker eller är möjligt, utveckla nya arketyper.

  • Utveckla i första hand arketyper som är internationellt gångbara
    Om det inte är relevant eller möjligt, utveckla arketyper som är nationellt gångbara.
    Om det inte är relevant eller möjligt, utveckla lokala arketyper.

  • Följ vedertagna designmönster för den typ av arketyp som ska utvecklas
    Läs på hur liknande arketyper utformats och dokumenterats.

  • Utveckla tvåspråkigt från start
    Nya arketyper ska ha engelska som källspråk, men att översätta till svenska direkt är en kvalitetsåtgärd som säkerställer att arketypen blir översättningsbar.

  • Terminologibindning på attribut kan med fördel ske på arketypnivå

  • Bindning mellan datavärden och terminologikoder sker sällan på arketypnivå
    Brukar fördelaktigt göras på templatenivå för att inte begränsa arketypens användning. Om det finns behov av att göra det ändå, se till att det inte är obligatoriskt att använda.

  • Rapportera fel
    Om du under arbetets gång hittar fel och brister i befintliga arketyper i CKM, gör en change request.

2 Innan du börjar

Innan en ny utredning för arketypmodellering påbörjas är det bra att ha koll på vilka verktyg som kan användas, vilka forum som kan utnyttjas för diskussion och hjälp, samt vilka förkunskaper som kommer leda till en enklare utvecklingsprocess.

2.1 Verktyg och forum

Vid arketypmodellering är följande verktyg och forum lämpliga att använda (det finns även andra):

Säkerställ att du har konton och åtkomst.

2.2 Förberedelser och förkunskaper

Följande sidor innehåller information som kan hjälpa till i utredningen och utvecklingen:

3 Utred

Det första steget i processen för arketypmodellering är att utreda behovet.

3.1 Identifiera informationsbehovet

Syfte: Förstå vilket kliniskt informationsbehov som ska modelleras.

Aktiviteter:

  • Dialog mellan klinisk domänexpert och informatik/modellerare.

  • Beskriva behovet i fritext (vad, varför, när informationen används).

  • Beskriva behovet i en mindmap.

  • Identifiera vilket kliniskt begrepp som efterfrågas.

Ansvar:

  • Klinisk domänexpert.

  • Arketypförfattare (t.ex. informatiker).

Resultat:

  • Ett tydligt formulerat arketypbehov.

3.2 Identifiera modelleringsbehovet

Syfte: Främja återanvändning och undvika duplicering.

Aktiviteter:

  • Sök i CKM efter arketyper som kan täcka det aktuella behovet.

  • Bedöm om befintliga arketyper:

    • kan återanvändas

    • kan specialiseras

    • inte täcker behovet.

  • Sök i Discourse eller openEHR Sverige om någon annan diskuterat samma behov.

Ansvar:

  • Arketypförfattare.

Resultat:

  • Lösningsförslag för hur behovet ska mötas (ny arketyp, specialisering, återanvändning).

3.3 Verifiera lösningsförslaget

Syfte: Säkerställ att idén håller och att alla perspektiv beaktats.

Aktivitet:

  • Ta upp lösningsförslaget i openEHR Sverige eller internationellt.

Ansvar:

  • Arketypförfattare.

Resultat:

  • Förankrat beslut om ny arketyp, specialisering eller återanvändning.

4 Utveckla ny arketyp

Om det beslutats att det finns ett behov av en ny arketyp så blir nästa steg att utveckla denna.

4.1 Fastställ arketypens omfattning

Syfte: Säkerställa rätt granularitet enligt openEHR‑principer.

Aktiviteter:

  • Skapa en mindmap över arketypens innehåll och gränser

  • Hitta korrekt arketyp‑typ (OBSERVATION, EVALUATION, ACTION, INSTRUCTION, ADMIN_ENTRY)

  • Hitta relevanta kodverk och urval för innehållet.

Riktlinjer:

  • Det kliniska fenomenet ska vara så avgränsat som möjligt men ändå kliniskt relevant - varken för litet (ingen teknisk fragmentering) eller för stort (inte hela formulär eller vårdprocesser).

  • Arketypen ska vara maxmängd för det kliniska fenomenet.

  • Arketypen ska kunna förstås och användas utan kontext.

  • Arketypen ska vara återanvändbar i flera templates.

  • Detaljer som bara gäller ett lokalt användningsfall hör hemma i template, inte arketyp.

  • Följ ramverket CGEM: https://freshehr.notion.site/Introduction-to-the-CGEM-Framework-115ed58514b344da825c3b42c372aff2 .

Ansvar:

  • Arketypförfattare i samråd med klinisk domänexpert.

Resultat: En mindmap.

4.2 Modellera arketypen

Syfte: Skapa en semantiskt korrekt och stabil modell.

Aktiviteter:

  • Modellera datavärden, strukturer och kardinalitet i Archetype Designer.

  • Välj korrekta datatyper för alla datafält.

  • Lägg till beskrivningar (purpose, use, misuse).

  • Genomför terminologibindningar till attribut där relevant.

  • Ange två epostadresser på Author-fältet, din egen samt contact@openehr.se.

Riktlinjer:

Ansvar:

  • Arketypförfattare.

Resultat: Utkast på en arketyp klar för granskning.

5 Uppdatera befintlig arketyp

En instruktion av processen för att förfråga en uppdatering på en existerande arketyp har skapats av openEHR International https://openehr.atlassian.net/wiki/spaces/healthmod/pages/2949196 .

6 Kvalitetssäkra

Det är viktigt att granska och kvalitetssäkra en arketyp efter att den utvecklats eller uppdaterats innan den publiceras.

Syfte: Säkerställa kvalitet innan publicering.

Aktiviteter:

  • Klinisk validering av begrepp och datainnehåll.

  • Teknisk granskning (struktur, constraints, återanvändbarhet).

  • Justering baserat på feedback.

  • Genomgång i modelleringsgrupp.

  • Identifiera oklarheter och förbättringar.

  • Säkerställa att regler/logik inte byggs in i arketypen.

Ansvar:

  • Klinisk domänexpert

  • Arketypförfattare.

Resultat: Slutversion av arketypen som är redo för publicering med version enligt https://openehr.atlassian.net/wiki/spaces/SWE/pages/2423029783.

7 Publicera

För att avsluta arbetet med en ny eller uppdaterad arketyp så bör den publiceras för att göras tillgänglig till andra. Detta kan göras både på nationell nivå via GitHub och internationell nivå via CKM. Arketypen kan användas lokalt innan den är publicerad internationellt.

7.1 GitHub

Syfte: Öka tillgängligheten för modellen så att fler kan ta del. Enklare att starta feedbackprocessen. Viktigt om det är en nationell arketyp som inte kommer hamna på CKM.

Aktiviteter:

Ansvar:

  • Arketypförfattare.

Resultat: Arketyp är tillgänglig i Sveriges GitHub-repository.

7.2 Internationella CKM

Om arketypen är internationellt gångbar så bör den publiceras i CKM.

Syfte: Förankra arketypen enligt openEHR International governance.

Aktiviteter:

Beslut:

  • Arketypens status (Draft → Team Review → Published).

Ansvar:

  • Arketypförfattare.

  • CKM‑roller enligt openEHR governance.

Resultat: Arketyp publicerad på CKM.

Nästa steg

När arketypen är fastställd fortsätter arbetet normalt med: