Prosesser og flyt
Her er info om prosesser og flyt
Expand |
---|
title | Overordnet flyt og sekvensdiagram |
---|
|
Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten. Prosess | Funksjonalitet | Versjon | Notifikasjon_Innbygger_Helsekontakt | Avsender kan sende en helsekontakt til innbygger på Helsenorge. | 1.0 |
Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes for de ulike versjonene. Versjon | Rolle | Funksjon | Meldingsinnhold | 1.0 | Helsepersonell | Helsekontakt | FHIR | Innbygger | Apprec | Applikasjonskvittering |
Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under. |
Hodemelding
Hodemelding er å betrakte som transport for selve Helsekontakten og inneholder informasjon om avsender, mottakende systrem samt pasient for notifikasjonen om en ny- eller endret helsekontakt. Selve Helsekontyakten er i sin helhet bekrevet i Document-delen av hodemelingen i form av FHIR-ressurs.
Expand |
---|
title | Krav til elementet «MsgHead/MsgInfo/MsgId» |
---|
|
Den unike id (MsgId) i Hodemeldingen skal være en UUID (Universally Unique Identifier). XML eksempel: Code Block |
---|
<MsgId>9713cf31-f4a0-49da-b4d6-75887502f0d3</MsgId> |
|
Expand |
---|
title | Krav til elementet «MsgHead/MsgInfo/Type» |
---|
|
Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Notifikason - helsekontakt og skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon: Kodeverdi | Kodetekst | NOTIFIKASJON_INNBYGGER_HELSEKONTAKT | Notifikasjon til innbygger – Helsekontakt |
|
Expand |
---|
title | Krav til elementet «MsgHead/MsgInfo/Ack» |
---|
|
Elementet «MsgHead/MsgInfo/Ack» skal angi at det kreves applikasjonskvittering på meldingen. Verdi og kode | <Ack DN="Ja" V="J" /> |
|
Expand |
---|
title | Krav til informasjonsinnhold for avsender og mottaker |
---|
|
Informasjon om avsender og mottaker av Hodemeldingen skal være i henhold til beskrivelsen i standarden standardene for tjenestebasert adressering tilgjengelig her: https://www.ehelse.no/standarder/om-standardisering-i-e-helse/tjenestebasert-adressering Avsender: MsgHead/MsgInfo/Sender I avsender av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator. Dette er altså avsender av notifikasjonen, og er ikke relatert til selve helsekontakten. XML eksempel med “Universitetssykehuset i Nord-Norge HF” som avsender: Code Block |
---|
<Sender>
<Organisation>
<OrganisationName>UNIVERSITETSSYKEHUSET NORD-NORGE HF</OrganisationName>
<Ident>
<Id>9</Id>
<TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
</Ident>
<Organisation>
<OrganisationName>Digitale innbyggertjenester</OrganisationName>
<Ident>
<Id>8135429</Id>
<TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
</Ident>
</Organisation>
</Organisation>
</Sender> |
Mottaker: MsgHead/MsgInfo/Receiver I mottager av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator, et XML eksempel er vist under. Code Block |
---|
<Receiver>
<Organisation>
<OrganisationName>Direktoratet for e-helse</OrganisationName>
<Ident>
<Id>93580</Id>
<TypeId DN="HER-id" V="HER" S="2.16.578.1.12.4.1.1.9051"/>
</Ident>
<Organisation>
<OrganisationName>Digitale innbyggertjenester</OrganisationName>
<Ident>
<Id>93239</Id>
<TypeId DN="HER-id" V="HER" S="2.16.578.1.12.4.1.1.9051"/>
</Ident>
</Organisation>
</Organisation>
</Receiver> |
|
Expand |
---|
title | Krav til informasjonsinnhold for MsgHead/MsgInfo/Patient |
---|
|
For identifikasjon av en pasient benyttes kodeverket «ID-type for personer» 8116, se http://www.volven.no . Skjemaet støtter flere identifikatorer, men for digital dialog benyttes bare en identifikator og det er bare støtte for fødselsnummer eller D-nummer Følgende informasjon er obligatorisk å oppgi for pasient. XML eksempel for pasient med fødselsnummer: Code Block |
---|
<Patient>
<FamilyName>Danser</FamilyName>
<GivenName>Line</GivenName>
<Ident>
<Id>13116900216</Id>
<TypeId V="FNR" DN="Fødselsnummer" S="2.16.578.1.12.4.1.1.8116" />
</Ident>
</Patient> |
|
Expand |
---|
title | Krav til bruk av MsgHead/Document |
---|
|
Hodemeldingen har struktur for å ha null til mange forekomster av MsgHead/Document. Under «Document» vil faginnholdet i en melding være plassert, og faginnholdet er definert i egne xml skjema med FHIR-innhold skal inneholde en FHIR-ressurs av typen EpisodeOfCare. |
FHIR-innhold
For overføring av helsekontakter benyttes to FHIR ressurser:
EpisodeOfCare
NB! Formell profil ikke oppdatert. Implementasjonsguiden angitt her på Confluence gjelder
(FHIR-profil http://ehelse.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare, basert på EpisodeOfCare.)
Expand |
---|
|
Elementnavn | Påkrevd | Beskrivelse |
---|
Identifier | Ja | Unik forretningsidentifikator for denne EpisodeOfCare. All senere dialog og andre type hendelser vil refere til denne identifikatoren. Skal være en GUID.
Code Block |
<identifier>
<!-- GUID satt av den som har generert ressursen --> For generell informasjon om tilgjengelige opsjoner som kan gjelde alle FHIR-ressurser se: Meta informasjon som kan benyttes for alle FHIR ressurser
Følgende av disse er relevante for Helsekontakt:
meta.security - Tilgangsbegrensning (betinget)
Denne parameteren skal være med dersom melding/ressurs inneholder informasjon om en innbygger som er fra og med 12 år og opp til og med 15 år. Elementet er altså "conditional" (og ikke obligatorisk i skjemaet). Parameteren skal angi om det ikke er noen tilgangsbegrensning (dvs. at både foreldre og ungdommen selv har tilgang til informasjonen), eller om bare foreldre har tilgang eller bare ungdommen selv. Årsaken til at vi krever denne er satt når pasienten er 12-16 år, er at den indikerer at det er gjort et bevist valg/vurdering om hvem som skal ha tilgang til informasjonen. (Selv om konklusjonen er at både foreldre og ungdom kan få tilgang).
Kodesystem: "http://helsenorge.no/fhir/tilgangsbegrensning
Gyldige verdier:
1 - Ingen begrensning
2 - Kan kun ses av foreldre (ungdom vil ikke kunne se dette informasjonselemnentet selv).
3 - Kan kun ses av ungdommen selv (foreldre vil ikke kunne se dette informasjon selementet),
Code Block |
---|
<meta>
<security>
<Tilgangsbegrensning>
<system value="http://helsenorge.no/fhir/tilgangsbegrensning"/>
<code value="2" />
<display>Kun foreldre</display>
</Tilgangsbegrensning>
</security>
</meta) |
EpisodeOfCare
(FHIR-profil http://helsenorge.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare, basert på EpisodeOfCare.)
Expand |
---|
|
Elementnavn | Påkrevd | Beskrivelse |
---|
Identifier | Ja | Unik forretningsidentifikator for denne EpisodeOfCare. Tilordnes av den som oppretter helseko takten. All senere dialog og andre type hendelser vil refere til denne identifikatoren. Skal være en GUID. Code Block |
---|
<identifier>
<!-- GUID satt av den som har generert ressursen -->
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier> |
| status | Ja | Påkrevd felt. HJelsenorge tar enda ikke hensyn til verdien her, men forutsetter "active". Mer foretningslogikk kan bli definert senere. Se under "period.end" for hvordan en helskontakt "avsluttes". | type | Ja | Obligatorisk del av kontrakten. Kodeverk: http://helsenorge.no/fhir/BehandlingsperiodeType Lovlige verdier: 1 - Kommunal helse og omsorg 2 - Primærhelsetjenesten 3 - Spesialisthelsetjeneste Eks: Code Block |
---|
<type>
<coding>
<system value="urn:ietf:rfc:3986http://helsenorge.no/fhir/BehandlingsperiodeType"/>
<value <code value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d3"/>
</identifier> |
| status | Ja | Påkrevd felt. HJelsenorge tar enda ikke hensyn til verdien her, men forutsetter "active". Mer foretningslogikk kan bli definert senere. Se under "period.end" for hvordan en helskontakt "avsluttes". | type | Ja | Obligatorisk del av kontrakten. Kodeverk: http://helsenorge.no/fhir/BehandlingsperiodeType Lovlige verdier: 1 - Kommunal helse og omsorg 2 - Primærhelsetjenesten 3 - Spesialisthelsetjeneste Eks: Code Block |
---|
<type>
<coding>
<display value="Spesialisthelsetjenesten"/>
</coding>
</type> |
| patient.identifier | Ja | Innbyggers fødselsnummer eller d-nummer. Eks: Code Block |
---|
<patient>
<identifier>
<system value="http://helsenorge.no/fhir/BehandlingsperiodeType"urn:oid:2.16.578.1.12.4.1.4.1" />
<code<value value="313116900216" />
<display value="Spesialisthelsetjenesten"/>
</coding>
</type> |
| patient.identifier | Ja | Innbyggers fødselsnummer eller d-nummer. | managingOrganization.identifier | Betinget (endret fra “Påkrevd” til “Betinget” 2023-11-15) | Elementet skal være med dersom det tilbys digital dialog for denne Helsekontakten. Dersom det ikke tilbys digital dialog for Helsekontakten skal telefonnummer angis i CareTeam, og dette elementet utelates. Skal peke til en unik HERID i Adresseregisteret. Adressen vil senere benyttes for digital dialog mellom innbygger og helsekontakten. Skal være HERID til tjenesteadressen (dvs. HERID nivå 2 i Adresseregistret). NB! Det er ikke krav om at dette er samme HERID som nivå 2 i hodemeldingen, dersom Helsekontakten sendes via AMQP.
Eks: Code Block |
---|
<patient><managingOrganization>
<identifier>
<system value="urn:oid:2.16.578.1.12.4.1.4.12" />
<value value="131169002168137991" />
</identifier>
</patient>managingOrganization> |
| managingOrganizationperiod.identifier | Ja | Må være med og skal peke til en unik HERID i Adresseregisteret. Adressen vil senere kunne benyttes for digital dialog mellom innbygger og helsekontakten. Skal være HERID til tjenesteadressen (dvs. HERID nivå 2 i Adresseregistret). NB! Det er ikke krav om at dette er samme HERID som nivå 2 i hodemeldingen, dersom Helsekontakten sendes via AMQPstart | Ja | Helsekontaktens starttidspunkt Eks: Code Block |
---|
<period>
<start value="2022-08-18T02:00:00+02:00" />
</period> |
| period.end | Nei | Helsekontaktens sluttidspunkt Dersom denne er med vil helsekontakten flyttes til "tidligere helsekontakter" når period.end er nådd, og det er ikke lenger mulig å ha dialog med helsekontakten. | referralRequest (Nytt element i versjon 1.1) | Betinget | Dersom helsekontakten er opprettet som resultat av en henvisning skal dette elementet være med. Det kreves at EPJ genererer en ekstern unik business “identifier” (GUID) som entydig identifiserere henvisning. Eks: Code Block |
---|
<managingOrganization><referralRequest>
<identifier>
<!-- GUID generert som identifiserer den aktuelle <system value="urn:oid:2.16.578.1.12.4.1.2" />henvisning unikt -->
<value<system value="8137991" urn:ietf:rfc:3986"/>
</identifier> </managingOrganization> |
| period.start | Ja | Helsekontaktens starttidspunkt Eks: Code Block |
---|
<period> <value <start value="2022-08-18T02:00:00+02:00" />
</period> |
| period.end | Nei | Helsekontaktens sluttidspunkt Dersom denne er med vil helsekontakten flyttes til "tidligere helsekontakter" når period.end er nådd, og det er ikke lenger mulig å ha dialog med helsekontakten.urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>
</referralRequest> |
| team | Ja | Referanse til contained FHIR-ressurs CareTeam (under) Eks: Code Block |
---|
<team>
<!-- Referanse til contained ressurs. -->
<reference value="#CareTeam-1" />
</team> |
|
|
CareTeam
NB! Formell profil ikke oppdatert. Implementasjonsguiden angitt her på Confluence gjelder(contained)
(FHIR-profil http://ehelsehelsenorge.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare_containedCareTeam, basert på CareTeam.)
Expand |
---|
|
Elementnavn | Påkrevd | Beskrivelse |
---|
id | Ja | Samme id som er benyttet i referansen i EpisodeOdCare (se over) Eks: Code Block |
---|
<id value="CareTeam-1"/> |
| category | Ja | Obligatorisk del av kontrakten. Kodeverk: http://helsenorge.no/fhir/BehandlingsteamKategori Lovlige verdier: 1 - Helsepersonell 2 - Rolle 3 - Gruppe Eks: Code Block |
---|
<category>
<coding>
<system value="http://helsenorge.no/fhir/BehandlingsteamKategori"/>
<code value="3"/>
<display value="Gruppe"/>
</coding>
</category> |
| name | Ja | Navnet på CareTeam. Altså et fellesnavn for hele teamet (alle deltagere). Merk! Det er dette navnet som blir benyttet som navn på helsekontakten i dialogmeldingene. Eks. Code Block |
---|
<name value="UNN - Alderspsykiatrisk avdeling" /> |
| telecom | NeiBetinget | Telefonnummeret om man ønsker at det skal synes på helsekontakten. NB! Skal være med dersom det ikke tilbys digital dialog for denne Helsekontakten. Eks: Code Block |
---|
<telecom>
<system value="phone"/>
<value value="+4798765432" />
</telecom> |
|
|
Eksempel melding
Expand |
---|
Code Block |
---|
<MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.kith.no/xmlstds/msghead/2006-05-24 MsgHead-v1_2.xsd">
<MsgInfo>
<Type V="NOTIFIKASJON_INNBYGGER_HELSEKONTAKT" DN="Helsekontakt" />
<MIGversion>v1.2 2006-05-24</MIGversion>
<GenDate>2022-08-18T14:32:28</GenDate>
<MsgId>341c7be7-bf2f-4a41-9cc4-f7489f319a10</MsgId>
<Ack DN="Ja" V="J" />
<Sender>
<Organisation>
<OrganisationName>UNIVERSITETSSYKEHUSET NORD-NORGE HF</OrganisationName>
<Ident>
<Id>9</Id>
<TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
</Ident>
<Organisation>
<OrganisationName>Digitale innbyggertjenester</OrganisationName>
<Ident>
<Id>8135429</Id>
<TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
</Ident>
</Organisation>
</Organisation>
</Sender>
<Receiver>
<Organisation>
<OrganisationName>DIREKTORATET FOR E-HELSE</OrganisationName>
<Ident>
<Id>115851</Id>
<TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
</Ident>
<Organisation>
<OrganisationName>Digitale innbyggertjenester</OrganisationName>
<Ident>
<Id>8093247</Id>
<TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
</Ident>
</Organisation>
</Organisation>
</Receiver>
<Patient>
<FamilyName>Sørve von</FamilyName>
<GivenName>Æss</GivenName>
<Ident>
<Id>05073500186</Id>
<TypeId V="FNR" S="2.16.578.1.12.4.1.1.8116" DN="Fødselsnummer" />
</Ident>
</Patient>
</MsgInfo>
<Document>
<RefDoc>
<IssueDate V="2022-08-18T14:32:28" />
<MsgType V="A" DN="Vedlegg" />
<MimeType>application/xml</MimeType>
<Description>HelseKontakt</Description>
<Content>
<EpisodeOfCare xmlns="http://hl7.org/fhir"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://hl7.org/fhir fhir-single.xsd">
<contained>
<CareTeam>
<id value="CareTeam-1"/>
<category>
<coding>
<system value="http://helsenorge.no/fhir/BehandlingsteamKategori"/>
<code value="3"/>
<display value="Gruppe"/>
</coding>
</category>
<name value="UNN - Alderspsykiatrisk avdeling" />
<telecom>
<system value="phone"/>
<value value="+4798765432" />
</telecom>
</CareTeam>
</contained>
<identifier>
<!-- GUID satt av den som har generert task'et. Benyttes for å referer dette tasket unikt i forretningsprosessen.
Merk! Dette er ikke ressursidentifieren i FHIR-serveren. -->
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>
<status value="active" />
<type>
<coding>
<system value="http://helsenorge.no/fhir/BehandlingsperiodeType"/>
<code value="3"/>
<display value="Spesialisthelsetjenesten"/>
</coding>
</type>
<!-- Skal alltid vøre med, angir hvilken innbygger denn eEpisodeOfCare tilhører -->
<patient>
<identifier>
<system value="urn:oid:2.16.578.1.12.4.1.4.1" />
<value value="05073500186" />
</identifier>
</patient>
<managingOrganization>
<!-- Skal være HERID på nivå 2 for den organisasjon som er ansvarlig for denne behandlingen
Dennme HERID benyttes for digital dialog med Helsekontakten. -->
<identifier>
<system value="urn:oid:2.16.578.1.12.4.1.2" />
<value value="8135429" />
</identifier>
</managingOrganization>
<period>
<start value="2022-08-18T02:00:00+02:00" />
</period>
<team>
<!-- Referanse til contained ressurs. -->
<reference value="#CareTeam-1" />
</team>
</EpisodeOfCare>
</Content>
</RefDoc>
</Document>
</MsgHead> |
|