...
Metainformasjon
(Se her for forklaring av elementer og gyldige kodeverdier som kan benyttes på Helsenorge for alle typer FHIR-ressurser: Meta informasjon som kan benyttes for alle FHIR ressurser )
id: Dette er ressursens ID når ressursen er lagret på Helsenorge. Denne genereres av Helsenorge og er alltid en GUID.
meta.security - Tjenesteområde (betingetobligatorisk):
Skal alltid være med for CommunicationRequest dersom dette er en hendelse som skal vises på Helsenorge (se elementet ServiceRequest.medium)Skal ikke være med dersom dette er en direktemelding til innbygger (se elementet ServiceRequest.medium(se HER for ytterligere forklaring og gyldige kodeverdier)
Eks:
Code Block |
---|
<meta> <!-- For en del FHIR-ressurser skal avsender angi hvilket "område" ressursen faller inn under. Dette benyttes på Helsenorge for å tilordnede riktig tilgansstyringsprofil til det aktuelle objektet. --> <!-- Volven kodeverk 7618 --> <security> <system value="urn:oid:2.16.578.1.12.4.1.1.7618"/> <code value="3"/> <display value="Helsehjelp"/> </security> </meta> |
meta.tag - Varsling (frivillig)
Parameteren bør benyttes for å angi hvordan avsender organisasjonen skal framstå (navn) i SMS- og e-post varsler til innbygger. Dersom ikke angitt, inkluderes ikke navnet til avsender av servicemeldingen Hendelsesvarselet i SMS/e-post varsel til innbygger om ny hendlesehendelse.
Kodesystem: http://helsenorge.no/fhir/varsling
Verdisett (gyldige kodeverdi for ServiceRequest):
9 - Benytt angitt navn som avsender i varsel til innbygger (erstatter tidligere bruk av meta.security - sensitivAvsender)
Eksempler:
Code Block |
---|
<meta> <tag> <extension url="http://helsenorge.no/fhir/extension/varselorganisasjon"> <valueString value="Ullevål sykehus, OUS"/> </extension> <system value="http://helsenorge.no/fhir/varsling"/> <code value="9"/> <display value="Benytt angitt navn som avsender i varsel til innbygger"/> </tag> </meta> |
Ressursens profil (CommunicationRequest)
|
| ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| identifier (mandatory): En identifikator som identifiserer denne servicemeldingen det enkelte Hendelsesvarsel forretningsmessig uavhengig av ressursens id på en FHIR-server. Skal være en GUID. Kan benyttes for å knytte denne servicemeldingen Hendelsesvarsel sammen med eventuelle etterfølgende servicemeldinger. Eks: Hendelsesvarseler. Eksempel på bruk under:
| ||||||||||
status (mandatory): Status på CommunicationRequest i henhold til FHIR kodeverk.Skal , skal alltid være “active” og er påkrevd.
| |||||||||||
statusReason category (mandatory): Årsaken til at det skal sendes en servicemelding. Benyttes som tittel i Hendelsesmenyen. Eksempel for melding om nytt prøvesvar: Code Block | Type CommunicationRequest i henhold til FHIR kodeverk. Gyldige kodeverdier for Hendelsesvarselet:
category (mandatory): Type CommunicationRequest i henhold til FHIR kodeverk. Gyldige kodeverdier for servicemelding:
| ||||||||||
subject (mandatory): Dette identifiser innbygger som skal ha Hendelsesvarselet og det skal benyttes fødselsnummer eller d-nummer. Eksempel på bruk under:
| |||||||||||
subject about (mandatorybetinget): Her identifiseres den innbygger som skal ha servicemeldingen. Det skal benyttes fødselsnummer eller d-nummer. Eks: Code Block | DersomHendelsesvarsel referer til en ressurs som er tilgjengelig på Helsenorge, kan det legges inn en referanse til denne her. Med tilgjengelig menes at ressursen enten er lagret på Helsenorge eller at Helsenorge kan hente denne på vegne av innbygger fra den eksterne aktøren. Helsenorge kan da vise detaljene til innbygger. For ressurser som hentes eksternt, må avsender av hendelse verifisere at innbygger som mottar hendelse også har tilgang til ressursen. Eksempelvis skal det ikke sendes varsel om prøvesvar som ikke er tilgjengelig for innbygger. Eksempel for hendelsevarsel knyttet til en eksisterende timeavtale
Eksempler for en hendelsevarsel som angår nytt prøvesvar. Pr. i dag har vi 3 forskjellige kilder for prøvesvar:
Eksempel på hendelsevarsel som inneholder påminnelse fra et Verktøy
| ||||||||||
payload: Referanse til en Hendelsestype på Helsenorge. Disse er forhåndsdefinert og nye legges til ved behov. Teksten som vises for innbygger i Hendelsesmenyen vil være funksjon av Hendelsestype og “category” og vedlikeholdes av Helsenorge. Foreløpig er følgende Hendelsestyper definert:
| |||||||||||
requester (mandatory): Den som har generert Hendelsesvarselet. Skal inneholde organisasjonsnummer og navn. Denne informasjonen vises ikke til innygger i Hendelsemenyen. Eks:
| |||||||||||
Sender (mandatory): Den tjeneste som varselet er relatert til. Denne vises som avsender av Hendelsesvarselet for innbygger i Hendelsesmenyen. Eks:
|
Eksempel på CommunicationRequest
Varsel om nytt Prøvesvar i Pasientens Prøvesvar
Code Block |
---|
<?xml version="1.0" encoding="UTF-8"?> <CommunicationRequest xmlns="http://hl7.org/fhir" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://hl7.org/fhir fhir-single.xsd"> <meta> <security> <!-- Man skal angi hvilket "område" ressursen faller inn under. Dette benyttes på Helsenorge for å tilordnede riktig tilgansstyringsprofil til det aktuelle objektet. --> <!-- Volven kodeverk 7618 benyttes --> <system value="urn:oid:2.16.578.1.12.4.1.1.7618"/> <code value="3"/> <display value="Helsehjelp"/> </security> <!-- Må benyttes dersom avsenders navn skal være med i varsler fra Helsenorge til innbygger på e-post/SMS --> <tag> <extension url="http://helsenorge.no/fhir/extension/varselorgansasjon"> <valueString value="Pasientens Prøvesvar"/> </extension> <system value="http://helsenorge.no/fhir/varsling"/> |
...
<code value=" |
...
9" |
...
/>
|
...
<display value="Benytt angitt navn som avsender i varsel |
...
til innbygger"/> </tag> |
...
</meta> <identifier> |
...
< |
...
about (betinget): Dersom servicemeldingen referer til en FHIR-ressurs som er “kjent” på Helsenorge, kan det legges inn en referanse til denne her. Med “kjent” menes at ressursen enten er lagret på Helsenorge eller at Helsenorge kan hente denne på vegne av innbygger fra den eksterne aktøren. Hver ressurs-type er tilknyttet et løsningsområde på Helsenorge som har ansvaret for å vise den aktuelle referansen til innbygger når det “klikkes” i hendelsesmenyen.
Eksempel for varsel knyttet til en eksisterende timeavtale
...
!-- GUID satt av den som har generert Hendelsesvarselet. Benyttes for å referer til dette Hendelsesvarselet unikt --> <system value="urn:ietf:rfc:3986"/> <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/> </identifier> <status value="active" /> <!-- |
...
Hendelsesvarsel |
...
skal |
...
alltid |
...
angi |
...
kategori |
...
--> |
...
|
...
|
...
|
...
|
...
<category> |
...
|
...
|
...
|
...
<coding> |
...
<system value="http:// |
...
terminology.hl7. |
...
org/CodeSystem/communication-category "/> |
...
Eksempler for en melding som angår nytt prøvesvar.
Pr. i dag har vi 3 forskjellige kilder for prøvesvar:
Pasientens Prøvesvar (sentral tjeneste under utprøving)
...
|
...
|
...
|
...
|
...
<code value="notification"/> </coding> </category> <subject> <type value=" |
...
Patient" /> <identifier> <system value=" |
...
urn:oid:2.16.578.1.12.4.1.4.1" /> <value value=" |
...
13116900216" /> </identifier> |
...
Dokumentbaserte prøvesvar (via nasjonal XDS-løsning)
...
</subject> <about> <!-- |
...
|
...
Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge --> <!-- Eksempel fra |
...
Pasientens Prøvesvar --> <type value="Observation" /> <identifier> <system value="http://nhn.no/ |
...
pps/ |
...
ressursid"/> |
...
|
...
|
...
|
...
|
...
|
...
FHI sine korona prøvesvar
...
|
...
<value value="aa54d29e-4009-49cb-9ec4-847a6469459d"/> </identifier> </about> <payload> |
...
<contentReference> |
...
|
...
|
...
|
...
|
...
|
...
|
...
<identifier> |
...
<system value="http:// |
...
helsenorge.no/ |
...
fhir/ |
...
hendelsestype"/> |
...
|
...
|
...
|
...
payload (mandatory, maks 250 tegn): Dette er den tekststreng som skal vises for innbygger under hendelsesmenyen.
...
|
...
<value value=" |
...
requester (mandatory): Den som har generert servicemeldingen. Skal inneholde organisasjonsnummer og navn. “Display-verdien” er slik avsender framstår for innbygger i hendelsesmenyen på Helsenorge.
...
1001"/> </identifier> <display value="Nytt prøvesvar"/> </contentReference> </payload> <requester> <type value="Organization"/> <identifier> <!-- Avsenders organisasjonsnummer --> <system value="urn:oid:2.16.578.1.12.4.1.2.101" /> <value value=" |
...
994598759" /> </identifier> |
...
<display value=" |
...
Norsk Helsenett SF"></display> </requester> <sender> <type |
...
value="HealthcareService"/> <display value="Pasientens |
...
Prøvesvar"/> </sender> </ |
...
CommunicationRequest> |
Påminnelse fra Verktøy
Code Block |
---|
<?xml version="1.0" encoding="UTF-8"?> <CommunicationRequest xmlns="http://hl7.org/fhir" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://hl7.org/fhir fhir-single.xsd"> <meta> <security> <!-- For en del FHIR-ressurser-- Man skal avsender angi hvilket "område" ressursen faller inn under. Dette benyttes på Helsenorge for å tilordnede riktig tilgansstyringsprofil til det aktuelle objektet. --> <!-- Volven kodeverk 7618 benyttes --> <system value="urn:oid:2.16.578.1.12.4.1.1.7618"/> <code value="3"/7618"/> <code value="1"/> <display value="Rettigheter og selvhjelp"/> </security> <!-- Må benyttes dersom avsenders navn skal være med i varsler fra Helsenorge til innbygger på e-post/SMS --> <!-- Inntil videre tillates <display value="Helsehjelp"/> </security>ikke at Helsenorge selv varsler innbygger via e-post/SMS for Verktøypåminnelser --> <tag> <extension url="http://helsenorge.no/fhir/extension/varselorganisasjonvarselorgansasjon"> <valueString value="Ullevål sykehus, OUSSMART-mosjon"/> </extension> <system value="http://helsenorge.no/fhir/varsling"/> <code value="9"/> <display value="Benytt angitt navn som avsender i varsel til innbygger"/> </tag> </meta> <identifier> <!-- GUID satt av den som har generert servicemeldingenHendelsesvarselet. Benyttes for å referer til dennedette servicemedlingenHendelsesvarselet unikt --> <system value="urn:ietf:rfc:3986"/> <value value="urn:uuid:aa54d29e3b52ec71-40093681-49cb4d01-9ec4849f-847a6469459d21278bf2a21d"/> </identifier> <status value="active" /> <!-- Hendelsesvarsel skal alltid <statusReason>angi kategori --> <category> <!-- Her SKAL<coding> årsak/servicemeldingens tittel legges. --> <text<system value="Her skal servicemedlingens tittel leggeshttp://terminology.hl7.org/CodeSystem/communication-category "/> </statusReason> <!-- Servicemeldinger skal alltid ha denne kategorien --><code value="reminder"/> <category> </coding> </category> <coding> <subject> <system<type value="http://terminology.hl7.org/CodeSystem/communication-category "/> Patient" /> <identifier> <code<system value="notification"urn:oid:2.16.578.1.12.4.1.4.1" /> </coding> </category> <value <subject>value="13116900216" /> </identifier> <type value="Patient" </>subject> <about> <identifier> <!-- Her legges inn referanse til FHIR-ressurs som finnes, eller <system value="urn:oid:2.16.578.1.12.4.1.4.1" /> kan hentes, på Helsenorge --> <!-- Eksempel for Verktøyet SMART-mosjon --> <value<type value="13116900216Device" /> </identifier><identifier> </subject> <about> <!-- Dersom relevant: Her legges inn referanse til FHIR-ressurs som finnes, eller kan hentes, på Helsenorge --<system value="http://nhn.no/helsenorge/verktoyid" /> <value value="9d493acb-a404-48de-83d4-5f2d0806f74b"/> </identifier> <!-- Eksempel fra Pasientens Prøvesvar --> </about> <payload> <contentReference> <type value="Observation" /> <identifier> <system value="http://nhnhelsenorge.no/ppsfhir/ressursidhendelsestype"/> <value value="aa54d29e-4009-49cb-9ec4-847a6469459d1010"/> </identifier> </about>identifier> <payload> <!-- Max 250 tegn --> <contentString<display value="DettePåmionnelse er teksten i servicemeldingen slik den skal vises for innbygger"/>fra verktøy"/> </contentReference> </payload> <requester> <type value="Organization"/> <identifier> <!-- Avsenders organisasjonsnummer --> <system value="urn:oid:2.16.578.1.12.4.1.2.101" /> <value value="948554062983544622" /> </identifier> <display value="Helsedirektoratet"></display> </requester> <sender> <type value="Studentsamskipnaden i Oslo og Akershus"></display>"HealthcareService"/> <display value="SMART-mosjon"/> </requester>sender> </CommunicationRequest> |
Add label