0.1.0 - ci-build
FastaKontakter - Lokal utvecklingsbygge (v0.1.0) byggt av FHIR (HL7® FHIR® Standard) Build Tools. Se katalogen över publicerade versioner
Denna sida beskriver bakgrund, användningsfall och viktiga designval för FHIR-profilerna inom området Fasta kontakter.
Syftet är att ge stöd för hur profilerna ska förstås och användas, samt hur de relaterar till det informatiska arbete som ligger till grund för profileringen.
Fasta kontakter är en informationsmängd som beskriver kontakt- och samordningsfunktioner runt en invånare inom vård och omsorg.
Syftet med informationen är att göra det tydligare för invånaren vem som är fast kontakt, hur kontakten kan nås och om kontakten sker direkt eller via ett team.
Arbetet utgår från den informationsmodell som tagits fram för Fasta kontakter. Profileringen i FHIR visar hur informationsinnehållet kan representeras på ett strukturerat och standardiserat sätt.
Det huvudsakliga användningsfallet är att kunna beskriva information som kan användas för att visa eller dela uppgifter om en invånares fasta kontakter.
Exempel på information som kan behöva uttryckas är:
Profilerna beskriver kontakt- och samordningsfunktioner kring invånaren. De beskriver inte fullständiga organisatoriska strukturer.
Fasta kontakter och team modelleras med FHIR-resursen CareTeam, men med två separata profiler:
RIVCareManager för Fast kontaktRIVManagingTeam för TeamBåda profilerna bygger på CareTeam, men används för olika betydelser.
En fast kontakt beskriver relationen mellan en invånare och en namngiven vård- eller omsorgspersonal med samordnande funktion.
Ett team beskriver ett vård- eller omsorgsteam som kan ha egna kontaktuppgifter och som i vissa fall kan användas som kontaktväg till en fast kontakt.
Vilken typ av CareTeam som avses anges med CareTeam.category.
En fast kontakt uttrycks med profilen RIVCareManager.
Profilen används när en invånare har en namngiven vård- eller omsorgspersonal som fast kontakt, till exempel:
Typ av fast kontakt anges med participant.role och bör i första hand anges med kod från värdemängden för typ av fast kontakt.
Om en mer specifik eller lokal benämning behöver uttryckas, till exempel diabetessjuksköterska, kan detta anges i CodeableConcept.text på participant.role. Detta bör användas som kompletterande fritext och inte ersätta kodad typ av fast kontakt när en lämplig kod finns.
När profilen används för fast kontakt gäller följande principer:
subject anger invånaren som den fasta kontakten gäller förcategory anger att resursen avser fast kontaktparticipant.member anger den namngivna personen i sin roll, via PractitionerRoleparticipant.role anger typ av fast kontaktperiod kan ange när relationen börjar och upphörtelecom kan ange direkta kontaktuppgifter till den fasta kontakten eller funktionen som förmedlar kontaktYrkestitel, befattning och organisatorisk tillhörighet bör beskrivas i den refererade PractitionerRole-resursen, inte som typ av fast kontakt.
Typ av fast kontakt beskriver personens funktion i relation till invånaren, inte personens yrkestitel.
Ett team uttrycks med profilen RIVManagingTeam.
Profilen används när ett vård- eller omsorgsteam behöver beskrivas strukturerat, till exempel när teamet har egna kontaktuppgifter eller används som kontaktväg till en fast kontakt.
När profilen används för team gäller följande principer:
category anger att resursen avser teamname kan ange teamets namnidentifier kan ange identifierare för teametparticipant.member kan ange personer eller roller som ingår i teamettelecom kan ange kontaktuppgifter till teametperiod kan ange när teamet är relevant i det aktuella sammanhangetsubject är frivilligt för team. Det innebär att ett team kan beskrivas utan att vara direkt kopplat till en specifik invånare.
Det är relevant när teamet exempelvis används som kontaktväg för en fast kontakt, men där invånaren inte ingår i teamet.
En fast kontakt kan ibland nås via ett team. Det kan till exempel vara så att en namngiven sjuksköterska är fast vårdkontakt, men att invånaren inte får ett direktnummer till sjuksköterskan. I stället används teamets telefonnummer.
I denna IG uttrycks detta genom en extension på RIVCareManager.participant.
Extensionen anger vilket team den fasta kontakten kan nås via.
Principen är:
RIVCareManager.subject anger invånarenRIVCareManager.participant.member anger den fasta kontakten som PractitionerRoleRIVCareManager.participant.extension[contactViaTeam] kan ange det team som kontakten nås viaRIVManagingTeam-resursens telecomExempel:
Anna har Eva Svensson som fast vårdkontakt. Eva nås via Norra teamet. Norra teamets telefonnummer och kontakttider anges på teamresursen.
Denna struktur gör det möjligt att skilja mellan den fasta kontakten som person och det team som används som kontaktväg.
Kontaktuppgifter anges med telecom.
På RIVCareManager avser telecom kontaktuppgifter som kan användas för att nå den fasta kontakten när kontaktvägen uttrycks direkt på relationen fast kontakt.
På RIVManagingTeam avser telecom kontaktuppgifter till teamet. Dessa kontaktuppgifter kan även användas när en fast kontakt nås via teamet.
Exempel på kontaktuppgifter är:
Om kontakt sker via ett team bör kontaktuppgifterna i första hand anges på teamresursen.
Tillgänglighet för en kontaktväg anges med extensionen RIVHoursOfServiceExtension.
Extensionen placeras på telecom, eftersom olika kontaktvägar kan ha olika tillgänglighet.
Ett telefonnummer kan till exempel ha vissa telefontider, medan en annan kontaktväg kan ha andra tider eller sakna tidsbegränsning.
Extensionen kan användas för att ange:
period används för att ange under vilken tid relationen eller teamet gäller.
För RIVCareManager beskriver perioden när relationen som fast kontakt börjar och eventuellt upphör.
För RIVManagingTeam beskriver perioden när teamet är relevant i det aktuella sammanhanget.
Element som är markerade med Must Support är element som bedöms vara viktiga för implementering av profilen.
Det innebär att en implementation som producerar eller konsumerar information enligt profilen ska ha stöd för att hantera dessa element när de är relevanta för användningsfallet.
Must Support innebär inte i sig att elementet alltid måste förekomma i varje instans. Om ett element måste förekomma styrs detta av elementets kardinalitet.
Exempel:
category är 1..1 MS, vilket innebär att elementet måste finnas och ska stödjas av implementationen.subject är 1..1 MS i RIVCareManager, eftersom en fast kontakt alltid ska vara kopplad till en invånare.subject är 0..1 MS i RIVManagingTeam, eftersom ett team kan beskrivas utan direkt patientkoppling.participant.member är 1..1 MS i RIVCareManager, eftersom den fasta kontakten ska vara en namngiven person i roll.telecom är 0..* MS, vilket innebär att kontaktuppgifter inte alltid måste finnas, men att implementationen ska kunna hantera dem när de skickas.CarePlan används inte som sammanbindande resurs för Fasta kontakter i nuläget.
Skälet är att informationsmängden Fasta kontakter inte i sig beskriver en plan, målbild eller planerade aktiviteter. En fast kontakt eller ett team är i detta sammanhang en kontakt- och samordningsfunktion, inte en vård- eller omsorgsplan.
Om fasta kontakter i ett senare skede ska beskrivas som del av exempelvis en dokumenterad överenskommelse, SIP eller annan vård- och omsorgsplan kan en särskild CarePlan-profil övervägas för det planeringssammanhanget.
Implementationsguiden innehåller mappningar mellan informationsmodellen för Fasta kontakter och de FHIR-profiler som tagits fram.
De mappningar som är relevanta för denna IG är:
RIVCareManagerRIVManagingTeamPå profilsidorna kan även andra mappningar visas, till exempel FiveWs Pattern Mapping, RIM Mapping, Interface Pattern och HL7 V2 Mapping. Dessa följer med FHIR:s grundresurser och är inte specifika för informationsmängden Fasta kontakter.
Denna IG beskriver hur information om fasta kontakter och team kan uttryckas med FHIR.
RIVCareManager används för att beskriva den fasta kontakten mellan en invånare och en namngiven person i roll.
RIVManagingTeam används för att beskriva ett team som kan ha egna kontaktuppgifter och som kan användas som kontaktväg till en fast kontakt.
Tillsammans gör profilerna det möjligt att uttrycka både vem som är fast kontakt och hur invånaren kan nå kontakten, direkt eller via ett team.