Innehåll
Table of Contents | ||||
---|---|---|---|---|
|
Status
DEV
Versionshistorik
Version | Datum | Uppdatering | Ansvarig |
---|---|---|---|
0.1.0 | Första version för internremiss | ||
0.2.0 | 2021-12 | Inför första remissrundan | PDL-arbetsgruppen |
2022-02-08 | Förslag till ändrad kodning av roll (från OID till samma Snomed-begrepp som svenska FHIR-profilerna planerar införa) samt ändrad hierarki (enl förslag #2 i remissens diskussionsfrågor) har markerats och alternativa skrivningar påbörjats. | PDL-arbetsgruppen via Erik Sundvall | |
0.4.0 | 2022-03-29 | Ny version efter remissomgång 1 | PDL-arbetsgruppen |
...
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.
...
Krav-ID | Beskrivning | Fördjupnings-avsnitt |
---|---|---|
COMPOSITION.context → EVENT_CONTEXT.other_context MÅSTE ange vårdenhet och vårdgivare som ska användas för utvärdering av åtkomst ur PDL-perspektiv. | ||
Lagring av vårdenhet och vårdgivare i COMPOSITION.context → EVENT_CONTEXT.other_context MÅSTE göras genom att inkludera templaten “Care Unit”en template som motsvarar den som specificeras i denna implementationsguide. | ||
Vid tillämpning av arketypen “Care Unit” ska kraven som detaljeras i kapitlet Template för lagring av vårdenhet och vårdgivare följas. | ||
COMPOSITION.context → EVENT_CONTEXT.health_care_facility MÅSTE ange den mest specifika enheten där vården bedrivs, om sådan finns, annars MÅSTE vårdenhet anges. | ||
COMPOSITION.context → EVENT_CONTEXT.health_care_facility FÅR INTE användas för utvärdering av åtkomst ur PDL-perspektiv. | ||
Information från olika vårdenheter FÅR INTE journalföras inom ramen för samma COMPOSITION vid ett och samma tillfälle om de ur PDL-synpunkt borde ha journalförts hos olika vårdenheter. | Dokumentation gemensam för flera vårdenheter (eller vårdgivare) | |
Flera ENTRY-objekt (t.ex. mätvärden) från olika vårdenheter FÅR INTE blandas i samma COMPOSITION-version om de ur PDL-synpunkt borde ha journalförts hos olika vårdenheter. | Dokumentation gemensam för flera vårdenheter (eller vårdgivare) |
...
Attribut | Krav | |
---|---|---|
Namn (openEHR-EHR-CLUSTER.organisation.v1/items[at0001] Name) | Vårdgivarens namn (vid dokumentationstillfället), MÅSTE anges i fältet DV_TEXT.value (eftersom arketypen i dagsläget kräver detta), själva PDL-utvärderingen baseras dock endast på identifieraren, inte på namnet. Exempel:
| |
Identifierare (openEHR-EHR-CLUSTER.organisation.v1/items[at0003] Identifier) | Organisationsnummer MÅSTE anges som en av vårdgivarens identifierare i enlighet med Implementationsguide för HSA-id och Organisationsnummer. Själva organisationsnumret läggs då vid användning i fältet DV_IDENTIFIER.id. Om vårdgivaren har ett HSA-id eller annan relevant identifierare BÖR detta anges som ytterligare identifierare utöver det obligatoriska organisationsnumret. Exempel på organisationsnummer:
| |
OM Tillägg 2023-07-19 genomförsså ska denna rad läggas till för organisationsnummer och (det kursiverade i) ovanstående rad ändras till att endast gälla HSA-id eller eventuella andra identifierare som inte är Organisationsnummer. Organisationsnummer (openEHR-EHR-CLUSTER.organisation.v1/items[at0003] Organisational number) | Organisationsnummer MÅSTE anges som en av vårdgivarens identifierare i enlighet med Implementationsguide för HSA-id och Organisationsnummer. Själva organisationsnumret läggs då vid användning i fältet DV_IDENTIFIER.id. Exempel på organisationsnummer:
| |
Roll (openEHR-EHR-CLUSTER.organisation.v1/items[at0004] Role) | Vårdgivarens roll MÅSTE anges för att kunna identifiera vilken typ av organisation som avses. Attributet Role (Roll) är av typen DV_CODED_TEXT, följande gäller för dess attribut (se även bild nedan):
|
...
COMPOSITION.context → EVENT_CONTEXT.health_care_facility BÖR ange den mest granulära eller exakta (under)enhet/mottagning som är möjlig och lämplig, om sådan finns, annars MÅSTE man åtminstone ange vårdenhet, eftersom innehållet i detta attribut kan förväntas vara det som visas i många användargränsnitt samt används för vissa sorters filtreringar i gränssnitt.
Exempel: Distriktssköterskemottagning vid Brandbergens vårdcentral, med HSA-id SE2321000016-14LF
COMPOSITION.context → EVENT_CONTEXT.health_care_facility är av typen PARTY_IDENTIFIED, för detta attribut gäller:
Normalfall: En identifierare för den mest specifika enheten MÅSTE anges som ett element i listan PARTY_IDENTIFIED.identifiers, som är en lista med objekt av typen DV_IDENTIFIER i enlighet med Implementationsguide för HSA-id och Organisationsnummer. Om enheten har ett eget HSA-id MÅSTE detta anges som en av identifierarna. Om HSA-id saknas för den egna enheten eller vårdenhet som den ingår i, men ändå ett organisationsnummer finns så MÅSTE organisationsnummer anges som en av identifierarna (se specialfall nedan)
Specialfall: Undantaget är de fall (t.ex. vissa riktigt små verksamheter) som inte har HSA-idn eller vårdavdelningar, i det fallet FÅR den minsta enheten vara själva vårdgivaren, i dessa fall MÅSTE istället vårdgivarens organisationsnummer finnas i PARTY_IDENTIFIED.identifiersi enlighet med Implementationsguide för HSA-id och Organisationsnummer
Fler identifierare för den mest specifika enheten FÅR anges vid behov i listan med DV_IDENTIFIER-objekt.
Namnet på enheten FÅR anges via EVENT_CONTEXT.health_care_facility → PARTY_IDENTIFIED.name
Om namn på enhet anges så MÅSTE det vara det namn som gällde på enheten vid händelsen som föranledde dokumentet (det ska alltså inte uppdateras i den redan sparade journalanteckingen om enheten senare byter namn)
Ett alternativ till att spara information om namn på enheten är att slå upp det i en versionshanterad katalogtjänst som kan ange dåvarande (och kanske även nuvarande) namn på enheten.
Eftersom health_care_facility ofta används som läsbart namn i användargränssnitt rekommenderar vi att mer information än den mest specifika enhetens interna katalognamn anges utifall detta är otydligt. Om det t.ex. står bara "Distriktssköterskemottagning" i HSA-katalogen så rekommenderar vi något mer beskrivande som "Distriktssköterskemottagning, Brandbergens vårdcentral".
Förväxlingsrisker
Andra relaterade fält i openEHR vars funktion inte används för utvärdering av åtkomst enligt PDL och som inte ska förväxlas med ovanstående är exempelvis:
COMPOSITION.composer som MÅSTE ange dokumentets författare, som ansvarar för innehållet kliniskt (t.ex. en läkare) och kan vara annan än den den inloggade användare (t.ex. vårdaministratör) som i praktiken faktiskt lagrar det.
EVENT_CONTEXT.location beskriver en fysisk plats, t.ex. ett visst rum, operationssal - inte en organisatorisk enhet. Detta frivilliga fält FÅR användas och kan vara av intresse exempelvis vid smittspårning eller annan uppföljning, men är alltså inte relevant för åtkomstkontroll enligt PDL.
Teknisk information: För varje uppdatering av en COMPOSITION som görs MÅSTE info om inloggad användare (vanligen användarnamn) sparas i attributet VERSION.commit_audit → AUDIT_DETAILS.committer
- Elektronisk (kryptografisk) signering av journalanteckning FÅR göras, vid behov, på versionshanterad COMPOSITION-nivå via ORIGINAL_VERSION.attestations som beskrivs i openEHRs “Change Control Package“. I svenska journalsystem görs sällan sådan kryptografisk signering idag, utan snarare signeringsmarkering realiserad via ett ja/nej i en databas
.
Diagram och klassbeskrivningar
...
Anchor | ||||
---|---|---|---|---|
|
...
Namn | Org nr | HSA-id | Funktion |
---|---|---|---|
Stockholms läns sjukvårdsområde | 232100-0016 | SE2321000016-2GJS | Vårdgivare |
Brandbergens vårdcentral | SE2321000016-1003 | Vårdenhet (Vårdcenral) | |
Distriktssköterskemottagning (vid Brandbergens vårdcentral) | SE2321000016-14LF | ||
Täby Vårdcentral | SE2321000016-150H | Vårdenhet (Vårdcenral) | |
Beroendecentrum Stockholm | SE2321000016-15FL | Vårdenhet | |
Namy Nursington | SE2321000016-7ABC | Distriktssköterska | |
Urban Uskman | SE2321000016-1CBA | Undersköterska (medverkade) | |
Danderyds Sjukhus AB | 556575-6169 | SE2321000016-1K2W | Vårdgivare |
Ortopedkliniken | SE2321000016-1K6Q | Vårdenhet | |
Vårdavdelning 14 gynekologi | SE2321000016-1K54 | Vårdenhet | |
Annas Medicinska Fotvård EN | 790127-1111 | Vårdgivare (Enskild firma) | |
Annas Medicinska Fotvård | SE2321000016-DGM2 | “Vårdenhet” | |
Anna Nnamn | SE2321000016-2222 | Fotvårdsterapeut |
...
Exemplet nedan är i ett av openEHRs förenklade format: structSDT genererat via EhrScape https://www.ehrscape.com/api-explorer.htmlBehöver uppdateras om strukturändringsförslaget 2022-02-08 samt tillägget 2023-07-19 genomförs
...