Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Innehåll

Table of Contents
minLevel1
maxLevel7

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

0.3.0 (wiki v74)

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

Lagring av vårdenhet och vårdgivare i COMPOSITION.contextEVENT_CONTEXT.other_context MÅSTE göras genom att inkludera templaten “Care Unit”en template som motsvarar den som specificeras i denna implementationsguide.

Template för lagring av vårdenhet och vårdgivare

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

Lagring av den mest specifika enheten

COMPOSITION.contextEVENT_CONTEXT.health_care_facility FÅR INTE användas för utvärdering av åtkomst ur PDL-perspektiv.

Lagring av den mest specifika enheten

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:

  • DV_TEXT.value = Region Östergötland

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):

  • DV_CODED_TEXT.defining_code.code_string MÅSTE sättas till 143591000052106 (Snomed CT begrepps-id för rollen vårdgivare).

  • DV_CODED_TEXT.defining_code.terminology_id MÅSTE sättas till http://snomed.info/sct/45991000052106, dvs. SNOMED CT Sweden NRC maintained module.

  • DV_CODED_TEXT.value BÖR sättas till Vårdgivare i en svenskspråkig journalanteckning, men FÅR INTE användas som bas för utvärdering av åtkomst enligt PDL.

...

  • COMPOSITION.contextEVENT_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.contextEVENT_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_facilityPARTY_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_auditAUDIT_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
care-unit-v2
care-unit-v2
Tillägg 2023-07-19: Iago Corbaland Erik Sundvall had a meeting based on Cambio’s and Karolinska’s implementation experiences and are suggesting an updated version (v2) of the care unit template. We suggest specific names for identifier node level siblings when both orgnaisation number and HSA-id of a care provider are used at the same time. (In openEHR data, node-level siblings with the same at-code must have different names/labels to avoid collision.) Some testing remains to be done before changing the template from alpha status to release-candidate status. This PDL implementation guide (both text and examples) will need to be ajusted. An example tempate is available in https://github.com/modellbibliotek/CKM-mirror/blob/pdl-test/local/pdl/Care%20unit%20v2.t.json The change (addition of a new node) is highlighted in light blue below:

...

Namn

Org nr
(för enskild firma = PNR)

HSA-id

Funktion

Stockholms läns sjukvårdsområde

232100-0016

SE2321000016-2GJS
(Behöver ej anges, men har angetts i ett exempel nedan)

Vårdgivare

Brandbergens vårdcentral

SE2321000016-1003

Vårdenhet (Vårdcenral)

Distriktssköterskemottagning (vid Brandbergens vårdcentral)

SE2321000016-14LF

Den mest specifika enheten

Täby Vårdcentral

SE2321000016-150H

Vårdenhet (Vårdcenral)

Beroendecentrum Stockholm

SE2321000016-15FL

Vårdenhet

Namy Nursington

SE2321000016-7ABC

Distriktssköterska
(“Composer” ansvarig för journalanteckningen)

Urban Uskman

SE2321000016-1CBA

Undersköterska (medverkade)

Danderyds Sjukhus AB

556575-6169

SE2321000016-1K2W

Vårdgivare

Ortopedkliniken
(vid Danderyds Sjukhus AB)

SE2321000016-1K6Q

Vårdenhet

Vårdavdelning 14 gynekologi
(vid Danderyds Sjukhus AB)

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

...